boto3-refresh-session 1.3.3__py3-none-any.whl → 1.3.5__py3-none-any.whl

boto3_refresh_session/__init__.py

@@ -3,5 +3,5 @@ from .session import RefreshableSession
 from .sts import STSRefreshableSession
 
 __all__ = ["RefreshableSession"]
-__version__ = "1.3.3"
+__version__ = "1.3.5"
 __author__ = "Mike Letts"

{boto3_refresh_session-1.3.3.dist-info → boto3_refresh_session-1.3.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: boto3-refresh-session
-Version: 1.3.3
+Version: 1.3.5
 Summary: A simple Python package for refreshing the temporary security credentials in a boto3.session.Session object automatically.
 License: MIT
 Keywords: boto3,botocore,aws
@@ -83,8 +83,10 @@ Description-Content-Type: text/markdown
 - Supports automatic credential refresh methods for various AWS services:
   - STS
   - ECS
-- Supports `assume_role` configuration, custom STS clients, and profile / region configuration, as well as all other parameters supported by `boto3.session.Session`
+- Supports custom authentication methods for complicated authentication flows
+- Natively supports all parameters supported by `boto3.session.Session`
 - Tested, documented, and published to PyPI
+- Future releases will include support for EC2, IoT, SSO, and OIDC
 
 ## Recognition, Adoption, and Testimonials
 
@@ -98,12 +100,6 @@ A testimonial from a Cyber Security Engineer at a FAANG company:
 
 > _Most of my work is on tooling related to AWS security, so I'm pretty choosy about boto3 credentials-adjacent code. I often opt to just write this sort of thing myself so I at least know that I can reason about it. But I found boto3-refresh-session to be very clean and intuitive [...] We're using the RefreshableSession class as part of a client cache construct [...] We're using AWS Lambda to perform lots of operations across several regions in hundreds of accounts, over and over again, all day every day. And it turns out that there's a surprising amount of overhead to creating boto3 clients (mostly deserializing service definition json), so we can run MUCH more efficiently if we keep a cache of clients, all equipped with automatically refreshing sessions._
 
-The following line plot illustrates the adoption of BRS over the last three months in terms of average daily downloads over a rolling seven day window.
-
-<p align="center">
-  <img src="https://raw.githubusercontent.com/michaelthomasletts/boto3-refresh-session/refs/heads/main/doc/downloads.png" />
-</p>
-
 ## Installation
 
 ```bash
@@ -148,31 +144,3 @@ session = brs.RefreshableSession(
 s3 = session.client(service_name='s3')
 buckets = s3.list_buckets()
 ```
-
-## Raison d'être
-
-Long-running data pipelines, security tooling, ETL jobs, and cloud automation scripts frequently interact with the AWS API using boto3 — and often run into the same problem:
-
-**Temporary credentials expire.**
-
-When that happens, engineers typically fall back on one of two strategies:
-
-- Wrapping AWS calls in try/except blocks that catch ClientError exceptions
-- Writing ad hoc logic to refresh credentials using botocore credentials internals
-
-Both approaches are fragile, tedious to maintain, and error-prone at scale.
-
-Over the years, I noticed that every company I worked for — whether a scrappy startup or FAANG — ended up with some variation of the same pattern:  
-a small in-house module to manage credential refresh, written in haste, duplicated across services, and riddled with edge cases. Things only 
-got more strange and difficult when I needed to run things in parallel.
-
-Eventually, I decided to build boto3-refresh-session as a proper open-source Python package:  
-
-- Fully tested  
-- Extensible  
-- Integrated with boto3 idioms  
-- Equipped with automatic documentation and CI tooling  
-
-**The goal:** to solve a real, recurring problem once — cleanly, consistently, and for everyone - with multiple refresh strategies.
-
-If you've ever written the same AWS credential-refresh boilerplate more than once, this library is for you. 

{boto3_refresh_session-1.3.3.dist-info → boto3_refresh_session-1.3.5.dist-info}/RECORD

@@ -1,11 +1,11 @@
-boto3_refresh_session/__init__.py,sha256=IaBcXiBocyXYPqJ6PxNhjkTQJkCGuJGp13k_Tey978I,200
+boto3_refresh_session/__init__.py,sha256=D0r3Nr19lp_qzLeinuCSE-7G9iq2hBj-_hMgLlktRvw,200
 boto3_refresh_session/custom.py,sha256=ZnN94A69Eku9L-kHZ7JJxn_aWbrt6mJDWOIEWrJrIcY,3229
 boto3_refresh_session/ecs.py,sha256=WIC5mlbcEnM1oo-QXmmtiw2mjFDn01hBfcFh67ku42A,3713
 boto3_refresh_session/exceptions.py,sha256=qcFzdIuK5PZirs77H_Kb64S9QFb6cn2OJtirjvaRLiY,972
 boto3_refresh_session/session.py,sha256=ak8lvgoHMObaJgL4c80ih4bptRHS3ASojnaWdbxn5kA,5246
 boto3_refresh_session/sts.py,sha256=paIgbmn9a3cATNX-6AEGxnSGNZnX1pj4rRQmh8gQSKs,3132
-boto3_refresh_session-1.3.3.dist-info/LICENSE,sha256=I3ZYTXAjbIly6bm6J-TvFTuuHwTKws4h89QaY5c5HiY,1067
-boto3_refresh_session-1.3.3.dist-info/METADATA,sha256=QKZotYwzTjQ9gl_3uhqcSYa-HJA9An5T-Dp1JMpXlu0,7898
-boto3_refresh_session-1.3.3.dist-info/NOTICE,sha256=1s8r33qbl1z0YvPB942iWgvbkP94P_e8AnROr1qXXuw,939
-boto3_refresh_session-1.3.3.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-boto3_refresh_session-1.3.3.dist-info/RECORD,,
+boto3_refresh_session-1.3.5.dist-info/LICENSE,sha256=I3ZYTXAjbIly6bm6J-TvFTuuHwTKws4h89QaY5c5HiY,1067
+boto3_refresh_session-1.3.5.dist-info/METADATA,sha256=mJKnoAJ7RJklmP_zOF7g801DkEw1H-7vNWaRpqVnt64,6271
+boto3_refresh_session-1.3.5.dist-info/NOTICE,sha256=1s8r33qbl1z0YvPB942iWgvbkP94P_e8AnROr1qXXuw,939
+boto3_refresh_session-1.3.5.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+boto3_refresh_session-1.3.5.dist-info/RECORD,,