Changeset 3217

Timestamp:

06/27/06 15:36:25 (3 years ago)

Author:

jacob

Message:

Added Manager.create() method to create and save an object in a single step.

Files:

• django/trunk/django/db/models/manager.py (modified) (1 diff)
• django/trunk/django/db/models/query.py (modified) (1 diff)
• django/trunk/docs/db-api.txt (modified) (2 diffs)
• django/trunk/tests/modeltests/basic/models.py (modified) (1 diff)

django/trunk/django/db/models/manager.py

@@ -70 +70 @@
-        return self.get_query_set().get(*args, **kwargs)
-
-
-
+
+
+
+
+
-
-    def filter(self, *args, **kwargs):

django/trunk/django/db/models/query.py

@@ -205 +205 @@
-        assert len(obj_list) == 1, "get() returned more than one %s -- it returned %s! Lookup parameters were %s" % (self.model._meta.object_name, len(obj_list), kwargs)
-        return obj_list[0]
+        
+    def create(self, **kwargs):
+        """
+        Create a new object with the given kwargs, saving it to the database
+        and returning the created object.
+        """
+        obj = self.model(**kwargs)
+        obj.save()
+        return obj
-
-    def get_or_create(self, **kwargs):

django/trunk/docs/db-api.txt

@@ -60 +60 @@
-
-The ``save()`` method has no return value.
+
+To create an object and save it all in one step see the `create`__ method.
+
+__ `create(**kwargs)`_
-
-Auto-incrementing primary keys
@@ -706 +710 @@
-        print "Either the entry or blog doesn't exist."
-
+``create(**kwargs)``
+~~~~~~~~~~~~~~~~~~~~
+
+A convenience method for creating an object and saving it all in one step.  Thus::
+
+    p = Person.objects.create(first_name="Bruce", last_name="Springsteen")
+    
+and::
+
+    p = Person(first_name="Bruce", last_name="Springsteen")
+    p.save()
+    
+are equivalent.
+
-``get_or_create(**kwargs)``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~

django/trunk/tests/modeltests/basic/models.py

@@ -348 +348 @@
->>> a101.headline
-'Article 101'
-
+
+
+
+
+
+