Metadata-Version: 2.1
Name: aws-session
Version: 5.4.0
Summary: A CLI to generate session credentials based on ~/.aws/config profiles and store them as profile in ~/.aws/credentials file
Home-page: https://github.com/qoomon/aws-session
Author: Bengt Brodersen
Author-email: me@qoomon.me
License: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: System :: Systems Administration
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Description-Content-Type: text/markdown
Requires-Dist: botocore (<2,>=1.16.0)

# aws-session

[![PyPI](https://img.shields.io/pypi/v/aws-session)](https://pypi.org/project/aws-session/)

A CLI to generate and store session credentials in `~/.aws/credentials` file, based on `~/.aws/config` profiles

## Usage
```
    get session credentials:

        aws-session get [--profile/-p <profile_name>]

            --profile/-p <profile_name> : select profile ['default']
            --force/-f                  : force new session

        To create MFA user sessions just add `session_mfa_serial` to profile config in ~/.aws/config profiles

        [profile john]
        session_mfa_serial = arn:aws:iam::0123456789:mfa/john

    list session profiles:

        aws-session list

    purge expired session profiles:

        aws-session purge

            --force/-f                  : purge all session profiles

    print help

        aws-session help
```

## Setup dev environment

#### Install Dev Dependencies
```
pip3 install --user -r requirements.txt
pip3 install --user -r requirements-dev.txt
```

## Run
`python3 -m aws_session get`

#### Create Package
`python3 setup.py clean --all sdist bdist_wheel` 

#### Local Install
`pip3 install --force-reinstall --no-deps dist/aws_session-*-py3-none-any.whl`

#### Deploy to PiPy
`twine upload dist/*`


