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.

Metadata

Release files for pymongo 0.13

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pymongo 0.13
File Size Uploaded
pymongo-0.13.tar.gz 80.8 kB Details

Built distributions (wheels)

Table of built distributions (wheels) for pymongo 0.13
File
pymongo-0.13-py2.6-win32.egg Legacy Egg format - - Details
pymongo-0.13-py2.6-macosx-10.5-i386.egg Legacy Egg format - - Details
pymongo-0.13-py2.5-macosx-10.5-i386.egg Legacy Egg format - - Details
pymongo-0.13-py2.4-macosx-10.5-i386.egg Legacy Egg format - - Details

Total release size: 565.1 kB

Release files / pymongo-0.13.tar.gz

Download URL pymongo-0.13.tar.gz
Size 80.8 kB
Tags Source
SHA-256 checksum
How to use checksums
117258c20b4fc639a8d2d6f1849d217e714e7357ef1a1f310322db6d1b9cde96
BLAKE2b-256 checksum
How to use checksums
d92891d77ce557aac8fc47deeb3dc7ec9d9324c295da87d25d54e9f1b977345d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / pymongo-0.13-py2.6-win32.egg

Download URL pymongo-0.13-py2.6-win32.egg
Size 121.3 kB
Tags Egg
SHA-256 checksum
How to use checksums
f0af6a79bf43bb1e2ab1024be9a55551836cb6c6e27a69caac7173e44b0279f1
BLAKE2b-256 checksum
How to use checksums
199d48088fabad19038fb539d95920b7713741eb9e3141437d30bb7f3c171be8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / pymongo-0.13-py2.6-macosx-10.5-i386.egg

Download URL pymongo-0.13-py2.6-macosx-10.5-i386.egg
Size 120.5 kB
Tags Egg
SHA-256 checksum
How to use checksums
6901637def26649d45feffa1b8e9a26ba562709d480a7a24a9b2787537e6697e
BLAKE2b-256 checksum
How to use checksums
b78a2c8877ca036c38d111d3880de54137d92ae529537b85a0b32e835bb36e62
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / pymongo-0.13-py2.5-macosx-10.5-i386.egg

Download URL pymongo-0.13-py2.5-macosx-10.5-i386.egg
Size 120.6 kB
Tags Egg
SHA-256 checksum
How to use checksums
e96c285b321bc887c2a989a317a2214476452d6c27922c1626b6b11ae5f42a5b
BLAKE2b-256 checksum
How to use checksums
1056397fd450e8c01cbf111726e085ff1e7825049d457697484dc31f6c2e0238
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / pymongo-0.13-py2.4-macosx-10.5-i386.egg

Download URL pymongo-0.13-py2.4-macosx-10.5-i386.egg
Size 121.9 kB
Tags Egg
SHA-256 checksum
How to use checksums
0661856fe68bf4381ad929fa12c74091cfe034a9a58705d547b6dbe1017f7014
BLAKE2b-256 checksum
How to use checksums
6aafc96c1651f520df30489ac4f51ef30812ad028d17a2db1f40424921bfef01
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

4.11

45 release files

4.9.1

59 release files

4.9

59 release files

4.8.0

50 release files

4.7.1

60 release files

4.7.0

60 release files

4.6.3

82 release files

4.6.2

82 release files

4.6.1

82 release files

4.5.0

82 release files

4.4.1

74 release files

4.4.0

74 release files

4.3.3

74 release files

4.3.2

74 release files

4.2.0

67 release files

4.1.1

83 release files

4.0

83 release files

3.9.0

31 release files

3.8.0

31 release files

3.7.2

39 release files

3.7.1

47 release files

3.7.0

44 release files

3.5.1

53 release files

3.4.0

49 release files

3.3.1

53 release files

3.3.0

44 release files

3.2.2

61 release files

3.2

61 release files

3.1.1

61 release files

3.1

61 release files

3.0.2

48 release files

3.0.1

49 release files

3.0

49 release files

2.9.5

41 release files

2.9.4

56 release files

2.9.3

67 release files

2.9.1

67 release files

2.9

63 release files

2.8.1

55 release files

2.8

55 release files

2.7.2

56 release files

2.7.1

56 release files

2.7

56 release files

2.6.3

29 release files

2.6

29 release files

2.5.1

34 release files

2.5

34 release files

2.4.2

34 release files

2.4

34 release files

2.3

28 release files

2.2

25 release files

2.1

21 release files

2.0.1

19 release files

2.0

20 release files

1.11

13 release files

1.10

13 release files

1.9

9 release files

1.8.1

8 release files

1.8

8 release files

1.7

8 release files

1.6

6 release files

1.5.2

6 release files

1.5.1

6 release files

1.5

6 release files

1.4

6 release files

1.3

6 release files

1.2.1

6 release files

1.2

6 release files

1.1.2

6 release files

1.1.1

4 release files

1.1

6 release files

1.0

6 release files

0.16

6 release files

0.15

7 release files

0.14.2

6 release files

0.14.1

5 release files

0.14

5 release files

This release

0.13 This release

5 release files

0.12

5 release files

0.11.3

5 release files

0.11

2 release files

0.10.3

2 release files

0.10.2

2 release files

0.10.1

2 release files

0.10

2 release files

0.9.7

2 release files

0.9.6

2 release files

0.9.5

2 release files

0.9.4

2 release files

0.9.3

2 release files

0.9.2

2 release files

0.9.1

2 release files

0.9

2 release files

0.8.1

2 release files

0.8

2 release files

0.7.2

2 release files

0.7.1

2 release files

0.7

2 release files

0.6

3 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page