https://github.com/nakagami/nmongo

Yet another MongoDB 3.x driver
https://github.com/nakagami/nmongo

Last synced: 2 months ago
JSON representation

Yet another MongoDB 3.x driver

• Host: GitHub
• URL: https://github.com/nakagami/nmongo
• Owner: nakagami
• License: mit
• Created: 2016-11-12T00:12:59.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2021-12-12T04:51:46.000Z (about 3 years ago)
• Last Synced: 2024-10-01T11:16:18.099Z (3 months ago)
• Language: Python
• Homepage:
• Size: 212 KB
• Stars: 20
• Watchers: 5
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

• awesome-micropython-lib - nmongo - MongoDB client for CPython and MicroPython. (Database)
• awesome-micropython - nmongo - MongoDB client for CPython and MicroPython, with MongoDB shell-like APIs. (Libraries / Storage)

README

        
==========

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