Translate: Add nox session docs, reorder methods (via synth). (#7785)

yoshi-automation · busunkim96 · commit 09dbed86421e · 2019-04-30T14:05:12.000-07:00
diff --git a/packages/google-cloud-translate/google/cloud/translate_v3beta1/gapic/translation_service_client.py b/packages/google-cloud-translate/google/cloud/translate_v3beta1/gapic/translation_service_client.py
@@ -76,22 +76,22 @@ def from_service_account_file(cls, filename, *args, **kwargs):
     from_service_account_json = from_service_account_file
 
     @classmethod
-    def location_path(cls, project, location):
-        """Return a fully-qualified location string."""
+    def glossary_path(cls, project, location, glossary):
+        """Return a fully-qualified glossary string."""
         return google.api_core.path_template.expand(
-            "projects/{project}/locations/{location}",
+            "projects/{project}/locations/{location}/glossaries/{glossary}",
             project=project,
             location=location,
+            glossary=glossary,
         )
 
     @classmethod
-    def glossary_path(cls, project, location, glossary):
-        """Return a fully-qualified glossary string."""
+    def location_path(cls, project, location):
+        """Return a fully-qualified location string."""
         return google.api_core.path_template.expand(
-            "projects/{project}/locations/{location}/glossaries/{glossary}",
+            "projects/{project}/locations/{location}",
             project=project,
             location=location,
-            glossary=glossary,
         )
 
     def __init__(
diff --git a/packages/google-cloud-translate/noxfile.py b/packages/google-cloud-translate/noxfile.py
@@ -140,12 +140,12 @@ def cover(session):
 
     session.run("coverage", "erase")
 
-@nox.session(python='3.6')
+@nox.session(python="3.7")
 def docs(session):
-    """Build the docs."""
+    """Build the docs for this library."""
 
-    session.install('sphinx', 'alabaster', 'recommonmark')
     session.install('-e', '.')
+    session.install('sphinx', 'alabaster', 'recommonmark')
 
     shutil.rmtree(os.path.join('docs', '_build'), ignore_errors=True)
     session.run(
diff --git a/packages/google-cloud-translate/synth.metadata b/packages/google-cloud-translate/synth.metadata
@@ -1,26 +1,26 @@
 {
-  "updateTime": "2019-04-08T22:42:12.391231Z",
+  "updateTime": "2019-04-23T12:32:43.079835Z",
   "sources": [
     {
       "generator": {
         "name": "artman",
-        "version": "0.16.25",
-        "dockerImage": "googleapis/artman@sha256:d9597f983d1d4e61272c63cb97b7d8f8234da9999526c35d357de3d781f0ec1b"
+        "version": "0.17.0",
+        "dockerImage": "googleapis/artman@sha256:c58f4ec3838eb4e0718eb1bccc6512bd6850feaa85a360a9e38f6f848ec73bc2"
       }
     },
     {
       "git": {
         "name": "googleapis",
-        "remote": "git@github.com:googleapis/googleapis.git",
-        "sha": "9a02c5acecb43f38fae4fa52c6420f21c335b888",
-        "internalRef": "242170119"
+        "remote": "https://github.com/googleapis/googleapis.git",
+        "sha": "547e19e7df398e9290e8e3674d7351efc500f9b0",
+        "internalRef": "244712781"
       }
     },
     {
       "template": {
         "name": "python_library",
         "origin": "synthtool.gcp",
-        "version": "2019.2.26"
+        "version": "2019.4.10"
       }
     }
   ],
diff --git a/packages/google-cloud-translate/synth.py b/packages/google-cloud-translate/synth.py
@@ -38,6 +38,7 @@
     s.move(library / f'google/cloud/translate_{version}', excludes=excludes)
     s.move(library / 'tests')
     s.move(library / f"docs/gapic/{version}")
+    s.move(library / "docs/conf.py")
 
 # translation -> translate
 s.replace(

Original file line number	Diff line number	Diff line change
`@@ -1,26 +1,26 @@`
`1`	`1`	`{`
`2`		`- "updateTime": "2019-04-08T22:42:12.391231Z",`
	`2`	`+ "updateTime": "2019-04-23T12:32:43.079835Z",`
`3`	`3`	`"sources": [`
`4`	`4`	`{`
`5`	`5`	`"generator": {`
`6`	`6`	`"name": "artman",`
`7`		`- "version": "0.16.25",`
`8`		`- "dockerImage": "googleapis/artman@sha256:d9597f983d1d4e61272c63cb97b7d8f8234da9999526c35d357de3d781f0ec1b"`
	`7`	`+ "version": "0.17.0",`
	`8`	`+ "dockerImage": "googleapis/artman@sha256:c58f4ec3838eb4e0718eb1bccc6512bd6850feaa85a360a9e38f6f848ec73bc2"`
`9`	`9`	`}`
`10`	`10`	`},`
`11`	`11`	`{`
`12`	`12`	`"git": {`
`13`	`13`	`"name": "googleapis",`
`14`		`- "remote": "git@github.com:googleapis/googleapis.git",`
`15`		`- "sha": "9a02c5acecb43f38fae4fa52c6420f21c335b888",`
`16`		`- "internalRef": "242170119"`
	`14`	`+ "remote": "https://github.com/googleapis/googleapis.git",`
	`15`	`+ "sha": "547e19e7df398e9290e8e3674d7351efc500f9b0",`
	`16`	`+ "internalRef": "244712781"`
`17`	`17`	`}`
`18`	`18`	`},`
`19`	`19`	`{`
`20`	`20`	`"template": {`
`21`	`21`	`"name": "python_library",`
`22`	`22`	`"origin": "synthtool.gcp",`
`23`		`- "version": "2019.2.26"`
	`23`	`+ "version": "2019.4.10"`
`24`	`24`	`}`
`25`	`25`	`}`
`26`	`26`	`],`