docs(firestore): add CRUD operation guide

Author: AsifArmanRahman

docs/guide/firebase-rest-api.rst

@@ -126,6 +126,8 @@ A Firebase app can use multiple Firebase services.
 
 ``firebaseApp.database()`` - :ref:`Database<guide/database:Database>`
 
+``firebaseApp.firestore()`` - :ref:`Firestore<guide/firestore:Firestore>`
+
 ``firebaseApp.storage()`` - :ref:`Storage<guide/storage:Storage>`
 
 Check out the documentation for each service for further details.

docs/guide/firestore.rst

@@ -0,0 +1,128 @@
+Firestore
+=========
+
+The firestore service allows you to run CRUD operations to your Firebase Firestore
+Database.
+
+.. code-block:: python
+
+   # Create database instance
+   fsdb = firebaseApp.firestore()
+..
+
+   .. note::
+      Each of the following methods accepts a user token:
+      :ref:`get()<guide/firestore:get>`, :ref:`set()<guide/firestore:set>`,
+      :ref:`update()<guide/firestore:update>`, and
+      :ref:`delete()<guide/firestore:delete>`.
+
+
+Build Path
+----------
+
+You can build paths to your data by using the ``collection()`` and ``document()`` method.
+
+.. code-block:: python
+
+   fsdb.collection('Marvels').document('Movies')
+   fsdb.collection('Marvels').document('Movies').collection('PhaseOne').document('2008')
+
+..
+
+Save Data
+---------
+
+set
+^^^
+
+To store data in a collection named ``Marvels`` and a document inside
+the collection named ``Movies``, use  ``set()`` method.
+
+.. code-block:: python
+
+   data = {
+      "name": "Iron Man",
+      "lead": {
+         "name": "Robert Downey Jr."
+      },
+      'released': False,
+   }
+
+   fsdb.collection('Marvels').document('Movies').set(data)
+..
+
+   .. attention::
+      Using this method on an existing document will overwrite the existing
+      document.
+
+
+Read Data
+---------
+
+get
+^^^
+
+To read data from an existing document of an collection, use ``get()`` method.
+
+.. code-block:: python
+
+   fsdb.collection('Marvels').document('Movies').get()
+..
+
+It is possible to filter the data of an document to receive specific fields.
+
+.. code-block:: python
+
+   fsdb.collection('Marvels').document('Movies').get(field_paths=['lead.name', 'released'])
+
+   # Output:
+   # {'lead': {'name': "Robert Downey Jr."}, 'released': False}
+..
+
+
+
+Update Data
+-----------
+
+update
+^^^^^^
+
+To update existing data or add more data to an existing document, use
+``update()`` method.
+
+.. code-block:: python
+
+   # add new data to an existing document
+
+   data = {
+      'year': 2008,
+   }
+
+   fsdb.collection('Marvels').document('Movies').update(data)
+..
+
+.. code-block:: python
+
+   # update data of an existing document
+
+   data = {
+      'released': True,
+   }
+
+   fsdb.collection('Marvels').document('Movies').update(data)
+..
+
+
+Delete Data
+-----------
+
+delete
+^^^^^^
+
+To remove an existing document in a collection, use ``delete()``
+method.
+
+.. code-block:: python
+
+   fsdb.collection('Marvels').document('Movies').delete()
+..

docs/index.rst

@@ -103,6 +103,7 @@ Documentation contents
    guide/firebase-rest-api
    guide/authentication
    guide/database
+   guide/firestore
    guide/storage
 
 .. toctree::