Metadata-Version: 1.1
Name: envassume
Version: 1.0.5
Summary: Assume an AWS IAM role from AWS API credentials in environment variables
Home-page: https://github.com/wamonite/envassume
Author: Warren Moore
Author-email: warren@wamonite.com
License: MIT
Description: envassume
        =========
        
        .. image:: https://img.shields.io/pypi/v/envassume.svg
            :target: https://pypi.python.org/pypi/envassume
        
        .. image:: https://img.shields.io/pypi/pyversions/envassume.svg
            :target: https://pypi.python.org/pypi/envassume
        
        .. image:: https://img.shields.io/pypi/l/envassume.svg
            :target: https://pypi.python.org/pypi/envassume
        
        .. image:: https://travis-ci.org/wamonite/envassume.svg?branch=master
            :target: https://travis-ci.org/wamonite/envassume
        
        .. image:: https://codecov.io/gh/wamonite/envassume/branch/master/graph/badge.svg
            :target: https://codecov.io/gh/wamonite/envassume
        
        Assume an AWS IAM role from AWS API credentials in environment variables and execute a command with the assumed credentials (similar to envdir_).
        
        .. _envdir: https://cr.yp.to/daemontools/envdir.html
        
        `envassume` takes the effort out of assuming an AWS role from the command-line and copying/pasting the returned credentials into environment variables to run a script. If you often need to do this:-
        
        ::
        
            $ aws sts assume-role --role-arn arn:aws:iam::123456789012:role/s3_access --role-session-name s3_access_session
            {
                "AssumedRoleUser": {
                    "AssumedRoleId": "xxxxxxxxxxxxxxxxxxxxx:s3_access_session",
                    "Arn": "arn:aws:sts::123456789012:assumed-role/s3_access/s3_access_session"
                },
                "Credentials": {
                    "SecretAccessKey": "mmm",
                    "SessionToken": "nnn",
                    "Expiration": "2019-02-26T00:00:00Z",
                    "AccessKeyId": "ooo"
                }
            }
            $ AWS_ACCESS_KEY_ID='ooo' AWS_SECRET_ACCESS_KEY='mmm' AWS_SESSION_TOKEN='nnn' aws s3 ls
        
        It can be shortened to:-
        
        ::
        
            $ envassume arn:aws:iam::123456789012:role/s3_access aws s3 ls
        
        Useful if you often need to test roles, or run scripts with assumed roles on AWS instances using credentials from the instance profile.
        
        Install
        -------
        
        ::
        
            pip install envassume
        
        Usage
        -----
        
        ::
        
            usage: envassume [-h] [-i EXTERNAL_ID] [ARN] command [argument [argument ...]]
        
            optional arguments:
                -h, --help              show this help message and exit
                -i, --id EXTERNAL_ID    external id
                ARN                     AWS role ARN to assume (required if not set by environment variable)
        
            environment variables:
                environment must contain valid AWS API credentials
        
                AWS_ASSUME_ROLE=ARN
                    no options can be present before the command if this is defined
        
                AWS_ASSUME_ID=EXTERNAL_ID
        
        License
        -------
        
        Copyright (c) 2017 Warren Moore
        
        This software may be redistributed under the terms of the MIT License.
        See the file LICENSE for details.
        
        Contact
        -------
        
        ::
        
                  @wamonite     - twitter
                   \_______.com - web
            warren____________/ - email
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Utilities
