Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Common Lisp library for accessing Amazon Web Services APIs

branch: master

Fetching latest commit…


Cannot retrieve the latest commit at this time

Octocat-spinner-32 LICENSE
Octocat-spinner-32 README
Octocat-spinner-32 common.lisp
Octocat-spinner-32 conditions.lisp
Octocat-spinner-32 constants.lisp
Octocat-spinner-32 ec2.lisp
Octocat-spinner-32 hh-aws.asd
Octocat-spinner-32 package.lisp
Octocat-spinner-32 s3.lisp
Octocat-spinner-32 sdb.lisp
Octocat-spinner-32 sqs.lisp
Octocat-spinner-32 tests.lisp
Octocat-spinner-32 utils.lisp
Octocat-spinner-32 xml.lisp

This package is a Common Lisp library for acessing the APIs of Amazon Web Services.  Current services supported 
(partially or completely) are:

* Simple Storage Service (S3) -- version 3/1/2006
* SimpleDB (SDB) -- version 7/11/2007
* Elastic Compute Cloud (EC2) -- version 6/15/2010
* Simple Queue Service (SQS) -- version 1/1/2008

All code in this package is licensed under the MIT License.

When possible, the library uses the REST versions of AWS APIs, rather than SOAP.  Also, unfortunately, the library
is still using older versions of some Amazon services, and are in need of update to newer versions of Amazon APIs.

To access AWS, you must have an AWS account.  The library uses the *credentials* variable to locate an object which 
can supply credentials when needed to perform AWS calls.  The object in *credentials* can be any object that implements
generic methods #'access-key-id and #'secret-key, each of which take a single argument.  Each function is expected
to return the appropriate value required by AWS.  By default, the library uses an internal implementation which
assumes the AWS access key id is in a text file located at ~/.aws/access-key-id and the secret key is in a text
file located at ~/.aws/secret-key.

The library exports #:*credentials, #:access-key-id, and #:secret-key, so you are free to add your own implementation
for providing credentials when needed.

To test that your installation is working, place your credentials in the files mentioned above,  load package :hh-aws-tests, 
and then run:

(lisp-unit:run-all-tests :hh-aws-tests)

Note that timing errors or temporary conditions can sometimes make these tests fail.  If it appears Amazon has
reported service unavailable on one or more calls, just run the tests again, as they will likely then succeed.

Contact for any questions, comments, feedback, or contributions, and keep an eye on for info and news about this library.

Something went wrong with that request. Please try again.