chore(migration): Migrate code from googleapis/python-storage into packages/google-cloud-storage

.librarian/generator-input/client-post-processing/storage-integration.yaml

@@ -0,0 +1,48 @@
+description: Restore handwritten __init__.py for google-cloud-storage
+replacements:
+  - paths: [
+      packages/google-cloud-storage/google/cloud/storage/__init__.py
+    ]
+    before: '(?s)\A(?:(?!\bClient\b).)*\Z'
+    after: |
+      # Copyright 2014 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.
+
+      """Shortcut methods for getting set up with Google Cloud Storage.
+
+      You'll typically use these to get started with the API:
+
+      .. literalinclude:: snippets.py
+          :start-after: START storage_get_started
+          :end-before: END storage_get_started
+          :dedent: 4
+
+      The main concepts with this API are:
+
+      - :class:`~google.cloud.storage.bucket.Bucket` which represents a particular
+        bucket (akin to a mounted disk on a computer).
+
+      - :class:`~google.cloud.storage.blob.Blob` which represents a pointer to a
+        particular entity in Cloud Storage (akin to a file path on a remote
+        machine).
+      """
+
+      from google.cloud.storage.version import __version__  # isort: skip
+      from google.cloud.storage.batch import Batch
+      from google.cloud.storage.blob import Blob
+      from google.cloud.storage.bucket import Bucket
+      from google.cloud.storage.client import Client
+
+      __all__ = ["__version__", "Batch", "Blob", "Bucket", "Client"]
+    count: 1

.librarian/state.yaml

@@ -3229,6 +3229,46 @@ libraries:
     remove_regex:
       - packages/google-cloud-speech/
     tag_format: '{id}-v{version}'
+  - id: google-cloud-storage
+    version: 3.10.1
+    last_generated_commit: 5400ccce473c439885bd6bf2924fd242271bfcab
+    apis:
+      - path: google/storage/v2
+        service_config: storage_v2.yaml
+    source_roots:
+      - packages/google-cloud-storage
+    preserve_regex:
+      - packages/google-cloud-storage/CHANGELOG.md
+      - docs/CHANGELOG.md
+    remove_regex:
+      - ^packages/google-cloud-storage/google/cloud/storage/__init__.py
+      - ^packages/google-cloud-storage/.coveragerc
+      - ^packages/google-cloud-storage/.flake8
+      - ^packages/google-cloud-storage/.repo-metadata.json
+      - ^packages/google-cloud-storage/LICENSE
+      - ^packages/google-cloud-storage/MANIFEST.in
+      - ^packages/google-cloud-storage/README.rst
+      - ^packages/google-cloud-storage/mypy.ini
+      - ^packages/google-cloud-storage/noxfile.py
+      - ^packages/google-cloud-storage/setup.py
+      - ^packages/google-cloud-storage/google/cloud/_storage_v2/__init__.py
+      - ^packages/google-cloud-storage/google/cloud/_storage_v2/services
+      - ^packages/google-cloud-storage/google/cloud/_storage_v2/types
+      - ^packages/google-cloud-storage/google/cloud/_storage_v2/gapic_version.py
+      - ^packages/google-cloud-storage/google/cloud/_storage_v2/py.typed
+      - ^packages/google-cloud-storage/samples/generated_samples
+      - ^packages/google-cloud-storage/testing
+      - ^packages/google-cloud-storage/tests/__init__.py
+      - ^packages/google-cloud-storage/tests/unit/__init__.py
+      - ^packages/google-cloud-storage/tests/unit/gapic
+      - ^packages/google-cloud-storage/docs/conf.py
+      - ^packages/google-cloud-storage/docs/index.rst
+      - ^packages/google-cloud-storage/docs/README.rst
+      - ^packages/google-cloud-storage/docs/_static
+      - ^packages/google-cloud-storage/docs/_templates
+      - ^packages/google-cloud-storage/docs/storage
+      - ^packages/google-cloud-storage/docs/summary_overview.md
+    tag_format: '{id}-v{version}'
   - id: google-cloud-storage-control
     version: 1.10.0
     last_generated_commit: 9eea40c74d97622bb0aa406dd313409a376cc73b

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/.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/google-cloud-python",
+    "distribution_name": "google-cloud-storage",
+    "api_id": "storage.googleapis.com",
+    "requires_billing": true,
+    "default_version": "v2",
+    "codeowner_team": "@googleapis/cloud-sdk-python-team @googleapis/gcs-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."
+}