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) sphinx
- (to auto-discover tests) nose
Examples
Here’s a basic example (for more see the examples/ directory):
>>> import pymongo >>> connection = pymongo.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('4aba15ebe23f6b53b0000000') >>> db.my_collection.save({"x": 8}) ObjectId('4aba160ee23f6b543e000000') >>> db.my_collection.save({"x": 11}) ObjectId('4aba160ee23f6b543e000002') >>> db.my_collection.find_one() {u'x': 10, u'_id': ObjectId('4aba160ee23f6b543e000002')} >>> for item in db.my_collection.find(): ... print item["x"] ... 10 8 11 >>> db.my_collection.create_index("x") u'x_1' >>> for item in db.my_collection.find().sort("x", pymongo.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 sphinx installed to generate the documentation. Documentation can be generated by running python setup.py doc. Generated documentation can be found in the doc/build/html/ 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-1.1.1-py2.6-macosx-10.6-i386.egg
Algorithm | Hash digest | |
---|---|---|
SHA256 | 029ad2ac3d46b96551932b5c0e2782d7a580f77307a3de91418a25cb128d7a5c |
|
MD5 | cb7bb265bc662818afd3889326905ac7 |
|
BLAKE2-256 | 4610c885b83e64698f1f9258d64f9dd0851cc9d1e31ece5b55845f1d0e1921ca |
Hashes for pymongo-1.1.1-py2.5-macosx-10.6-i386.egg
Algorithm | Hash digest | |
---|---|---|
SHA256 | a09b72ae5643c15d75398ed2f87056a74cede766f5036d52cc39a53576402572 |
|
MD5 | 8da4c223cb37e7dfe409b6c8fcf427cd |
|
BLAKE2-256 | bcb65e23300d6a77920e8384362d26a10773e2958bb6b80eacd13b5f6bea59bc |
Hashes for pymongo-1.1.1-py2.4-macosx-10.6-i386.egg
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1728123ec12fa8724fb80214cb4e4f687bf87835d5a13a5641470a35a0adb7c2 |
|
MD5 | f5140d795cb434cd5d5e16fed3401c0b |
|
BLAKE2-256 | b0aedba18f856aa202b3205ebe74db25148cff7bebc948b5eae9b28656a47afe |