Metadata-Version: 1.0
Name: awscurl
Version: 0.14
Summary: Curl like tool with AWS request signing
Home-page: http://github.com/okigan/awscurl
Author: Igor Okulist
Author-email: okigan@gmail.com
License: MIT
Description: # awscurl [![Build Status](https://travis-ci.org/okigan/awscurl.svg?branch=master)](https://travis-ci.org/okigan/awscurl)
        
        Curl like tool with AWS Signature Version 4 request signing.
        
        
        ## Overview
        Requests to AWS API must be signed (see [Signing AWS API Requests](http://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html))
        automates the process of signing and allows to make requests to AWS as simple as standard curl command.
        
        
        ## Installation
          ```sh
          $ pip install awscurl
          ```
          
        #### Installation from source (bleeding edge)
          ```sh
          $ pip install git+https://github.com/okigan/awscurl
          ```
        
        #### Installation via Docker
        Assumes Docker is installed and the working directory is project root of the cloned repo.  Result will be an image named `$USER/awscurl`.  
        
          ```sh
          $ docker build --rm -t $USER/awscurl .
          ```
        
        On OS X run via a shell script in your $PATH or directly with something like the following:
        
          ```sh
        #!/bin/bash
        
        export AWS_DIR="${AWS_DIR:-$HOME/.aws}"
        mkdir -p $AWS_DIR
        
        docker run --rm -it -v "$AWS_DIR:/root/.aws" "$USER/awscurl:latest" "$@"
          ```
        
        ## Examples
        * Call S3:
         List bucket content
          ```sh
          $ awscurl --service s3 https://awscurl-sample-bucket.s3.amazonaws.com
          ```
        
        * Call EC2:
          ```sh
          $ awscurl --service ec2 'https://ec2.amazonaws.com?Action=DescribeRegions&Version=2013-10-15'
          ```
        
        * Call API Gateway:
          ```sh
          $ awscurl --service execute-api -X POST -d @request.json \
            https://<prefix>.execute-api.us-east-1.amazonaws.com/<resource>
          ```
        
        ## Options
        ```
        usage: awscurl [-h] [-v] [-X REQUEST] [-d DATA] [-H HEADER]
                          [--region REGION] [--service SERVICE]
                          [--profile AWS_PROFILE]
                          [--access_key ACCESS_KEY] [--secret_key SECRET_KEY]
                          [--security_token SECURITY_TOKEN]
                          uri
        
        Curl AWS request signing If an arg is specified in more than one place, then
        command-line values override environment variables which override defaults.
        
        positional arguments:
          uri
        
        optional arguments:
          -h, --help            show this help message and exit
          -v, --verbose         verbose flag (default: False)
          -X REQUEST, --request REQUEST
                                Specify request command to use (default: GET)
          -d DATA, --data DATA  HTTP POST data (default: )
          -H HEADER, --header HEADER
                                HTTP POST data (default: None)
          --region REGION       AWS region (default: us-east-1)
          --profile PROFILE     [env var: AWS_PROFILE] (default: default)
          --service SERVICE     AWS service (default: execute-api)
          --access_key ACCESS_KEY
                                [env var: AWS_ACCESS_KEY_ID] (default: None)
          --secret_key SECRET_KEY
                                [env var: AWS_SECRET_ACCESS_KEY] (default: None)
          --security_token SECURITY_TOKEN
                                [env var: AWS_SECURITY_TOKEN] (default: None)
        
        ```
        
        If you do not specify the `--access_key` or `--secret_key`
        (or environment variables), `awscurl` will attempt to use
        the credentials you set in `~/.aws/credentials`. If you
        do not specify a `--profile` or `AWS_PROFILE`, `awscurl`
        uses `default`.
        
        
Platform: UNKNOWN
