boto3-refresh-session 0.0.20__tar.gz → 0.0.22__tar.gz

{boto3_refresh_session-0.0.20 → boto3_refresh_session-0.0.22}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: boto3-refresh-session
-Version: 0.0.20
+Version: 0.0.22
 Summary: A simple Python package for refreshing boto3 sessions automatically.
 Home-page: https://github.com/michaelthomasletts/boto3-refresh-session
 License: MIT
@@ -74,10 +74,10 @@ credentials. To learn more about how `boto3` searches for credentials on a
 machine, check [this documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html).
 
 ```python
-from boto3_refresh_session import AutoRefreshableSession
+import boto3_refresh_session as brs
 
 
-sess = AutoRefreshableSession(
+sess = brs.AutoRefreshableSession(
     region="<your-region>",
     role_arn="<your-role-arn>",
     session_name="<your-session-name>",

{boto3_refresh_session-0.0.20 → boto3_refresh_session-0.0.22}/README.md

@@ -49,10 +49,10 @@ credentials. To learn more about how `boto3` searches for credentials on a
 machine, check [this documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html).
 
 ```python
-from boto3_refresh_session import AutoRefreshableSession
+import boto3_refresh_session as brs
 
 
-sess = AutoRefreshableSession(
+sess = brs.AutoRefreshableSession(
     region="<your-region>",
     role_arn="<your-role-arn>",
     session_name="<your-session-name>",

{boto3_refresh_session-0.0.20 → boto3_refresh_session-0.0.22}/boto3_refresh_session/session.py

@@ -1,12 +1,12 @@
 from __future__ import annotations
 
 __doc__ = """
-Helper method for generating an automatically refreshing ``boto3.Session``
+Helper method for generating an automatically refreshing :class:`boto3.session.Session`
 object.
 
 .. warning::
     ``AutoRefreshableSession`` was not tested for manually passing hard-coded
-    account credentials to the ``boto3.Session`` or ``boto3.Session.client`` 
+    account credentials to the :class:`boto3.session.Session` or ``boto3.client`` 
     objects! There are optional ``session_kwargs`` and ``client_kwargs``
     parameters available for passing hard-coded account credentials, which
     should work; however, that cannot be guaranteed! In any case, the ``boto3``
@@ -29,14 +29,11 @@ from botocore.session import get_session
 
 @define
 class AutoRefreshableSession:
-    """Returns a ``boto3.Session`` object which refreshes automatically, no extra
+    """Returns a :class:`boto3.session.Session` object which refreshes automatically, no extra
     steps required.
 
     This object is useful for long-running processes where temporary credentials
-    may expire between iterations.
-
-    To use this class, you must have ``~/.aws/config`` or ``~/.aws/credentials``
-    configured on your machine.
+    may expire.
 
     Parameters
     ----------
@@ -49,29 +46,26 @@ class AutoRefreshableSession:
     ttl : int, optional
         Number of seconds until temporary credentials expire, default 900.
     session_kwargs : dict, optional
-        Optional keyword arguments for ``boto3.Session``.
+        Optional keyword arguments for :class:`boto3.session.Session`.
     client_kwargs : dict, optional
-        Optional keyword arguments for ``boto3.Session.client``.
+        Optional keyword arguments for ``boto3.client``.
 
     Attributes
     ----------
     session
-        Returns a ``boto3.Session`` object with credentials which refresh
+        Returns a :class:`boto3.session.Session` object with credentials which refresh
         automatically.
 
     Notes
     -----
-    boto3 employs a variety of methods (in order) to identify credentials:
-
-    https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html
-
-    This class assumes that ``~/.aws`` exists with ``/config`` or ``/credentials``!
+    Check the :ref:`authorization documentation <authorization>` for additional
+    information concerning how to authorize access to AWS.
 
     Examples
     --------
-    Here's how to initialize the ``boto3.Client.S3`` object:
+    Here's how to initialize this object:
 
-    >>> sess = AutoRefreshableSession(
+    >>> sess = brs.AutoRefreshableSession(
     >>>   region="us-east-1",
     >>>   role_arn="<your-arn>",
     >>>   session_name="test",

{boto3_refresh_session-0.0.20 → boto3_refresh_session-0.0.22}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "boto3-refresh-session"
-version = "0.0.20"
+version = "0.0.22"
 description = "A simple Python package for refreshing boto3 sessions automatically."
 authors = [
     {name = "Mike Letts",email = "michaelthomasletts@gmail.com"}