boto3-refresh-session 1.3.16__py3-none-any.whl → 1.3.18__py3-none-any.whl

boto3_refresh_session/__init__.py

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

boto3_refresh_session/custom.py

@@ -5,7 +5,7 @@ __all__ = ["CustomRefreshableSession"]
 from typing import Any, Callable
 
 from .exceptions import BRSError
-from .session import BaseRefreshableSession
+from .session import BaseRefreshableSession, TemporaryCredentials
 
 
 class CustomRefreshableSession(BaseRefreshableSession, method="custom"):
@@ -80,8 +80,8 @@ class CustomRefreshableSession(BaseRefreshableSession, method="custom"):
             refresh_method="custom",
         )
 
-    def _get_credentials(self) -> dict[str, str]:
-        credentials = self._custom_get_credentials(
+    def _get_credentials(self) -> TemporaryCredentials:
+        credentials: TemporaryCredentials = self._custom_get_credentials(
             **self._custom_get_credentials_args
         )
         required_keys = {"access_key", "secret_key", "token", "expiry_time"}

boto3_refresh_session/ecs.py

@@ -7,7 +7,7 @@ import os
 import requests
 
 from .exceptions import BRSError
-from .session import BaseRefreshableSession
+from .session import BaseRefreshableSession, TemporaryCredentials
 
 _ECS_CREDENTIALS_RELATIVE_URI = "AWS_CONTAINER_CREDENTIALS_RELATIVE_URI"
 _ECS_CREDENTIALS_FULL_URI = "AWS_CONTAINER_CREDENTIALS_FULL_URI"
@@ -71,7 +71,7 @@ class ECSRefreshableSession(BaseRefreshableSession, method="ecs"):
         session.headers.update(self._headers)
         return session
 
-    def _get_credentials(self) -> dict[str, str]:
+    def _get_credentials(self) -> TemporaryCredentials:
         try:
             response = self._http.get(self._endpoint, timeout=3)
             response.raise_for_status()

boto3_refresh_session/session.py

@@ -3,7 +3,8 @@ from __future__ import annotations
 __all__ = ["RefreshableSession"]
 
 from abc import ABC, abstractmethod
-from typing import Any, Callable, ClassVar, Literal, get_args
+from datetime import datetime
+from typing import Any, Callable, ClassVar, Literal, TypedDict, get_args
 
 from boto3.session import Session
 from botocore.credentials import (
@@ -18,6 +19,15 @@ Method = Literal["sts", "ecs", "custom"]
 RefreshMethod = Literal["sts-assume-role", "ecs-container-metadata", "custom"]
 
 
+class TemporaryCredentials(TypedDict):
+    """Temporary IAM credentials."""
+
+    access_key: str
+    secret_key: str
+    token: str
+    expiry_time: datetime | str
+
+
 class BaseRefreshableSession(ABC, Session):
     """Abstract base class for implementing refreshable AWS sessions.
 
@@ -54,7 +64,7 @@ class BaseRefreshableSession(ABC, Session):
         super().__init__(**kwargs)
 
     @abstractmethod
-    def _get_credentials(self) -> dict[str, str]: ...
+    def _get_credentials(self) -> TemporaryCredentials: ...
 
     @abstractmethod
     def get_identity(self) -> dict[str, Any]: ...

boto3_refresh_session/sts.py

@@ -5,7 +5,7 @@ __all__ = ["STSRefreshableSession"]
 from typing import Any
 
 from .exceptions import BRSWarning
-from .session import BaseRefreshableSession
+from .session import BaseRefreshableSession, TemporaryCredentials
 
 
 class STSRefreshableSession(BaseRefreshableSession, method="sts"):
@@ -66,7 +66,7 @@ class STSRefreshableSession(BaseRefreshableSession, method="sts"):
             refresh_method="sts-assume-role",
         )
 
-    def _get_credentials(self) -> dict[str, str]:
+    def _get_credentials(self) -> TemporaryCredentials:
         temporary_credentials = self._sts_client.assume_role(
             **self.assume_role_kwargs
         )["Credentials"]

{boto3_refresh_session-1.3.16.dist-info → boto3_refresh_session-1.3.18.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: boto3-refresh-session
-Version: 1.3.16
+Version: 1.3.18
 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
@@ -57,11 +57,11 @@ Description-Content-Type: text/markdown
   </a>
 
   <a href="https://pypistats.org/packages/boto3-refresh-session">
-    <img src="https://img.shields.io/badge/downloads-67.6K-red?logo=python&color=%23FF0000&label=Downloads%20%28with%20mirrors%29" alt="Downloads with mirrors"/>
+    <img src="https://img.shields.io/badge/downloads-72.1K-red?logo=python&color=%23FF0000&label=Downloads%20%28with%20mirrors%29" alt="Downloads with mirrors"/>
   </a>
 
   <a href="https://pypistats.org/packages/boto3-refresh-session">
-    <img src="https://img.shields.io/badge/downloads-17.3K-red?logo=python&color=%23FF0000&label=Downloads%20%28without%20mirrors%29" alt="Downloads without mirrors"/>
+    <img src="https://img.shields.io/badge/downloads-18.1K-red?logo=python&color=%23FF0000&label=Downloads%20%28without%20mirrors%29" alt="Downloads without mirrors"/>
   </a>  
 
   <a href="https://michaelthomasletts.github.io/boto3-refresh-session/index.html">
@@ -118,6 +118,8 @@ pip install boto3-refresh-session
 
 ## Usage (STS)
 
+Most users use AWS STS to assume an IAM role and return a set of temporary security credentials. boto3-refresh-session can be used to ensure those temporary credentials refresh automatically.
+
 ```python
 import boto3_refresh_session as brs
 
@@ -152,6 +154,8 @@ session = brs.RefreshableSession(
 
 ## Usage (ECS)
 
+You can use boto3-refresh-session in an ECS container to automatically refresh temporary security credentials.
+
 ```python
 session = RefreshableSession(
   method="ecs", 

boto3_refresh_session-1.3.18.dist-info/RECORD

@@ -0,0 +1,11 @@
+boto3_refresh_session/__init__.py,sha256=W9zruekrLBvjzIyUaIC3ybJRmsQTdfXr7kS5IAwwPNU,364
+boto3_refresh_session/custom.py,sha256=wR7122COYuFkmVprORfz-mPRqH4XeTH8Uw8_2QUYWUg,3845
+boto3_refresh_session/ecs.py,sha256=Php_ETJ-4E99ka93nXwpDa7vS3El7UCxfX0ptb6ofA4,3741
+boto3_refresh_session/exceptions.py,sha256=qcFzdIuK5PZirs77H_Kb64S9QFb6cn2OJtirjvaRLiY,972
+boto3_refresh_session/session.py,sha256=TGI3-Zv52kGigw0f-mUNBkB2nqM632gCRZgY6KhZd-A,5564
+boto3_refresh_session/sts.py,sha256=f9dtJMfs5bYWfZAcKuANAe0InjmNjZfKyqt5LpHFDxk,3202
+boto3_refresh_session-1.3.18.dist-info/LICENSE,sha256=I3ZYTXAjbIly6bm6J-TvFTuuHwTKws4h89QaY5c5HiY,1067
+boto3_refresh_session-1.3.18.dist-info/METADATA,sha256=__Rg3ZoT_HS7GDNaJnZPqKvVAPFjSrOKy2Ehw0lqMOc,8109
+boto3_refresh_session-1.3.18.dist-info/NOTICE,sha256=1s8r33qbl1z0YvPB942iWgvbkP94P_e8AnROr1qXXuw,939
+boto3_refresh_session-1.3.18.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+boto3_refresh_session-1.3.18.dist-info/RECORD,,

boto3_refresh_session-1.3.16.dist-info/RECORD

@@ -1,11 +0,0 @@
-boto3_refresh_session/__init__.py,sha256=zb1pSAs5tu6DDGFJibXDoMxTB0wxFynt2USx0PWKziw,364
-boto3_refresh_session/custom.py,sha256=xW_OiAO1D6-uPj-JWMjXmgNy1BpQxvF7nWavrGZtrqA,3795
-boto3_refresh_session/ecs.py,sha256=2lLMDWEE_JArBf0sRtcFmrzxiIpo_S6dauHS-TDUn4U,3713
-boto3_refresh_session/exceptions.py,sha256=qcFzdIuK5PZirs77H_Kb64S9QFb6cn2OJtirjvaRLiY,972
-boto3_refresh_session/session.py,sha256=wtaLKf2DOnUpt9wJLP_9j2zJEhhFRcUMBNvKBzWY7-Q,5351
-boto3_refresh_session/sts.py,sha256=gJKbslmNl8kR8oAeZfOGmrHtgUUxMm7e9hPgZO678FE,3174
-boto3_refresh_session-1.3.16.dist-info/LICENSE,sha256=I3ZYTXAjbIly6bm6J-TvFTuuHwTKws4h89QaY5c5HiY,1067
-boto3_refresh_session-1.3.16.dist-info/METADATA,sha256=yoKsAPM28pzClq58vh67pLCVhx_D_ewUHwcj9I9w9WE,7804
-boto3_refresh_session-1.3.16.dist-info/NOTICE,sha256=1s8r33qbl1z0YvPB942iWgvbkP94P_e8AnROr1qXXuw,939
-boto3_refresh_session-1.3.16.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-boto3_refresh_session-1.3.16.dist-info/RECORD,,