boto3-refresh-session 1.3.19__py3-none-any.whl → 1.3.21__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.19"
+__version__ = "1.3.21"
 __title__ = "boto3-refresh-session"
 __author__ = "Mike Letts"
 __maintainer__ = "Mike Letts"

boto3_refresh_session/ecs.py

@@ -96,8 +96,7 @@ class ECSRefreshableSession(BaseRefreshableSession, method="ecs"):
             "expiry_time": credentials.get("Expiration"),  # already ISO8601
         }
 
-    @staticmethod
-    def get_identity() -> dict[str, str]:
+    def get_identity(self) -> dict[str, str]:
         """Returns metadata about ECS.
 
         Returns

{boto3_refresh_session-1.3.19.dist-info → boto3_refresh_session-1.3.21.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: boto3-refresh-session
-Version: 1.3.19
+Version: 1.3.21
 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
@@ -56,8 +56,8 @@ Description-Content-Type: text/markdown
     <img src="https://img.shields.io/github/stars/michaelthomasletts/boto3-refresh-session?style=flat&logo=github&labelColor=555&color=FF0000&label=Stars" alt="Stars"/>
   </a>
 
-  <a href="https://pypistats.org/packages/boto3-refresh-session">
-    <img src="https://img.shields.io/badge/downloads-73.4K-red?logo=python&color=%23FF0000&label=Downloads" alt="Downloads"/>
+  <a href="https://pepy.tech/projects/boto3-refresh-session">
+    <img src="https://img.shields.io/badge/downloads-76.2K-red?logo=python&color=%23FF0000&label=Downloads" alt="Downloads"/>
   </a>
 
   <a href="https://michaelthomasletts.github.io/boto3-refresh-session/index.html">
@@ -94,7 +94,7 @@ Description-Content-Type: text/markdown
 - [Tested](https://github.com/michaelthomasletts/boto3-refresh-session/tree/main/tests), [documented](https://michaelthomasletts.github.io/boto3-refresh-session/index.html), and [published to PyPI](https://pypi.org/project/boto3-refresh-session/)
 - Future releases will include support for EC2, IoT, SSO, and OIDC
 
-## Recognition, Adoption, and Testimonials
+## Recognition and Testimonials
 
 [Featured in TL;DR Sec.](https://tldrsec.com/p/tldr-sec-282)
 
@@ -112,77 +112,94 @@ A testimonial from a Cyber Security Engineer at a FAANG company:
 pip install boto3-refresh-session
 ```
 
-## Usage (STS)
+## Usage
 
-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. 
+<details>
+  <summary><strong>STS (click to expand)</strong></summary>
 
-```python
-import boto3_refresh_session as brs
+  ### STS
 
-# you can pass all of the params normally associated with boto3.session.Session
-profile_name = "<your-profile-name>"
-region_name = "us-east-1"
-...
+  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. 
 
-# as well as all of the params associated with STS.Client.assume_role
-assume_role_kwargs = {
-  "RoleArn": "<your-role-arn>",
-  "RoleSessionName": "<your-role-session-name>",
-  "DurationSeconds": "<your-selection>",
-  ...
-}
+  ```python
+  import boto3_refresh_session as brs
 
-# as well as all of the params associated with STS.Client, except for 'service_name'
-sts_client_kwargs = {
-  "region_name": region_name,
-  ...
-}
-
-# basic initialization of boto3.session.Session
-session = brs.RefreshableSession(
-  assume_role_kwargs=assume_role_kwargs, # required
-  sts_client_kwargs=sts_client_kwargs,
-  region_name=region_name,
-  profile_name=profile_name,
+  # you can pass all of the params normally associated with boto3.session.Session
+  profile_name = "<your-profile-name>"
+  region_name = "us-east-1"
   ...
-)
-```
 
-## Usage (ECS)
+  # as well as all of the params associated with STS.Client.assume_role
+  assume_role_kwargs = {
+    "RoleArn": "<your-role-arn>",
+    "RoleSessionName": "<your-role-session-name>",
+    "DurationSeconds": "<your-selection>",
+    ...
+  }
 
-You can use boto3-refresh-session in an ECS container to automatically refresh temporary security credentials.
+  # as well as all of the params associated with STS.Client, except for 'service_name'
+  sts_client_kwargs = {
+    "region_name": region_name,
+    ...
+  }
 
-```python
-session = RefreshableSession(
-  method="ecs", 
-  region_name=region_name, 
-  profile_name=profile_name,
-  ...
-)
-```
+  # basic initialization of boto3.session.Session
+  session = brs.RefreshableSession(
+    assume_role_kwargs=assume_role_kwargs, # required
+    sts_client_kwargs=sts_client_kwargs,
+    region_name=region_name,
+    profile_name=profile_name,
+    ...
+  )
+  ```
 
-## Usage (Custom)
+</details>
 
-If you have a highly sophisticated, novel, or idiosyncratic authentication flow not included in boto3-refresh-session then you will need to provide your own custom temporary credentials callable object. `RefreshableSession` accepts custom credentials callable objects, as shown below.
+<details>
+   <summary><strong>ECS (click to expand)</strong></summary>
 
-```python
-# create (or import) your custom credential method
-def your_custom_credential_getter(...):
-    ...
-    return {
-        "access_key": ...,
-        "secret_key": ...,
-        "token": ...,
-        "expiry_time": ...,
-    }
-
-# and pass it to RefreshableSession
-session = RefreshableSession(
-    method="custom",
-    custom_credentials_method=your_custom_credential_getter,
-    custom_credentials_method_args=...,
-    region_name=region_name,
+  ### ECS
+
+  You can use boto3-refresh-session in an ECS container to automatically refresh temporary security credentials.
+
+  ```python
+  session = RefreshableSession(
+    method="ecs", 
+    region_name=region_name, 
     profile_name=profile_name,
     ...
-)
-```
+  )
+  ```
+
+</details>
+
+<details>
+   <summary><strong>Custom authentication flows (click to expand)</strong></summary>
+
+  ### Custom
+
+  If you have a highly sophisticated, novel, or idiosyncratic authentication flow not included in boto3-refresh-session then you will need to provide your own custom temporary credentials callable object. `RefreshableSession` accepts custom credentials callable objects, as shown below.
+
+  ```python
+  # create (or import) your custom credential method
+  def your_custom_credential_getter(...):
+      ...
+      return {
+          "access_key": ...,
+          "secret_key": ...,
+          "token": ...,
+          "expiry_time": ...,
+      }
+
+  # and pass it to RefreshableSession
+  session = RefreshableSession(
+      method="custom",
+      custom_credentials_method=your_custom_credential_getter,
+      custom_credentials_method_args=...,
+      region_name=region_name,
+      profile_name=profile_name,
+      ...
+  )
+  ```
+
+</details>

boto3_refresh_session-1.3.21.dist-info/RECORD

@@ -0,0 +1,11 @@
+boto3_refresh_session/__init__.py,sha256=0o7J4SvkJmqil8uXC1XT9HaYbu_krjnCNO67nbSqln4,364
+boto3_refresh_session/custom.py,sha256=wR7122COYuFkmVprORfz-mPRqH4XeTH8Uw8_2QUYWUg,3845
+boto3_refresh_session/ecs.py,sha256=npuMlooixhB7qXYACsPDRx8A2xhFTrRgcAPFZK1P9i8,3727
+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.21.dist-info/LICENSE,sha256=I3ZYTXAjbIly6bm6J-TvFTuuHwTKws4h89QaY5c5HiY,1067
+boto3_refresh_session-1.3.21.dist-info/METADATA,sha256=eYbmLVd5gpuVgDsZUK_KK6ttgONKepRbiufDgEmJJGs,8201
+boto3_refresh_session-1.3.21.dist-info/NOTICE,sha256=1s8r33qbl1z0YvPB942iWgvbkP94P_e8AnROr1qXXuw,939
+boto3_refresh_session-1.3.21.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+boto3_refresh_session-1.3.21.dist-info/RECORD,,

boto3_refresh_session-1.3.19.dist-info/RECORD

@@ -1,11 +0,0 @@
-boto3_refresh_session/__init__.py,sha256=k8kjkIoiC4p9sts12tV5miDsL2F9ZKNUDj4jYIQDWl0,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.19.dist-info/LICENSE,sha256=I3ZYTXAjbIly6bm6J-TvFTuuHwTKws4h89QaY5c5HiY,1067
-boto3_refresh_session-1.3.19.dist-info/METADATA,sha256=20lIagyN4ZyQn8G-bRXge6z8PqDG1D2EnhRDAQgdfbU,7830
-boto3_refresh_session-1.3.19.dist-info/NOTICE,sha256=1s8r33qbl1z0YvPB942iWgvbkP94P_e8AnROr1qXXuw,939
-boto3_refresh_session-1.3.19.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-boto3_refresh_session-1.3.19.dist-info/RECORD,,