========== nmongo

MongoDB 3.x client for CPython and MicroPython.

It has mongo shell like APIs.

Support platform

• CPython 3.5+ https://www.python.org
• MicroPython (unix) http://docs.micropython.org/en/latest/unix/　(I haven't tried any other platforms.)

Support database

• MongoDB 3.2, 3.4, 3.6
• Azure CosmosDB (MongoDB API)

Install

CPython

::

$ python3 -m pip install nmongo

MicroPython

if you use MicroPython patch datetime.py

• https://github.com/nakagami/nmongo/blob/master/tzinfo.patch
• https://github.com/micropython/micropython-lib/pull/338

::

$ micropython -m upip install micropython-time micropython-datetime $ patch --directory=$HOME/.micropython/lib < tzinfo.patch $ micropython -m upip install nmongo

Example

Connect to Database

::

   >>> import nmongo
   >>> db = nmongo.connect('servername', 'somewhatdatabase')
   >>>

SSL connection

::

import nmongo db = nmongo.connect('servername', 'somewhatdatabase', use_ssl=True)

or

::

import nmongo db = nmongo.connect('servername', 'somewhatdatabase', use_ssl=True, ssl_ca_certs='/path/to/something-cert.crt)

User Authentication

::

   >>> import nmongo
   >>> db = nmongo.connect('servername', 'somewhatdatabase', user='user', password='password')
   >>>

Connect to Azure CosmosDB (MongoDB API)

::

import nmongo db = nmongo.connect('xxx.mongo.cosmos.azure.com', 'somewhatdatabase', user='xxx', password='password', port=10255, use_ssl=True)

Create

::

   >>> db.fruits.insert({'name': 'apple', 'price': 200})
   1
   >>> db.fruits.insert([{'name': 'orange', 'price': 100}, {'name': 'banana', 'price': 50}])
   2
   >>> db.fruits.count()
   3
   >>>

Read

::

cur = db.fruits.find({'name': 'banana'}) cur.fetchone() {'price': 50, '_id': ObjectId("5826b2313d28909ce9f6ea63"), 'name': 'banana'} cur = db.fruits.find() cur.fetchall() [{'price': 200, '_id': ObjectId("5826b2273d28909ce9f6ea61"), 'name': 'apple'}, {'price': 100, '_id': ObjectId("5826b2313d28909ce9f6ea62"), 'name': 'orange'}, {'price': 50, '_id': ObjectId("5826b2313d28909ce9f6ea63"), 'name': 'banana'}]

Update

::

   >>> db.fruits.update({'name': 'banana'}, {'$inc': {'price': 20}})
   {'nModified': 1, 'ok': 1, 'n': 1}
   >>> cur = db.fruits.find({'name': 'banana'})
   >>> cur.fetchone()
   {'_id': ObjectId("5823dd6d3d28909ce9f6e99c"), 'name': 'banana', 'price': 70}
   >>>

Delete

::

db.fruits.remove({'name': 'banana'}) 1 db.fruits.count() 2

Count each collection records

::

   >>> for collection in db.getCollections():
   ...     print(collection.name, collection.count())
   ...
   fruits 3
   >>> db.getCollection('fruits').count()
   3
   >>>

See also mongo Shell Methods (Collection and Database sections).

- https://docs.mongodb.com/manual/reference/method/#collection
- https://docs.mongodb.com/manual/reference/method/#database

Features Not Implemented
--------------------------

- GridFS