DOCSP-46321: CRUD operations

Author: norareidy

snooty.toml

@@ -14,3 +14,4 @@ api = "https://django-mongodb.readthedocs.io/en/latest/"
 mdb-server = "MongoDB Server"
 django-version = "5.0"
 django-docs = "https://docs.djangoproject.com/en/{+django-version+}"
+framework = "Django"

source/includes/interact-data/crud.py

@@ -0,0 +1,45 @@
+# start-models
+from django.db import models
+from django_mongodb_backend.fields import ArrayField
+
+class Movie(models.Model):
+    title = models.CharField(max_length=200)
+    plot = models.TextField(blank=True)
+    runtime = models.IntegerField(default=0)
+    released = models.DateTimeField("release date", null=True, blank=True)
+    genres = ArrayField(models.CharField(max_length=100), null=True, blank=True)
+
+    class Meta:
+        db_table = "movies"
+        managed = False
+    
+    def __str__(self):
+        return self.title
+# end-models
+
+# start-insert
+Movie.objects.create(title="Poor Things", runtime=141)
+# end-insert
+
+# start-save
+movie = Movie(title="Poor Things", runtime=141)
+movie.save()
+# end-save
+
+# start-find-many
+Movie.objects.filter(released=timezone.make_aware(datetime(2000, 1, 1)))
+# end-find-many
+
+# start-find-one
+Movie.objects.get(title="Boyhood")
+# end-find-one
+
+# start-update
+Movie.objects.filter(
+    title="High Fidelity").update(
+    plot="Rob, a record store owner, recounts his top five breakups,including the one in progress.")
+# end-update
+
+# start-delete
+Movie.objects.filter(runtime=5).delete()
+# end-delete

source/index.txt

@@ -11,14 +11,14 @@ Django MongoDB Backend
 
 .. toctree::
 
-    Issues & Help </issues-and-help>
-    Compatibility </compatibility>
+   Interact with Data </interact-data>
+   Issues & Help </issues-and-help>
+   Compatibility </compatibility>
 
 
 .. TODO:
    Get Started </get-started>
    Connection Configuration </connect>
-   Interact with Data </interact-data>
    Model Your Data </model-data>
    Django Feature Limitations </feature-limitations>
    API Documentation <{+api+}>
@@ -43,11 +43,11 @@ a Django database backend that uses PyMongo to connect to MongoDB.
 .. Learn how to configure a connection to a MongoDB deployment
    in the :ref:`django-connection-configuration` section.
 
-.. Interact with Data
-.. ------------------
+Interact with Data
+------------------
 
-.. Learn how to use {+django-odm+} to perform operations on MongoDB data
-   in the :ref:`django-interact-data` section.
+Learn how to use {+django-odm+} to perform operations on MongoDB data
+in the :ref:`django-interact-data` section.
 
 .. Model Your Data
 .. ---------------

source/interact-data.txt

@@ -0,0 +1,17 @@
+.. _django-interact-data:
+
+==================
+Interact with Data
+==================
+
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta::
+   :keywords: odm, crud, query
+
+.. toctree::
+   :caption: Interact with Data
+
+   CRUD Operations </interact-data/crud>