goamz

module
v0.0.0-...-021b8db Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Feb 16, 2017 License: LGPL-3.0

README

goamz - An Amazon Library for Go

Build Status

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/goamz/goamz/autoscaling
github.com/goamz/goamz/aws
github.com/goamz/goamz/cloudformation
github.com/goamz/goamz/cloudfront
github.com/goamz/goamz/cloudwatch
github.com/goamz/goamz/dynamodb
github.com/goamz/goamz/ecs
github.com/goamz/goamz/ec2
github.com/goamz/goamz/elb
github.com/goamz/goamz/iam
github.com/goamz/goamz/rds
github.com/goamz/goamz/route53
github.com/goamz/goamz/s3
github.com/goamz/goamz/sqs
github.com/goamz/goamz/sts

github.com/goamz/goamz/exp/mturk
github.com/goamz/goamz/exp/sdb
github.com/goamz/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/goamz/goamz

How to build and install goamz

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

  • $ go get github.com/goamz/goamz/ec2
  • $ go get github.com/goamz/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/goamz/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

Directories

Path Synopsis
goamz - Go packages to interact with the Amazon Web Services.
goamz - Go packages to interact with the Amazon Web Services.
ec2
ec2test
The ec2test package implements a fake EC2 provider with the capability of inducing errors on any given operation, and retrospectively determining what operations have been carried out.
The ec2test package implements a fake EC2 provider with the capability of inducing errors on any given operation, and retrospectively determining what operations have been carried out.
elb
This package provides types and functions to interact Elastic Load Balancing service
This package provides types and functions to interact Elastic Load Balancing service
elbtest
Package elbtest implements a fake ELB provider with the capability of inducing errors on any given operation, and retrospectively determining what operations have been carried out.
Package elbtest implements a fake ELB provider with the capability of inducing errors on any given operation, and retrospectively determining what operations have been carried out.
exp
mturk
This package is in an experimental state, and does not currently follow conventions and style of the rest of goamz or common Go conventions.
This package is in an experimental state, and does not currently follow conventions and style of the rest of goamz or common Go conventions.
sdb
This package is in an experimental state, and does not currently follow conventions and style of the rest of goamz or common Go conventions.
This package is in an experimental state, and does not currently follow conventions and style of the rest of goamz or common Go conventions.
ses
ses.go
ses.go
sns
This package is in an experimental state, and does not currently follow conventions and style of the rest of goamz or common Go conventions.
This package is in an experimental state, and does not currently follow conventions and style of the rest of goamz or common Go conventions.
iam
The iam package provides types and functions for interaction with the AWS Identity and Access Management (IAM) service.
The iam package provides types and functions for interaction with the AWS Identity and Access Management (IAM) service.
iamtest
Package iamtest implements a fake IAM provider with the capability of inducing errors on any given operation, and retrospectively determining what operations have been carried out.
Package iamtest implements a fake IAM provider with the capability of inducing errors on any given operation, and retrospectively determining what operations have been carried out.
s3
gosqs - Go packages to interact with the Amazon SQS Web Services.
gosqs - Go packages to interact with the Amazon SQS Web Services.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL