greghendershott / aws

Racket support for Amazon Web Services.

Overview

Provides Racket support for many Amazon Web Services:

• S3 storage.

• SimpleDB database.

• SES email.

• SNS notification.

• SQS queues.

• CloudWatch monitoring.

• Glacier archiving.

• Authorization signature version 4.

• Route 53.

• Dynamo.

Requirements

• Racket 6.2 or newer.

• The access keys for an Amazon Web Services account. (If you want to experiment but are concerned about cost, keep in mind that AWS has a free usage tier.)

• My http and sha packages. These are listed as dependencies and will be installed automatically when you raco pkg install aws.

Documentation

• Documentation.

Unit tests

To simply use the library you don't need to run the unit tests. But if you want to run them:

• The tests require you to specify certain personal information in a dot file. See example-dot-aws-tests-data for more information.

• The rackunit tests use the submodule feature added in Racket 5.3. Tests are inside (module+ test ...) forms.

  • You can run the tests for one foo.rkt file with raco test foo.rkt.

  • You can run tests for all files using raco test -x .. (The -x flag is important to avoid evaluating rkt files that have no test module whatsoever.)

• Be aware that the tests are extensive and will do significant data transfer with Amazon AWS. Although this shouldn't cost a lot of money, it will take some time for them to complete.