From bf133198cd47b9e2e73de5d612b75f9ce748f6a4 Mon Sep 17 00:00:00 2001 From: Heba Alazzeh Date: Tue, 30 Jun 2026 06:39:48 +0000 Subject: [PATCH 1/4] feat: implement native PEP 810 lazy loading in gapic generator --- .../%name_%version/%sub/__init__.py.j2 | 17 +++++++++++++++++ .../asset/google/cloud/asset_v1/__init__.py | 8 ++++++++ .../google/iam/credentials_v1/__init__.py | 7 +++++++ .../google/cloud/eventarc_v1/__init__.py | 17 +++++++++++++++++ .../logging/google/cloud/logging_v2/__init__.py | 11 +++++++++++ .../google/cloud/logging_v2/__init__.py | 11 +++++++++++ .../redis/google/cloud/redis_v1/__init__.py | 6 ++++++ .../google/cloud/redis_v1/__init__.py | 6 ++++++ .../cloud/storagebatchoperations_v1/__init__.py | 7 +++++++ 9 files changed, 90 insertions(+) diff --git a/packages/gapic-generator/gapic/templates/%namespace/%name_%version/%sub/__init__.py.j2 b/packages/gapic-generator/gapic/templates/%namespace/%name_%version/%sub/__init__.py.j2 index 497592654d20..c887c3c96025 100644 --- a/packages/gapic-generator/gapic/templates/%namespace/%name_%version/%sub/__init__.py.j2 +++ b/packages/gapic-generator/gapic/templates/%namespace/%name_%version/%sub/__init__.py.j2 @@ -12,6 +12,23 @@ __version__ = package_version.__version__ from importlib import metadata +if sys.version_info >= (3, 15): # pragma: NO COVER + __lazy_modules__ = { + {% filter sort_lines -%} + {% for subpackage, _ in api.subpackages|dictsort -%} + f"{__name__}.{{ subpackage }}", + {% endfor -%} + {% for service in api.services.values() + if service.meta.address.subpackage == api.subpackage_view -%} + f"{__name__}.services.{{ service.name|snake_case }}", + {% endfor -%} + {% for proto in api.protos.values() + if proto.meta.address.subpackage == api.subpackage_view -%} + f"{__name__}.types.{{ proto.module_name }}", + {% endfor -%} + {% endfilter %} + } + {# Import subpackages. -#} {% for subpackage, _ in api.subpackages|dictsort %} from . import {{ subpackage }} diff --git a/packages/gapic-generator/tests/integration/goldens/asset/google/cloud/asset_v1/__init__.py b/packages/gapic-generator/tests/integration/goldens/asset/google/cloud/asset_v1/__init__.py index f272a61b7a4e..bc3fb4d7d41a 100755 --- a/packages/gapic-generator/tests/integration/goldens/asset/google/cloud/asset_v1/__init__.py +++ b/packages/gapic-generator/tests/integration/goldens/asset/google/cloud/asset_v1/__init__.py @@ -22,6 +22,14 @@ from importlib import metadata +if sys.version_info >= (3, 15): # pragma: NO COVER + __lazy_modules__ = { +f"{__name__}.services.asset_service", +f"{__name__}.types.asset_enrichment_resourceowners", +f"{__name__}.types.asset_service", +f"{__name__}.types.assets", + } + from .services.asset_service import AssetServiceClient from .services.asset_service import AssetServiceAsyncClient diff --git a/packages/gapic-generator/tests/integration/goldens/credentials/google/iam/credentials_v1/__init__.py b/packages/gapic-generator/tests/integration/goldens/credentials/google/iam/credentials_v1/__init__.py index 943687313e36..636624603e76 100755 --- a/packages/gapic-generator/tests/integration/goldens/credentials/google/iam/credentials_v1/__init__.py +++ b/packages/gapic-generator/tests/integration/goldens/credentials/google/iam/credentials_v1/__init__.py @@ -22,6 +22,13 @@ from importlib import metadata +if sys.version_info >= (3, 15): # pragma: NO COVER + __lazy_modules__ = { +f"{__name__}.services.iam_credentials", +f"{__name__}.types.common", +f"{__name__}.types.iamcredentials", + } + from .services.iam_credentials import IAMCredentialsClient from .services.iam_credentials import IAMCredentialsAsyncClient diff --git a/packages/gapic-generator/tests/integration/goldens/eventarc/google/cloud/eventarc_v1/__init__.py b/packages/gapic-generator/tests/integration/goldens/eventarc/google/cloud/eventarc_v1/__init__.py index c2c65d30a333..92758ec90259 100755 --- a/packages/gapic-generator/tests/integration/goldens/eventarc/google/cloud/eventarc_v1/__init__.py +++ b/packages/gapic-generator/tests/integration/goldens/eventarc/google/cloud/eventarc_v1/__init__.py @@ -22,6 +22,23 @@ from importlib import metadata +if sys.version_info >= (3, 15): # pragma: NO COVER + __lazy_modules__ = { +f"{__name__}.services.eventarc", +f"{__name__}.types.channel", +f"{__name__}.types.channel_connection", +f"{__name__}.types.discovery", +f"{__name__}.types.enrollment", +f"{__name__}.types.eventarc", +f"{__name__}.types.google_api_source", +f"{__name__}.types.google_channel_config", +f"{__name__}.types.logging_config", +f"{__name__}.types.message_bus", +f"{__name__}.types.network_config", +f"{__name__}.types.pipeline", +f"{__name__}.types.trigger", + } + from .services.eventarc import EventarcClient from .services.eventarc import EventarcAsyncClient diff --git a/packages/gapic-generator/tests/integration/goldens/logging/google/cloud/logging_v2/__init__.py b/packages/gapic-generator/tests/integration/goldens/logging/google/cloud/logging_v2/__init__.py index 8b559fb0b227..30892a95156f 100755 --- a/packages/gapic-generator/tests/integration/goldens/logging/google/cloud/logging_v2/__init__.py +++ b/packages/gapic-generator/tests/integration/goldens/logging/google/cloud/logging_v2/__init__.py @@ -22,6 +22,17 @@ from importlib import metadata +if sys.version_info >= (3, 15): # pragma: NO COVER + __lazy_modules__ = { +f"{__name__}.services.config_service_v2", +f"{__name__}.services.logging_service_v2", +f"{__name__}.services.metrics_service_v2", +f"{__name__}.types.log_entry", +f"{__name__}.types.logging", +f"{__name__}.types.logging_config", +f"{__name__}.types.logging_metrics", + } + from .services.config_service_v2 import ConfigServiceV2Client from .services.config_service_v2 import ConfigServiceV2AsyncClient diff --git a/packages/gapic-generator/tests/integration/goldens/logging_internal/google/cloud/logging_v2/__init__.py b/packages/gapic-generator/tests/integration/goldens/logging_internal/google/cloud/logging_v2/__init__.py index 0469de869617..51ac410a1ec1 100755 --- a/packages/gapic-generator/tests/integration/goldens/logging_internal/google/cloud/logging_v2/__init__.py +++ b/packages/gapic-generator/tests/integration/goldens/logging_internal/google/cloud/logging_v2/__init__.py @@ -22,6 +22,17 @@ from importlib import metadata +if sys.version_info >= (3, 15): # pragma: NO COVER + __lazy_modules__ = { +f"{__name__}.services.config_service_v2", +f"{__name__}.services.logging_service_v2", +f"{__name__}.services.metrics_service_v2", +f"{__name__}.types.log_entry", +f"{__name__}.types.logging", +f"{__name__}.types.logging_config", +f"{__name__}.types.logging_metrics", + } + from .services.config_service_v2 import BaseConfigServiceV2Client from .services.config_service_v2 import BaseConfigServiceV2AsyncClient diff --git a/packages/gapic-generator/tests/integration/goldens/redis/google/cloud/redis_v1/__init__.py b/packages/gapic-generator/tests/integration/goldens/redis/google/cloud/redis_v1/__init__.py index c2897c61e9d7..29e76ed5e656 100755 --- a/packages/gapic-generator/tests/integration/goldens/redis/google/cloud/redis_v1/__init__.py +++ b/packages/gapic-generator/tests/integration/goldens/redis/google/cloud/redis_v1/__init__.py @@ -22,6 +22,12 @@ from importlib import metadata +if sys.version_info >= (3, 15): # pragma: NO COVER + __lazy_modules__ = { +f"{__name__}.services.cloud_redis", +f"{__name__}.types.cloud_redis", + } + from .services.cloud_redis import CloudRedisClient from .services.cloud_redis import CloudRedisAsyncClient diff --git a/packages/gapic-generator/tests/integration/goldens/redis_selective/google/cloud/redis_v1/__init__.py b/packages/gapic-generator/tests/integration/goldens/redis_selective/google/cloud/redis_v1/__init__.py index 043562140c7d..0597a66c810c 100755 --- a/packages/gapic-generator/tests/integration/goldens/redis_selective/google/cloud/redis_v1/__init__.py +++ b/packages/gapic-generator/tests/integration/goldens/redis_selective/google/cloud/redis_v1/__init__.py @@ -22,6 +22,12 @@ from importlib import metadata +if sys.version_info >= (3, 15): # pragma: NO COVER + __lazy_modules__ = { +f"{__name__}.services.cloud_redis", +f"{__name__}.types.cloud_redis", + } + from .services.cloud_redis import CloudRedisClient from .services.cloud_redis import CloudRedisAsyncClient diff --git a/packages/gapic-generator/tests/integration/goldens/storagebatchoperations/google/cloud/storagebatchoperations_v1/__init__.py b/packages/gapic-generator/tests/integration/goldens/storagebatchoperations/google/cloud/storagebatchoperations_v1/__init__.py index c1ad7c247ae0..5e2da0dda762 100755 --- a/packages/gapic-generator/tests/integration/goldens/storagebatchoperations/google/cloud/storagebatchoperations_v1/__init__.py +++ b/packages/gapic-generator/tests/integration/goldens/storagebatchoperations/google/cloud/storagebatchoperations_v1/__init__.py @@ -22,6 +22,13 @@ from importlib import metadata +if sys.version_info >= (3, 15): # pragma: NO COVER + __lazy_modules__ = { +f"{__name__}.services.storage_batch_operations", +f"{__name__}.types.storage_batch_operations", +f"{__name__}.types.storage_batch_operations_types", + } + from .services.storage_batch_operations import StorageBatchOperationsClient from .services.storage_batch_operations import StorageBatchOperationsAsyncClient From 47d8d01dca8e042006fda801fda39e90e5e0f05c Mon Sep 17 00:00:00 2001 From: Heba Alazzeh Date: Tue, 30 Jun 2026 17:44:40 +0000 Subject: [PATCH 2/4] fix: remove python version guard for PEP 810 lazy imports --- .../%name_%version/%sub/__init__.py.j2 | 35 ++++++++++--------- 1 file changed, 19 insertions(+), 16 deletions(-) diff --git a/packages/gapic-generator/gapic/templates/%namespace/%name_%version/%sub/__init__.py.j2 b/packages/gapic-generator/gapic/templates/%namespace/%name_%version/%sub/__init__.py.j2 index c887c3c96025..89078329172e 100644 --- a/packages/gapic-generator/gapic/templates/%namespace/%name_%version/%sub/__init__.py.j2 +++ b/packages/gapic-generator/gapic/templates/%namespace/%name_%version/%sub/__init__.py.j2 @@ -12,22 +12,25 @@ __version__ = package_version.__version__ from importlib import metadata -if sys.version_info >= (3, 15): # pragma: NO COVER - __lazy_modules__ = { - {% filter sort_lines -%} - {% for subpackage, _ in api.subpackages|dictsort -%} - f"{__name__}.{{ subpackage }}", - {% endfor -%} - {% for service in api.services.values() - if service.meta.address.subpackage == api.subpackage_view -%} - f"{__name__}.services.{{ service.name|snake_case }}", - {% endfor -%} - {% for proto in api.protos.values() - if proto.meta.address.subpackage == api.subpackage_view -%} - f"{__name__}.types.{{ proto.module_name }}", - {% endfor -%} - {% endfilter %} - } +# PEP 0810: Global Lazy Imports Control +# This variable provides a migration path for library maintainers. +# Python 3.15+ natively intercepts and defers these imports. +# Older Python versions safely ignore this variable. +__lazy_modules__ = { + {% filter sort_lines -%} + {% for subpackage, _ in api.subpackages|dictsort -%} + f"{__name__}.{{ subpackage }}", + {% endfor -%} + {% for service in api.services.values() + if service.meta.address.subpackage == api.subpackage_view -%} + f"{__name__}.services.{{ service.name|snake_case }}", + {% endfor -%} + {% for proto in api.protos.values() + if proto.meta.address.subpackage == api.subpackage_view -%} + f"{__name__}.types.{{ proto.module_name }}", + {% endfor -%} + {% endfilter %} +} {# Import subpackages. -#} {% for subpackage, _ in api.subpackages|dictsort %} From 082628365ef07068971b1154494228bb137b00bd Mon Sep 17 00:00:00 2001 From: Heba Alazzeh Date: Tue, 30 Jun 2026 19:03:28 +0000 Subject: [PATCH 3/4] update goldens --- .../goldens/asset/google/cloud/asset_v1/__init__.py | 9 ++++++--- .../credentials/google/iam/credentials_v1/__init__.py | 9 ++++++--- .../eventarc/google/cloud/eventarc_v1/__init__.py | 9 ++++++--- .../goldens/logging/google/cloud/logging_v2/__init__.py | 9 ++++++--- .../logging_internal/google/cloud/logging_v2/__init__.py | 9 ++++++--- .../goldens/redis/google/cloud/redis_v1/__init__.py | 9 ++++++--- .../redis_selective/google/cloud/redis_v1/__init__.py | 9 ++++++--- .../google/cloud/storagebatchoperations_v1/__init__.py | 9 ++++++--- 8 files changed, 48 insertions(+), 24 deletions(-) diff --git a/packages/gapic-generator/tests/integration/goldens/asset/google/cloud/asset_v1/__init__.py b/packages/gapic-generator/tests/integration/goldens/asset/google/cloud/asset_v1/__init__.py index bc3fb4d7d41a..f68d355d354a 100755 --- a/packages/gapic-generator/tests/integration/goldens/asset/google/cloud/asset_v1/__init__.py +++ b/packages/gapic-generator/tests/integration/goldens/asset/google/cloud/asset_v1/__init__.py @@ -22,13 +22,16 @@ from importlib import metadata -if sys.version_info >= (3, 15): # pragma: NO COVER - __lazy_modules__ = { +# PEP 0810: Global Lazy Imports Control +# This variable provides a migration path for library maintainers. +# Python 3.15+ natively intercepts and defers these imports. +# Older Python versions safely ignore this variable. +__lazy_modules__ = { f"{__name__}.services.asset_service", f"{__name__}.types.asset_enrichment_resourceowners", f"{__name__}.types.asset_service", f"{__name__}.types.assets", - } +} from .services.asset_service import AssetServiceClient diff --git a/packages/gapic-generator/tests/integration/goldens/credentials/google/iam/credentials_v1/__init__.py b/packages/gapic-generator/tests/integration/goldens/credentials/google/iam/credentials_v1/__init__.py index 636624603e76..9d7513584ddf 100755 --- a/packages/gapic-generator/tests/integration/goldens/credentials/google/iam/credentials_v1/__init__.py +++ b/packages/gapic-generator/tests/integration/goldens/credentials/google/iam/credentials_v1/__init__.py @@ -22,12 +22,15 @@ from importlib import metadata -if sys.version_info >= (3, 15): # pragma: NO COVER - __lazy_modules__ = { +# PEP 0810: Global Lazy Imports Control +# This variable provides a migration path for library maintainers. +# Python 3.15+ natively intercepts and defers these imports. +# Older Python versions safely ignore this variable. +__lazy_modules__ = { f"{__name__}.services.iam_credentials", f"{__name__}.types.common", f"{__name__}.types.iamcredentials", - } +} from .services.iam_credentials import IAMCredentialsClient diff --git a/packages/gapic-generator/tests/integration/goldens/eventarc/google/cloud/eventarc_v1/__init__.py b/packages/gapic-generator/tests/integration/goldens/eventarc/google/cloud/eventarc_v1/__init__.py index 92758ec90259..e3843f8136b7 100755 --- a/packages/gapic-generator/tests/integration/goldens/eventarc/google/cloud/eventarc_v1/__init__.py +++ b/packages/gapic-generator/tests/integration/goldens/eventarc/google/cloud/eventarc_v1/__init__.py @@ -22,8 +22,11 @@ from importlib import metadata -if sys.version_info >= (3, 15): # pragma: NO COVER - __lazy_modules__ = { +# PEP 0810: Global Lazy Imports Control +# This variable provides a migration path for library maintainers. +# Python 3.15+ natively intercepts and defers these imports. +# Older Python versions safely ignore this variable. +__lazy_modules__ = { f"{__name__}.services.eventarc", f"{__name__}.types.channel", f"{__name__}.types.channel_connection", @@ -37,7 +40,7 @@ f"{__name__}.types.network_config", f"{__name__}.types.pipeline", f"{__name__}.types.trigger", - } +} from .services.eventarc import EventarcClient diff --git a/packages/gapic-generator/tests/integration/goldens/logging/google/cloud/logging_v2/__init__.py b/packages/gapic-generator/tests/integration/goldens/logging/google/cloud/logging_v2/__init__.py index 30892a95156f..a55efa0a752c 100755 --- a/packages/gapic-generator/tests/integration/goldens/logging/google/cloud/logging_v2/__init__.py +++ b/packages/gapic-generator/tests/integration/goldens/logging/google/cloud/logging_v2/__init__.py @@ -22,8 +22,11 @@ from importlib import metadata -if sys.version_info >= (3, 15): # pragma: NO COVER - __lazy_modules__ = { +# PEP 0810: Global Lazy Imports Control +# This variable provides a migration path for library maintainers. +# Python 3.15+ natively intercepts and defers these imports. +# Older Python versions safely ignore this variable. +__lazy_modules__ = { f"{__name__}.services.config_service_v2", f"{__name__}.services.logging_service_v2", f"{__name__}.services.metrics_service_v2", @@ -31,7 +34,7 @@ f"{__name__}.types.logging", f"{__name__}.types.logging_config", f"{__name__}.types.logging_metrics", - } +} from .services.config_service_v2 import ConfigServiceV2Client diff --git a/packages/gapic-generator/tests/integration/goldens/logging_internal/google/cloud/logging_v2/__init__.py b/packages/gapic-generator/tests/integration/goldens/logging_internal/google/cloud/logging_v2/__init__.py index 51ac410a1ec1..bc512430f70e 100755 --- a/packages/gapic-generator/tests/integration/goldens/logging_internal/google/cloud/logging_v2/__init__.py +++ b/packages/gapic-generator/tests/integration/goldens/logging_internal/google/cloud/logging_v2/__init__.py @@ -22,8 +22,11 @@ from importlib import metadata -if sys.version_info >= (3, 15): # pragma: NO COVER - __lazy_modules__ = { +# PEP 0810: Global Lazy Imports Control +# This variable provides a migration path for library maintainers. +# Python 3.15+ natively intercepts and defers these imports. +# Older Python versions safely ignore this variable. +__lazy_modules__ = { f"{__name__}.services.config_service_v2", f"{__name__}.services.logging_service_v2", f"{__name__}.services.metrics_service_v2", @@ -31,7 +34,7 @@ f"{__name__}.types.logging", f"{__name__}.types.logging_config", f"{__name__}.types.logging_metrics", - } +} from .services.config_service_v2 import BaseConfigServiceV2Client diff --git a/packages/gapic-generator/tests/integration/goldens/redis/google/cloud/redis_v1/__init__.py b/packages/gapic-generator/tests/integration/goldens/redis/google/cloud/redis_v1/__init__.py index 29e76ed5e656..c500631d96f4 100755 --- a/packages/gapic-generator/tests/integration/goldens/redis/google/cloud/redis_v1/__init__.py +++ b/packages/gapic-generator/tests/integration/goldens/redis/google/cloud/redis_v1/__init__.py @@ -22,11 +22,14 @@ from importlib import metadata -if sys.version_info >= (3, 15): # pragma: NO COVER - __lazy_modules__ = { +# PEP 0810: Global Lazy Imports Control +# This variable provides a migration path for library maintainers. +# Python 3.15+ natively intercepts and defers these imports. +# Older Python versions safely ignore this variable. +__lazy_modules__ = { f"{__name__}.services.cloud_redis", f"{__name__}.types.cloud_redis", - } +} from .services.cloud_redis import CloudRedisClient diff --git a/packages/gapic-generator/tests/integration/goldens/redis_selective/google/cloud/redis_v1/__init__.py b/packages/gapic-generator/tests/integration/goldens/redis_selective/google/cloud/redis_v1/__init__.py index 0597a66c810c..ff256aeca5d7 100755 --- a/packages/gapic-generator/tests/integration/goldens/redis_selective/google/cloud/redis_v1/__init__.py +++ b/packages/gapic-generator/tests/integration/goldens/redis_selective/google/cloud/redis_v1/__init__.py @@ -22,11 +22,14 @@ from importlib import metadata -if sys.version_info >= (3, 15): # pragma: NO COVER - __lazy_modules__ = { +# PEP 0810: Global Lazy Imports Control +# This variable provides a migration path for library maintainers. +# Python 3.15+ natively intercepts and defers these imports. +# Older Python versions safely ignore this variable. +__lazy_modules__ = { f"{__name__}.services.cloud_redis", f"{__name__}.types.cloud_redis", - } +} from .services.cloud_redis import CloudRedisClient diff --git a/packages/gapic-generator/tests/integration/goldens/storagebatchoperations/google/cloud/storagebatchoperations_v1/__init__.py b/packages/gapic-generator/tests/integration/goldens/storagebatchoperations/google/cloud/storagebatchoperations_v1/__init__.py index 5e2da0dda762..24a7e169e524 100755 --- a/packages/gapic-generator/tests/integration/goldens/storagebatchoperations/google/cloud/storagebatchoperations_v1/__init__.py +++ b/packages/gapic-generator/tests/integration/goldens/storagebatchoperations/google/cloud/storagebatchoperations_v1/__init__.py @@ -22,12 +22,15 @@ from importlib import metadata -if sys.version_info >= (3, 15): # pragma: NO COVER - __lazy_modules__ = { +# PEP 0810: Global Lazy Imports Control +# This variable provides a migration path for library maintainers. +# Python 3.15+ natively intercepts and defers these imports. +# Older Python versions safely ignore this variable. +__lazy_modules__ = { f"{__name__}.services.storage_batch_operations", f"{__name__}.types.storage_batch_operations", f"{__name__}.types.storage_batch_operations_types", - } +} from .services.storage_batch_operations import StorageBatchOperationsClient From 84c1eb20bb3d668ada8976a73b520a065027b73c Mon Sep 17 00:00:00 2001 From: Heba Alazzeh Date: Tue, 30 Jun 2026 19:46:10 +0000 Subject: [PATCH 4/4] update goldens + update template comment --- .../templates/%namespace/%name_%version/%sub/__init__.py.j2 | 6 ++++-- .../goldens/asset/google/cloud/asset_v1/__init__.py | 6 ++++-- .../credentials/google/iam/credentials_v1/__init__.py | 6 ++++-- .../goldens/eventarc/google/cloud/eventarc_v1/__init__.py | 6 ++++-- .../goldens/logging/google/cloud/logging_v2/__init__.py | 6 ++++-- .../logging_internal/google/cloud/logging_v2/__init__.py | 6 ++++-- .../goldens/redis/google/cloud/redis_v1/__init__.py | 6 ++++-- .../redis_selective/google/cloud/redis_v1/__init__.py | 6 ++++-- .../google/cloud/storagebatchoperations_v1/__init__.py | 6 ++++-- 9 files changed, 36 insertions(+), 18 deletions(-) diff --git a/packages/gapic-generator/gapic/templates/%namespace/%name_%version/%sub/__init__.py.j2 b/packages/gapic-generator/gapic/templates/%namespace/%name_%version/%sub/__init__.py.j2 index 89078329172e..37054425f91a 100644 --- a/packages/gapic-generator/gapic/templates/%namespace/%name_%version/%sub/__init__.py.j2 +++ b/packages/gapic-generator/gapic/templates/%namespace/%name_%version/%sub/__init__.py.j2 @@ -12,9 +12,11 @@ __version__ = package_version.__version__ from importlib import metadata -# PEP 0810: Global Lazy Imports Control -# This variable provides a migration path for library maintainers. +# PEP 0810: Explicit Lazy Imports # Python 3.15+ natively intercepts and defers these imports. +# Developers can disable this behavior and force eager imports. +# For more information, see: +# https://docs.python.org/3.15/library/sys.html#sys.set_lazy_imports_filter # Older Python versions safely ignore this variable. __lazy_modules__ = { {% filter sort_lines -%} diff --git a/packages/gapic-generator/tests/integration/goldens/asset/google/cloud/asset_v1/__init__.py b/packages/gapic-generator/tests/integration/goldens/asset/google/cloud/asset_v1/__init__.py index f68d355d354a..d8dd1f4be7fa 100755 --- a/packages/gapic-generator/tests/integration/goldens/asset/google/cloud/asset_v1/__init__.py +++ b/packages/gapic-generator/tests/integration/goldens/asset/google/cloud/asset_v1/__init__.py @@ -22,9 +22,11 @@ from importlib import metadata -# PEP 0810: Global Lazy Imports Control -# This variable provides a migration path for library maintainers. +# PEP 0810: Explicit Lazy Imports # Python 3.15+ natively intercepts and defers these imports. +# Developers can disable this behavior and force eager imports. +# For more information, see: +# https://docs.python.org/3.15/library/sys.html#sys.set_lazy_imports_filter # Older Python versions safely ignore this variable. __lazy_modules__ = { f"{__name__}.services.asset_service", diff --git a/packages/gapic-generator/tests/integration/goldens/credentials/google/iam/credentials_v1/__init__.py b/packages/gapic-generator/tests/integration/goldens/credentials/google/iam/credentials_v1/__init__.py index 9d7513584ddf..280a0b983ffa 100755 --- a/packages/gapic-generator/tests/integration/goldens/credentials/google/iam/credentials_v1/__init__.py +++ b/packages/gapic-generator/tests/integration/goldens/credentials/google/iam/credentials_v1/__init__.py @@ -22,9 +22,11 @@ from importlib import metadata -# PEP 0810: Global Lazy Imports Control -# This variable provides a migration path for library maintainers. +# PEP 0810: Explicit Lazy Imports # Python 3.15+ natively intercepts and defers these imports. +# Developers can disable this behavior and force eager imports. +# For more information, see: +# https://docs.python.org/3.15/library/sys.html#sys.set_lazy_imports_filter # Older Python versions safely ignore this variable. __lazy_modules__ = { f"{__name__}.services.iam_credentials", diff --git a/packages/gapic-generator/tests/integration/goldens/eventarc/google/cloud/eventarc_v1/__init__.py b/packages/gapic-generator/tests/integration/goldens/eventarc/google/cloud/eventarc_v1/__init__.py index e3843f8136b7..3fa5867f37aa 100755 --- a/packages/gapic-generator/tests/integration/goldens/eventarc/google/cloud/eventarc_v1/__init__.py +++ b/packages/gapic-generator/tests/integration/goldens/eventarc/google/cloud/eventarc_v1/__init__.py @@ -22,9 +22,11 @@ from importlib import metadata -# PEP 0810: Global Lazy Imports Control -# This variable provides a migration path for library maintainers. +# PEP 0810: Explicit Lazy Imports # Python 3.15+ natively intercepts and defers these imports. +# Developers can disable this behavior and force eager imports. +# For more information, see: +# https://docs.python.org/3.15/library/sys.html#sys.set_lazy_imports_filter # Older Python versions safely ignore this variable. __lazy_modules__ = { f"{__name__}.services.eventarc", diff --git a/packages/gapic-generator/tests/integration/goldens/logging/google/cloud/logging_v2/__init__.py b/packages/gapic-generator/tests/integration/goldens/logging/google/cloud/logging_v2/__init__.py index a55efa0a752c..ecbd5db766e6 100755 --- a/packages/gapic-generator/tests/integration/goldens/logging/google/cloud/logging_v2/__init__.py +++ b/packages/gapic-generator/tests/integration/goldens/logging/google/cloud/logging_v2/__init__.py @@ -22,9 +22,11 @@ from importlib import metadata -# PEP 0810: Global Lazy Imports Control -# This variable provides a migration path for library maintainers. +# PEP 0810: Explicit Lazy Imports # Python 3.15+ natively intercepts and defers these imports. +# Developers can disable this behavior and force eager imports. +# For more information, see: +# https://docs.python.org/3.15/library/sys.html#sys.set_lazy_imports_filter # Older Python versions safely ignore this variable. __lazy_modules__ = { f"{__name__}.services.config_service_v2", diff --git a/packages/gapic-generator/tests/integration/goldens/logging_internal/google/cloud/logging_v2/__init__.py b/packages/gapic-generator/tests/integration/goldens/logging_internal/google/cloud/logging_v2/__init__.py index bc512430f70e..2b7a468204d6 100755 --- a/packages/gapic-generator/tests/integration/goldens/logging_internal/google/cloud/logging_v2/__init__.py +++ b/packages/gapic-generator/tests/integration/goldens/logging_internal/google/cloud/logging_v2/__init__.py @@ -22,9 +22,11 @@ from importlib import metadata -# PEP 0810: Global Lazy Imports Control -# This variable provides a migration path for library maintainers. +# PEP 0810: Explicit Lazy Imports # Python 3.15+ natively intercepts and defers these imports. +# Developers can disable this behavior and force eager imports. +# For more information, see: +# https://docs.python.org/3.15/library/sys.html#sys.set_lazy_imports_filter # Older Python versions safely ignore this variable. __lazy_modules__ = { f"{__name__}.services.config_service_v2", diff --git a/packages/gapic-generator/tests/integration/goldens/redis/google/cloud/redis_v1/__init__.py b/packages/gapic-generator/tests/integration/goldens/redis/google/cloud/redis_v1/__init__.py index c500631d96f4..a5b428efd8aa 100755 --- a/packages/gapic-generator/tests/integration/goldens/redis/google/cloud/redis_v1/__init__.py +++ b/packages/gapic-generator/tests/integration/goldens/redis/google/cloud/redis_v1/__init__.py @@ -22,9 +22,11 @@ from importlib import metadata -# PEP 0810: Global Lazy Imports Control -# This variable provides a migration path for library maintainers. +# PEP 0810: Explicit Lazy Imports # Python 3.15+ natively intercepts and defers these imports. +# Developers can disable this behavior and force eager imports. +# For more information, see: +# https://docs.python.org/3.15/library/sys.html#sys.set_lazy_imports_filter # Older Python versions safely ignore this variable. __lazy_modules__ = { f"{__name__}.services.cloud_redis", diff --git a/packages/gapic-generator/tests/integration/goldens/redis_selective/google/cloud/redis_v1/__init__.py b/packages/gapic-generator/tests/integration/goldens/redis_selective/google/cloud/redis_v1/__init__.py index ff256aeca5d7..7a3008966b37 100755 --- a/packages/gapic-generator/tests/integration/goldens/redis_selective/google/cloud/redis_v1/__init__.py +++ b/packages/gapic-generator/tests/integration/goldens/redis_selective/google/cloud/redis_v1/__init__.py @@ -22,9 +22,11 @@ from importlib import metadata -# PEP 0810: Global Lazy Imports Control -# This variable provides a migration path for library maintainers. +# PEP 0810: Explicit Lazy Imports # Python 3.15+ natively intercepts and defers these imports. +# Developers can disable this behavior and force eager imports. +# For more information, see: +# https://docs.python.org/3.15/library/sys.html#sys.set_lazy_imports_filter # Older Python versions safely ignore this variable. __lazy_modules__ = { f"{__name__}.services.cloud_redis", diff --git a/packages/gapic-generator/tests/integration/goldens/storagebatchoperations/google/cloud/storagebatchoperations_v1/__init__.py b/packages/gapic-generator/tests/integration/goldens/storagebatchoperations/google/cloud/storagebatchoperations_v1/__init__.py index 24a7e169e524..da72001ccfbf 100755 --- a/packages/gapic-generator/tests/integration/goldens/storagebatchoperations/google/cloud/storagebatchoperations_v1/__init__.py +++ b/packages/gapic-generator/tests/integration/goldens/storagebatchoperations/google/cloud/storagebatchoperations_v1/__init__.py @@ -22,9 +22,11 @@ from importlib import metadata -# PEP 0810: Global Lazy Imports Control -# This variable provides a migration path for library maintainers. +# PEP 0810: Explicit Lazy Imports # Python 3.15+ natively intercepts and defers these imports. +# Developers can disable this behavior and force eager imports. +# For more information, see: +# https://docs.python.org/3.15/library/sys.html#sys.set_lazy_imports_filter # Older Python versions safely ignore this variable. __lazy_modules__ = { f"{__name__}.services.storage_batch_operations",