MongoEngine

A Document-Object Mapper is like ORM, but for document databases.

It uses a simple declarative API, similar to the Django ORM.

What is new in this release:

• Allow strings to be used in index creation
• Fixed EmbeddedDoc weakref proxy issue
• Fixed nested reference field distinct error
• Fixed change tracking on nested MapFields
• Dynamic fields in embedded documents now visible to queryset.only() / qs.exclude()
• Add authentication_source option to register_connection
• Implemented equality between Documents and DBRefs
• Fixed ReferenceField inside nested ListFields dereferencing problem
• Added the ability to reload specific document fields
• Added db_alias support and fixes for custom map/reduce output
• post_save signal now has access to delta information about field changes
• Don't query with $orderby for qs.get()
• Fix id shard key save issue
• Fixes issue with recursive embedded document errors
• Fix clear_changed_fields() clearing unsaved documents bug
• Removing support for Django 1.4.x, pymongo 2.5.x, pymongo 2.6.x.
• Removing support for Python < 2.6.6
• Fixed $maxDistance location for geoJSON $near queries with MongoDB 2.6+
• QuerySet.modify() and Document.modify() methods to provide find_and_modify() like behaviour
• Added support for the using() method on a queryset
• PYPY support
• Connection pooling
• Avoid to open all documents from cursors in an if stmt
• Ability to clear the ordering
• Raise NotUniqueError in Document.update() on pymongo.errors.DuplicateKeyError
• Slots - memory improvements
• Fixed incorrectly split a query key when it ends with "_"
• Geo docs updates
• Workaround a dateutil bug
• Conditional save for atomic-style operations
• Allow dynamic dictionary-style field access
• Increase email field length to accommodate new TLDs
• index_cls is ignored when deciding to set _cls as index prefix
• Make ‘db' argument to connection optional
• Allow atomic update for the entire DictField
• Added MultiPointField, MultiLineField, MultiPolygonField
• Fix multiple connections aliases being rewritten
• Fixed a few instances where reverse_delete_rule was written as reverse_delete_rules.
• Make in_bulk() respect no_dereference()
• Handle None from model __str__;

What is new in version 0.6.20:

• Added support for distinct and db_alias.
• Improved support for chained querysets when constraining the same fields.
• Fixed BinaryField lookup re.

What is new in version 0.6.18:

• Fixed recursion loading bug in _get_changed_fields.

What is new in version 0.6.16:

• Fixed issue where db_alias wasn't inherited.

What is new in version 0.6.14:

• Fixed Int/Float fields and not equals None
• Exclude tests from installation
• Allow tuples for index meta
• Fixed use of str in instance checks
• Fixed unicode support in transform update
• Added support for add_to_set and each

What is new in version 0.6.13:

• Fixed EmbeddedDocument db_field validation issue.
• Fixed StringField unicode issue.
• Fixes __repr__ modifying the cursor.

What is new in version 0.6.9:

• Fixed sparse indexes on inherited docs.
• Removed FileField auto deletion, needs more work maybe 0.7.

What is new in version 0.6.8:

• Added support for pull operations on nested EmbeddedDocuments
• Added support for choices with GenericReferenceFields
• Added support for choices with GenericEmbeddedDocumentFields
• Fixed Django 1.4 sessions first save data loss
• FileField now automatically delete files on .delete()
• Fix for GenericReference to_mongo method
• Fixed connection regression
• Updated Django User document, now allows inheritance

What is new in version 0.6.7:

• Fixed indexing on ‘_id' or ‘pk' or ‘id'
• Invalid data from the DB now raises a InvalidDocumentError
• Cleaned up the Validation Error - docs and code
• Added meta auto_create_index so you can disable index creation
• Added write concern options to inserts
• Fixed typo in meta for index options
• Bug fix Read preference now passed correctly
• Added support for File like objects for GridFS

What is new in version 0.5:

• Updated item_frequencies to handle embedded document lookups
• Added delta tracking now only sets / unsets explicitly changed fields
• Fixed saving so sets updated values rather than overwrites
• Added ComplexDateTimeField - Handles datetimes correctly with microseconds
• Added ComplexBaseField - for improved flexibility and performance
• Added get_FIELD_display() method for easy choice field displaying
• Added queryset.slave_okay(enabled) method
• Updated queryset.timeout(enabled) and queryset.snapshot(enabled) to be chainable
• Added insert method for bulk inserts
• Added blinker signal support
• Added query_counter context manager for tests
• Added map_reduce method item_frequencies and set as default (as db.eval doesn't work in sharded environments)
• Added inline_map_reduce option to map_reduce
• Updated connection exception so it provides more info on the cause.
• Added searching multiple levels deep in DictField
• Added DictField entries containing strings to use matching operators
• Added MapField, similar to DictField
• Added Abstract Base Classes
• Added Custom Objects Managers
• Added sliced subfields updating
• Added NotRegistered exception if dereferencing Document not in the registry
• Added a write concern for save, update, update_one and get_or_create
• Added slicing / subarray fetching controls
• Fixed various unique index and other index issues
• Fixed threaded connection issues

What is new in version 0.4:

• Completely re-written Q-object implementation that no longer uses Javascript. A lengthier post on these will be coming soon, but basic point is that they should be a lot faster, more maintainable and less buggy as they now use native MongoDB queries.
• Support for GridFS through the FileField (docs).
• Geospatial querying support. This is implemented though the GeoPointField and the near, within_box and within_distance query operators (docs).
• New SortedListField and EmailField (docs).
• New QuerySet methods: distinct(), create(), snapshot(), timeout() and all().

Requirements:

• pymongo 2.7.1 or higher