chore: update docstring formatting; update templates (via synth)

google/cloud/trace_v1/gapic/enums.py

@@ -30,8 +30,8 @@ class ViewType(enum.IntEnum):
           and trace IDs.
           ROOTSPAN (int): Root span view of the trace record that returns the root spans along
           with the minimal trace data.
-          COMPLETE (int): Complete view of the trace record that contains the actual trace data.
-          This is equivalent to calling the REST ``get`` or RPC ``GetTrace``
+          COMPLETE (int): Complete view of the trace record that contains the actual trace
+          data. This is equivalent to calling the REST ``get`` or RPC ``GetTrace``
           method using the ID of each listed trace.
         """
 

google/cloud/trace_v1/proto/trace_pb2_grpc.py

@@ -2,7 +2,7 @@
 import grpc
 
 from google.cloud.trace_v1.proto import (
-    trace_pb2 as google_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2,
+    trace_pb2 as google_dot_cloud_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2,
 )
 from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
 
@@ -23,17 +23,17 @@ def __init__(self, channel):
     """
         self.ListTraces = channel.unary_unary(
             "/google.devtools.cloudtrace.v1.TraceService/ListTraces",
-            request_serializer=google_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.ListTracesRequest.SerializeToString,
-            response_deserializer=google_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.ListTracesResponse.FromString,
+            request_serializer=google_dot_cloud_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.ListTracesRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.ListTracesResponse.FromString,
         )
         self.GetTrace = channel.unary_unary(
             "/google.devtools.cloudtrace.v1.TraceService/GetTrace",
-            request_serializer=google_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.GetTraceRequest.SerializeToString,
-            response_deserializer=google_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.Trace.FromString,
+            request_serializer=google_dot_cloud_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.GetTraceRequest.SerializeToString,
+            response_deserializer=google_dot_cloud_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.Trace.FromString,
         )
         self.PatchTraces = channel.unary_unary(
             "/google.devtools.cloudtrace.v1.TraceService/PatchTraces",
-            request_serializer=google_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.PatchTracesRequest.SerializeToString,
+            request_serializer=google_dot_cloud_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.PatchTracesRequest.SerializeToString,
             response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
         )
 
@@ -76,17 +76,17 @@ def add_TraceServiceServicer_to_server(servicer, server):
     rpc_method_handlers = {
         "ListTraces": grpc.unary_unary_rpc_method_handler(
             servicer.ListTraces,
-            request_deserializer=google_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.ListTracesRequest.FromString,
-            response_serializer=google_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.ListTracesResponse.SerializeToString,
+            request_deserializer=google_dot_cloud_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.ListTracesRequest.FromString,
+            response_serializer=google_dot_cloud_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.ListTracesResponse.SerializeToString,
         ),
         "GetTrace": grpc.unary_unary_rpc_method_handler(
             servicer.GetTrace,
-            request_deserializer=google_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.GetTraceRequest.FromString,
-            response_serializer=google_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.Trace.SerializeToString,
+            request_deserializer=google_dot_cloud_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.GetTraceRequest.FromString,
+            response_serializer=google_dot_cloud_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.Trace.SerializeToString,
         ),
         "PatchTraces": grpc.unary_unary_rpc_method_handler(
             servicer.PatchTraces,
-            request_deserializer=google_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.PatchTracesRequest.FromString,
+            request_deserializer=google_dot_cloud_dot_devtools_dot_cloudtrace__v1_dot_proto_dot_trace__pb2.PatchTracesRequest.FromString,
             response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
         ),
     }

google/cloud/trace_v2/gapic/trace_service_client.py

@@ -235,8 +235,8 @@ def batch_write_spans(
             >>> client.batch_write_spans(name, spans)
 
         Args:
-            name (str): Required. The name of the project where the spans belong. The format is
-                ``projects/[PROJECT_ID]``.
+            name (str): Required. The name of the project where the spans belong. The format
+                is ``projects/[PROJECT_ID]``.
             spans (list[Union[dict, ~google.cloud.trace_v2.types.Span]]): Required. A list of new spans. The span names must not match existing
                 spans, or the results are undefined.
 
@@ -335,14 +335,14 @@ def create_span(
 
                 ::
 
-                     projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]
+                    projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]
 
-                [TRACE\_ID] is a unique identifier for a trace within a project; it is a
+                [TRACE_ID] is a unique identifier for a trace within a project; it is a
                 32-character hexadecimal encoding of a 16-byte array.
 
-                [SPAN\_ID] is a unique identifier for a span within a trace; it is a
+                [SPAN_ID] is a unique identifier for a span within a trace; it is a
                 16-character hexadecimal encoding of an 8-byte array.
-            span_id (str): The [SPAN\_ID] portion of the span's resource name.
+            span_id (str): The [SPAN_ID] portion of the span's resource name.
             display_name (Union[dict, ~google.cloud.trace_v2.types.TruncatableString]): A description of the span's operation (up to 128 bytes).
                 Stackdriver Trace displays the description in the
                 Google Cloud Platform Console.
@@ -365,8 +365,8 @@ def create_span(
 
                 If a dict is provided, it must be of the same form as the protobuf
                 message :class:`~google.cloud.trace_v2.types.Timestamp`
-            parent_span_id (str): The [SPAN\_ID] of this span's parent span. If this is a root span, then
-                this field must be empty.
+            parent_span_id (str): The [SPAN_ID] of this span's parent span. If this is a root span,
+                then this field must be empty.
             attributes (Union[dict, ~google.cloud.trace_v2.types.Attributes]): A set of attributes on the span. You can have up to 32 attributes per
                 span.