From b00d37cd4ab3146a4a1d7e6252d6e5e256356632 Mon Sep 17 00:00:00 2001 From: Noah Stapp Date: Wed, 14 May 2025 13:28:41 -0400 Subject: [PATCH 1/3] Update changelog for v4.13 release --- doc/changelog.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/changelog.rst b/doc/changelog.rst index 9b0275dbd8..232fc0b4ab 100644 --- a/doc/changelog.rst +++ b/doc/changelog.rst @@ -6,6 +6,7 @@ Changes in Version 4.13.0 (2025/05/14) PyMongo 4.13 brings a number of changes including: +- The asynchronous API is now stable and no longer in beta. - Fixed a bug where :class:`pymongo.write_concern.WriteConcern` repr was not eval-able when using ``w="majority"``. From ec0c4e54d9aa2ab7e97536b33ca365e2dab1caa6 Mon Sep 17 00:00:00 2001 From: Noah Stapp Date: Wed, 14 May 2025 13:42:34 -0400 Subject: [PATCH 2/3] Remove beta warnings --- doc/api/gridfs/asynchronous/index.rst | 4 ---- doc/api/pymongo/asynchronous/change_stream.rst | 4 ---- doc/api/pymongo/asynchronous/client_session.rst | 4 ---- doc/api/pymongo/asynchronous/collection.rst | 4 ---- doc/api/pymongo/asynchronous/command_cursor.rst | 4 ---- doc/api/pymongo/asynchronous/cursor.rst | 4 ---- doc/api/pymongo/asynchronous/database.rst | 4 ---- doc/api/pymongo/asynchronous/index.rst | 4 ---- doc/api/pymongo/asynchronous/mongo_client.rst | 4 ---- doc/async-tutorial.rst | 4 ---- doc/changelog.rst | 2 ++ pymongo/asynchronous/mongo_client.py | 2 -- 12 files changed, 2 insertions(+), 42 deletions(-) diff --git a/doc/api/gridfs/asynchronous/index.rst b/doc/api/gridfs/asynchronous/index.rst index 0904d10f98..7b6ebb28b8 100644 --- a/doc/api/gridfs/asynchronous/index.rst +++ b/doc/api/gridfs/asynchronous/index.rst @@ -1,10 +1,6 @@ :mod:`gridfs async` -- Async tools for working with GridFS ========================================================== -.. warning:: This API is currently in beta, meaning the classes, methods, - and behaviors described within may change before the full release. - If you come across any bugs during your use of this API, - please file a Jira ticket in the "Python Driver" project at https://jira.mongodb.org/browse/PYTHON. .. automodule:: gridfs.asynchronous :synopsis: Async tools for working with GridFS diff --git a/doc/api/pymongo/asynchronous/change_stream.rst b/doc/api/pymongo/asynchronous/change_stream.rst index df4f5dee41..1b506fdb55 100644 --- a/doc/api/pymongo/asynchronous/change_stream.rst +++ b/doc/api/pymongo/asynchronous/change_stream.rst @@ -1,10 +1,6 @@ :mod:`change_stream` -- Watch changes on a collection, database, or cluster =========================================================================== -.. warning:: This API is currently in beta, meaning the classes, methods, - and behaviors described within may change before the full release. - If you come across any bugs during your use of this API, - please file a Jira ticket in the "Python Driver" project at https://jira.mongodb.org/browse/PYTHON. .. automodule:: pymongo.asynchronous.change_stream :members: diff --git a/doc/api/pymongo/asynchronous/client_session.rst b/doc/api/pymongo/asynchronous/client_session.rst index c4bbd8edd2..d8403325d7 100644 --- a/doc/api/pymongo/asynchronous/client_session.rst +++ b/doc/api/pymongo/asynchronous/client_session.rst @@ -1,10 +1,6 @@ :mod:`client_session` -- Logical sessions for sequential operations =================================================================== -.. warning:: This API is currently in beta, meaning the classes, methods, - and behaviors described within may change before the full release. - If you come across any bugs during your use of this API, - please file a Jira ticket in the "Python Driver" project at https://jira.mongodb.org/browse/PYTHON. .. automodule:: pymongo.asynchronous.client_session :members: diff --git a/doc/api/pymongo/asynchronous/collection.rst b/doc/api/pymongo/asynchronous/collection.rst index ce1fe3ca04..779295ced1 100644 --- a/doc/api/pymongo/asynchronous/collection.rst +++ b/doc/api/pymongo/asynchronous/collection.rst @@ -1,10 +1,6 @@ :mod:`collection` -- Collection level operations ================================================ -.. warning:: This API is currently in beta, meaning the classes, methods, - and behaviors described within may change before the full release. - If you come across any bugs during your use of this API, - please file a Jira ticket in the "Python Driver" project at https://jira.mongodb.org/browse/PYTHON. .. automodule:: pymongo.asynchronous.collection :synopsis: Collection level operations diff --git a/doc/api/pymongo/asynchronous/command_cursor.rst b/doc/api/pymongo/asynchronous/command_cursor.rst index 7058563eee..1f94c6e525 100644 --- a/doc/api/pymongo/asynchronous/command_cursor.rst +++ b/doc/api/pymongo/asynchronous/command_cursor.rst @@ -1,10 +1,6 @@ :mod:`command_cursor` -- Tools for iterating over MongoDB command results ========================================================================= -.. warning:: This API is currently in beta, meaning the classes, methods, - and behaviors described within may change before the full release. - If you come across any bugs during your use of this API, - please file a Jira ticket in the "Python Driver" project at https://jira.mongodb.org/browse/PYTHON. .. automodule:: pymongo.asynchronous.command_cursor :synopsis: Tools for iterating over MongoDB command results diff --git a/doc/api/pymongo/asynchronous/cursor.rst b/doc/api/pymongo/asynchronous/cursor.rst index d357b84514..f511734de4 100644 --- a/doc/api/pymongo/asynchronous/cursor.rst +++ b/doc/api/pymongo/asynchronous/cursor.rst @@ -1,10 +1,6 @@ :mod:`cursor` -- Tools for iterating over MongoDB query results =============================================================== -.. warning:: This API is currently in beta, meaning the classes, methods, - and behaviors described within may change before the full release. - If you come across any bugs during your use of this API, - please file a Jira ticket in the "Python Driver" project at https://jira.mongodb.org/browse/PYTHON. .. automodule:: pymongo.asynchronous.cursor :synopsis: Tools for iterating over MongoDB query results diff --git a/doc/api/pymongo/asynchronous/database.rst b/doc/api/pymongo/asynchronous/database.rst index b45fe457e7..7b043ab0d1 100644 --- a/doc/api/pymongo/asynchronous/database.rst +++ b/doc/api/pymongo/asynchronous/database.rst @@ -1,10 +1,6 @@ :mod:`database` -- Database level operations ============================================ -.. warning:: This API is currently in beta, meaning the classes, methods, - and behaviors described within may change before the full release. - If you come across any bugs during your use of this API, - please file a Jira ticket in the "Python Driver" project at https://jira.mongodb.org/browse/PYTHON. .. automodule:: pymongo.asynchronous.database :synopsis: Database level operations diff --git a/doc/api/pymongo/asynchronous/index.rst b/doc/api/pymongo/asynchronous/index.rst index 1b41fb8222..b7fc985415 100644 --- a/doc/api/pymongo/asynchronous/index.rst +++ b/doc/api/pymongo/asynchronous/index.rst @@ -1,10 +1,6 @@ :mod:`pymongo async` -- Async Python driver for MongoDB ======================================================= -.. warning:: This API is currently in beta, meaning the classes, methods, - and behaviors described within may change before the full release. - If you come across any bugs during your use of this API, - please file a Jira ticket in the "Python Driver" project at https://jira.mongodb.org/browse/PYTHON. .. automodule:: pymongo.asynchronous :synopsis: Asynchronous Python driver for MongoDB diff --git a/doc/api/pymongo/asynchronous/mongo_client.rst b/doc/api/pymongo/asynchronous/mongo_client.rst index d0729da78b..899ca687d5 100644 --- a/doc/api/pymongo/asynchronous/mongo_client.rst +++ b/doc/api/pymongo/asynchronous/mongo_client.rst @@ -1,10 +1,6 @@ :mod:`mongo_client` -- Tools for connecting to MongoDB ====================================================== -.. warning:: This API is currently in beta, meaning the classes, methods, - and behaviors described within may change before the full release. - If you come across any bugs during your use of this API, - please file a Jira ticket in the "Python Driver" project at https://jira.mongodb.org/browse/PYTHON. .. automodule:: pymongo.asynchronous.mongo_client :synopsis: Tools for connecting to MongoDB diff --git a/doc/async-tutorial.rst b/doc/async-tutorial.rst index 1884631ec3..b3e33e4b5c 100644 --- a/doc/async-tutorial.rst +++ b/doc/async-tutorial.rst @@ -1,10 +1,6 @@ Async Tutorial ============== -.. warning:: This API is currently in beta, meaning the classes, methods, - and behaviors described within may change before the full release. - If you come across any bugs during your use of this API, - please file a Jira ticket in the "Python Driver" project at https://jira.mongodb.org/browse/PYTHON. .. code-block:: pycon diff --git a/doc/changelog.rst b/doc/changelog.rst index 232fc0b4ab..129ce29682 100644 --- a/doc/changelog.rst +++ b/doc/changelog.rst @@ -7,6 +7,8 @@ Changes in Version 4.13.0 (2025/05/14) PyMongo 4.13 brings a number of changes including: - The asynchronous API is now stable and no longer in beta. + See the `API docs `_ + or `migration guide `_ for more information. - Fixed a bug where :class:`pymongo.write_concern.WriteConcern` repr was not eval-able when using ``w="majority"``. diff --git a/pymongo/asynchronous/mongo_client.py b/pymongo/asynchronous/mongo_client.py index a236b21348..72755263c9 100644 --- a/pymongo/asynchronous/mongo_client.py +++ b/pymongo/asynchronous/mongo_client.py @@ -194,8 +194,6 @@ def __init__( For more details, see the relevant section of the PyMongo 4.x migration guide: :ref:`pymongo4-migration-direct-connection`. - .. warning:: This API is currently in beta, meaning the classes, methods, and behaviors described within may change before the full release. - The client object is thread-safe and has connection-pooling built in. If an operation fails because of a network error, :class:`~pymongo.errors.ConnectionFailure` is raised and the client From 67b506a9bf3f85f34215982b55bfcbdb3a96c7c1 Mon Sep 17 00:00:00 2001 From: Noah Stapp Date: Wed, 14 May 2025 13:50:48 -0400 Subject: [PATCH 3/3] Fix async API link --- doc/changelog.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/changelog.rst b/doc/changelog.rst index 129ce29682..80d1c4e2f0 100644 --- a/doc/changelog.rst +++ b/doc/changelog.rst @@ -7,8 +7,8 @@ Changes in Version 4.13.0 (2025/05/14) PyMongo 4.13 brings a number of changes including: - The asynchronous API is now stable and no longer in beta. - See the `API docs `_ - or `migration guide `_ for more information. + See the :mod:`pymongo.asynchronous` docs + or the `migration guide `_ for more information. - Fixed a bug where :class:`pymongo.write_concern.WriteConcern` repr was not eval-able when using ``w="majority"``.