Skip to content

Commit fde5b86

Browse files
DefrankShaneHarvey
authored andcommitted
Update tools documentation (mongodb#345)
Add testing driver, mongomock. Add new ORM-like framework, uMongo. Update no longer maintained ORM-like libraries, MongoKit, MongoAlchemy, minimongo, and Manga.
1 parent d08c258 commit fde5b86

File tree

1 file changed

+32
-18
lines changed

1 file changed

+32
-18
lines changed

doc/tools.rst

Lines changed: 32 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -48,11 +48,6 @@ Humongolus
4848
`at github <https://github.com/entone/Humongolus>`_. Tutorials and usage
4949
examples are also available at GitHub.
5050

51-
MongoKit
52-
The `MongoKit <http://github.com/namlook/mongokit>`_ framework
53-
is an ORM-like layer on top of PyMongo. There is also a MongoKit
54-
`google group <http://groups.google.com/group/mongokit>`_.
55-
5651
Ming
5752
`Ming <http://merciless.sourceforge.net/>`_ (the Merciless) is a
5853
library that allows you to enforce schemas on a MongoDB database in
@@ -62,12 +57,6 @@ Ming
6257
<http://blog.pythonisito.com/2009/12/ming-01-released-python-library-for.html>`_
6358
for more details.
6459

65-
MongoAlchemy
66-
`MongoAlchemy <http://mongoalchemy.org>`_ is another ORM-like layer on top of
67-
PyMongo. Its API is inspired by `SQLAlchemy <http://sqlalchemy.org>`_. The
68-
code is available `on github <http://github.com/jeffjenkins/MongoAlchemy>`_;
69-
for more information, see `the tutorial <http://mongoalchemy.org/tutorial.html>`_.
70-
7160
MongoEngine
7261
`MongoEngine <http://mongoengine.org/>`_ is another ORM-like
7362
layer on top of PyMongo. It allows you to define schemas for
@@ -76,6 +65,35 @@ MongoEngine
7665
<http://github.com/mongoengine/mongoengine>`_; for more information, see
7766
the `tutorial <http://docs.mongoengine.org/en/latest/tutorial.html>`_.
7867

68+
MotorEngine
69+
`MotorEngine <https://motorengine.readthedocs.io/>`_ is a port of
70+
MongoEngine to Motor, for asynchronous access with Tornado.
71+
It implements the same modeling APIs to be data-portable, meaning that a
72+
model defined in MongoEngine can be read in MotorEngine. The source is
73+
`available on github <http://github.com/heynemann/motorengine>`_.
74+
75+
uMongo
76+
`uMongo <https://umongo.readthedocs.io/>`_ is a Python MongoDB ODM.
77+
Its inception comes from two needs: the lack of async ODM and the
78+
difficulty to do document (un)serialization with existing ODMs.
79+
Works with multiple drivers: PyMongo, TxMongo, motor_asyncio, and
80+
mongomock. The source `is on github
81+
<https://github.com/Scille/umongo>`_
82+
83+
No longer maintained
84+
""""""""""""""""""""
85+
86+
MongoKit
87+
The `MongoKit <http://github.com/namlook/mongokit>`_ framework
88+
is an ORM-like layer on top of PyMongo. There is also a MongoKit
89+
`google group <http://groups.google.com/group/mongokit>`_.
90+
91+
MongoAlchemy
92+
`MongoAlchemy <http://mongoalchemy.org>`_ is another ORM-like layer on top of
93+
PyMongo. Its API is inspired by `SQLAlchemy <http://sqlalchemy.org>`_. The
94+
code is available `on github <http://github.com/jeffjenkins/MongoAlchemy>`_;
95+
for more information, see `the tutorial <http://mongoalchemy.org/tutorial.html>`_.
96+
7997
Minimongo
8098
`minimongo <http://pypi.python.org/pypi/minimongo>`_ is a lightweight,
8199
pythonic interface to MongoDB. It retains pymongo's query and update API,
@@ -90,13 +108,6 @@ Manga
90108
Django ORM, but Pymongo's query language is maintained. The source `is on
91109
github <http://github.com/wladston/manga>`_.
92110

93-
MotorEngine
94-
`MotorEngine <https://motorengine.readthedocs.io/>`_ is a port of
95-
MongoEngine to Motor, for asynchronous access with Tornado.
96-
It implements the same modeling APIs to be data-portable, meaning that a
97-
model defined in MongoEngine can be read in MotorEngine. The source is
98-
`available on github <http://github.com/heynemann/motorengine>`_.
99-
100111
Framework Tools
101112
---------------
102113
This section lists tools and adapters that have been designed to work with
@@ -153,3 +164,6 @@ These are alternatives to PyMongo.
153164
MongoDB driver for Python Tornado applications.
154165
* `TxMongo <https://github.com/twisted/txmongo>`_ is an asynchronous Twisted
155166
Python driver for MongoDB.
167+
* `MongoMock <https://github.com/mongomock/mongomock>`_ is a small
168+
library to help testing Python code that interacts with MongoDB via
169+
Pymongo.

0 commit comments

Comments
 (0)