Merge branch 'autogen' into feat/add-ast-utilities

Author: chalmerlowe

scripts/microgenerator/templates/_helpers.py.j2

@@ -1,3 +1,19 @@
+# -*- coding: utf-8 -*-
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
 from typing import Any, Dict, List, Optional, Type
 
 

scripts/microgenerator/templates/partials/_method_with_request_builder.j2

@@ -1,7 +1,9 @@
 def {{ method.name }}(
     self,
+    {# Assumes the primary resource ID is the last arg in request_id_args #}
     {{ method.request_id_args[-1] }}: Optional[str] = None,
     *,
+    {# Assumes the request class is a nested type within the service, e.g., bigquery_v2.types.dataset.GetDatasetRequest #}
     request: Optional[{{ '.'.join(method.request_class_full_name.split('.')[-2:]) }}] = None,
     retry: OptionalRetry = DEFAULT_RETRY,
     timeout: Union[float, object] = DEFAULT_TIMEOUT,
@@ -40,4 +42,4 @@ def {{ method.name }}(
         retry=retry,
         timeout=timeout,
         metadata=metadata,
-    )
+    )