The goamz package enables Go programs to interact with Amazon Web Services.
This is a fork of the version developed within Canonical with additional functionality and services from a number of contributors!
The API of AWS is very comprehensive, though, and goamz doesn't even scratch the surface of it. That said, it's fairly well tested, and is the foundation in which further calls can easily be integrated. We'll continue extending the API as necessary - Pull Requests are very welcome!
The following packages are available at the moment:
github.com/AdRoll/goamz/aws
github.com/AdRoll/goamz/cloudwatch
github.com/AdRoll/goamz/dynamodb
github.com/AdRoll/goamz/ec2
github.com/AdRoll/goamz/elb
github.com/AdRoll/goamz/iam
github.com/AdRoll/goamz/kinesis
github.com/AdRoll/goamz/s3
github.com/AdRoll/goamz/sqs
github.com/AdRoll/goamz/sns
github.com/AdRoll/goamz/exp/mturk
github.com/AdRoll/goamz/exp/sdb
github.com/AdRoll/goamz/exp/ses
Packages under exp/
are still in an experimental or unfinished/unpolished state.
The API documentation is currently available at:
http://godoc.org/github.com/AdRoll/goamz
Just use go get
with any of the available packages. For example:
$ go get github.com/AdRoll/goamz/ec2
$ go get github.com/AdRoll/goamz/s3
To run tests, first install gocheck with:
$ go get launchpad.net/gocheck
Then run go test as usual:
$ go test github.com/AdRoll/goamz/...
Note: running all tests with the command go test ./...
will currently fail as tests do not tear down their HTTP listeners.
If you want to run integration tests (costs money), set up the EC2 environment variables as usual, and run:
$ gotest -i