← Back to branch summary

~crunch.io/ubuntu/precise/pymongo/unstable

« back to all changes in this revision

Viewing changes to doc/changelog.rst

  • Committer: Joseph Tate
  • Date: 2013-01-31 08:00:57 UTC
  • mfrom: (1.1.12)
  • Revision ID: jtate@dragonstrider.com-20130131080057-y7lv17xi6x8c1j5x
New upstream release.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/changelog.rst
1
1
Changelog
2
2
=========
3
3
 
 
4
Changes in Version 2.4.2
 
5
------------------------
 
6
 
 
7
Version 2.4.2 is a minor release that fixes issues discovered after the
 
8
release of 2.4.1. Most importantly, PyMongo will no longer select a replica
 
9
set member for read operations that is not in primary or secondary state.
 
10
 
 
11
Issues Resolved
 
12
...............
 
13
 
 
14
See the `PyMongo 2.4.2 release notes in JIRA`_ for the list of resolved issues
 
15
in this release.
 
16
 
 
17
.. _PyMongo 2.4.2 release notes in JIRA: https://jira.mongodb.org/browse/PYTHON/fixforversion/12299
 
18
 
 
19
Changes in Version 2.4.1
 
20
------------------------
 
21
 
 
22
Version 2.4.1 is a minor release that fixes issues discovered after the
 
23
release of 2.4. Most importantly, this release fixes a regression using
 
24
:meth:`~pymongo.collection.Collection.aggregate`, and possibly other commands,
 
25
with mongos.
 
26
 
 
27
Issues Resolved
 
28
...............
 
29
 
 
30
See the `PyMongo 2.4.1 release notes in JIRA`_ for the list of resolved issues
 
31
in this release.
 
32
 
 
33
.. _PyMongo 2.4.1 release notes in JIRA: https://jira.mongodb.org/browse/PYTHON/fixforversion/12286
 
34
 
 
35
Changes in Version 2.4
 
36
----------------------
 
37
 
 
38
Version 2.4 includes a few important new features and a large number of bug
 
39
fixes.
 
40
 
 
41
Important new features:
 
42
 
 
43
- New :class:`~pymongo.mongo_client.MongoClient` and
 
44
  :class:`~pymongo.mongo_replica_set_client.MongoReplicaSetClient` classes -
 
45
  these connection classes do acknowledged write operations (previously referred
 
46
  to as 'safe' writes) by default. :class:`~pymongo.connection.Connection` and
 
47
  :class:`~pymongo.replica_set_connection.ReplicaSetConnection` are deprecated
 
48
  but still support the old default fire-and-forget behavior.
 
49
- A new write concern API implemented as a
 
50
  :attr:`~pymongo.collection.Collection.write_concern` attribute on the connection,
 
51
  :class:`~pymongo.database.Database`, or :class:`~pymongo.collection.Collection`
 
52
  classes.
 
53
- :class:`~pymongo.mongo_client.MongoClient` (and :class:`~pymongo.connection.Connection`)
 
54
  now support Unix Domain Sockets.
 
55
- :class:`~pymongo.cursor.Cursor` can be copied with functions from the :mod:`copy`
 
56
  module.
 
57
- The :meth:`~pymongo.database.Database.set_profiling_level` method now supports
 
58
  a `slow_ms` option.
 
59
- The replica set monitor task (used by
 
60
  :class:`~pymongo.mongo_replica_set_client.MongoReplicaSetClient` and
 
61
  :class:`~pymongo.replica_set_connection.ReplicaSetConnection`) is a daemon thread
 
62
  once again, meaning you won't have to call
 
63
  :meth:`~pymongo.mongo_replica_set_client.MongoReplicaSetClient.close` before
 
64
  exiting the python interactive shell.
 
65
 
 
66
.. warning::
 
67
 
 
68
    The constructors for :class:`~pymongo.mongo_client.MongoClient`,
 
69
    :class:`~pymongo.mongo_replica_set_client.MongoReplicaSetClient`,
 
70
    :class:`~pymongo.connection.Connection`, and
 
71
    :class:`~pymongo.replica_set_connection.ReplicaSetConnection` now raise
 
72
    :exc:`~pymongo.errors.ConnectionFailure` instead of its subclass
 
73
    :exc:`~pymongo.errors.AutoReconnect` if the server is unavailable. Applications
 
74
    that expect to catch :exc:`~pymongo.errors.AutoReconnect` should now catch
 
75
    :exc:`~pymongo.errors.ConnectionFailure` while creating a new connection.
 
76
 
 
77
Issues Resolved
 
78
...............
 
79
 
 
80
See the `PyMongo 2.4 release notes in JIRA`_ for the list of resolved issues
 
81
in this release.
 
82
 
 
83
.. _PyMongo 2.4 release notes in JIRA: https://jira.mongodb.org/browse/PYTHON/fixforversion/11485
 
84
 
 
85
Changes in Version 2.3
 
86
----------------------
 
87
 
 
88
Version 2.3 adds support for new features and behavior changes in MongoDB
 
89
2.2.
 
90
 
 
91
Important New Features:
 
92
 
 
93
- Support for expanded read preferences including directing reads to tagged
 
94
  servers - See :ref:`secondary-reads` for more information.
 
95
- Support for mongos failover -
 
96
  See :ref:`mongos-high-availability` for more information.
 
97
- A new :meth:`~pymongo.collection.Collection.aggregate` method to support
 
98
  MongoDB's new `aggregation framework
 
99
  <http://docs.mongodb.org/manual/applications/aggregation/>`_.
 
100
- Support for legacy Java and C# byte order when encoding and decoding UUIDs.
 
101
- Support for connecting directly to an arbiter.
 
102
 
 
103
.. warning::
 
104
 
 
105
    Starting with MongoDB 2.2 the getLastError command requires authentication
 
106
    when the server's `authentication features
 
107
    <http://www.mongodb.org/display/DOCS/Security+and+Authentication>`_ are enabled.
 
108
    Changes to PyMongo were required to support this behavior change. Users of
 
109
    authentication must upgrade to PyMongo 2.3 (or newer) for "safe" write operations
 
110
    to function correctly.
 
111
 
 
112
Issues Resolved
 
113
...............
 
114
 
 
115
See the `PyMongo 2.3 release notes in JIRA`_ for the list of resolved issues
 
116
in this release.
 
117
 
 
118
.. _PyMongo 2.3 release notes in JIRA: https://jira.mongodb.org/browse/PYTHON/fixforversion/11146
 
119
 
 
120
Changes in Version 2.2.1
 
121
------------------------
 
122
 
 
123
Version 2.2.1 is a minor release that fixes issues discovered after the
 
124
release of 2.2. Most importantly, this release fixes an incompatibility
 
125
with mod_wsgi 2.x that could cause connections to leak. Users of mod_wsgi
 
126
2.x are strongly encouraged to upgrade from PyMongo 2.2.
 
127
 
 
128
Issues Resolved
 
129
...............
 
130
 
 
131
See the `PyMongo 2.2.1 release notes in JIRA`_ for the list of resolved issues
 
132
in this release.
 
133
 
 
134
.. _PyMongo 2.2.1 release notes in JIRA: https://jira.mongodb.org/browse/PYTHON/fixforversion/11185
 
135
 
4
136
Changes in Version 2.2
5
137
-----------------------
6
138
 
84
216
  automatic failover handling and periodically checks the state of the
85
217
  replica set to handle issues like primary stepdown or secondaries
86
218
  being removed for backup operations. Read preferences are defined through
87
 
  :class:`~pymongo.ReadPreference`.
 
219
  :class:`~pymongo.read_preferences.ReadPreference`.
88
220
- PyMongo supports the new BSON binary subtype 4 for UUIDs. The default
89
221
  subtype to use can be set through
90
222
  :attr:`~pymongo.collection.Collection.uuid_subtype`
690
822
  get around some issues with queries on fields named ``query``
691
823
- enforce 4MB document limit on the client side
692
824
- added :meth:`~pymongo.collection.Collection.map_reduce` helper - see
693
 
  :doc:`example <examples/map_reduce>`
 
825
  :doc:`example <examples/aggregation>`
694
826
- added :meth:`~pymongo.cursor.Cursor.distinct` method on
695
827
  :class:`~pymongo.cursor.Cursor` instances to allow distinct with
696
828
  queries