Prerequisite

• Python 3.6 or above

• AWS CLI or equivalent AWS supported CLI

Install

Install using pip

$ pip install awsassume

Install using setup script

$ python setup.py install

Usage

usage: awsassume [-h] -a ROLE_ARN -n ROLE_SESSION_NAME [--no-cache]
                 [-r REGION] [-c COMMAND [COMMAND ...]]

Execute AWS CLI commands after assuming role

optional arguments:
  -h, --help            show this help message and exit
  --no-cache            Disable caching of the assumed role response
  -r REGION, --region REGION
                        The region to be associated with the client
  -c COMMAND [COMMAND ...], --command COMMAND [COMMAND ...]
                        The AWS CLI command to execute after assuming role

required arguments:
  -a ROLE_ARN, --role-arn ROLE_ARN
                        The ARN of the role to assume
  -n ROLE_SESSION_NAME, --role-session-name ROLE_SESSION_NAME
                        An identifier for the assumed role session

$ awsassume -a arn:aws:iam::0123456789012:role/assume_role_test -n sessionname --no-cache

$ awsassume -a arn:aws:iam::0123456789012:role/assume_role_test -n sessionname -r ap-southeast-1

$ awsassume -a arn:aws:iam::0123456789012:role/assume_role_test -n sessionname -c aws s3 ls

$ `awsassume -a arn:aws:iam::0123456789012:role/assume_role_test -n sessionname`

Development

Clone the repository

$ git clone https://github.com/zulhilmizainuddin/aws-assume.git

Create and activate virtual environment

$ python -m venv ./venv
$ source ./venv/bin/activate

Install into development environment

$ python setup.py develop

Run unit test with pytest

$ python setup.py test

Run typing checking with mypy

$ mypy awsassume

Publishing to PyPI

Create source and binary distribution

$ python setup.py sdist bdist_wheel

Upload to PyPI

$ twine upload dist/*