[do not merge]: Dry run for packages/google-cloud-storage migration

packages/google-cloud-storage/.coveragerc

@@ -0,0 +1,14 @@
+[run]
+branch = True
+
+[report]
+show_missing = True
+omit =
+    .nox/*
+    google/cloud/storage/__init__.py
+    google/cloud/storage/gapic_version.py
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__

packages/google-cloud-storage/.flake8

@@ -0,0 +1,34 @@
+# -*- 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.
+#
+[flake8]
+# TODO(https://github.com/googleapis/gapic-generator-python/issues/2333):
+# Resolve flake8 lint issues
+ignore = E203, E231, E266, E501, W503
+exclude =
+  # TODO(https://github.com/googleapis/gapic-generator-python/issues/2333):
+  # Ensure that generated code passes flake8 lint
+  **/gapic/**
+  **/services/**
+  **/types/**
+  # Exclude Protobuf gencode
+  *_pb2.py
+
+  # Standard linting exemptions.
+  **/.nox/**
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py

packages/google-cloud-storage/.gitignore

@@ -0,0 +1,67 @@
+*.py[cod]
+*.sw[op]
+
+# C extensions
+*.so
+
+# Packages
+*.egg
+*.egg-info
+dist
+build
+eggs
+.eggs
+parts
+bin
+var
+sdist
+develop-eggs
+.installed.cfg
+lib
+lib64
+__pycache__
+
+# Installer logs
+pip-log.txt
+
+# Unit test / coverage reports
+.coverage
+.nox
+.cache
+.pytest_cache
+
+
+# Mac
+.DS_Store
+
+# JetBrains
+.idea
+
+# VS Code
+.vscode
+
+# emacs
+*~
+
+# Built documentation
+docs/_build
+bigquery/docs/generated
+docs.metadata
+
+# Virtual environment
+env/
+venv/
+
+# Test logs
+coverage.xml
+*sponge_log.xml
+
+# System test environment variables.
+system_tests/local_test_setup
+
+# Make sure a generated file isn't accidentally committed.
+pylintrc
+pylintrc.test
+
+# Benchmarking results and logs
+__benchmark_results__/**

packages/google-cloud-storage/.librarian/generator-input/.repo-metadata.json

@@ -0,0 +1,18 @@
+{
+    "name": "storage",
+    "name_pretty": "Google Cloud Storage",
+    "product_documentation": "https://cloud.google.com/storage",
+    "client_documentation": "https://cloud.google.com/python/docs/reference/storage/latest",
+    "issue_tracker": "https://issuetracker.google.com/savedsearches/559782",
+    "release_level": "stable",
+    "language": "python",
+    "library_type": "GAPIC_MANUAL",
+    "repo": "googleapis/python-storage",
+    "distribution_name": "google-cloud-storage",
+    "api_id": "storage.googleapis.com",
+    "requires_billing": true,
+    "default_version": "v2",
+    "codeowner_team": "@googleapis/yoshi-python @googleapis/gcs-sdk-team @googleapis/gcs-fs",
+    "api_shortname": "storage",
+    "api_description": "is a durable and highly available object storage service. Google Cloud Storage is almost infinitely scalable and guarantees consistency: when a write succeeds, the latest copy of the object will be returned to any GET, globally."
+}

packages/google-cloud-storage/.librarian/generator-input/librarian.py

@@ -0,0 +1,108 @@
+# Copyright 2020 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.
+
+"""This script is used to synthesize generated parts of this library."""
+
+import json
+from pathlib import Path
+import shutil
+
+import synthtool as s
+from synthtool import gcp
+from synthtool.languages import python
+
+# ----------------------------------------------------------------------------
+# Copy the generated client from the owl-bot staging directory
+# ----------------------------------------------------------------------------
+
+# Load the default version defined in .repo-metadata.json.
+default_version = json.load(open(".repo-metadata.json", "rt")).get("default_version")
+
+for library in s.get_staging_dirs(default_version):
+    s.move(
+        [library],
+        excludes=[
+            ".coveragerc",
+            "docs/**/*",
+            "scripts/fixup*.py",
+            "setup.py",
+            "noxfile.py",
+            "README.rst",
+            # Exclude autogenerated default import `google.cloud.storage`
+            "google/cloud/storage/*",
+            # Exclude autogenerated constraints files for Python 3.7/3.9
+            "testing/constraints-3.7.txt",
+            "testing/constraints-3.9.txt",
+            "tests/unit/__init__.py",
+        ],
+    )
+
+    source_path = Path("google/cloud/storage_v2")
+    renamed_path = Path("google/cloud/_storage_v2")
+
+    # Remove the old _storage_v2 directory if it exists
+    if renamed_path.exists():
+        shutil.rmtree(renamed_path)
+
+    if source_path.exists():
+        source_path.rename(renamed_path)
+
+    if renamed_path.exists():
+        s.replace(
+        renamed_path / "**/*.py",
+        "google.cloud.storage_v2",
+        "google.cloud._storage_v2",
+    )
+
+    # Fix imports in the unit tests
+    s.replace(
+    "tests/unit/gapic/storage_v2/**/*.py",
+    "google.cloud.storage_v2",
+    "google.cloud._storage_v2",
+    )
+
+
+s.remove_staging_dirs()
+
+common = gcp.CommonTemplates()
+
+# ----------------------------------------------------------------------------
+# Add templated files
+# ----------------------------------------------------------------------------
+templated_files = common.py_library(
+    cov_level=99,
+    split_system_tests=True,
+    intersphinx_dependencies={
+        # python-requests url temporary change related to
+        # https://github.com/psf/requests/issues/6140#issuecomment-1135071992
+        "requests": "https://requests.readthedocs.io/en/stable/"
+    },
+)
+
+s.move(
+    templated_files,
+    excludes=[
+        ".coveragerc",
+        "docs/multiprocessing.rst",
+        "noxfile.py",
+        "CONTRIBUTING.rst",
+        "README.rst",
+        ".kokoro/**",
+        ".github/**",
+    ],
+)
+
+python.py_samples(skip_readmes=True)
+
+s.shell.run(["nox", "-s", "blacken"], hide_output=False)