From 75535388923e6cb68472c6e2859f450973ac047a Mon Sep 17 00:00:00 2001 From: Nate Prewitt Date: Wed, 5 Jun 2024 10:09:02 -0600 Subject: [PATCH 1/3] Add caveat about default session --- docs/source/guide/clients.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/source/guide/clients.rst b/docs/source/guide/clients.rst index 9a4c442391..ca4242f45b 100644 --- a/docs/source/guide/clients.rst +++ b/docs/source/guide/clients.rst @@ -132,6 +132,12 @@ which may interact with boto3’s client. The majority of users will not need to use these interfaces, but those that do should no longer consider their clients thread-safe without careful review. +.. note:: + `boto3.client('')` is an alias for creating a client with a + shared default session. Invoking `boto3.client()` inside of a concurrent + context may result in response ordering issues or interpreter failures + from underlying SSL modules. + General Example ~~~~~~~~~~~~~~~ From f98b978783e68e18a7cdd02642ab092f4a84e2ff Mon Sep 17 00:00:00 2001 From: Nate Prewitt Date: Wed, 5 Jun 2024 13:36:41 -0600 Subject: [PATCH 2/3] Update docs/source/guide/clients.rst Co-authored-by: jonathan343 <43360731+jonathan343@users.noreply.github.com> --- docs/source/guide/clients.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/guide/clients.rst b/docs/source/guide/clients.rst index ca4242f45b..040a167d1b 100644 --- a/docs/source/guide/clients.rst +++ b/docs/source/guide/clients.rst @@ -133,7 +133,7 @@ need to use these interfaces, but those that do should no longer consider their clients thread-safe without careful review. .. note:: - `boto3.client('')` is an alias for creating a client with a + ``boto3.client('')`` is an alias for creating a client with a shared default session. Invoking `boto3.client()` inside of a concurrent context may result in response ordering issues or interpreter failures from underlying SSL modules. From f76cd2a8419b3c0e186cfa557b7017e2ed56034a Mon Sep 17 00:00:00 2001 From: Nate Prewitt Date: Wed, 5 Jun 2024 13:37:03 -0600 Subject: [PATCH 3/3] Update docs/source/guide/clients.rst Co-authored-by: jonathan343 <43360731+jonathan343@users.noreply.github.com> --- docs/source/guide/clients.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/guide/clients.rst b/docs/source/guide/clients.rst index 040a167d1b..52ce0fcc69 100644 --- a/docs/source/guide/clients.rst +++ b/docs/source/guide/clients.rst @@ -134,7 +134,7 @@ consider their clients thread-safe without careful review. .. note:: ``boto3.client('')`` is an alias for creating a client with a - shared default session. Invoking `boto3.client()` inside of a concurrent + shared default session. Invoking ``boto3.client()`` inside of a concurrent context may result in response ordering issues or interpreter failures from underlying SSL modules.