Skip to main content
Info:

See the mongo site for more information. See github for the latest source.

Author:

Mike Dirolf <mike@10gen.com>

About

The PyMongo distribution contains tools for interacting with the Mongo database from Python. The pymongo package is a native Python driver for the Mongo database. The gridfs package is a gridfs implementation on top of pymongo.

Installation

If you have setuptools installed you should be able to do easy_install pymongo to install PyMongo. Otherwise you can download the project source and do python setup.py install to install.

Dependencies

The PyMongo distribution has been tested on Python 2.x, where x >= 3. On Python 2.3 the optional C extension will not be built. This will negatively affect performance, but everything should still work.

Additional dependencies are:

  • ElementTree (this is included with Python >= 2.5)

  • (to generate documentation) epydoc

  • (to auto-discover tests) nose

Examples

Here’s a basic example (for more see the examples/ directory):

>>> from pymongo.connection import Connection
>>> connection = Connection("localhost", 27017)
>>> db = connection.test
>>> db.name()
u'test'
>>> db.my_collection
Collection(Database(Connection('localhost', 27017), u'test'), u'my_collection')
>>> db.my_collection.save({"x": 10})
ObjectId('D\x87\xdd\xe8\xd6\x0f\x89\xfc\xab\x06\xac\x8e')
>>> db.my_collection.save({"x": 8})
ObjectId('\xde\x0b\xec^\xdc\x11`\x12\xf8\xeb/\xcf')
>>> db.my_collection.save({"x": 11})
ObjectId('\t6\xc6\x07\xb3\xfc\x87\xc4\x82\x04\x0f\\')
>>> db.my_collection.find_one()
{u'x': 10, u'_id': ObjectId('D\x87\xdd\xe8\xd6\x0f\x89\xfc\xab\x06\xac\x8e')}
>>> for item in db.my_collection.find():
...     print item["x"]
...
10
8
11
>>> from pymongo import ASCENDING
>>> db.my_collection.create_index("x", ASCENDING)
u'x_1'
>>> for item in db.my_collection.find().sort("x", ASCENDING):
...     print item["x"]
...
8
10
11
>>> [item["x"] for item in db.my_collection.find().limit(2).skip(1)]
[8, 11]

Documentation

You will need epydoc installed to generate the documentation. Documentation can be generated by running python setup.py doc. Generated documentation can be found in the doc/ directory.

Testing

The easiest way to run the tests is to install nose (easy_install nose) and run nosetests or python setup.py test in the root of the distribution. Tests are located in the test/ directory.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pymongo-0.11.2.tar.gz (73.7 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

pymongo-0.11.2-py2.6-win32.egg (116.2 kB view details)

Uploaded Egg

pymongo-0.11.2-py2.6-macosx-10.5-i386.egg (115.4 kB view details)

Uploaded Egg

File details

Details for the file pymongo-0.11.2.tar.gz.

File metadata

  • Download URL: pymongo-0.11.2.tar.gz
  • Upload date:
  • Size: 73.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for pymongo-0.11.2.tar.gz
Algorithm Hash digest
SHA256 023bf918a42c14c194fc988a323d2bc98269a911481b5e34999fe96dc13330b7
MD5 e8b3f5955f4e6dd999b607f9ef25a09b
BLAKE2b-256 8e5e732666c83d79466ec20ba657a47258c0c7ca16f5e3dbec48e7ca77fcfb97

See more details on using hashes here.

File details

Details for the file pymongo-0.11.2-py2.6-win32.egg.

File metadata

File hashes

Hashes for pymongo-0.11.2-py2.6-win32.egg
Algorithm Hash digest
SHA256 2ea0d9cfa10e7c297d7f762b85679693c5f22a1b19cfd23b9bbf4632959abc3c
MD5 fc972a12b41beddac2ea11a1f7cec4df
BLAKE2b-256 8404d5254c05102fa895019e4cc3e72b3e0e88d2a353c79574822fb5ce0ce3ee

See more details on using hashes here.

File details

Details for the file pymongo-0.11.2-py2.6-macosx-10.5-i386.egg.

File metadata

File hashes

Hashes for pymongo-0.11.2-py2.6-macosx-10.5-i386.egg
Algorithm Hash digest
SHA256 a20c6742515f50db1a6d77f072e84cf9617fb3d1f067f0a80fbc3864c03b793d
MD5 b8e458b9a36d8516fa207cc94771bf4e
BLAKE2b-256 9127c850ec789a0f2d667fbe2fe0323c271011f24de7978f92ac25a9ef03d067

See more details on using hashes here.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page