boto3-refresh-session 0.0.22__py3-none-any.whl → 0.0.23__py3-none-any.whl

boto3_refresh_session/session.py

@@ -23,7 +23,10 @@ from typing import Type
 from attrs import define, field
 from attrs.validators import instance_of, le, optional
 from boto3 import Session
-from botocore.credentials import RefreshableCredentials
+from botocore.credentials import (
+    DeferredRefreshableCredentials,
+    RefreshableCredentials,
+)
 from botocore.session import get_session
 
 
@@ -43,6 +46,10 @@ class AutoRefreshableSession:
         AWS role ARN.
     session_name : str
         Name for session.
+    defer_refresh : bool, optional
+        If ``True`` then temporary credentials are not automatically refreshed until
+        they are explicitly needed. If ``False`` then temporary credentials refresh
+        immediately upon expiration. Default is ``True``.
     ttl : int, optional
         Number of seconds until temporary credentials expire, default 900.
     session_kwargs : dict, optional
@@ -61,6 +68,10 @@ class AutoRefreshableSession:
     Check the :ref:`authorization documentation <authorization>` for additional
     information concerning how to authorize access to AWS.
 
+    The default ``defer_refresh`` parameter value results in temporary credentials not
+    being refreshed until they are explicitly requested; that is more efficient than
+    refreshing expired temporary credentials automatically after they expire.
+
     Examples
     --------
     Here's how to initialize this object:
@@ -76,6 +87,7 @@ class AutoRefreshableSession:
     region: str = field(validator=instance_of(str))
     role_arn: str = field(validator=instance_of(str))
     session_name: str = field(validator=instance_of(str))
+    defer_refresh: bool = field(default=True, validator=instance_of(bool))
     ttl: int = field(
         default=900, validator=optional([instance_of(int), le(900)])
     )
@@ -88,13 +100,19 @@ class AutoRefreshableSession:
     session: Type[Session] = field(init=False)
 
     def __attrs_post_init__(self):
-        __credentials = RefreshableCredentials.create_from_metadata(
-            metadata=self._get_credentials(),
-            refresh_using=self._get_credentials,
-            method="sts-assume-role",
-        )
         __session = get_session()
-        # https://github.com/boto/botocore/blob/f8a1dd0820b548a5e8dc05420b28b6f1c6e21154/botocore/session.py#L143
+
+        if not self.defer_refresh:
+            __credentials = RefreshableCredentials.create_from_metadata(
+                metadata=self._get_credentials(),
+                refresh_using=self._get_credentials,
+                method="sts-assume-role",
+            )
+        else:
+            __credentials = DeferredRefreshableCredentials(
+                refresh_using=self._get_credentials, method="sts-assume-role"
+            )
+
         __session._credentials = __credentials
         self.session = Session(botocore_session=__session)
 

{boto3_refresh_session-0.0.22.dist-info → boto3_refresh_session-0.0.23.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: boto3-refresh-session
-Version: 0.0.22
+Version: 0.0.23
 Summary: A simple Python package for refreshing boto3 sessions automatically.
 Home-page: https://github.com/michaelthomasletts/boto3-refresh-session
 License: MIT

boto3_refresh_session-0.0.23.dist-info/RECORD

@@ -0,0 +1,6 @@
+boto3_refresh_session/__init__.py,sha256=OMY8el4qROyEvo0vr1Kv8rtFU7g3xnjHuBss54XRTEA,135
+boto3_refresh_session/session.py,sha256=W5LAPD_s7oRUDmneqI3rTcB-MRd96RSbIr93QwtVW_s,5235
+boto3_refresh_session-0.0.23.dist-info/LICENSE,sha256=I3ZYTXAjbIly6bm6J-TvFTuuHwTKws4h89QaY5c5HiY,1067
+boto3_refresh_session-0.0.23.dist-info/METADATA,sha256=NS6-RSO485PN4a-Ok1m5A3etch71w8ClfdGwLpk67ak,3990
+boto3_refresh_session-0.0.23.dist-info/WHEEL,sha256=RaoafKOydTQ7I_I3JTrPCg6kUmTgtm4BornzOqyEfJ8,88
+boto3_refresh_session-0.0.23.dist-info/RECORD,,

boto3_refresh_session-0.0.22.dist-info/RECORD

@@ -1,6 +0,0 @@
-boto3_refresh_session/__init__.py,sha256=OMY8el4qROyEvo0vr1Kv8rtFU7g3xnjHuBss54XRTEA,135
-boto3_refresh_session/session.py,sha256=Pyrhgw0rdLbFJ-7Cv1N_58EpUxx4OAoTM6Jn7ser2Zo,4493
-boto3_refresh_session-0.0.22.dist-info/LICENSE,sha256=I3ZYTXAjbIly6bm6J-TvFTuuHwTKws4h89QaY5c5HiY,1067
-boto3_refresh_session-0.0.22.dist-info/METADATA,sha256=-q_1T-SKGD6DpJB1j7kpG8uOjlHhOn1xpXLAxzFaK_g,3990
-boto3_refresh_session-0.0.22.dist-info/WHEEL,sha256=RaoafKOydTQ7I_I3JTrPCg6kUmTgtm4BornzOqyEfJ8,88
-boto3_refresh_session-0.0.22.dist-info/RECORD,,