boto3-refresh-session 2.0.8__py3-none-any.whl → 2.0.10__py3-none-any.whl

boto3_refresh_session/__init__.py

@@ -4,7 +4,7 @@ from .methods.sts import STSRefreshableSession
 from .session import RefreshableSession
 
 __all__ = ["RefreshableSession"]
-__version__ = "2.0.8"
+__version__ = "2.0.10"
 __title__ = "boto3-refresh-session"
 __author__ = "Mike Letts"
 __maintainer__ = "Mike Letts"

boto3_refresh_session/methods/custom.py

@@ -6,7 +6,13 @@ from typing import Any, Callable
 
 from ..exceptions import BRSError, BRSWarning
 from ..session import BaseRefreshableSession
-from ..utils import TemporaryCredentials, refreshable_session
+from ..utils import (
+    CustomCredentialsMethod,
+    CustomCredentialsMethodArgs,
+    Identity,
+    TemporaryCredentials,
+    refreshable_session,
+)
 
 
 @refreshable_session
@@ -18,11 +24,11 @@ class CustomRefreshableSession(BaseRefreshableSession, registry_key="custom"):
 
     Parameters
     ----------
-    custom_credentials_method: Callable
+    custom_credentials_method: CustomCredentialsMethod
         Required. Accepts a callable object that returns temporary AWS
         security credentials. That object must return a dictionary containing
         'access_key', 'secret_key', 'token', and 'expiry_time' when called.
-    custom_credentials_method_args : dict[str, Any], optional
+    custom_credentials_method_args : CustomCredentialsMethodArgs, optional
         Optional keyword arguments for the function passed to the
         ``custom_credentials_method`` parameter.
     defer_refresh : bool, optional
@@ -62,8 +68,10 @@ class CustomRefreshableSession(BaseRefreshableSession, registry_key="custom"):
 
     def __init__(
         self,
-        custom_credentials_method: Callable,
-        custom_credentials_method_args: dict[str, Any] | None = None,
+        custom_credentials_method: CustomCredentialsMethod,
+        custom_credentials_method_args: (
+            CustomCredentialsMethodArgs | None
+        ) = None,
         **kwargs,
     ):
         if "refresh_method" in kwargs:
@@ -75,8 +83,10 @@ class CustomRefreshableSession(BaseRefreshableSession, registry_key="custom"):
 
         # initializing BRSSession
         super().__init__(refresh_method="custom", **kwargs)
-        self._custom_get_credentials = custom_credentials_method
-        self._custom_get_credentials_args = (
+        self._custom_get_credentials: CustomCredentialsMethod = (
+            custom_credentials_method
+        )
+        self._custom_get_credentials_args: CustomCredentialsMethodArgs = (
             custom_credentials_method_args
             if custom_credentials_method_args is not None
             else {}
@@ -97,12 +107,12 @@ class CustomRefreshableSession(BaseRefreshableSession, registry_key="custom"):
 
         return credentials
 
-    def get_identity(self) -> dict[str, str]:
+    def get_identity(self) -> Identity:
         """Returns metadata about the custom credential getter.
 
         Returns
         -------
-        dict[str, str]
+        Identity
             Dict containing information about the custom credential getter.
         """
 

boto3_refresh_session/methods/ecs.py

@@ -8,7 +8,7 @@ import requests
 
 from ..exceptions import BRSError, BRSWarning
 from ..session import BaseRefreshableSession
-from ..utils import TemporaryCredentials, refreshable_session
+from ..utils import Identity, TemporaryCredentials, refreshable_session
 
 _ECS_CREDENTIALS_RELATIVE_URI = "AWS_CONTAINER_CREDENTIALS_RELATIVE_URI"
 _ECS_CREDENTIALS_FULL_URI = "AWS_CONTAINER_CREDENTIALS_FULL_URI"
@@ -101,12 +101,12 @@ class ECSRefreshableSession(BaseRefreshableSession, registry_key="ecs"):
             "expiry_time": credentials.get("Expiration"),  # already ISO8601
         }
 
-    def get_identity(self) -> dict[str, str]:
+    def get_identity(self) -> Identity:
         """Returns metadata about ECS.
 
         Returns
         -------
-        dict[str, str]
+        Identity
             Dict containing metadata about ECS.
         """
 

boto3_refresh_session/methods/iot/certificate.typed

@@ -4,7 +4,7 @@ from pathlib import Path
 from typing import Any
 
 from ...exceptions import BRSError
-from ...utils import PKCS11, TemporaryCredentials, refreshable_session
+from ...utils import Identity, PKCS11, TemporaryCredentials, refreshable_session
 from .core import BaseIoTRefreshableSession
 
 
@@ -52,4 +52,4 @@ class IoTCertificateRefreshableSession(
 
     def _get_credentials(self) -> TemporaryCredentials: ...
 
-    def get_identity(self) -> dict[str, Any]: ...
+    def get_identity(self) -> Identity: ...

boto3_refresh_session/methods/iot/cognito.typed

@@ -2,7 +2,7 @@ __all__ = ["IoTCognitoRefreshableSession"]
 
 from typing import Any
 
-from ...utils import TemporaryCredentials, refreshable_session
+from ...utils import Identity, TemporaryCredentials, refreshable_session
 from .core import BaseIoTRefreshableSession
 
 
@@ -14,4 +14,4 @@ class IoTCognitoRefreshableSession(
 
     def _get_credentials(self) -> TemporaryCredentials: ...
 
-    def get_identity(self) -> dict[str, Any]: ...
+    def get_identity(self) -> Identity: ...

boto3_refresh_session/methods/sts.py

@@ -8,6 +8,7 @@ from ..exceptions import BRSWarning
 from ..session import BaseRefreshableSession
 from ..utils import (
     AssumeRoleParams,
+    Identity,
     STSClientParams,
     TemporaryCredentials,
     refreshable_session,
@@ -85,12 +86,12 @@ class STSRefreshableSession(BaseRefreshableSession, registry_key="sts"):
             "expiry_time": temporary_credentials.get("Expiration").isoformat(),
         }
 
-    def get_identity(self) -> dict[str, Any]:
+    def get_identity(self) -> Identity:
         """Returns metadata about the identity assumed.
 
         Returns
         -------
-        dict[str, Any]
+        Identity
             Dict containing caller identity according to AWS STS.
         """
 

boto3_refresh_session/utils.py

@@ -10,6 +10,9 @@ from typing import (
     Generic,
     List,
     Literal,
+    Mapping,
+    Protocol,
+    TypeAlias,
     TypedDict,
     TypeVar,
     cast,
@@ -52,6 +55,9 @@ RegistryKey = TypeVar("RegistryKey", bound=str)
 #: Type alias for a generic refreshable session type.
 BRSSessionType = TypeVar("BRSSessionType", bound="BRSSession")
 
+#: Type alias for values returned by get_identity
+Identity: TypeAlias = dict[str, Any]
+
 
 def refreshable_session(
     cls: type[BRSSessionType],
@@ -126,6 +132,17 @@ class TemporaryCredentials(TypedDict):
     expiry_time: datetime | str
 
 
+class _CustomCredentialsMethod(Protocol):
+    def __call__(self, **kwargs: Any) -> TemporaryCredentials: ...
+
+
+#: Type alias for custom credential retrieval methods.
+CustomCredentialsMethod: TypeAlias = _CustomCredentialsMethod
+
+#: Type alias for custom credential method arguments.
+CustomCredentialsMethodArgs: TypeAlias = Mapping[str, Any]
+
+
 class RefreshableTemporaryCredentials(TypedDict):
     """Refreshable IAM credentials.
 

{boto3_refresh_session-2.0.8.dist-info → boto3_refresh_session-2.0.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: boto3-refresh-session
-Version: 2.0.8
+Version: 2.0.10
 Summary: A simple Python package for refreshing the temporary security credentials in a boto3.session.Session object automatically.
 License: MIT
 Keywords: boto3,botocore,aws,sts,ecs,credentials,token,refresh

boto3_refresh_session-2.0.10.dist-info/RECORD

@@ -0,0 +1,17 @@
+boto3_refresh_session/__init__.py,sha256=cv1nXmKo_tIuI-y-JFDK7Q20VCtc0pBX-edmEUGCn_8,388
+boto3_refresh_session/exceptions.py,sha256=cP5d9S8QnUEwXIU3pzMGr6jMOz447kddNJ_UIRERMrk,964
+boto3_refresh_session/methods/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+boto3_refresh_session/methods/custom.py,sha256=FBVkcnT0-VPDbgcjl2iMDvl16miRGXFr-fSNs2g4vkI,4211
+boto3_refresh_session/methods/ecs.py,sha256=HN3dJUGeso0q6YC0S8m40jCfkf3l1lSfxKIP7kKADhM,3929
+boto3_refresh_session/methods/iot/__init__.typed,sha256=Z33nIB6oCsz9TZwikHfNHgY1SKxkSCdB5rwdPSUl3C4,135
+boto3_refresh_session/methods/iot/certificate.typed,sha256=dRVP_Rsob9nQmap9GeKZL3I0kM-pc2hzxnep7kBFhqY,1820
+boto3_refresh_session/methods/iot/cognito.typed,sha256=wyBMWUkuhLt27JsKZIwtfylDdCavNexcEy16ZaDFjUY,435
+boto3_refresh_session/methods/iot/core.typed,sha256=tL-ngB2XYq0XtxhS9mbggCJYdX3eEE0u1Gvcq8sEYGE,1422
+boto3_refresh_session/methods/sts.py,sha256=Iv4FlLvn7dc45uAxJp-DkLxg3ZqnngK4XvjbItq44Uo,3403
+boto3_refresh_session/session.py,sha256=_Z3uB5Xq3S-dFqOFmWhMQbcd__NPGThjULLPStHI6E4,2914
+boto3_refresh_session/utils.py,sha256=fhtWLTHmERPx_3F-dDGrLxG37m2AdLRrhHq8R6ImCfc,8064
+boto3_refresh_session-2.0.10.dist-info/LICENSE,sha256=I3ZYTXAjbIly6bm6J-TvFTuuHwTKws4h89QaY5c5HiY,1067
+boto3_refresh_session-2.0.10.dist-info/METADATA,sha256=RXVVp0ZjG2jZE9I7bAZ-IKBJjNPthtl5rzYZTQanQko,8796
+boto3_refresh_session-2.0.10.dist-info/NOTICE,sha256=1s8r33qbl1z0YvPB942iWgvbkP94P_e8AnROr1qXXuw,939
+boto3_refresh_session-2.0.10.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+boto3_refresh_session-2.0.10.dist-info/RECORD,,

boto3_refresh_session-2.0.8.dist-info/RECORD

@@ -1,17 +0,0 @@
-boto3_refresh_session/__init__.py,sha256=HfXKz-omIFHEIEjjPVuwpmkqrAox_HU_IFXeTrVTazU,387
-boto3_refresh_session/exceptions.py,sha256=cP5d9S8QnUEwXIU3pzMGr6jMOz447kddNJ_UIRERMrk,964
-boto3_refresh_session/methods/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-boto3_refresh_session/methods/custom.py,sha256=-KzDFOykdbjXMwGYVJZP8Qbwz8zEbS0R8BtJE8vvfWw,3976
-boto3_refresh_session/methods/ecs.py,sha256=aXQXS7beS2RBXIeQkUNQkM4zhtDQv0n1Mkf9wnFbOTE,3931
-boto3_refresh_session/methods/iot/__init__.typed,sha256=Z33nIB6oCsz9TZwikHfNHgY1SKxkSCdB5rwdPSUl3C4,135
-boto3_refresh_session/methods/iot/certificate.typed,sha256=xBucJJfRb0_iKuhbtRxOWeRERzyJxo7iYW6-0VbmdA0,1816
-boto3_refresh_session/methods/iot/cognito.typed,sha256=OgFYOCDIkt2QC_F0KLL_BrxVxT6qMwjn-0yi4ZIwZYo,431
-boto3_refresh_session/methods/iot/core.typed,sha256=tL-ngB2XYq0XtxhS9mbggCJYdX3eEE0u1Gvcq8sEYGE,1422
-boto3_refresh_session/methods/sts.py,sha256=FvblbuXDaczEfsRIs59eKOodrJjHcMKHrnrmxjXfNeU,3401
-boto3_refresh_session/session.py,sha256=_Z3uB5Xq3S-dFqOFmWhMQbcd__NPGThjULLPStHI6E4,2914
-boto3_refresh_session/utils.py,sha256=SBzqLeCsAWpDJfGNjIvYPZ5cEKClluOzATHgLKxSWMA,7590
-boto3_refresh_session-2.0.8.dist-info/LICENSE,sha256=I3ZYTXAjbIly6bm6J-TvFTuuHwTKws4h89QaY5c5HiY,1067
-boto3_refresh_session-2.0.8.dist-info/METADATA,sha256=MQZkpUhHdFISwB07q_tKXNV6iGlRaWJ-TaX0x4MSrBw,8795
-boto3_refresh_session-2.0.8.dist-info/NOTICE,sha256=1s8r33qbl1z0YvPB942iWgvbkP94P_e8AnROr1qXXuw,939
-boto3_refresh_session-2.0.8.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-boto3_refresh_session-2.0.8.dist-info/RECORD,,