Skip to content

PYTHON-5377 - Update assets to align with GA release of Async PyMongo #2339

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
May 14, 2025
Merged

PYTHON-5377 - Update assets to align with GA release of Async PyMongo #2339

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
e59d83c
PYTHON-5377 - Update assets to align with GA release of Async PyMongo
NoahStapp May 9, 2025
8881c1e
Address review
NoahStapp May 13, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
The PyMongo distribution contains tools for interacting with MongoDB
database from Python. The `bson` package is an implementation of the
[BSON format](http://bsonspec.org) for Python. The `pymongo` package is
a native Python driver for MongoDB. The `gridfs` package is a
a native Python driver for MongoDB, offering both synchronous and asynchronous APIs. The `gridfs` package is a
[gridfs](https://github.com/mongodb/specifications/blob/master/source/gridfs/gridfs-spec.md/)
implementation on top of `pymongo`.

Expand Down
8 changes: 4 additions & 4 deletions doc/faq.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -170,12 +170,12 @@ PyMongo supports CPython 3.9+ and PyPy3.10+. See the :doc:`python3` for details.

Does PyMongo support asynchronous frameworks like Gevent, asyncio, Tornado, or Twisted?
---------------------------------------------------------------------------------------
As of PyMongo v4.13, PyMongo fully supports asyncio. See `the official docs <https://www.mongodb.com/docs/languages/python/pymongo-driver/current/reference/migration/>`_ for more details.

PyMongo fully supports :doc:`Gevent <examples/gevent>`.
PyMongo also fully supports :doc:`Gevent <examples/gevent>`.

To use MongoDB with `asyncio <https://docs.python.org/3/library/asyncio.html>`_
or `Tornado <https://www.tornadoweb.org/>`_, see the
`Motor <https://github.com/mongodb/motor>`_ project.
PyMongo does not support T`ornado <https://www.tornadoweb.org/>`_.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

T`ornado -> Tornado.

But also, pymongo asyncio totally does support Tornado. Tornado is compatible with asyncio.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh nice! I wasn't sure. We don't test against Tornado, but I'm fine with including that Async Pymongo still supports Tornado.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tornado is integrated with the standard library asyncio module and shares the same event loop (by default since Tornado 5.0). In general, libraries designed for use with asyncio can be mixed freely with Tornado.

https://www.tornadoweb.org/en/stable/

`Motor <https://github.com/mongodb/motor>`_ , our older asynchronous driver, does support Tornado, but will be officially deprecated on May 14th, 2026.

For `Twisted <https://twistedmatrix.com/>`_, see `TxMongo
<https://github.com/twisted/txmongo>`_. Its stated mission is to keep feature
Expand Down
2 changes: 1 addition & 1 deletion doc/tools.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -162,7 +162,7 @@ Alternative Drivers
These are alternatives to PyMongo.

* `Motor <https://github.com/mongodb/motor>`_ is a full-featured, non-blocking
MongoDB driver for Python Tornado applications.
MongoDB driver for Python Tornado applications. Motor will be officially deprecated on May 14th, 2026.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could you mention why by saying that motor's features has been merged into pymongo via the new AsyncMongoClient api.

* `TxMongo <https://github.com/twisted/txmongo>`_ is an asynchronous Twisted
Python driver for MongoDB.
* `MongoMock <https://github.com/mongomock/mongomock>`_ is a small
Expand Down
Loading