docs: Fix formatting of request arg in docstring (#308)

* docs: Fix formatting of request arg in docstring chore: Update gapic-generator-python to v1.9.1 PiperOrigin-RevId: 518604533 Source-Link: googleapis/googleapis@8a085ae Source-Link: googleapis/googleapis-gen@b2ab4b0 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiYjJhYjRiMGEwYWUyOTA3ZTgxMmMyMDkxOThhNzRlMDg5OGFmY2IwNCJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
googleapis · Mar 23, 2023 · 838132e · 838132e
1 parent 9a5bf5d
commit 838132e
Show file tree

Hide file tree

Showing 8 changed files with 32 additions and 38 deletions.
diff --git a/google/cloud/trace_v1/services/trace_service/async_client.py b/google/cloud/trace_v1/services/trace_service/async_client.py
@@ -255,9 +255,8 @@ async def sample_list_traces():
 
         Args:
             request (Optional[Union[google.cloud.trace_v1.types.ListTracesRequest, dict]]):
-                The request object. The request message for the
-                `ListTraces` method. All fields are required unless
-                specified.
+                The request object. The request message for the ``ListTraces`` method. All
+                fields are required unless specified.
             project_id (:class:`str`):
                 Required. ID of the Cloud project
                 where the trace data is stored.
@@ -383,8 +382,7 @@ async def sample_get_trace():
 
         Args:
             request (Optional[Union[google.cloud.trace_v1.types.GetTraceRequest, dict]]):
-                The request object. The request message for the
-                `GetTrace` method.
+                The request object. The request message for the ``GetTrace`` method.
             project_id (:class:`str`):
                 Required. ID of the Cloud project
                 where the trace data is stored.
@@ -514,8 +512,7 @@ async def sample_patch_traces():
 
         Args:
             request (Optional[Union[google.cloud.trace_v1.types.PatchTracesRequest, dict]]):
-                The request object. The request message for the
-                `PatchTraces` method.
+                The request object. The request message for the ``PatchTraces`` method.
             project_id (:class:`str`):
                 Required. ID of the Cloud project
                 where the trace data is stored.

diff --git a/google/cloud/trace_v1/services/trace_service/client.py b/google/cloud/trace_v1/services/trace_service/client.py
@@ -466,9 +466,8 @@ def sample_list_traces():
 
         Args:
             request (Union[google.cloud.trace_v1.types.ListTracesRequest, dict]):
-                The request object. The request message for the
-                `ListTraces` method. All fields are required unless
-                specified.
+                The request object. The request message for the ``ListTraces`` method. All
+                fields are required unless specified.
             project_id (str):
                 Required. ID of the Cloud project
                 where the trace data is stored.
@@ -584,8 +583,7 @@ def sample_get_trace():
 
         Args:
             request (Union[google.cloud.trace_v1.types.GetTraceRequest, dict]):
-                The request object. The request message for the
-                `GetTrace` method.
+                The request object. The request message for the ``GetTrace`` method.
             project_id (str):
                 Required. ID of the Cloud project
                 where the trace data is stored.
@@ -705,8 +703,7 @@ def sample_patch_traces():
 
         Args:
             request (Union[google.cloud.trace_v1.types.PatchTracesRequest, dict]):
-                The request object. The request message for the
-                `PatchTraces` method.
+                The request object. The request message for the ``PatchTraces`` method.
             project_id (str):
                 Required. ID of the Cloud project
                 where the trace data is stored.

diff --git a/google/cloud/trace_v1/services/trace_service/transports/rest.py b/google/cloud/trace_v1/services/trace_service/transports/rest.py
@@ -362,7 +362,6 @@ def __call__(
                 request (~.trace.ListTracesRequest):
                     The request object. The request message for the ``ListTraces`` method. All
                 fields are required unless specified.
-
                 retry (google.api_core.retry.Retry): Designation of what errors, if any,
                     should be retried.
                 timeout (float): The timeout for this request.

diff --git a/google/cloud/trace_v2/services/trace_service/async_client.py b/google/cloud/trace_v2/services/trace_service/async_client.py
@@ -263,8 +263,7 @@ async def sample_batch_write_spans():
 
         Args:
             request (Optional[Union[google.cloud.trace_v2.types.BatchWriteSpansRequest, dict]]):
-                The request object. The request message for the
-                `BatchWriteSpans` method.
+                The request object. The request message for the ``BatchWriteSpans`` method.
             name (:class:`str`):
                 Required. The name of the project where the spans
                 belong. The format is ``projects/[PROJECT_ID]``.
@@ -378,14 +377,16 @@ async def sample_create_span():
         Args:
             request (Optional[Union[google.cloud.trace_v2.types.Span, dict]]):
                 The request object. A span represents a single operation
-                within a trace. Spans can be nested to form a trace
-                tree. Often, a trace contains a root span that describes
-                the end-to-end latency, and one or more subspans for its
-                sub-operations.
-
-                A trace can also contain multiple root spans, or none at
-                all. Spans do not need to be contiguous. There might be
-                gaps or overlaps between spans in a trace.
+                within a trace. Spans can be nested to
+                form a trace tree. Often, a trace
+                contains a root span that describes the
+                end-to-end latency, and one or more
+                subspans for its sub-operations.
+
+                A trace can also contain multiple root
+                spans, or none at all. Spans do not need
+                to be contiguous. There might be gaps or
+                overlaps between spans in a trace.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.

diff --git a/google/cloud/trace_v2/services/trace_service/client.py b/google/cloud/trace_v2/services/trace_service/client.py
@@ -494,8 +494,7 @@ def sample_batch_write_spans():
 
         Args:
             request (Union[google.cloud.trace_v2.types.BatchWriteSpansRequest, dict]):
-                The request object. The request message for the
-                `BatchWriteSpans` method.
+                The request object. The request message for the ``BatchWriteSpans`` method.
             name (str):
                 Required. The name of the project where the spans
                 belong. The format is ``projects/[PROJECT_ID]``.
@@ -599,14 +598,16 @@ def sample_create_span():
         Args:
             request (Union[google.cloud.trace_v2.types.Span, dict]):
                 The request object. A span represents a single operation
-                within a trace. Spans can be nested to form a trace
-                tree. Often, a trace contains a root span that describes
-                the end-to-end latency, and one or more subspans for its
-                sub-operations.
-
-                A trace can also contain multiple root spans, or none at
-                all. Spans do not need to be contiguous. There might be
-                gaps or overlaps between spans in a trace.
+                within a trace. Spans can be nested to
+                form a trace tree. Often, a trace
+                contains a root span that describes the
+                end-to-end latency, and one or more
+                subspans for its sub-operations.
+
+                A trace can also contain multiple root
+                spans, or none at all. Spans do not need
+                to be contiguous. There might be gaps or
+                overlaps between spans in a trace.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.

diff --git a/google/cloud/trace_v2/services/trace_service/transports/rest.py b/google/cloud/trace_v2/services/trace_service/transports/rest.py
@@ -339,7 +339,6 @@ def __call__(
                 spans, or none at all. Spans do not need
                 to be contiguous. There might be gaps or
                 overlaps between spans in a trace.
-
                 retry (google.api_core.retry.Retry): Designation of what errors, if any,
                     should be retried.
                 timeout (float): The timeout for this request.

diff --git a/samples/generated_samples/snippet_metadata_google.devtools.cloudtrace.v1.json b/samples/generated_samples/snippet_metadata_google.devtools.cloudtrace.v1.json
@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-trace",
-    "version": "1.11.0"
+    "version": "0.1.0"
   },
   "snippets": [
     {

diff --git a/samples/generated_samples/snippet_metadata_google.devtools.cloudtrace.v2.json b/samples/generated_samples/snippet_metadata_google.devtools.cloudtrace.v2.json
@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-trace",
-    "version": "1.11.0"
+    "version": "0.1.0"
   },
   "snippets": [
     {