Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Mnj — the MongoDB library which does it right

Mnj — the MongoDB library which does it right

There are a lot of MongoDB libraries for Python. Some of them could be very helpful. But when it comes to use PyMongo we are stuck with dicts and strings. Mnj (MongoEnergy) is here to fix it.

Serge Matveenko

June 17, 2016
Tweet

More Decks by Serge Matveenko

Other Decks in Programming

Transcript

  1. MongoDB state in Python • PyMongo — main driver ◦

    Direct MongoDB syntax mapping to dicts. ◦ Officially supported ◦ Has async derivative “Motor” • MongoEngine — most popular ODM ◦ Class to Collection mapping ◦ Django-like syntax ◦ Has async derivative “MotorEngine” • Other ◦ TxMongo (Twisted, PyMongo-like) ◦ MongoKit (alternative ODM, lack of maintenance, slow, was buggy) ◦ Some Django hacks, etc
  2. About Mnj • “Mnj” stands for “Mongo Energy” • Query

    DSL for PyMongo-like API • Helper Library that implements useful features • Object Document Mapping (ODM) • Licensed under BSD 2-clause license • Well coded and tested (PEP-8, 99% coverage) • `pip install mnj`
  3. MongoEngine vs Mnj MongoEngine PyMongo a lot of magic Mnj

    ODM Level PyMongo Mnj DSL Level Mnj Feature Level
  4. Comparison PyMongo MongoEngine Mnj Objects Mapping - Validation - Usability

    MongoDB like PyMongo Compatibility Defending errors
  5. PyMongo Example books = col.find({ 'author': {'$regex': 'Gibson', '$options': 'i'},

    'year': {'$gte': 2003}, }) for book in books: print(book['title'])
  6. Comparison PyMongo MongoEngine Mnj Objects Mapping - Validation - Usability

    - MongoDB like + PyMongo Compatibility + :) Defending errors -
  7. MongoEngine Example class Book(Document): author = StringField() year = IntField()

    title = StringField() books = Book.objects(author__icontains='Gibson', year__gte=2003) for book in books: print(book.title)
  8. Comparison PyMongo MongoEngine Mnj Objects Mapping - + Validation -

    + Usability - ± MongoDB like + - PyMongo Compatibility + :) - Defending errors - ±
  9. Mnj mixed with PyMongo Example books = col.find(q( q(author=regex_('Gibson', re.IGNORECASE)),

    {'year': {'$gte': 2003}} )) for book in books: print(book['title'])
  10. Mnj mixed with PyMongo Example books = col.find( q(year=mod_(divisor=1000, remainder=42))

    | q(year=mod_(1000, 13)) ) for book in books: print(book['title'], book['author'])
  11. Comparison PyMongo MongoEngine Mnj Objects Mapping - + + unstable

    Validation - + + planned Usability - ± + MongoDB like + - + PyMongo Compatibility + :) - + Defending errors - ± + improving
  12. Planned Mnj Features • Map/Reduce and Aggregation framework support •

    Object Document Mapping (different types in the same query) • Document linking/referencing • Redundant data in document references • Large documents (transparently split and merge docs>16MB) • Bucketing (transparently store series in a single document)
  13. How to help • Provide use cases for improving DSL

    https://pypi.python.org/pypi/mnj • Star and fork on Github https://github.com/lig/mnj • Implement and contribute features https://github.com/lig/mnj/issues • Join chat and ask questions on Gitter https://gitter.im/lig/mnj