Metadata-Version: 1.1
Name: pymongo
Version: 2.5.2
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 `distribute
        <http://packages.python.org/distribute/>`_ 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) and Python 3.x (where x >= 1). PyMongo versions <= 1.3 also
        supported Python 2.3, but that is no longer supported.
        
        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):
        
        .. code-block:: pycon
        
          >>> import pymongo
          >>> client = pymongo.MongoClient("localhost", 27017)
          >>> db = client.test
          >>> db.name
          u'test'
          >>> db.my_collection
          Collection(Database(MongoClient('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 :: 2
Classifier: Programming Language :: Python :: 2.4
Classifier: Programming Language :: Python :: 2.5
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.1
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: Jython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Database