/aws-elixir

AWS clients for Elixir

Primary LanguageElixirOtherNOASSERTION

AWS clients for Elixir

Build Status

Features

  • Generated by aws-codegen using the same JSON descriptions of AWS services used to build the AWS SDK for Go.
  • Support for most AWS services that use json and rest-json protocols.

Example

Listing Amazon Kinesis streams. Start a console with iex -S mix:

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.

    def deps do
      [{:aws, "~> 0.5.0"}]
    end
  • Run mix deps.get to install.

Development

Code is generated using the aws-codegen library from the JSON descriptions of AWS services provided by Amazon.

Documentation

  • Run MIX_ENV=docs mix docs
  • Open docs/index.html

note: Arguments, errors and reponse structure can be found by viewing the model schemas used to generate this module at aws-sdk-go/models/apis/<aws-service>/<version>/ an example is aws-sdk-go/models/apis/rekognition/2016-06-27/api-2.json

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 v$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.

License

© 2015-2017 Jamshed Kakar jkakar@kakar.ca. See LICENSE file for details.