Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Update changelog.

  • Loading branch information...
commit e00603105ba421a4fee66844dfdc44739b09dd30 1 parent 2e4adbd
@ajdavis ajdavis authored
Showing with 17 additions and 1 deletion.
  1. +17 −1 doc/changelog.rst
View
18 doc/changelog.rst
@@ -32,7 +32,10 @@ executed with the (result, error) of the operation as in Motor 0.1. If no
callback is passed, a Future is returned that resolves to the method's
result or error.
-The ``length`` argument to :meth:`MotorCursor.to_list` is no longer optional.
+The ``length`` argument to :meth:`MotorCursor.to_list` is no longer optional:
+it's dangerous to let Motor buffer unlimited data from a single query.
+You can pass ``None`` as the length if you still want to retrieve the whole
+result set as a single list, no matter how large.
:class:`MotorPool` has been rewritten, both to support the same new features
as the new PyMongo 2.6 Pool, and to stop subclassing PyMongo's Pool to protect
@@ -45,6 +48,16 @@ Motor somewhat from PyMongo changes.
``waitQueueMultiple``. Timeouts raise a PyMongo :exc:`ConnectionFailure`;
:exc:`MotorPoolTimeout` is gone.
+Motor can take advantage of Tornado 3's `asynchronous resolver interface`_. By
+default, Motor still uses blocking DNS, but you can do configure non-blocking
+lookup with a threaded resolver::
+
+ Resolver.configure('tornado.netutil.ThreadedResolver')
+
+Or install `pycares`_ and use the c-ares resolver:
+
+ Resolver.configure('tornado.platform.caresresolver.CaresResolver')
+
The ``MotorCursor.tail`` method has been removed. It was complex, diverged from
PyMongo's feature set, and encouraged overuse of MongoDB capped collections as
message queues when a purpose-built message queue is more appropriate. An
@@ -60,6 +73,9 @@ Tornado 3's ``Future`` interface has equivalent functionality.
:meth:`~web.GridFSHandler.get_gridfs_file` now
returns a Future instead of accepting a callback.
+.. _asynchronous resolver interface: http://www.tornadoweb.org/en/stable/netutil.html#tornado.netutil.Resolver
+.. _pycares: https://pypi.python.org/pypi/pycares
+
Migration
~~~~~~~~~
Please sign in to comment.
Something went wrong with that request. Please try again.