# AWS SDK for Elixir
[![Build Status](https://travis-ci.org/jkakar/aws-elixir.svg?branch=master)](https://travis-ci.org/jkakar/aws-elixir)
## Features
* Generated using the same JSON descriptions of AWS services used to build
the [AWS SDK for Go](https://github.com/awslabs/aws-sdk-go/tree/master/apis).
* Supports AWS services that use `json` and `rest-json` protocols.
## Example
Listing Amazon Kinesis streams
```elixir
iex> client = %AWS.Client{access_key_id: "<access-key-id>",
secret_access_key: "<secret-access-key>",
region: "us-east-1",
endpoint: "amazonaws.com"}
iex> {:ok, result, resp} = AWS.Kinesis.list_streams(client, %{})
iex> IO.inspect result
%{"HasMoreStreams" => false, "StreamNames" => []}
```
## Usage
* Add it as a Mix dependency in the project.
```elixir
def deps do
[{:aws, "~> 0.0.7"}]
end
```
* Run `mix deps.get` to install.
## Development
Code is generated using the [aws-codegen](https://github.com/jkakar/aws-codegen) library, from the JSON descriptions of AWS services provided by Amazon.
## Documentation
* Run `MIX_ENV=docs mix docs`
* Open `docs/index.html`
## Tests
```
mix test
```
## Release
* Make sure the `CHANGELOG.md` is up-to-date and and reflects the changes for
the new version.
* Bump the version here in the `README.md` and in `mix.exs`.
* Run `git tag $VERSION` to tag the version that was just published.
* Run `git push --tags origin master` to push tags to Github.
* Run `mix hex.publish` to publish the new version.
* Run `mix hex.docs` to publish the documentation.
## License
© 2015-2016 Jamshed Kakar <jkakar@kakar.ca>. See `LICENSE` file for details.