wip

Author: mongoKart

source/crud.txt

@@ -22,15 +22,14 @@ CRUD Operations
    :titlesonly:
    :maxdepth: 1
 
-   Insert Documents </insert>
-   Query Documents </query>
-   Update Documents </update>
-   Delete Documents </delete>
-   Bulk Write Operations </bulk-write>
-   Transactions </transactions>
-   Configure CRUD Operations </configure>
-   Store Large Files </gridfs>
-   Geospatial Queries </geospatial>
+   Insert Documents </crud/insert>
+   Query Documents </crud/query>
+   Update Documents </crud/update>
+   Delete Documents </crud/delete>
+   Bulk Write Operations </crud/bulk-write>
+   Transactions </crud/transactions>
+   Configure CRUD Operations </crud/configure>
+   Store Large Files </crud/gridfs>
 
 Overview
 --------
@@ -44,16 +43,184 @@ to MongoDB with various settings.
   provided in each section.
 
 To use a connection example from this page, copy the code example into the
-:ref:`sample application <pymongo-connect-sample>` or your own application.
+:ref:`sample application <pymongo-crud-sample>` or your own application.
 Be sure to replace all placeholders in the code examples, such as ``<hostname>``, with
 the relevant values for your MongoDB deployment.
 
-.. _pymongo-connect-sample:
+.. _pymongo-crud-sample:
 
 .. include:: /includes/usage-examples/sample-app-intro.rst
 
-.. literalinclude:: /includes/usage-examples/connect-sample-app.py
+.. literalinclude:: /includes/usage-examples/crud-sample-app.py
    :language: python
    :copyable: true
    :linenos:
-   :emphasize-lines: 4-6
+   :emphasize-lines: 4-6
+
+Insert One
+----------
+
+.. literalinclude:: /includes/usage-examples/write-code-examples.py
+   :start-after: start-insert-one
+   :end-before: end-insert-one
+   :language: python
+   :copyable:
+
+To learn more about the ``insert_one()`` method, see the :ref:`Insert Documents
+<pymongo-write-insert>` guide.
+
+Insert Multiple
+---------------
+
+.. literalinclude:: /includes/usage-examples/write-code-examples.py
+   :start-after: start-insert-multiple
+   :end-before: end-insert-multiple
+   :language: python
+   :copyable:
+
+To learn more about the ``insert_many()`` method, see the :ref:`Insert Documents
+<pymongo-write-insert>` guide.
+
+Update One
+----------
+
+.. literalinclude:: /includes/usage-examples/write-code-examples.py
+   :start-after: start-update-one
+   :end-before: end-update-one
+   :language: python
+   :copyable:
+
+To learn more about the ``update_one()`` method, see the
+:ref:`Update Documents <pymongo-write-update>` guide.
+
+Update Multiple
+---------------
+
+.. literalinclude:: /includes/usage-examples/write-code-examples.py
+   :start-after: start-update-multiple
+   :end-before: end-update-multiple
+   :language: python
+   :copyable:
+
+To learn more about the ``update_many()`` method, see the
+:ref:`Update Documents <pymongo-write-update>` guide.
+
+Replace One
+-----------
+
+.. literalinclude:: /includes/usage-examples/write-code-examples.py
+   :start-after: start-replace-one
+   :end-before: end-replace-one
+   :language: python
+   :copyable:
+
+To learn more about the ``replace_one()`` method, see the
+:ref:`Replace Documents <pymongo-write-replace>` guide.
+
+Delete One
+----------
+
+.. literalinclude:: /includes/usage-examples/write-code-examples.py
+   :start-after: start-delete-one
+   :end-before: end-delete-one
+   :language: python
+   :copyable:
+
+To learn more about the ``delete_one()`` method, see the
+:ref:`Delete Documents <pymongo-write-delete>` guide.
+
+Delete Multiple
+---------------
+
+.. literalinclude:: /includes/usage-examples/write-code-examples.py
+   :start-after: start-delete-multiple
+   :end-before: end-delete-multiple
+   :language: python
+   :copyable:
+
+To learn more about the ``delete_many()`` method, see the
+:ref:`Delete Documents <pymongo-write-delete>` guide.
+
+Bulk Write
+----------
+
+.. literalinclude:: /includes/usage-examples/write-code-examples.py
+   :start-after: start-bulk-write
+   :end-before: end-bulk-write
+   :language: python
+   :copyable:
+
+To learn more about the ``bulk_write()`` method, see the
+:ref:`Bulk Write <pymongo-bulk-write>` guide.
+
+Find One
+--------
+
+.. literalinclude:: /includes/usage-examples/retrieve-code-examples.py
+   :start-after: start-find-one
+   :end-before: end-find-one
+   :language: python
+   :copyable:
+
+To learn more about the ``find_one()`` method, see :ref:`pymongo-retrieve-find-one` in
+the Retrieve Data guide.
+
+Find Multiple
+-------------
+
+.. literalinclude:: /includes/usage-examples/retrieve-code-examples.py
+   :start-after: start-find
+   :end-before: end-find
+   :language: python
+   :copyable:
+
+To learn more about the ``find()`` method, see :ref:`pymongo-retrieve-find-multiple` in
+the Retrieve Data guide.
+
+Count Documents in a Collection
+-------------------------------
+
+.. literalinclude:: /includes/usage-examples/retrieve-code-examples.py
+   :start-after: start-count-all
+   :end-before: end-count-all
+   :language: python
+   :copyable:
+
+To learn more about the ``count_documents()`` method, see the
+:ref:`pymongo-accurate-count` guide.
+
+Count Documents Returned from a Query
+-------------------------------------
+
+.. literalinclude:: /includes/usage-examples/retrieve-code-examples.py
+   :start-after: start-count-query
+   :end-before: end-count-query
+   :language: python
+   :copyable:
+
+To learn more about the ``count_documents()`` method, see the
+:ref:`pymongo-accurate-count` guide.
+
+Estimated Document Count
+------------------------
+
+.. literalinclude:: /includes/usage-examples/retrieve-code-examples.py
+   :start-after: start-estimated-count
+   :end-before: end-estimated-count
+   :language: python
+   :copyable:
+
+To learn more about the ``estimated_document_count()`` method, see the
+:ref:`pymongo-estimated-count` guide.
+
+Retrieve Distinct Values
+------------------------
+
+.. literalinclude:: /includes/usage-examples/retrieve-code-examples.py
+   :start-after: start-distinct
+   :end-before: end-distinct
+   :language: python
+   :copyable:
+
+To learn more about the ``distinct()`` method, see the
+:ref:`pymongo-distinct` guide.