https://github.com/adroll/goamz

Fork of the GOAMZ version developed within Canonical with additional functionality with DynamoDB
https://github.com/adroll/goamz

Last synced: 7 days ago
JSON representation

Fork of the GOAMZ version developed within Canonical with additional functionality with DynamoDB

• Host: GitHub
• URL: https://github.com/adroll/goamz
• Owner: AdRoll
• License: other
• Created: 2013-04-01T19:36:11.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2023-07-14T10:05:14.000Z (over 1 year ago)
• Last Synced: 2024-11-06T20:31:58.085Z (14 days ago)
• Language: Go
• Homepage: https://wiki.ubuntu.com/goamz
• Size: 1.85 MB
• Stars: 401
• Watchers: 40
• Forks: 214
• Open Issues: 43
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# GoAMZ

[![Sourcegraph](https://sourcegraph.com/github.com/AdRoll/goamz/-/badge.svg)](https://sourcegraph.com/github.com/AdRoll/goamz?badge)

[![Build Status](https://travis-ci.org/AdRoll/goamz.png?branch=master)](https://travis-ci.org/AdRoll/goamz)

The _goamz_ package enables Go programs to interact with Amazon Web Services.

This is a fork of the version [developed within Canonical](https://wiki.ubuntu.com/goamz) with additional functionality and services from [a number of contributors](https://github.com/AdRoll/goamz/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.

## API documentation

The API documentation is currently available at:

[http://godoc.org/github.com/AdRoll/goamz](http://godoc.org/github.com/AdRoll/goamz)

## How to build and install 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`

## Running tests

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`