{
    "info": {
        "author": "Sander Knape",
        "author_email": "s.knape88@gmail.com",
        "bugtrack_url": null,
        "classifiers": [],
        "description": "# AWS Assume Role Helper\n[![Build Status](https://travis-ci.org/SanderKnape/assume.svg?branch=master)](https://travis-ci.org/SanderKnape/assume)\n\n`assume` is a simple CLI utility that makes it easier to switch between different AWS roles. This is helpful when you work with different AWS accounts or users. In addition, this utility is helpful when you develop AWS resources locally (such as an application that will run on EC2 or when running a Lambda function locally using [AWS SAM](https://github.com/awslabs/aws-sam-cli)). You can easily switch to a role that your EC2 instance / Lambda function will assume in AWS.\n\nWhat this command actually does is change your AWS credentials file (`~/.aws/credentials`). If there is a `default` role in there, it will be stored in a temporary role. The assumed role is then passed in the `default` role, so you can immediately start using it.\n\n## Table of Contents\n\n* [Prerequisites](#prerequisites)\n* [Installation](#installation)\n* [Usage](#usage)\n* [Alternatives](#alternatives)\n\n## Prerequisites\n\n[Install Python](https://www.python.org/downloads/). Versions 3.5 and 3.6 are supported.\n\n## Installation\n\nUse [pip](https://pypi.org/project/pip/) to install `assume':\n\n```bash\npip install assume\n```\n\nRun the following to show all available commands:\n\n```bash\nassume --help\n```\n\n## Usage\n\nAdd a new role to assume as follows:\n\n```bash\nassume add [rolename] --role-arn [arn] --profile [profile]\n```\n\nSpecifying the profile is optional. When you don't specify this, the default profile is used. The following would `add` a new role \"myrole\" to be assumed:\n\n```bash\nassume add myrole --role-arn arn:aws:iam::012345678912:role/myrole\n```\n\nYou can now `assume` this role as follows:\n\n```bash\nassume switch myrole\n```\n\n`assume` keeps a configuration file in `~/.assume/config.yaml`. You can list the contents of the current configuration with the following file:\n\n```bash\nassume list\n```\n\nWhen you want to switch back to your initial default role, you can `clear` the assumed role as follows:\n\n```bash\nassume clear\n```\n\nTo `remove` a role to be assumed, run the following command:\n\n```bash\nassume remove myrole\n```\n\nThis command grabs the `default` role that was stored in a temporary location when running the `switch` command. These credentials are then put back in the `default` role.\n\n## Alternatives\n\nI'm aware that a number of alternatives already exist with similar functionality. The reason I decided to build my own functionality is because I wasn't be able to find an existing option that combines all of the following features:\n\n* Easy switching using shortcuts\n* Easily remove the temporarry role and switch back to the original one\n\n\n",
        "description_content_type": "text/markdown",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "http://github.com/SanderKnape/assume",
        "keywords": "",
        "license": "MIT",
        "maintainer": "",
        "maintainer_email": "",
        "name": "assume",
        "package_url": "https://pypi.org/project/assume/",
        "platform": "",
        "project_url": "https://pypi.org/project/assume/",
        "project_urls": {
            "Homepage": "http://github.com/SanderKnape/assume"
        },
        "release_url": "https://pypi.org/project/assume/0.2.3/",
        "requires_dist": [
            "pyyaml (~=4.2b1)",
            "boto3 (~=1.5)",
            "flake8 ; extra == 'dev'",
            "pylint ; extra == 'dev'"
        ],
        "requires_python": ">3.5.2",
        "summary": "Helper to easily assume IAM roles in AWS",
        "version": "0.2.3"
    },
    "last_serial": 4825957,
    "releases": {
        "0.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "17c76dd54ef710a634c96f8b0a55969e",
                    "sha256": "564daee16a0e144ec9af352a794bcef07db8bfab8ef07af114bb458dceabade9"
                },
                "downloads": -1,
                "filename": "assume-0.1-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "17c76dd54ef710a634c96f8b0a55969e",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">3.5.2",
                "size": 5100,
                "upload_time": "2018-09-01T17:05:21",
                "url": "https://files.pythonhosted.org/packages/15/60/00a7ae2ad4a79bb36907933ac12432aa08115c81e89a1fb14835fa362792/assume-0.1-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "03fcf09bc8f0e4fa8ce68f0dad375c62",
                    "sha256": "8440365c56251291d498b8490ec4f9be2d93afbc6d7e09c3cd817d10f12d366d"
                },
                "downloads": -1,
                "filename": "assume-0.1.tar.gz",
                "has_sig": false,
                "md5_digest": "03fcf09bc8f0e4fa8ce68f0dad375c62",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">3.5.2",
                "size": 4391,
                "upload_time": "2018-09-01T17:05:22",
                "url": "https://files.pythonhosted.org/packages/fc/6d/0c22d860747290b59a743275a23df8846cb281bbea2a86ae005f3492d68a/assume-0.1.tar.gz"
            }
        ],
        "0.2.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "f4c8cb45902d8c6c890be2c19fc107c1",
                    "sha256": "a4d2007a1bbd1572e229481a490015714995dd5c9bfd56f9232e1e091cf9b6c5"
                },
                "downloads": -1,
                "filename": "assume-0.2.1-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "f4c8cb45902d8c6c890be2c19fc107c1",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">3.5.2",
                "size": 5127,
                "upload_time": "2018-09-01T17:12:21",
                "url": "https://files.pythonhosted.org/packages/9d/e0/8b1f1358e3c506ae5357ae81222d1c4b633291104684123a2ebacad9c091/assume-0.2.1-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "aaab13d44ef8f81ef9c6a17499e6200f",
                    "sha256": "e2859d9b5b14b14d0c7fc8dcb8bfdfdb8b861c0e33493d3f2c9e2eb1837dd9ed"
                },
                "downloads": -1,
                "filename": "assume-0.2.1.tar.gz",
                "has_sig": false,
                "md5_digest": "aaab13d44ef8f81ef9c6a17499e6200f",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">3.5.2",
                "size": 4392,
                "upload_time": "2018-09-01T17:12:22",
                "url": "https://files.pythonhosted.org/packages/72/3a/c5971e1df2f6b793fa635e8c4235d89f2be9b851d07dd66f6574df446e9e/assume-0.2.1.tar.gz"
            }
        ],
        "0.2.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "186f1d23226dd7e23db6132b8a5d27ae",
                    "sha256": "1a224facd1cb95c2c03ae647c832a0d481bb7e0a8be3728776ac2925f072ff25"
                },
                "downloads": -1,
                "filename": "assume-0.2.2-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "186f1d23226dd7e23db6132b8a5d27ae",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">3.5.2",
                "size": 5127,
                "upload_time": "2018-09-02T17:00:50",
                "url": "https://files.pythonhosted.org/packages/0e/d6/c3158efd02fdd2aae9720ed03a9c6f90c7b4cac194a7e82107fbd8dbd012/assume-0.2.2-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "60e52c95d18a45115aec4e9277278fea",
                    "sha256": "489ecea9e248fcd2701daf5f70ce54d4f435702773d085ac144ba80b5ce6000f"
                },
                "downloads": -1,
                "filename": "assume-0.2.2.tar.gz",
                "has_sig": false,
                "md5_digest": "60e52c95d18a45115aec4e9277278fea",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">3.5.2",
                "size": 4386,
                "upload_time": "2018-09-02T17:00:51",
                "url": "https://files.pythonhosted.org/packages/2f/2c/e7521d20d62f85432f0ae1f489836161e0f73524c3a0f14335dc7c43671e/assume-0.2.2.tar.gz"
            }
        ],
        "0.2.3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "35a29f1ed5dd845c5654d1a90a2ae594",
                    "sha256": "b971eff3d2633ddf39d1138c35acec15a23214b6dc723da70c122548e09db9e4"
                },
                "downloads": -1,
                "filename": "assume-0.2.3-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "35a29f1ed5dd845c5654d1a90a2ae594",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": ">3.5.2",
                "size": 5929,
                "upload_time": "2019-02-15T16:28:38",
                "url": "https://files.pythonhosted.org/packages/55/a5/cd292c5530aa40631fd24a937a408a9fb226a3bbbc574917c74e1a62795b/assume-0.2.3-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "eb67467b81e24904a761187a02129a7a",
                    "sha256": "9ddeff49dbe6c08205830e6541fd2bc3a549a49ae37522b50dcf72b1cbc8afea"
                },
                "downloads": -1,
                "filename": "assume-0.2.3.tar.gz",
                "has_sig": false,
                "md5_digest": "eb67467b81e24904a761187a02129a7a",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": ">3.5.2",
                "size": 4386,
                "upload_time": "2019-02-15T16:28:40",
                "url": "https://files.pythonhosted.org/packages/5f/6c/1a4e0e5969c3eac540451bd77c8b42b7f739049efbf5849f18cf5b24a0e2/assume-0.2.3.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "35a29f1ed5dd845c5654d1a90a2ae594",
                "sha256": "b971eff3d2633ddf39d1138c35acec15a23214b6dc723da70c122548e09db9e4"
            },
            "downloads": -1,
            "filename": "assume-0.2.3-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "35a29f1ed5dd845c5654d1a90a2ae594",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">3.5.2",
            "size": 5929,
            "upload_time": "2019-02-15T16:28:38",
            "url": "https://files.pythonhosted.org/packages/55/a5/cd292c5530aa40631fd24a937a408a9fb226a3bbbc574917c74e1a62795b/assume-0.2.3-py3-none-any.whl"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "eb67467b81e24904a761187a02129a7a",
                "sha256": "9ddeff49dbe6c08205830e6541fd2bc3a549a49ae37522b50dcf72b1cbc8afea"
            },
            "downloads": -1,
            "filename": "assume-0.2.3.tar.gz",
            "has_sig": false,
            "md5_digest": "eb67467b81e24904a761187a02129a7a",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">3.5.2",
            "size": 4386,
            "upload_time": "2019-02-15T16:28:40",
            "url": "https://files.pythonhosted.org/packages/5f/6c/1a4e0e5969c3eac540451bd77c8b42b7f739049efbf5849f18cf5b24a0e2/assume-0.2.3.tar.gz"
        }
    ]
}