BUMP 1.4 - see changelog for details

Author: Mike Dirolf

README.rst

@@ -7,9 +7,9 @@ PyMongo
 About
 =====
 
-The PyMongo distribution contains tools for interacting with the Mongo
+The PyMongo distribution contains tools for interacting with MongoDB
 database from Python.  The ``pymongo`` package is a native Python
-driver for the Mongo database. The ``gridfs`` package is a `gridfs
+driver for MongoDB. The ``gridfs`` package is a `gridfs
 <http://www.mongodb.org/display/DOCS/GridFS+Specification>`_
 implementation on top of ``pymongo``.
 

doc/changelog.rst

@@ -1,6 +1,68 @@
 Changelog
 =========
 
+Changes in Version 1.4
+----------------------
+
+Perhaps the most important change in version 1.4 is that we have
+decided to **no longer support Python 2.3**. The most immediate reason
+for this is to allow some improvements to connection pooling. This
+will also allow us to use some new (as in Python 2.4 ;) idioms and
+will help begin the path towards supporting Python 3.0. If you need to
+use Python 2.3 you should consider using version 1.3 of this driver,
+although that will no longer be actively supported.
+
+Other changes:
+
+- move ``"_id"`` to front only for top-level documents (fixes some
+  corner cases).
+- :meth:`~pymongo.collection.Collection.update` and
+  :meth:`~pymongo.collection.Collection.remove` return the entire
+  response to the *lastError* command when safe is ``True``.
+- completed removal of things that were deprecated in version 1.2 or
+  earlier.
+- enforce that collection names do not contain the NULL byte.
+- fix to allow using UTF-8 collection names with the C extension.
+- added :class:`~pymongo.errors.PyMongoError` as base exception class
+  for all :mod:`~pymongo.errors`. this changes the exception hierarchy
+  somewhat, and is a BREAKING change if you depend on
+  :class:`~pymongo.errors.ConnectionFailure` being a :class:`IOError`
+  or :class:`~pymongo.errors.InvalidBSON` being a :class:`ValueError`,
+  for example.
+- added :class:`~pymongo.errors.DuplicateKeyError` for calls to
+  :meth:`~pymongo.collection.Collection.insert` or
+  :meth:`~pymongo.collection.Collection.update` with `safe` set to
+  ``True``.
+- removed :mod:`~pymongo.thread_util`
+- added :meth:`~pymongo.database.Database.add_user` and
+  :meth:`~pymongo.database.Database.remove_user` helpers.
+- fix for :meth:`~pymongo.database.Database.authenticate` when using
+  non-UTF-8 names or passwords.
+- minor fixes for
+  :class:`~pymongo.master_slave_connection.MasterSlaveConnection`.
+- clean up all cases where :class:`~pymongo.errors.ConnectionFailure`
+  is raised.
+- simplification of connection pooling - makes driver ~2x faster for
+  simple benchmarks. see :ref:`connection-pooling` for more information.
+- DEPRECATED `pool_size`, `auto_start_request` and `timeout`
+  parameters to :class:`~pymongo.connection.Connection`. DEPRECATED
+  :meth:`~pymongo.connection.Connection.start_request`.
+- use :meth:`socket.sendall`.
+- removed :meth:`~pymongo.son.SON.from_xml` as it was only being used
+  for some internal testing - also eliminates dependency on
+  :mod:`elementtree`.
+- implementation of :meth:`~pymongo.message.update` in C.
+- deprecate :meth:`~pymongo.database.Database._command` in favor of
+  :meth:`~pymongo.database.Database.command`.
+- send all commands without wrapping as ``{"query": ...}``.
+- support string as `key` argument to
+  :meth:`~pymongo.collection.Collection.group` (keyf) and run all
+  groups as commands.
+- support for equality testing for :class:`~pymongo.code.Code`
+  instances.
+- allow the NULL byte in strings and disallow it in key names or regex
+  patterns
+
 Changes in Version 1.3
 ----------------------
 - DEPRECATED running :meth:`~pymongo.collection.Collection.group` as

doc/faq.rst

@@ -9,6 +9,8 @@ Is PyMongo thread-safe?
 PyMongo is thread-safe and even provides built-in connection pooling
 for threaded applications.
 
+.. _connection-pooling:
+
 How does connection pooling work in PyMongo?
 --------------------------------------------
 

pymongo/__init__.py

@@ -28,7 +28,7 @@
 ALL = 2
 """Profile all operations."""
 
-version = "1.3+"
+version = "1.4"
 """Current version of PyMongo."""
 
 Connection = PyMongo_Connection

pymongo/collection.py

@@ -258,7 +258,7 @@ def update(self, spec, document,
             explicitly for all update operations in order to prepare your code
             for that change.
 
-        .. versionchanged:: 1.3+
+        .. versionchanged:: 1.4
            Return the response to *lastError* if `safe` is ``True``.
         .. versionadded:: 1.1.1
            The `multi` parameter.
@@ -309,7 +309,7 @@ def remove(self, spec_or_object_id=None, safe=False):
             ``_id`` field for the document to be removed
           - `safe` (optional): check that the remove succeeded?
 
-        .. versionchanged:: 1.3+
+        .. versionchanged:: 1.4
            Return the response to *lastError* if `safe` is ``True``.
         .. versionchanged:: 1.2
            The `spec_or_object_id` parameter is now optional. If it is
@@ -645,7 +645,7 @@ def group(self, key, condition, initial, reduce, finalize=None,
             command instead of in an eval - this option is deprecated and
             will be removed in favor of running all groups as commands
 
-        .. versionchanged:: 1.3+
+        .. versionchanged:: 1.4
            The `key` argument can now be ``None`` or a JavaScript function,
            in addition to a :class:`list` of keys.
         .. versionchanged:: 1.3

pymongo/connection.py

@@ -124,7 +124,7 @@ def __init__(self, host=None, port=None, pool_size=None,
             operations - default is no timeout
 
         .. seealso:: :meth:`end_request`
-        .. versionchanged:: 1.3+
+        .. versionchanged:: 1.4
            DEPRECATED The `pool_size`, `auto_start_request`, and `timeout`
            parameters.
         .. versionadded:: 1.1
@@ -542,7 +542,7 @@ def _send_message_with_response(self, message,
     def start_request(self):
         """DEPRECATED all operations will start a request.
 
-        .. versionchanged:: 1.3+
+        .. versionchanged:: 1.4
            DEPRECATED
         """
         warnings.warn("the Connection.start_request method is deprecated",

pymongo/database.py

@@ -213,7 +213,7 @@ def command(self, command, check=True, allowable_errors=[], _sock=None):
           - `allowable_errors`: if `check` is ``True``, error messages in this
             list will be ignored by error-checking
 
-        .. versionadded:: 1.3+
+        .. versionadded:: 1.4
         """
         result = self["$cmd"].find_one(command, _sock=_sock,
                                        _must_use_master=True,
@@ -379,7 +379,7 @@ def add_user(self, name, password):
           - `name`: the name of the user to create
           - `password`: the password of the user to create
 
-        .. versionadded:: 1.3+
+        .. versionadded:: 1.4
         """
         self.system.users.update({"user": name},
                                  {"user": name,
@@ -395,7 +395,7 @@ def remove_user(self, name):
         :Paramaters:
           - `name`: the name of the user to remove
 
-        .. versionadded:: 1.3+
+        .. versionadded:: 1.4
         """
         self.system.users.remove({"user": name}, safe=True)
 

pymongo/errors.py

@@ -17,7 +17,7 @@
 class PyMongoError(Exception):
     """Base class for all PyMongo exceptions.
 
-    .. versionadded:: 1.3+
+    .. versionadded:: 1.4
     """
 
 
@@ -51,7 +51,7 @@ class OperationFailure(PyMongoError):
 class DuplicateKeyError(OperationFailure):
     """Raised when a safe insert or update fails due to a duplicate key error.
 
-    .. versionadded:: 1.3+
+    .. versionadded:: 1.4
     """