Pick up stub docstring fix in GAPIC generator. (googleapis#6985)

yoshi-automation · tseaver · commit 2f20bc0c6947 · 2019-01-04T13:23:03.000-05:00
diff --git a/trace/google/cloud/trace_v1/gapic/enums.py b/trace/google/cloud/trace_v1/gapic/enums.py
@@ -18,25 +18,6 @@
 import enum
 
 
-class TraceSpan(object):
-    class SpanKind(enum.IntEnum):
-        """
-        Type of span. Can be used to specify additional relationships between spans
-        in addition to a parent/child relationship.
-
-        Attributes:
-          SPAN_KIND_UNSPECIFIED (int): Unspecified.
-          RPC_SERVER (int): Indicates that the span covers server-side handling of an RPC or other
-          remote network request.
-          RPC_CLIENT (int): Indicates that the span covers the client-side wrapper around an RPC or
-          other remote request.
-        """
-
-        SPAN_KIND_UNSPECIFIED = 0
-        RPC_SERVER = 1
-        RPC_CLIENT = 2
-
-
 class ListTracesRequest(object):
     class ViewType(enum.IntEnum):
         """
@@ -57,3 +38,22 @@ class ViewType(enum.IntEnum):
         MINIMAL = 1
         ROOTSPAN = 2
         COMPLETE = 3
+
+
+class TraceSpan(object):
+    class SpanKind(enum.IntEnum):
+        """
+        Type of span. Can be used to specify additional relationships between spans
+        in addition to a parent/child relationship.
+
+        Attributes:
+          SPAN_KIND_UNSPECIFIED (int): Unspecified.
+          RPC_SERVER (int): Indicates that the span covers server-side handling of an RPC or other
+          remote network request.
+          RPC_CLIENT (int): Indicates that the span covers the client-side wrapper around an RPC or
+          other remote request.
+        """
+
+        SPAN_KIND_UNSPECIFIED = 0
+        RPC_SERVER = 1
+        RPC_CLIENT = 2
diff --git a/trace/google/cloud/trace_v1/gapic/transports/trace_service_grpc_transport.py b/trace/google/cloud/trace_v1/gapic/transports/trace_service_grpc_transport.py
@@ -99,7 +99,7 @@ def channel(self):
 
     @property
     def patch_traces(self):
-        """Return the gRPC stub for {$apiMethod.name}.
+        """Return the gRPC stub for :meth:`TraceServiceClient.patch_traces`.
 
         Sends new traces to Stackdriver Trace or updates existing traces. If the ID
         of a trace that you send matches that of an existing trace, any fields
@@ -116,7 +116,7 @@ def patch_traces(self):
 
     @property
     def get_trace(self):
-        """Return the gRPC stub for {$apiMethod.name}.
+        """Return the gRPC stub for :meth:`TraceServiceClient.get_trace`.
 
         Gets a single trace by its ID.
 
@@ -129,7 +129,7 @@ def get_trace(self):
 
     @property
     def list_traces(self):
-        """Return the gRPC stub for {$apiMethod.name}.
+        """Return the gRPC stub for :meth:`TraceServiceClient.list_traces`.
 
         Returns of a list of traces that match the specified filter conditions.
 
diff --git a/trace/google/cloud/trace_v2/gapic/transports/trace_service_grpc_transport.py b/trace/google/cloud/trace_v2/gapic/transports/trace_service_grpc_transport.py
@@ -98,7 +98,7 @@ def channel(self):
 
     @property
     def batch_write_spans(self):
-        """Return the gRPC stub for {$apiMethod.name}.
+        """Return the gRPC stub for :meth:`TraceServiceClient.batch_write_spans`.
 
         Sends new spans to new or existing traces. You cannot update
         existing spans.
@@ -112,7 +112,7 @@ def batch_write_spans(self):
 
     @property
     def create_span(self):
-        """Return the gRPC stub for {$apiMethod.name}.
+        """Return the gRPC stub for :meth:`TraceServiceClient.create_span`.
 
         Creates a new span.
 
diff --git a/trace/synth.metadata b/trace/synth.metadata
@@ -1,19 +1,19 @@
 {
-  "updateTime": "2018-12-07T13:30:34.774710Z",
+  "updateTime": "2018-12-18T13:28:56.896085Z",
   "sources": [
     {
       "generator": {
         "name": "artman",
-        "version": "0.16.2",
-        "dockerImage": "googleapis/artman@sha256:2f6b261ee7fe1aedf238991c93a20b3820de37a343d0cacf3e3e9555c2aaf2ea"
+        "version": "0.16.3",
+        "dockerImage": "googleapis/artman@sha256:bfb92654b4a77368471f70e2808eaf4e60f263b9559f27bb3284097322787bf1"
       }
     },
     {
       "git": {
         "name": "googleapis",
         "remote": "https://github.com/googleapis/googleapis.git",
-        "sha": "200fbbe59cc7b0077ae525eb5f3d6420c0c53e61",
-        "internalRef": "224174014"
+        "sha": "c04bc0dc0a9164d924a9ab923fd6845b4ae6a7ab",
+        "internalRef": "225851467"
       }
     },
     {

Original file line number	Diff line number	Diff line change
`@@ -1,19 +1,19 @@`
`1`	`1`	`{`
`2`		`- "updateTime": "2018-12-07T13:30:34.774710Z",`
	`2`	`+ "updateTime": "2018-12-18T13:28:56.896085Z",`
`3`	`3`	`"sources": [`
`4`	`4`	`{`
`5`	`5`	`"generator": {`
`6`	`6`	`"name": "artman",`
`7`		`- "version": "0.16.2",`
`8`		`- "dockerImage": "googleapis/artman@sha256:2f6b261ee7fe1aedf238991c93a20b3820de37a343d0cacf3e3e9555c2aaf2ea"`
	`7`	`+ "version": "0.16.3",`
	`8`	`+ "dockerImage": "googleapis/artman@sha256:bfb92654b4a77368471f70e2808eaf4e60f263b9559f27bb3284097322787bf1"`
`9`	`9`	`}`
`10`	`10`	`},`
`11`	`11`	`{`
`12`	`12`	`"git": {`
`13`	`13`	`"name": "googleapis",`
`14`	`14`	`"remote": "https://github.com/googleapis/googleapis.git",`
`15`		`- "sha": "200fbbe59cc7b0077ae525eb5f3d6420c0c53e61",`
`16`		`- "internalRef": "224174014"`
	`15`	`+ "sha": "c04bc0dc0a9164d924a9ab923fd6845b4ae6a7ab",`
	`16`	`+ "internalRef": "225851467"`
`17`	`17`	`}`
`18`	`18`	`},`
`19`	`19`	`{`