Release notes
*Sourced from [motor's releases](https://github.com/mongodb/motor/releases).*
> ## 2.1.0
> Motor 2.1 adds support for MongoDB 4.2 features. It depends on PyMongo 3.10 or
> later. Motor continues to support MongoDB 3.0 and later. Motor 2.1 also adds
> support for Python 3.8.
>
> Motor now offers experimental support for Windows when it is using the asyncio
> event loop. This means it supports Windows exclusively with Python 3, either
> integrating with asyncio directly or with Tornado 5 or later: starting in
> version 5, Tornado uses the asyncio event loop on Python 3 by default.
>
> For more info see the changelog: https://motor.readthedocs.io/en/2.1.0/changelog.html
Changelog
*Sourced from [motor's changelog](https://github.com/mongodb/motor/blob/master/doc/changelog.rst).*
> Changelog
> =========
>
> Motor 2.1
> ---------
>
> Motor 2.1 adds support for MongoDB 4.2 features. It depends on PyMongo 3.10 or later. Motor continues to support MongoDB 3.0 and later. Motor 2.1 also adds support for Python 3.8.
>
> Motor now offers experimental support for Windows when it is using the asyncio event loop. This means it supports Windows exclusively with Python 3, either integrating with asyncio directly or with Tornado 5 or later: starting in version 5, Tornado uses the asyncio event loop on Python 3 by default.
>
> Additional changes:
>
> - Support for MongoDB 4.2 sharded transactions. Sharded transactions have the same API as replica set transactions.
> - New method \~motor.motor\_asyncio.AsyncIOMotorClientSession.with\_transaction to support conveniently running a transaction in a session with automatic retries and at-most-once semantics.
> - Added the `max_commit_time_ms` parameter to \~motor.motor\_asyncio.AsyncIOMotorClientSession.start\_transaction.
> - The `retryWrites` URI option now defaults to `True`. Supported write operations that fail with a retryable error will automatically be retried one time, with at-most-once semantics.
> - Support for retryable reads and the `retryReads` URI option which is enabled by default. See the \~pymongo.mongo\_client.MongoClient documentation for details. Now that supported operations are retried automatically and transparently, users should consider adjusting any custom retry logic to prevent an application from inadvertently retrying for too long.
> - Support zstandard for wire protocol compression.
> - Support for periodically polling DNS SRV records to update the mongos proxy list without having to change client configuration.
> - New method motor.motor\_asyncio.AsyncIOMotorDatabase.aggregate to support running database level aggregations.
> - Change stream enhancements for MongoDB 4.2:
> - Resume tokens can now be accessed from a `AsyncIOMotorChangeStream` cursor using the \~motor.motor\_asyncio.AsyncIOMotorChangeStream.resume\_token attribute.
> - New `AsyncIOMotorChangeStream` method \~motor.motor\_asyncio.AsyncIOMotorChangeStream.try\_next and attribute \~motor.motor\_asyncio.AsyncIOMotorChangeStream.alive.
> - New parameter `start_after` for change stream motor.motor\_asyncio.AsyncIOMotorCollection.watch, motor.motor\_asyncio.AsyncIOMotorDatabase.watch, and motor.motor\_asyncio.AsyncIOMotorClient.watch methods.
> - New parameters `bucket_name`, `chunk_size_bytes`, `write_concern`, and `read_preference` for motor.motor\_asyncio.AsyncIOMotorGridFSBucket.
>
> ### Issues Resolved
>
> See the [Motor 2.1 release notes in JIRA](https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=11182&version=20187) for the complete list of resolved issues in this release.
>
> Motor 2.0
> ---------
>
> Motor 2.0 drops support for MongoDB 2.6 and adds supports MongoDB 4.0 features, including multi-document transactions, and change stream notifications on entire databases or entire MongoDB servers. It adds support for Python 3.7. This version of Motor requires PyMongo 3.7 or later.
>
> This is a major release that removes previously deprecated APIs.
>
> To support multi-document transactions, Motor had to make breaking changes to the session API and release a major version bump. Since this is a major release it also deletes many helper methods and APIs that had been deprecated over the time since Motor 1.0, most notably the old CRUD methods `insert`, `update`, `remove`, and `save`, and the original callback-based API. Read the migrate-to-motor-2 carefully to upgrade your existing Motor application.
>
> Documentation is updated to warn about obsolete TLS versions, see configuration. Motor is now tested on Travis in addition to MongoDB's [Evergreen](https://github.com/evergreen-ci/evergreen) system.
>
> Added support for [aiohttp](https://aiohttp.readthedocs.io/) 3.0 and later, and dropped older aiohttp versions. The aiohttp integration now requires Python 3.5+.
>
> The `MotorDatabase.add_user` and `MotorDatabase.remove_user` methods are deleted. Manage user accounts with four database commands: [createUser](https://docs.mongodb.com/manual/reference/command/createUser/), [usersInfo](https://docs.mongodb.com/manual/reference/command/usersInfo/), [updateUser](https://docs.mongodb.com/manual/reference/command/updateUser/), and [dropUser](https://docs.mongodb.com/manual/reference/command/createUser/). You can run any database command with the MotorDatabase.command method.
>
> The deprecated GridFS classes `MotorGridFS` and `AsyncIOMotorGridFS` are deleted in favor of \~motor.motor\_tornado.MotorGridFSBucket and \~motor.motor\_asyncio.AsyncIOMotorGridFSBucket, which conform to driver specs for GridFS.
>
> Additional changes:
>
> - New methods for retrieving batches of raw BSON:
> ... (truncated)
Commits
- [`0690c83`](https://github.com/mongodb/motor/commit/0690c83326231123d2405ec982fd2978c04a8c0c) BUMP 2.1.0
- [`174b822`](https://github.com/mongodb/motor/commit/174b8227e5152c9df6b3876a40e7900286c40ee3) Update changelog for 2.1 release
- [`393b6b2`](https://github.com/mongodb/motor/commit/393b6b2dedcee59548f6a94dc68f2e22463b6945) MOTOR-478 Do not build universal wheels
- [`167e6a2`](https://github.com/mongodb/motor/commit/167e6a2497fe259d8bf9530cc7ad9e8da6f9fcac) MOTOR-444 Update minimum version to PyMongo 3.10
- [`47e7498`](https://github.com/mongodb/motor/commit/47e7498e7c6a073df1cb7b06f3fb0d549ee75ae5) MOTOR-472 Add PyPI classifier for PyPy implementation
- [`e797e6d`](https://github.com/mongodb/motor/commit/e797e6dcd76622c425b07ef6a16c383fb692dab6) MOTOR-471 Document support for Python 3.8
- [`bec8fb4`](https://github.com/mongodb/motor/commit/bec8fb47e9d7dcf7a6507cfbabb7f1bfa9ca55e6) MOTOR-458 Run Travis with Python 3.7 and 3.8 ([#57](https://github-redirect.dependabot.com/mongodb/motor/issues/57))
- [`1a4fe95`](https://github.com/mongodb/motor/commit/1a4fe95b5e301a9bb026bda13e0e218e10df18cb) MOTOR-461 Test Python 3.8 in Evergreen
- [`0db1890`](https://github.com/mongodb/motor/commit/0db189012877050d4033993ece030586a219ccf5) MOTOR-460 Fix TypeError when accessing __dict__ on GridFS classes
- [`ec8b33f`](https://github.com/mongodb/motor/commit/ec8b33ffe7bf97e933e0491a759aa4fe8230fc9f) MOTOR-467 Do not call set_exception on a done Future
- Additional commits viewable in [compare view](https://github.com/mongodb/motor/compare/2.0.0...2.1.0)
Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.
Dependabot commands and options
You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits that have been made to it
- `@dependabot merge` will merge this PR after your CI passes on it
- `@dependabot squash and merge` will squash and merge this PR after your CI passes on it
- `@dependabot cancel merge` will cancel a previously requested merge and block automerging
- `@dependabot reopen` will reopen this PR if it is closed
- `@dependabot close` will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
- `@dependabot ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
- `@dependabot ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
- `@dependabot ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)
- `@dependabot use these labels` will set the current labels as the default for future PRs for this repo and language
- `@dependabot use these reviewers` will set the current reviewers as the default for future PRs for this repo and language
- `@dependabot use these assignees` will set the current assignees as the default for future PRs for this repo and language
- `@dependabot use this milestone` will set the current milestone as the default for future PRs for this repo and language
- `@dependabot badge me` will comment on this PR with code to add a "Dependabot enabled" badge to your readme
Additionally, you can set the following in your Dependabot [dashboard](https://app.dependabot.com):
- Update frequency (including time of day and day of week)
- Pull request limits (per update run and/or open at any time)
- Out-of-range updates (receive only lockfile updates, if desired)
- Security updates (receive only security updates, if desired)
Bumps motor from 2.0.0 to 2.1.0.
Release notes
*Sourced from [motor's releases](https://github.com/mongodb/motor/releases).* > ## 2.1.0 > Motor 2.1 adds support for MongoDB 4.2 features. It depends on PyMongo 3.10 or > later. Motor continues to support MongoDB 3.0 and later. Motor 2.1 also adds > support for Python 3.8. > > Motor now offers experimental support for Windows when it is using the asyncio > event loop. This means it supports Windows exclusively with Python 3, either > integrating with asyncio directly or with Tornado 5 or later: starting in > version 5, Tornado uses the asyncio event loop on Python 3 by default. > > For more info see the changelog: https://motor.readthedocs.io/en/2.1.0/changelog.htmlChangelog
*Sourced from [motor's changelog](https://github.com/mongodb/motor/blob/master/doc/changelog.rst).* > Changelog > ========= > > Motor 2.1 > --------- > > Motor 2.1 adds support for MongoDB 4.2 features. It depends on PyMongo 3.10 or later. Motor continues to support MongoDB 3.0 and later. Motor 2.1 also adds support for Python 3.8. > > Motor now offers experimental support for Windows when it is using the asyncio event loop. This means it supports Windows exclusively with Python 3, either integrating with asyncio directly or with Tornado 5 or later: starting in version 5, Tornado uses the asyncio event loop on Python 3 by default. > > Additional changes: > > - Support for MongoDB 4.2 sharded transactions. Sharded transactions have the same API as replica set transactions. > - New method \~motor.motor\_asyncio.AsyncIOMotorClientSession.with\_transaction to support conveniently running a transaction in a session with automatic retries and at-most-once semantics. > - Added the `max_commit_time_ms` parameter to \~motor.motor\_asyncio.AsyncIOMotorClientSession.start\_transaction. > - The `retryWrites` URI option now defaults to `True`. Supported write operations that fail with a retryable error will automatically be retried one time, with at-most-once semantics. > - Support for retryable reads and the `retryReads` URI option which is enabled by default. See the \~pymongo.mongo\_client.MongoClient documentation for details. Now that supported operations are retried automatically and transparently, users should consider adjusting any custom retry logic to prevent an application from inadvertently retrying for too long. > - Support zstandard for wire protocol compression. > - Support for periodically polling DNS SRV records to update the mongos proxy list without having to change client configuration. > - New method motor.motor\_asyncio.AsyncIOMotorDatabase.aggregate to support running database level aggregations. > - Change stream enhancements for MongoDB 4.2: > - Resume tokens can now be accessed from a `AsyncIOMotorChangeStream` cursor using the \~motor.motor\_asyncio.AsyncIOMotorChangeStream.resume\_token attribute. > - New `AsyncIOMotorChangeStream` method \~motor.motor\_asyncio.AsyncIOMotorChangeStream.try\_next and attribute \~motor.motor\_asyncio.AsyncIOMotorChangeStream.alive. > - New parameter `start_after` for change stream motor.motor\_asyncio.AsyncIOMotorCollection.watch, motor.motor\_asyncio.AsyncIOMotorDatabase.watch, and motor.motor\_asyncio.AsyncIOMotorClient.watch methods. > - New parameters `bucket_name`, `chunk_size_bytes`, `write_concern`, and `read_preference` for motor.motor\_asyncio.AsyncIOMotorGridFSBucket. > > ### Issues Resolved > > See the [Motor 2.1 release notes in JIRA](https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=11182&version=20187) for the complete list of resolved issues in this release. > > Motor 2.0 > --------- > > Motor 2.0 drops support for MongoDB 2.6 and adds supports MongoDB 4.0 features, including multi-document transactions, and change stream notifications on entire databases or entire MongoDB servers. It adds support for Python 3.7. This version of Motor requires PyMongo 3.7 or later. > > This is a major release that removes previously deprecated APIs. > > To support multi-document transactions, Motor had to make breaking changes to the session API and release a major version bump. Since this is a major release it also deletes many helper methods and APIs that had been deprecated over the time since Motor 1.0, most notably the old CRUD methods `insert`, `update`, `remove`, and `save`, and the original callback-based API. Read the migrate-to-motor-2 carefully to upgrade your existing Motor application. > > Documentation is updated to warn about obsolete TLS versions, see configuration. Motor is now tested on Travis in addition to MongoDB's [Evergreen](https://github.com/evergreen-ci/evergreen) system. > > Added support for [aiohttp](https://aiohttp.readthedocs.io/) 3.0 and later, and dropped older aiohttp versions. The aiohttp integration now requires Python 3.5+. > > The `MotorDatabase.add_user` and `MotorDatabase.remove_user` methods are deleted. Manage user accounts with four database commands: [createUser](https://docs.mongodb.com/manual/reference/command/createUser/), [usersInfo](https://docs.mongodb.com/manual/reference/command/usersInfo/), [updateUser](https://docs.mongodb.com/manual/reference/command/updateUser/), and [dropUser](https://docs.mongodb.com/manual/reference/command/createUser/). You can run any database command with the MotorDatabase.command method. > > The deprecated GridFS classes `MotorGridFS` and `AsyncIOMotorGridFS` are deleted in favor of \~motor.motor\_tornado.MotorGridFSBucket and \~motor.motor\_asyncio.AsyncIOMotorGridFSBucket, which conform to driver specs for GridFS. > > Additional changes: > > - New methods for retrieving batches of raw BSON: > ... (truncated)Commits
- [`0690c83`](https://github.com/mongodb/motor/commit/0690c83326231123d2405ec982fd2978c04a8c0c) BUMP 2.1.0 - [`174b822`](https://github.com/mongodb/motor/commit/174b8227e5152c9df6b3876a40e7900286c40ee3) Update changelog for 2.1 release - [`393b6b2`](https://github.com/mongodb/motor/commit/393b6b2dedcee59548f6a94dc68f2e22463b6945) MOTOR-478 Do not build universal wheels - [`167e6a2`](https://github.com/mongodb/motor/commit/167e6a2497fe259d8bf9530cc7ad9e8da6f9fcac) MOTOR-444 Update minimum version to PyMongo 3.10 - [`47e7498`](https://github.com/mongodb/motor/commit/47e7498e7c6a073df1cb7b06f3fb0d549ee75ae5) MOTOR-472 Add PyPI classifier for PyPy implementation - [`e797e6d`](https://github.com/mongodb/motor/commit/e797e6dcd76622c425b07ef6a16c383fb692dab6) MOTOR-471 Document support for Python 3.8 - [`bec8fb4`](https://github.com/mongodb/motor/commit/bec8fb47e9d7dcf7a6507cfbabb7f1bfa9ca55e6) MOTOR-458 Run Travis with Python 3.7 and 3.8 ([#57](https://github-redirect.dependabot.com/mongodb/motor/issues/57)) - [`1a4fe95`](https://github.com/mongodb/motor/commit/1a4fe95b5e301a9bb026bda13e0e218e10df18cb) MOTOR-461 Test Python 3.8 in Evergreen - [`0db1890`](https://github.com/mongodb/motor/commit/0db189012877050d4033993ece030586a219ccf5) MOTOR-460 Fix TypeError when accessing __dict__ on GridFS classes - [`ec8b33f`](https://github.com/mongodb/motor/commit/ec8b33ffe7bf97e933e0491a759aa4fe8230fc9f) MOTOR-467 Do not call set_exception on a done Future - Additional commits viewable in [compare view](https://github.com/mongodb/motor/compare/2.0.0...2.1.0)Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting
@dependabot rebase.Dependabot commands and options
You can trigger Dependabot actions by commenting on this PR: - `@dependabot rebase` will rebase this PR - `@dependabot recreate` will recreate this PR, overwriting any edits that have been made to it - `@dependabot merge` will merge this PR after your CI passes on it - `@dependabot squash and merge` will squash and merge this PR after your CI passes on it - `@dependabot cancel merge` will cancel a previously requested merge and block automerging - `@dependabot reopen` will reopen this PR if it is closed - `@dependabot close` will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually - `@dependabot ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself) - `@dependabot ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself) - `@dependabot ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself) - `@dependabot use these labels` will set the current labels as the default for future PRs for this repo and language - `@dependabot use these reviewers` will set the current reviewers as the default for future PRs for this repo and language - `@dependabot use these assignees` will set the current assignees as the default for future PRs for this repo and language - `@dependabot use this milestone` will set the current milestone as the default for future PRs for this repo and language - `@dependabot badge me` will comment on this PR with code to add a "Dependabot enabled" badge to your readme Additionally, you can set the following in your Dependabot [dashboard](https://app.dependabot.com): - Update frequency (including time of day and day of week) - Pull request limits (per update run and/or open at any time) - Out-of-range updates (receive only lockfile updates, if desired) - Security updates (receive only security updates, if desired)