boto3-refresh-session 1.0.4__py3-none-any.whl → 6.2.5__py3-none-any.whl

boto3_refresh_session-1.0.4.dist-info/METADATA

@@ -1,102 +0,0 @@
-Metadata-Version: 2.3
-Name: boto3-refresh-session
-Version: 1.0.4
-Summary: A simple Python package for refreshing the temporary security credentials in a boto3.session.Session object automatically.
-License: MIT
-Keywords: boto3,botocore,aws
-Author: Mike Letts
-Author-email: lettsmt@gmail.com
-Maintainer: Michael Letts
-Maintainer-email: lettsmt@gmail.com
-Requires-Python: >=3.10
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Requires-Dist: boto3
-Requires-Dist: botocore
-Project-URL: Documentation, https://michaelthomasletts.github.io/boto3-refresh-session/index.html
-Project-URL: Repository, https://github.com/michaelthomasletts/boto3-refresh-session
-Description-Content-Type: text/markdown
-
-# boto3-refresh-session
-[![PyPI Download](https://img.shields.io/pypi/v/boto3-refresh-session?logo=pypis.svg)](https://pypi.org/project/boto3-refresh-session/)
-[![Workflow](https://img.shields.io/github/actions/workflow/status/michaelthomasletts/boto3-refresh-session/push.yml?logo=github)](https://github.com/michaelthomasletts/boto3-refresh-session/actions/workflows/push_pullrequest.yml)
-![Python Version](https://img.shields.io/pypi/pyversions/boto3-refresh-session?style=pypi)
-![GitHub last commit](https://img.shields.io/github/last-commit/michaelthomasletts/boto3-refresh-session?logo=github)
-![PyPI - Downloads](https://img.shields.io/pypi/dm/boto3-refresh-session?logo=pypi)
-
-![BRS Image](https://raw.githubusercontent.com/michaelthomasletts/boto3-refresh-session/refs/heads/main/doc/brs.png)
-
-A simple Python package for refreshing the temporary security credentials in a `boto3.session.Session` object automatically.
-
-- [Documentation](https://michaelthomasletts.github.io/boto3-refresh-session/index.html)
-- [Source Code](https://github.com/michaelthomasletts/boto3-refresh-session)
-- [PyPI](https://pypi.org/project/boto3-refresh-session/)
-- [Contributing](https://michaelthomasletts.github.io/boto3-refresh-session/contributing.html)
-
-### Why should I use this?
-
-It is common for data pipelines and workflows that interact with the AWS API via 
-`boto3` to run for a long time and, accordingly, for temporary credentials to 
-expire. 
-
-Usually, engineers deal with that problem one of two different ways: 
-
-- A `try except` block that catches `botocore.exceptions.ClientError` exceptions
-- A similar approach as that used in this project -- that is, using methods available 
-  within `botocore` for refreshing temporary credentials automatically. 
-  
-Speaking personally, variations of the code found herein exists in code bases at 
-nearly every company where I have worked. Sometimes, I turned that code into a module; 
-other times, I wrote it from scratch. Clearly, that is inefficient.
-
-I decided to finally turn that code into a proper Python package with unit testing, 
-automatic documentation, and quality checks; the idea being that, henceforth, depending 
-on my employer's open source policy, I may simply import this package instead of 
-reproducing the code herein for the Nth time.
-
-If any of that sounds relatable, then `boto3-refresh-session` should help you!
-
-### Usage
-
-Simply pass the basic parameters and initialize the `RefreshableSession` object; 
-that's it! You're good to go!
-
-`RefreshableSession` will refresh
-temporary credentials for you in the background. In the following example,
-continue using the `s3_client` object without worry of using `try` and 
-`except` blocks!
-
-To use this package, your machine must be configured with AWS
-credentials. To learn more about how `boto3` searches for credentials on a
-machine, check [this documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html).
-
-```python
-import boto3_refresh_session as brs
-
-assume_role_kwargs = {
-  'RoleArn': '<your-role-arn>',
-  'RoleSessionName': '<your-role-session-name>',
-  'DurationSeconds': '<your-selection>',
-  ...
-}
-session = brs.RefreshableSession(
-  assume_role_kwargs=assume_role_kwargs
-)
-s3 = session.client(service_name='s3')
-buckets = s3.list_buckets()
-```
-
-### Installation
-
-```bash
-pip install boto3-refresh-session
-```
-
-### Authors
-
-- [Michael Letts](https://michaelthomasletts.github.io/)
-

boto3_refresh_session-1.0.4.dist-info/RECORD

@@ -1,6 +0,0 @@
-boto3_refresh_session/__init__.py,sha256=OFlvwxa3cKjI5tUhRqSBsKy8Svx65CFxQNpg6xlsiqw,149
-boto3_refresh_session/session.py,sha256=rQHJDvOAz0glymYXQBfSt1keFvQAM_G8AQXgMDLZq2U,5349
-boto3_refresh_session-1.0.4.dist-info/LICENSE,sha256=I3ZYTXAjbIly6bm6J-TvFTuuHwTKws4h89QaY5c5HiY,1067
-boto3_refresh_session-1.0.4.dist-info/METADATA,sha256=16Y5Ua36XnllNclnwHXqcFmGMT8_hTeL8EVIUuv1ln8,4395
-boto3_refresh_session-1.0.4.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
-boto3_refresh_session-1.0.4.dist-info/RECORD,,