Metadata-Version: 1.0
Name: pymongo
Version: 2.1.1
Summary: Python driver for MongoDB <http://www.mongodb.org>
Home-page: http://github.com/mongodb/mongo-python-driver
Author: Bernie Hackett
Author-email: bernie@10gen.com
License: Apache License, Version 2.0
Description: =======
        PyMongo
        =======
        :Info: See `the mongo site <http://www.mongodb.org>`_ for more information. See `github <http://github.com/mongodb/mongo-python-driver/tree>`_ for the latest source.
        :Author: Mike Dirolf
        :Maintainer: Bernie Hackett <bernie@10gen.com>
        
        About
        =====
        
        The PyMongo distribution contains tools for interacting with MongoDB
        database from Python.  The ``bson`` package is an implementation of
        the `BSON format <http://bsonspec.org>`_ for Python. The ``pymongo``
        package is a native Python driver for MongoDB. The ``gridfs`` package
        is a `gridfs
        <http://www.mongodb.org/display/DOCS/GridFS+Specification>`_
        implementation on top of ``pymongo``.
        
        Issues / Questions / Feedback
        =============================
        
        Any issues with, questions about, or feedback for PyMongo should be
        sent to the mongodb-user list on Google Groups. For confirmed issues
        or feature requests, open a case on `jira
        <http://jira.mongodb.org>`_. Please do not e-mail any of the PyMongo
        developers directly with issues or questions - you're more likely to
        get an answer on the list.
        
        Installation
        ============
        
        If you have `setuptools
        <http://peak.telecommunity.com/DevCenter/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 is supported and tested on Python 2.x, where
        x >= 4. PyMongo versions <= 1.3 also supported Python 2.3, but that is
        no longer supported. If you need to use Python 2.3 please contact us.
        
        Additional dependencies are:
        
        - (to generate documentation) sphinx_
        - (to auto-discover tests) `nose <http://somethingaboutorange.com/mrl/projects/nose/>`_
        
        Examples
        ========
        Here's a basic example (for more see the *examples* section of the docs):
        
        >>> 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('4aba15ebe23f6b53b0000000')}
        >>> 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
        <http://somethingaboutorange.com/mrl/projects/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.
        
        .. _sphinx: http://sphinx.pocoo.org/
        
Keywords: mongo,mongodb,pymongo,gridfs,bson
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
Classifier: Topic :: Database