docs: add docs for admin client (#63)

Closes #49
googleapis · Aug 11, 2020 · 43ff64a · 43ff64a
1 parent f6290c0
commit 43ff64a
Show file tree

Hide file tree

Showing 5 changed files with 19 additions and 7 deletions.
diff --git a/docs/admin_client.rst b/docs/admin_client.rst
@@ -0,0 +1,6 @@
+Datastore Admin Client
+======================
+
+.. automodule:: google.cloud.datastore_admin_v1.gapic.datastore_admin_client
+  :members:
+  :show-inheritance:
diff --git a/docs/index.rst b/docs/index.rst
@@ -13,6 +13,7 @@ API Reference
   transactions
   batches
   helpers
+  admin_client
 
 
 Changelog

diff --git a/google/cloud/datastore_admin_v1/gapic/datastore_admin_client.py b/google/cloud/datastore_admin_v1/gapic/datastore_admin_client.py
@@ -56,7 +56,6 @@ class DatastoreAdminClient(object):
 
     The Datastore Admin API provides several admin services for Cloud Datastore.
 
-    -----------------------------------------------------------------------------
     ## Concepts
 
     Project, namespace, kind, and entity as defined in the Google Cloud Datastore
@@ -68,7 +67,6 @@ class DatastoreAdminClient(object):
     specified as a combination of kinds and namespaces (either or both of which
     may be all).
 
-    -----------------------------------------------------------------------------
     ## Services
 
     # Export/Import

diff --git a/synth.metadata b/synth.metadata
@@ -3,23 +3,23 @@
     {
       "git": {
         "name": ".",
-        "remote": "https://github.com/googleapis/python-datastore.git",
-        "sha": "50ed94503da244434df0be58098a0ccf2da54b16"
+        "remote": "git@github.com:googleapis/python-datastore",
+        "sha": "f6290c02c46c83616a26aaa9babc43c3c6bed2f2"
       }
     },
     {
       "git": {
         "name": "googleapis",
         "remote": "https://github.com/googleapis/googleapis.git",
-        "sha": "bbe5f05ccb4ccb4a4dae92c558a25c6d3fe55842",
-        "internalRef": "321580134"
+        "sha": "94006b3cb8d2fb44703cf535da15608eed6bf7db",
+        "internalRef": "325949033"
       }
     },
     {
       "git": {
         "name": "synthtool",
         "remote": "https://github.com/googleapis/synthtool.git",
-        "sha": "bfcdbe0da977b2de6c1c0471bb6dc2f1e13bf669"
+        "sha": "bd0deaa1113b588d70449535ab9cbf0f2bd0e72f"
       }
     }
   ],

diff --git a/synth.py b/synth.py
@@ -55,6 +55,13 @@
     "google-cloud-datstore"
 )
 
+# Remove spurious markup
+s.replace(
+    "google/**/datastore_admin_client.py",
+    "-----------------------------------------------------------------------------",
+    ""
+)
+
 # TODO(busunkim): Remove during the microgenerator transition.
 # This re-orders the parameters to avoid breaking existing code.
 num = s.replace(