chore: discovery docs diff with generator perf

Author: ohmayr

.librarian/generate-request.json

@@ -0,0 +1,32 @@
+{
+  "id": "google-cloud-discoveryengine",
+  "version": "0.4.0",
+  "apis": [
+    {
+      "path": "google/cloud/discoveryengine/v1",
+      "service_config": "discoveryengine_v1.yaml"
+    },
+    {
+      "path": "google/cloud/discoveryengine/v1beta",
+      "service_config": "discoveryengine_v1beta.yaml"
+    },
+    {
+      "path": "google/cloud/discoveryengine/v1alpha",
+      "service_config": "discoveryengine_v1alpha.yaml"
+    }
+  ],
+  "source_roots": [
+    "packages/google-cloud-discoveryengine"
+  ],
+  "preserve_regex": [
+    "packages/google-cloud-discoveryengine/CHANGELOG.md",
+    "docs/CHANGELOG.md",
+    "samples/README.txt",
+    "samples/snippets/README.rst",
+    "tests/system"
+  ],
+  "remove_regex": [
+    "packages/google-cloud-discoveryengine/"
+  ],
+  "tag_format": "{id}-v{version}"
+}

packages/google-cloud-discoveryengine/google/cloud/discoveryengine/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "0.16.0"  # {x-release-please-version}
+__version__ = "0.4.0"  # {x-release-please-version}

packages/google-cloud-discoveryengine/google/cloud/discoveryengine_v1/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "0.16.0"  # {x-release-please-version}
+__version__ = "0.4.0"  # {x-release-please-version}

packages/google-cloud-discoveryengine/google/cloud/discoveryengine_v1/services/assistant_service/async_client.py

@@ -345,7 +345,8 @@ async def sample_stream_assist():
         Args:
             request (Optional[Union[google.cloud.discoveryengine_v1.types.StreamAssistRequest, dict]]):
                 The request object. Request for the
-                [AssistantService.StreamAssist][google.cloud.discoveryengine.v1.AssistantService.StreamAssist]
+                `AssistantService.StreamAssist
+                <google.cloud.discoveryengine.v1.AssistantService.StreamAssist>`__
                 method.
             retry (google.api_core.retry_async.AsyncRetry): Designation of what errors, if any,
                 should be retried.
@@ -358,8 +359,9 @@ async def sample_stream_assist():
         Returns:
             AsyncIterable[google.cloud.discoveryengine_v1.types.StreamAssistResponse]:
                 Response for the
-                   [AssistantService.StreamAssist][google.cloud.discoveryengine.v1.AssistantService.StreamAssist]
-                   method.
+                `AssistantService.StreamAssist
+                <google.cloud.discoveryengine.v1.AssistantService.StreamAssist>`__
+                method.
 
         """
         # Create or coerce a protobuf request object.

packages/google-cloud-discoveryengine/google/cloud/discoveryengine_v1/services/assistant_service/client.py

@@ -880,7 +880,8 @@ def sample_stream_assist():
         Args:
             request (Union[google.cloud.discoveryengine_v1.types.StreamAssistRequest, dict]):
                 The request object. Request for the
-                [AssistantService.StreamAssist][google.cloud.discoveryengine.v1.AssistantService.StreamAssist]
+                `AssistantService.StreamAssist
+                <google.cloud.discoveryengine.v1.AssistantService.StreamAssist>`__
                 method.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
@@ -893,8 +894,9 @@ def sample_stream_assist():
         Returns:
             Iterable[google.cloud.discoveryengine_v1.types.StreamAssistResponse]:
                 Response for the
-                   [AssistantService.StreamAssist][google.cloud.discoveryengine.v1.AssistantService.StreamAssist]
-                   method.
+                `AssistantService.StreamAssist
+                <google.cloud.discoveryengine.v1.AssistantService.StreamAssist>`__
+                method.
 
         """
         # Create or coerce a protobuf request object.

packages/google-cloud-discoveryengine/google/cloud/discoveryengine_v1/services/assistant_service/transports/base.py

@@ -84,8 +84,6 @@ def __init__(
                 be used for service account credentials.
         """
 
-        scopes_kwargs = {"scopes": scopes, "default_scopes": self.AUTH_SCOPES}
-
         # Save the scopes.
         self._scopes = scopes
         if not hasattr(self, "_ignore_credentials"):
@@ -100,11 +98,16 @@ def __init__(
 
         if credentials_file is not None:
             credentials, _ = google.auth.load_credentials_from_file(
-                credentials_file, **scopes_kwargs, quota_project_id=quota_project_id
+                credentials_file,
+                scopes=scopes,
+                quota_project_id=quota_project_id,
+                default_scopes=self.AUTH_SCOPES,
             )
         elif credentials is None and not self._ignore_credentials:
             credentials, _ = google.auth.default(
-                **scopes_kwargs, quota_project_id=quota_project_id
+                scopes=scopes,
+                quota_project_id=quota_project_id,
+                default_scopes=self.AUTH_SCOPES,
             )
             # Don't apply audience if the credentials file passed from user.
             if hasattr(credentials, "with_gdch_audience"):

packages/google-cloud-discoveryengine/google/cloud/discoveryengine_v1/services/assistant_service/transports/rest.py

@@ -343,7 +343,8 @@ def __call__(
             Args:
                 request (~.assistant_service.StreamAssistRequest):
                     The request object. Request for the
-                [AssistantService.StreamAssist][google.cloud.discoveryengine.v1.AssistantService.StreamAssist]
+                `AssistantService.StreamAssist
+                <google.cloud.discoveryengine.v1.AssistantService.StreamAssist>`__
                 method.
                 retry (google.api_core.retry.Retry): Designation of what errors, if any,
                     should be retried.
@@ -356,7 +357,8 @@ def __call__(
             Returns:
                 ~.assistant_service.StreamAssistResponse:
                     Response for the
-                [AssistantService.StreamAssist][google.cloud.discoveryengine.v1.AssistantService.StreamAssist]
+                `AssistantService.StreamAssist
+                <google.cloud.discoveryengine.v1.AssistantService.StreamAssist>`__
                 method.
 
             """

packages/google-cloud-discoveryengine/google/cloud/discoveryengine_v1/services/cmek_config_service/async_client.py

@@ -379,12 +379,13 @@ async def sample_update_cmek_config():
 
         Returns:
             google.api_core.operation_async.AsyncOperation:
-                An object representing a long-running operation.
-
-                The result type for the operation will be
+                An object representing a long-running
+                operation.
+                The result type for the operation will
+                be
                 :class:`google.cloud.discoveryengine_v1.types.CmekConfig`
-                Configurations used to enable CMEK data encryption with
-                Cloud KMS keys.
+                Configurations used to enable CMEK data
+                encryption with Cloud KMS keys.
 
         """
         # Create or coerce a protobuf request object.
@@ -455,8 +456,8 @@ async def get_cmek_config(
         timeout: Union[float, object] = gapic_v1.method.DEFAULT,
         metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
     ) -> cmek_config_service.CmekConfig:
-        r"""Gets the
-        [CmekConfig][google.cloud.discoveryengine.v1.CmekConfig].
+        r"""Gets the `CmekConfig
+        <google.cloud.discoveryengine.v1.CmekConfig>`__.
 
         .. code-block:: python
 
@@ -490,14 +491,17 @@ async def sample_get_cmek_config():
                 GetCmekConfigRequest method.
             name (:class:`str`):
                 Required. Resource name of
-                [CmekConfig][google.cloud.discoveryengine.v1.CmekConfig],
-                such as ``projects/*/locations/*/cmekConfig`` or
+                `CmekConfig
+                <google.cloud.discoveryengine.v1.CmekConfig>`__,
+                such as
+                ``projects/*/locations/*/cmekConfig`` or
                 ``projects/*/locations/*/cmekConfigs/*``.
 
-                If the caller does not have permission to access the
-                [CmekConfig][google.cloud.discoveryengine.v1.CmekConfig],
-                regardless of whether or not it exists, a
-                PERMISSION_DENIED error is returned.
+                If the caller does not have permission
+                to access the `CmekConfig
+                <google.cloud.discoveryengine.v1.CmekConfig>`__,
+                regardless of whether or not it exists,
+                a PERMISSION_DENIED error is returned.
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -576,8 +580,8 @@ async def list_cmek_configs(
         timeout: Union[float, object] = gapic_v1.method.DEFAULT,
         metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
     ) -> cmek_config_service.ListCmekConfigsResponse:
-        r"""Lists all the
-        [CmekConfig][google.cloud.discoveryengine.v1.CmekConfig]s with
+        r"""Lists all the `CmekConfig
+        <google.cloud.discoveryengine.v1.CmekConfig>`__s with
         the project.
 
         .. code-block:: python
@@ -609,17 +613,20 @@ async def sample_list_cmek_configs():
         Args:
             request (Optional[Union[google.cloud.discoveryengine_v1.types.ListCmekConfigsRequest, dict]]):
                 The request object. Request message for
-                [CmekConfigService.ListCmekConfigs][google.cloud.discoveryengine.v1.CmekConfigService.ListCmekConfigs]
+                `CmekConfigService.ListCmekConfigs
+                <google.cloud.discoveryengine.v1.CmekConfigService.ListCmekConfigs>`__
                 method.
             parent (:class:`str`):
-                Required. The parent location resource name, such as
+                Required. The parent location resource
+                name, such as
                 ``projects/{project}/locations/{location}``.
 
-                If the caller does not have permission to list
-                [CmekConfig][google.cloud.discoveryengine.v1.CmekConfig]s
-                under this location, regardless of whether or not a
-                CmekConfig exists, a PERMISSION_DENIED error is
-                returned.
+                If the caller does not have permission
+                to list `CmekConfig
+                <google.cloud.discoveryengine.v1.CmekConfig>`__s
+                under this location, regardless of
+                whether or not a CmekConfig exists, a
+                PERMISSION_DENIED error is returned.
 
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -635,8 +642,9 @@ async def sample_list_cmek_configs():
         Returns:
             google.cloud.discoveryengine_v1.types.ListCmekConfigsResponse:
                 Response message for
-                   [CmekConfigService.ListCmekConfigs][google.cloud.discoveryengine.v1.CmekConfigService.ListCmekConfigs]
-                   method.
+                `CmekConfigService.ListCmekConfigs
+                <google.cloud.discoveryengine.v1.CmekConfigService.ListCmekConfigs>`__
+                method.
 
         """
         # Create or coerce a protobuf request object.
@@ -734,11 +742,13 @@ async def sample_delete_cmek_config():
         Args:
             request (Optional[Union[google.cloud.discoveryengine_v1.types.DeleteCmekConfigRequest, dict]]):
                 The request object. Request message for
-                [CmekConfigService.DeleteCmekConfig][google.cloud.discoveryengine.v1.CmekConfigService.DeleteCmekConfig]
+                `CmekConfigService.DeleteCmekConfig
+                <google.cloud.discoveryengine.v1.CmekConfigService.DeleteCmekConfig>`__
                 method.
             name (:class:`str`):
                 Required. The resource name of the
-                [CmekConfig][google.cloud.discoveryengine.v1.CmekConfig]
+                `CmekConfig
+                <google.cloud.discoveryengine.v1.CmekConfig>`__
                 to delete, such as
                 ``projects/{project}/locations/{location}/cmekConfigs/{cmek_config}``.
 
@@ -755,18 +765,21 @@ async def sample_delete_cmek_config():
 
         Returns:
             google.api_core.operation_async.AsyncOperation:
-                An object representing a long-running operation.
-
-                The result type for the operation will be :class:`google.protobuf.empty_pb2.Empty` A generic empty message that you can re-use to avoid defining duplicated
-                   empty messages in your APIs. A typical example is to
-                   use it as the request or the response type of an API
-                   method. For instance:
-
-                      service Foo {
-                         rpc Bar(google.protobuf.Empty) returns
-                         (google.protobuf.Empty);
-
-                      }
+                An object representing a long-running
+                operation.
+                The result type for the operation will
+                be
+                :class:`google.protobuf.empty_pb2.Empty`
+                A generic empty message that you can
+                re-use to avoid defining duplicated
+                empty messages in your APIs. A typical
+                example is to use it as the request or
+                the response type of an API method. For
+                instance:
+
+                    service Foo {
+                      rpc Bar(google.protobuf.Empty)
+                returns (google.protobuf.Empty);     }
 
         """
         # Create or coerce a protobuf request object.