awscli-mate 0.3.2

AWS CLI improvement.

---

Welcome to awscli_mate Documentation

awscli_mate improves the original AWS CLI.

Make sure you have done:

pip install awscli_mate
pip install boto3
pip install fire

Set AWS Profile as Default

It is very common that you wants to set a profile as the default when using a tools that doesn’t support explicit --profile ... argument. awscli_mate provides a command to do this for you. It will update your .aws/config and .aws/credentials file and set the default profile to the one you specified.

Example:

awscli_mate set_profile_as_default --profile=your_profile

One Click MFA auth

Based on this AWS re:Post How do I use an MFA token to authenticate access to my AWS resources through the AWS CLI?, you have to run aws sts get-session-token ... command to get some token, and manually copy and paste them to either environment variable or .aws/credentials file. This is a bit tedious. awscli_mate provides a one-click command to do this for you. Basically, it will use a base profile to get the token, let’s say it is your_profile, and automatically create / update a new profile called your_profile_mfa in your .aws/config and .aws/credentials file. So you can keep using the your_profile_mfa in your application.

Example:

awscli_mate mfa_auth --profile=your_profile --mfa_code=123456 --hours=12 --overwrite_default=True

Note that this command also automatically set the MFA profile as default profile. If you don’t want to set the your_profile_mfa as default profile automatically, you can just remove the --overwrite_default part.

Use awscli_mate as a Python Library

See example.

Install

awscli_mate is released on PyPI, so all you need is:

$ pip install awscli_mate

To upgrade to latest version:

$ pip install --upgrade awscli_mate