refactor(api-core): rename gapic_v1.method_helpers to gapic_v1.request and improve docstring

Author: hebaalazzeh

packages/google-api-core/google/api_core/gapic_v1/__init__.py

@@ -25,10 +25,10 @@
 # Older Python versions safely ignore this variable.
 __lazy_modules__: Set[str] = {
     "google.api_core.gapic_v1.client_info",
-    "google.api_core.gapic_v1.method_helpers",
+    "google.api_core.gapic_v1.request",
     "google.api_core.gapic_v1.routing_header",
 }
-__all__ = ["client_info", "method_helpers", "routing_header"]
+__all__ = ["client_info", "request", "routing_header"]
 
 if _has_grpc:
     __lazy_modules__.update(
@@ -42,7 +42,7 @@
 
 from google.api_core.gapic_v1 import (  # noqa: E402
     client_info,
-    method_helpers,
+    request,
     routing_header,
 )
 

…ogle/api_core/gapic_v1/method_helpers.py …core/google/api_core/gapic_v1/request.pypackages/google-api-core/google/api_core/gapic_v1/method_helpers.py renamed to packages/google-api-core/google/api_core/gapic_v1/request.py packages/google-api-core/google/api_core/gapic_v1/method_helpers.py renamed to packages/google-api-core/google/api_core/gapic_v1/request.py

@@ -14,10 +14,16 @@
 # limitations under the License.
 #
 
-"""Helpers for method requests."""
+"""Helpers for preparing and structuring API requests.
+
+This module provides utilities to preprocess request parameters and objects
+before invoking API methods, such as automatically generating request IDs
+if they are not already set.
+"""
 
 import uuid
 from typing import Union
+
 import google.protobuf.message
 
 

…/tests/unit/gapic/test_method_helpers.py …pi-core/tests/unit/gapic/test_request.pypackages/google-api-core/tests/unit/gapic/test_method_helpers.py renamed to packages/google-api-core/tests/unit/gapic/test_request.py packages/google-api-core/tests/unit/gapic/test_method_helpers.py renamed to packages/google-api-core/tests/unit/gapic/test_request.py

@@ -14,7 +14,8 @@
 # limitations under the License.
 
 import re
-from google.api_core.gapic_v1.method_helpers import setup_request_id
+
+from google.api_core.gapic_v1.request import setup_request_id
 
 
 def test_setup_request_id():