Metadata-Version: 2.1
Name: aws-sso-magic
Version: 1.0.14
Summary: Magic credentials on the AWS CLI home using AWS SSO login
Home-page: https://github.com/javiortizmol/aws-sso-magic
License: Apache-2.0
Author: Javier Ortiz
Author-email: jahor2@gmail.com
Requires-Python: >=3.6,<4.0
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
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 :: Utilities
Requires-Dist: aws-error-utils (>=1.0.4,<2.0.0)
Requires-Dist: aws-sso-lib (>=1.7.0,<2.0.0)
Requires-Dist: boto3 (>=1.17.20,<2.0.0)
Requires-Dist: click (>=7.1.2,<8.0.0)
Requires-Dist: jsonschema (>=3.2.0,<4.0.0)
Requires-Dist: prettytable (>=2.1.0,<3.0.0)
Requires-Dist: python-dateutil (>=2.8.1,<3.0.0)
Requires-Dist: pyyaml (>=5.3.1,<6.0.0)
Project-URL: Repository, https://github.com/javiortizmol/aws-sso-magic
Description-Content-Type: text/markdown

#
# aws-sso-magic tool cli 

This Docker image updates the aws credentials file for the default profile from the aws sso login. At the moment you should copy/paste the url in your browser and complete the login process.

This Docker solution mixed the following repositories:

1. [aws-sso-util](https://github.com/benkehoe/aws-sso-util) AWS SSO has some rough edges, and aws-sso-util is here to smooth them out, hopefully temporarily until AWS makes it better.
2. [aws-sso-credentials](https://github.com/NeilJed/aws-sso-credentials) A simple Python tool to simplify getting short-term credential tokens for CLI/Boto3 operations when using AWS SSO.

## Content of the repository

- [src](src) - The main folder with the aws_sso_magic folder with the .py files & the requirements.txt.
    - [aws_sso_magic](src/aws_sso_magic)
- [docker-build.sh](cli/docker-build.sh) - A docker build tool (Linux/MacOS) to build the docker image locally.
    ```bash
    sudo ./docker-build.sh
    ```     
- [pyproject.toml](pyproject.toml) - The metadata file with the dependencies and application information.    
- [Dockerfile](Dockerfile) - The docker file with the instructions to build the aws-sso-magic cli.

#
# Installing aws-sso-magic tool from [pyp.org](https://pypi.org/project/aws-sso-magic/)

## Prerequisites
1. [Python 3.9](https://www.python.org/downloads/) installed.
2. [AWS CLI v2](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html) installed, please click on the link depending of your OS.

## Installation Steps
1. `pip install aws-sso-magic`

## How to use

1. Execute the following command to configure the sso tool: `aws-sso-magic configure`
2. Type the sso url, sso_region, and the rest of information.
3. Execute the following command to log: `aws-sso-magic login`
4. Select the profile to use.

## How to use with pyp installer

1. Follow the pyp [aw-sso-magic](https://pypi.org/project/aws-sso-magic/) project instructions.

    NOTE: You will need the aws cli v2 installed previously.


## Prerequisites
1. [Python 3.9](https://www.python.org/downloads/) installed.
2. [AWS CLI v2](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html) installed, please click on the link depending of your OS.

## Installation Steps
1. `pip install aws-sso-magic`

#
# How to use with Docker

1. Please follow the instructions from the docker hub repository of [aws_sso_magic](https://hub.docker.com/r/javiortizmol/aws_sso_magic)

## Docker Hub
- [All Repositories](https://hub.docker.com/u/javiortizmol)
- [aws_sso_magic](https://hub.docker.com/r/javiortizmol/aws_sso_magic)

