boto3-refresh-session 1.3.19__tar.gz → 1.3.20__tar.gz

{boto3_refresh_session-1.3.19 → boto3_refresh_session-1.3.20}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: boto3-refresh-session
-Version: 1.3.19
+Version: 1.3.20
 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.19 → boto3_refresh_session-1.3.20}/README.md

@@ -32,8 +32,8 @@
     <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">
@@ -70,7 +70,7 @@
 - [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)
 
@@ -88,77 +88,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.19 → boto3_refresh_session-1.3.20}/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.20"
 __title__ = "boto3-refresh-session"
 __author__ = "Mike Letts"
 __maintainer__ = "Mike Letts"

{boto3_refresh_session-1.3.19 → boto3_refresh_session-1.3.20}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "boto3-refresh-session"
-version = "1.3.19"
+version = "1.3.20"
 description = "A simple Python package for refreshing the temporary security credentials in a boto3.session.Session object automatically."
 authors = [
     {name = "Mike Letts",email = "lettsmt@gmail.com"}