From 13316e5380f9886b0d8c65458096311b8382233a Mon Sep 17 00:00:00 2001
From: flosch <flori@n-schlachter.de>
Date: Sun, 25 Jul 2010 17:35:09 +0200
Subject: [PATCH] Introduced new Document.objects.create, like django has. It
 creates a new object, saves it and returns the new object instance.

---
 mongoengine/queryset.py | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/mongoengine/queryset.py b/mongoengine/queryset.py
index 1e42cd1d..e176c54c 100644
--- a/mongoengine/queryset.py
+++ b/mongoengine/queryset.py
@@ -1,5 +1,6 @@
 from connection import _get_db
 
+import pprint
 import pymongo
 import re
 import copy
@@ -414,6 +415,14 @@ class QuerySet(object):
             message = u'%d items returned, instead of 1' % count
             raise self._document.MultipleObjectsReturned(message)
 
+    def create(self, **kwargs):
+        """Create new object. Returns the saved object instance.
+        .. versionadded:: 0.4
+        """
+        doc = self._document(**kwargs)
+        doc.save()
+        return doc
+
     def first(self):
         """Retrieve the first object matching the query.
         """
@@ -667,7 +676,6 @@ class QuerySet(object):
 
         plan = self._cursor.explain()
         if format:
-            import pprint
             plan = pprint.pformat(plan)
         return plan