Python AWS SDK boto3 library enhancement
Project description
Welcome to boto_session_manager Documentation
Feature
Boto Client Enum
Provide an Enum class to access the aws service name to create boto client.
from boto_session_manager import BotoSesManager, AwsServiceEnum
bsm = BotoSesManager()
s3_client = bsm.get_client(AwsServiceEnum.S3)
Cached Client
Once an boto session is defined, each AWS Service client should be created only once in most of the case. boto_session_manager.BotoSesManager.get_client(service_name) allow you to fetch the client object from cache if possible.
from boto_session_manager import BotoSesManager, AwsServiceEnum
bsm = BotoSesManager()
s3_client1 = bsm.get_client(AwsServiceEnum.S3)
s3_client2 = bsm.get_client(AwsServiceEnum.S3)
assert id(s3_client1) = id(s3_client2)
Assume Role
Create another boto session manager based on an assumed IAM role. Allow you to check if it is expired and maybe renew later.
bsm_assumed = bsm.assume_role("arn:aws:iam::669508176277:role/sanhe-assume-role-for-iam-test")
sts_client = bsm_assumed.get_client(AwsServiceEnum.sts)
print(sts_client.get_caller_identity())
print(bsm_assumed.is_expired())
AWS CLI context manager
Suppose you have a boto session manager defined in python, sometime you want to run aws cli from Python using subprocess library. You can use boto_session_manager.BotoSesManager.awscli() context manager to setup temp credential for AWS CLI.
import subprocess
bsm = BotoSesManager(...)
with bsm.awscli():
subprocess.run(["aws", "sts", "get-caller-identity"])
Install
boto_session_manager is released on PyPI, so all you need is:
$ pip install boto_session_manager
To upgrade to latest version:
$ pip install --upgrade boto_session_manager
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for boto_session_manager-1.2.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | bf666700bd9c5f762fb9fe82b4955cb83b1fe473ede64931a73598ace672660d |
|
MD5 | 93e5471c678b3a17c902623c7c2070d4 |
|
BLAKE2b-256 | 73eef2ce2f03b00e091e9126b7f5edc9908aee517451ba1549ef5e0b89951a52 |
Hashes for boto_session_manager-1.2.1-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | dd312efda7cb3749045f6c4013c13a09ff89a72c47a41f1b3347b85490e30e30 |
|
MD5 | aeb81cb86a49b98482b16fd8be3b6788 |
|
BLAKE2b-256 | eed3595ad6094ae0453455f49cc2bd59199ec2b77315d22d0a2c1f40184845b9 |