/aws

Racket support for Amazon Web Services.

Primary LanguageRacketBSD 2-Clause "Simplified" LicenseBSD-2-Clause

CI raco pkg install aws Documentation BSD License

Overview

Provides Racket support for many Amazon Web Services:

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

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.