boto3_refresh_session.session

This module provides the main interface for constructing refreshable boto3 sessions.

The RefreshableSession class serves as a factory that dynamically selects the appropriate credential refresh strategy based on the method parameter, e.g., sts.

Users can interact with AWS services just like they would with a normal boto3.session.Session, with the added benefit of automatic credential refreshing.

Examples

>>> from boto3_refresh_session import RefreshableSession
>>> session = RefreshableSession(
...     assume_role_kwargs={"RoleArn": "...", "RoleSessionName": "..."},
...     region_name="us-east-1"
... )
>>> s3 = session.client("s3")
>>> s3.list_buckets()

See also

boto3_refresh_session.methods.custom.CustomRefreshableSession boto3_refresh_session.methods.ecs.ECSRefreshableSession boto3_refresh_session.methods.sts.STSRefreshableSession

Factory interface

RefreshableSession

Factory class for constructing refreshable boto3 sessions using various authentication methods, e.g. STS.