DataDog/goamz

Name: goamz

Owner: Datadog, Inc.

Description: Amazon AWS Library for Go

Created: 2015-09-18 20:17:13.0

Updated: 2015-09-18 20:17:14.0

Pushed: 2015-09-18 21:04:41.0

Homepage:

Size: 1171

Language: Go

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

goamz - An Amazon Library for Go

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:

ub.com/DataDog/goamz/autoscaling
ub.com/DataDog/goamz/aws
ub.com/DataDog/goamz/cloudformation
ub.com/DataDog/goamz/cloudfront
ub.com/DataDog/goamz/cloudwatch
ub.com/DataDog/goamz/dynamodb
ub.com/DataDog/goamz/ecs
ub.com/DataDog/goamz/ec2
ub.com/DataDog/goamz/elb
ub.com/DataDog/goamz/iam
ub.com/DataDog/goamz/rds
ub.com/DataDog/goamz/route53
ub.com/DataDog/goamz/s3
ub.com/DataDog/goamz/sqs
ub.com/DataDog/goamz/sts

ub.com/DataDog/goamz/exp/mturk
ub.com/DataDog/goamz/exp/sdb
ub.com/DataDog/goamz/exp/sns

Packages under exp/ are still in an experimental or unfinished/unpolished state.

API documentation

The API documentation is currently available at:

http://godoc.org/github.com/DataDog/goamz

How to build and install goamz

Just use go get with any of the available packages. For example:

• $ go get github.com/DataDog/goamz/ec2
• $ go get github.com/DataDog/goamz/s3

Running tests

To run tests, first install gocheck with:

$ go get gopkg.in/check.v1

Then run go test as usual:

$ go test github.com/DataDog/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