{ "info": { "author": "Zulhilmi Mohamed Zainuddin", "author_email": "zulhilmi.zainuddin@outlook.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Environment :: Console", "Intended Audience :: Developers", "Intended Audience :: System Administrators", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3 :: Only" ], "description": "aws-assume\n==========\n\n.. image:: https://travis-ci.org/zulhilmizainuddin/aws-assume.svg?branch=master\n :target: https://travis-ci.org/zulhilmizainuddin/aws-assume\n\n.. image:: https://api.codeclimate.com/v1/badges/cc17f352128d8ce24a9c/maintainability\n :target: https://codeclimate.com/github/zulhilmizainuddin/aws-assume/maintainability\n :alt: Maintainability\n\nExecute AWS CLI commands after assuming role\n\nPrerequisite\n------------\n\n- **Python 3.6 or above**\n- AWS CLI or equivalent AWS supported CLI\n\nInstall\n-------\n\nInstall using pip\n\n::\n\n $ pip install awsassume\n\nInstall using setup script\n\n::\n\n $ python setup.py install\n\nUsage\n-----\n\n::\n\n usage: awsassume [-h] -a ROLE_ARN -n ROLE_SESSION_NAME [--no-cache]\n [-r REGION] [-c COMMAND [COMMAND ...]]\n\n Execute AWS CLI commands after assuming role\n\n optional arguments:\n -h, --help show this help message and exit\n --no-cache Disable caching of the assumed role response\n -r REGION, --region REGION\n The region to be associated with the client\n -c COMMAND [COMMAND ...], --command COMMAND [COMMAND ...]\n The AWS CLI command to execute after assuming role\n\n required arguments:\n -a ROLE_ARN, --role-arn ROLE_ARN\n The ARN of the role to assume\n -n ROLE_SESSION_NAME, --role-session-name ROLE_SESSION_NAME\n An identifier for the assumed role session\n\nCaching\n~~~~~~~\n\nBy default, the assumed role response will be cached to ``~/.awsassume/cache`` and used until it expires.\nThe cache will expire one hour after the assume role request is successful.\n\nIf caching of the assumed role response is undesirable, use the ``--no-cache`` flag to disable caching of the assumed role response.\n\nExample\n^^^^^^^\n\n::\n\n $ awsassume -a arn:aws:iam::0123456789012:role/assume_role_test -n sessionname --no-cache\n\nRegion\n~~~~~~\n\nThe ``-r`` or ``--region`` option can be used to set the ``AWS_DEFAULT_REGION`` environment variable.\n\nExample\n^^^^^^^\n\n::\n\n $ awsassume -a arn:aws:iam::0123456789012:role/assume_role_test -n sessionname -r ap-southeast-1\n\nCommand\n~~~~~~~\n\nThe ``-c`` or ``--command`` option can be used to pass the AWS CLI that is to be executed after successfully assuming role.\nThe command will be executed with the following environment variables set to the credentials returned by the assumed role response.\n\n- ``AWS_ACCESS_KEY_ID``\n- ``AWS_SECRET_ACCESS_KEY``\n- ``AWS_SESSION_TOKEN``\n- ``AWS_DEFAULT_REGION`` (only if the ``-r`` or ``--region`` option is set)\n\nExample\n^^^^^^^\n\n::\n\n $ awsassume -a arn:aws:iam::0123456789012:role/assume_role_test -n sessionname -c aws s3 ls\n\nIf the ``-c`` or ``--command`` option is omitted, the output of the program can be evaluated to export the following environment variables to the current shell.\n\n- ``AWS_ACCESS_KEY_ID``\n- ``AWS_SECRET_ACCESS_KEY`` \n- ``AWS_SESSION_TOKEN``\n- ``AWS_DEFAULT_REGION`` (only if the ``-r`` or ``--region`` option is set)\n\nExample\n^^^^^^^\n\n::\n\n $ `awsassume -a arn:aws:iam::0123456789012:role/assume_role_test -n sessionname`\n\nDevelopment\n-----------\n\nClone the repository\n\n::\n\n $ git clone https://github.com/zulhilmizainuddin/aws-assume.git\n\nCreate and activate virtual environment\n\n::\n\n $ python -m venv ./venv\n $ source ./venv/bin/activate\n\nInstall into development environment\n\n::\n\n $ python setup.py develop\n\nRun unit test with pytest\n\n::\n\n $ python setup.py test\n\nRun typing checking with mypy\n\n::\n\n $ mypy awsassume\n\nPublishing to PyPI\n------------------\n\nCreate source and binary distribution\n\n::\n\n $ python setup.py sdist bdist_wheel\n\nUpload to PyPI\n\n::\n\n $ twine upload dist/*\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/zulhilmizainuddin/aws-assume", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "awsassume", "package_url": "https://pypi.org/project/awsassume/", "platform": "", "project_url": "https://pypi.org/project/awsassume/", "project_urls": { "Homepage": "https://github.com/zulhilmizainuddin/aws-assume" }, "release_url": "https://pypi.org/project/awsassume/0.1.1/", "requires_dist": [ "boto3 (>=1.6.16)", "botocore (>=1.9.16)", "python-dateutil (<2.7.0,>=2.1)" ], "requires_python": ">=3.6", "summary": "Execute AWS CLI commands after assuming role", "version": "0.1.1" }, "last_serial": 3727689, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "c2440f958cb21f21a0e6481514b6b4c1", "sha256": "e4382a93e26e5200543ba7b2016079bd2bc81a25f68f7f4d5104de980fb0c184" }, "downloads": -1, "filename": "awsassume-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "c2440f958cb21f21a0e6481514b6b4c1", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6", "size": 12568, "upload_time": "2018-03-29T16:54:32", "url": "https://files.pythonhosted.org/packages/cd/8f/8053de9373850c81c84c230d6e63dd00958bc49045ce3c8b55a9f50511f5/awsassume-0.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "965696274ced80ca9f21dc96deb6b129", "sha256": "330d7e5c97365f544432b70b900cb6268f3d041f679b85c54c2db128a8d5b412" }, "downloads": -1, "filename": "awsassume-0.1.0.tar.gz", "has_sig": false, "md5_digest": "965696274ced80ca9f21dc96deb6b129", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 6194, "upload_time": "2018-03-29T16:54:33", "url": "https://files.pythonhosted.org/packages/72/f2/9f211677356ea6b55f3d63b7ce2e6c33213309de2f4dc7455871f8db520a/awsassume-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "1617d4a7ebc0448bb6f11f949e67bc62", "sha256": "f8c342c955382f374826413610206140fe00b87c050d8f99b8cc730257076968" }, "downloads": -1, "filename": "awsassume-0.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "1617d4a7ebc0448bb6f11f949e67bc62", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6", "size": 12677, "upload_time": "2018-03-30T01:49:38", "url": "https://files.pythonhosted.org/packages/fd/83/642b6c19498ff4fa7d25afc7caa0b91f2c2e3396881b48277c89faff8b6d/awsassume-0.1.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "0e7dc320b31aba7bac29512272a67bd6", "sha256": "c1e1dacfd9e9e7de745d3b12bf41a9ceb70bfce6b3c9f879d7c44ca045cfcf23" }, "downloads": -1, "filename": "awsassume-0.1.1.tar.gz", "has_sig": false, "md5_digest": "0e7dc320b31aba7bac29512272a67bd6", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 6316, "upload_time": "2018-03-30T01:49:39", "url": "https://files.pythonhosted.org/packages/c2/cb/4cbc3e674877d2b204b8f05241da8d83a57679f3cbedfe8439e2e6ee2dc4/awsassume-0.1.1.tar.gz" } ], "0.2.0a0": [ { "comment_text": "", "digests": { "md5": "ff99d76c54b7f3bd2fa33f75159ad6d2", "sha256": "1956b373616d6e1229cdfcd949ba1bc9bec2a9535bc663fa34ca5df2a1967e9b" }, "downloads": -1, "filename": "awsassume-0.2.0a0-py3-none-any.whl", "has_sig": false, "md5_digest": "ff99d76c54b7f3bd2fa33f75159ad6d2", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6", "size": 12725, "upload_time": "2018-04-02T21:18:11", "url": "https://files.pythonhosted.org/packages/eb/c1/611de0ca313e1e31ece8c7b23e25c99e002d137a521c669648f474152f9b/awsassume-0.2.0a0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "bb420e8dfd8ded2ec51a04f2d124dcd9", "sha256": "ffb5939c4a8a4bf6d528839e36da43212a11f322928712da6ef6b1b86b0ee700" }, "downloads": -1, "filename": "awsassume-0.2.0a0.tar.gz", "has_sig": false, "md5_digest": "bb420e8dfd8ded2ec51a04f2d124dcd9", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 6344, "upload_time": "2018-04-02T21:18:12", "url": "https://files.pythonhosted.org/packages/e3/f2/388f13a5c43d4929646ba26d4602720b196fc4b61749efa06770a6e2f618/awsassume-0.2.0a0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "1617d4a7ebc0448bb6f11f949e67bc62", "sha256": "f8c342c955382f374826413610206140fe00b87c050d8f99b8cc730257076968" }, "downloads": -1, "filename": "awsassume-0.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "1617d4a7ebc0448bb6f11f949e67bc62", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6", "size": 12677, "upload_time": "2018-03-30T01:49:38", "url": "https://files.pythonhosted.org/packages/fd/83/642b6c19498ff4fa7d25afc7caa0b91f2c2e3396881b48277c89faff8b6d/awsassume-0.1.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "0e7dc320b31aba7bac29512272a67bd6", "sha256": "c1e1dacfd9e9e7de745d3b12bf41a9ceb70bfce6b3c9f879d7c44ca045cfcf23" }, "downloads": -1, "filename": "awsassume-0.1.1.tar.gz", "has_sig": false, "md5_digest": "0e7dc320b31aba7bac29512272a67bd6", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 6316, "upload_time": "2018-03-30T01:49:39", "url": "https://files.pythonhosted.org/packages/c2/cb/4cbc3e674877d2b204b8f05241da8d83a57679f3cbedfe8439e2e6ee2dc4/awsassume-0.1.1.tar.gz" } ] }