PyPI · #323 most downloaded on PyPI

pymongo

4.18.1100M downloads/momongodb/mongo-python-driver ↗New releases in your daily digest, changelog included.

PyMongo - the Official MongoDB Python driver

Last release 10 days ago
10 Sep 2026
Release timing varies
gaps range from 8 days to 4 months
Nearly every release is documented
notes for 56 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
18 years old
172 releases · first in 2009

Release timeline

172 releases since 2009

2009201120132015

Releases

1.5.117 Mar 2010
added _id property for GridFile instances.
added _id property for GridFile instances.

fix for making a Connection (with slave_okay set) directly to a slave in a replica pair.

accept kwargs for create_index() and ensure_index() to support all indexing options.

add pymongo.GEO2D and support for geo indexing.

improvements to Python code caching in C extension - should improve behavior on mod_wsgi.
Open source →
1.510 Mar 2010Deprecated
DEPRECATED options argument to Collection() and create_collection() in favor of kwargs.
added subtype constants to binary module.

DEPRECATED options argument to Collection() and create_collection() in favor of kwargs.

added has_c() to check for C extension.

added copy_database() .

added alive to tell when a cursor might have more data to return (useful for tailable cursors).

added Timestamp to better support dealing with internal MongoDB timestamps.

added name argument for create_index() and ensure_index() .

fixed connection pooling w/ fork

paired() takes all kwargs that are allowed for Connection() .

insert() returns list for bulk inserts of size one.

fixed handling of datetime.datetime instances in json_util .

added from_uri() to support MongoDB connection uri scheme.

fixed chunk number calculation when unaligned in gridfs .

command() takes a string for simple commands.

added system_js helper for dealing with server-side JS.

don’t wrap queries containing "$query" (support manual use of "$min" , etc.).

added GridFSError as base class for gridfs exceptions.

One column per quarter.

1.427 Jan 2010Breaking

added PyMongoError as base exception class for all errors . this changes the exception hierarchy somewhat, and is a BREAKING change if you depend on C…

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).
update() and 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 PyMongoError as base exception class for all errors . this changes the exception hierarchy somewhat, and is a BREAKING change if you depend on ConnectionFailure being a IOError or InvalidBSON being a ValueError , for example.
added DuplicateKeyError for calls to insert() or update() with safe set to True .
removed thread_util .
added add_user() and remove_user() helpers.
fix for authenticate() when using non-UTF-8 names or passwords.
minor fixes for MasterSlaveConnection .
clean up all cases where ConnectionFailure is raised.
simplification of connection pooling - makes driver ~2x faster for simple benchmarks. see How does connection pooling work in PyMongo? for more information.
DEPRECATED pool_size , auto_start_request and timeout parameters to Connection . DEPRECATED start_request() .
use socket.sendall() .
removed from_xml() as it was only being used for some internal testing - also eliminates dependency on elementtree .
implementation of update() in C.
deprecate _command() in favor of command() .
send all commands without wrapping as {"query": ...} .
support string as key argument to group() (keyf) and run all groups as commands.
support for equality testing for Code instances.
allow the NULL byte in strings and disallow it in key names or regex patterns

pymongo

Release timeline

Releases

Table of Contents

Previous topic

Next topic

This Page

Quick search

Navigation