Python driver for MongoDB <http://www.mongodb.org>
Project description
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Hashes for pymongo-0.13-py2.6-macosx-10.5-i386.egg
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6901637def26649d45feffa1b8e9a26ba562709d480a7a24a9b2787537e6697e |
|
MD5 | 7fb9ca90ddf380839628265197b80317 |
|
BLAKE2-256 | b78a2c8877ca036c38d111d3880de54137d92ae529537b85a0b32e835bb36e62 |
Hashes for pymongo-0.13-py2.5-macosx-10.5-i386.egg
Algorithm | Hash digest | |
---|---|---|
SHA256 | e96c285b321bc887c2a989a317a2214476452d6c27922c1626b6b11ae5f42a5b |
|
MD5 | ab235722aac1acc65d72a8f504a41b0d |
|
BLAKE2-256 | 1056397fd450e8c01cbf111726e085ff1e7825049d457697484dc31f6c2e0238 |
Hashes for pymongo-0.13-py2.4-macosx-10.5-i386.egg
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0661856fe68bf4381ad929fa12c74091cfe034a9a58705d547b6dbe1017f7014 |
|
MD5 | c2a4712976a969a9117682ea0961e5bc |
|
BLAKE2-256 | 6aafc96c1651f520df30489ac4f51ef30812ad028d17a2db1f40424921bfef01 |