Motor 1.2.3

-----------

Compatibility with latest Sphinx and document how to use the latest TLS
protocols.

Motor 1.2.2

-----------

Motor 1.2.0 requires PyMongo 3.6 or later. The dependency was properly
documented, but not enforced in ``setup.py``. PyMongo 3.6 is now an install-time
requirement; thanks to Shane Harvey for the fix.

Motor 1.2.1

-----------

An asyncio application that created a Change Stream with MotorCollection.watch
and shut down while the Change Stream was open would print several errors. I
have rewritten MotorChangeStream.next and some Motor internals to allow clean
shutdown with asyncio.

Motor 1.2 drops support for MongoDB 2.4 and adds support for MongoDB 3.6

features. It depends on PyMongo 3.6 or later. Motor continues to support
MongoDB 2.6 and later.

Dropped support for Python 2.6. Motor continues to support Python 2.7, and
3.3+.

Dropped support for Tornado 3. A recent version of Tornado 4 is required.

Dropped support for the Python 3.5.0 and Python 3.5.1 “async for” protocol.
Motor allows “async for” with cursors in Python 3.5.2 and later.

See the Compatibility Matrix for the relationships among Motor, Python,
Tornado, and MongoDB versions.

Added support for aiohttp 2.0 and later, and dropped older aiohttp versions.

Highlights include:

* New method MotorCollection.watch() to acquire a Change Stream on a
  collection.
* New Session API to support causal consistency, see
  MotorClient.start_session().
* Support for array_filters in update_one(), update_many(),
  find_one_and_update(), bulk_write(). MotorClient.list_databases() and
  MotorClient.list_database_names().
* Support for mongodb+srv:// URIs. See MongoClient for details.
* Support for retryable writes and the retryWrites URI option. See MongoClient
  for details.
* Deleted obsolete class motor.Op.

Motor 1.2 drops support for MongoDB 2.4 and adds support for MongoDB 3.6

features. It depends on PyMongo 3.6 or later. Motor continues to support
MongoDB 2.6 and later.

Dropped support for Python 2.6. Motor continues to support Python 2.7, and
3.3+.

Dropped support for Tornado 3. A recent version of Tornado 4 is required.

Dropped support for the Python 3.5.0 and Python 3.5.1 “async for” protocol.
Motor allows “async for” with cursors in Python 3.5.2 and later.

See the Compatibility Matrix for the relationships among Motor, Python,
Tornado, and MongoDB versions.

Added support for aiohttp 2.0 and later, and dropped older aiohttp versions.

Highlights include:

* New method MotorCollection.watch() to acquire a Change Stream on a
  collection.
* New Session API to support causal consistency, see
  MotorClient.start_session().
* Support for array_filters in update_one(), update_many(),
  find_one_and_update(), bulk_write(). MotorClient.list_databases() and
  MotorClient.list_database_names().
* Support for mongodb+srv:// URIs. See MongoClient for details.
* Support for retryable writes and the retryWrites URI option. See MongoClient
  for details.
* Deleted obsolete class motor.Op.

Motor depends on PyMongo 3.4 or later. It wraps the latest PyMongo co…

…de which

support the new server features introduced in MongoDB 3.4.

Complete support for MongoDB 3.4.
- Unicode aware string comparison using collations. See PyMongo's examples for
  collation.
- MotorCursor and MotorGridOutCursor have a new attribute collation().
- Support for the new Decimal128 BSON type.
- A new maxStalenessSeconds read preference option.
- A username is no longer required for the MONGODB-X509 authentication mechanism
  when connected to MongoDB >= 3.4.
- parallel_scan() supports maxTimeMS.
- WriteConcern is automatically applied by all helpers for commands that write
  to the database when connected to MongoDB 3.4+. This change affects the
  following helpers:
  - MotorClient.drop_database()
  - MotorDatabase.create_collection()
  - MotorDatabase.drop_collection()
  - MotorCollection.aggregate() (when using $out)
  - MotorCollection.create_indexes()
  - MotorCollection.create_index()
  - MotorCollection.drop_indexes()
  - MotorCollection.drop_indexes()
  - MotorCollection.drop_index()
  - MotorCollection.map_reduce() (when output is not “inline”)
  - MotorCollection.reindex()
  - MotorCollection.rename()

Improved support for logging server discovery and monitoring events. See
PyMongo's monitoring documentation for examples.

Support for matching iPAddress subjectAltName values for TLS certificate
verification.

TLS compression is now explicitly disabled when possible.

The Server Name Indication (SNI) TLS extension is used when possible.

PyMongo's bson module provides finer control over JSON encoding/decoding with
JSONOptions.

Allow Code objects to have a scope of None, signifying no scope. Also allow
encoding Code objects with an empty scope (i.e. {}).

Motor 1.0

Motor now depends on PyMongo 3.3 and later. The move from PyMongo 2 to 3 brings
a large number of API changes, read Motor 1.0 Migration Guide and the PyMongo 3
changelog carefully.

Motor 0.7

For asynchronous I/O Motor now uses a thread pool, which is faster and simpler
than the prior implementation with greenlets. It no longer requires the
greenlet package, and now requires the futures backport package on Python 2.

This version updates the PyMongo dependency from 2.8.0 to 2.9.x, and wraps
PyMongo 2.9’s new APIs.

Most of Motor 1.0’s API is now implemented, and APIs that will be removed in
Motor 1.0 are now deprecated and raise warnings. See the Motor 1.0 Migration
Guide to prepare your code for Motor 1.0.

MotorClient changes

The get_database method is added for getting a MotorDatabase instance with its
options configured differently than the MotorClient’s.

New read-only attributes:

- codec_options
- local_threshold_ms
- max_write_batch_size

MotorReplicaSetClient changes

The get_database method is added for getting a MotorDatabase instance with its
options configured differently than the MotorReplicaSetClient’s.

New read-only attributes:

- codec_options
- local_threshold_ms

MotorDatabase changes

The get_collection method is added for getting a MotorCollection instance with
its options configured differently than the MotorDatabase’s.

The connection property is deprecated in favor of a new read-only attribute
client.

New read-only attribute:

- codec_options

MotorCollection changes

The with_options method is added for getting a MotorCollection instance with
its options configured differently than this MotorCollection’s.

New read-only attribute:

- codec_options

The following methods wrap PyMongo’s implementation of the standard CRUD API
Spec for MongoDB Drivers:

- bulk_write
- insert_one
- insert_many
- update_one
- update_many
- replace_one
- delete_one
- delete_many
- find_one_and_delete
- find_one_and_replace
- find_one_and_update

These new methods do not apply SON Manipulators.

New MotorGridOutCursor methods:

- add_option
- remove_option
- clone

Added MotorGridOut documentation:

- aliases
- chunk_size
- close
- content_type
- filename
- length
- md5
- metadata
- name
- upload_date

Bugfix:

MOTOR-124: an import deadlock in Python 2 and Tornado 3 led to an AutoReconnect
exception with some replica sets.