feat: implement phase 1, constants and common classes.

Author: Test User

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

@@ -0,0 +1,15 @@
+# Copyright 2026 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.
+
+"""Resumable media library for Google APIs."""

packages/google-api-core/google/api_core/resumable_media/_common.py

@@ -0,0 +1,68 @@
+# Copyright 2026 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.
+
+"""Common constants and utilities for Resumable Media."""
+
+# The default size for individual upload chunks (10 MB).
+# When a resumable upload is chunked, the size of each chunk (except the last)
+# must be a multiple of the chunk granularity specified by the server in the
+# `X-Goog-Upload-Chunk-Granularity` header during the initial `start` request.
+# 10 MB is used as a default.
+DEFAULT_CHUNK_SIZE = 10 * 1024 * 1024  # 10MB
+
+# The header specifying the upload protocol.
+# Sent by the client during upload initiation.
+UPLOAD_PROTOCOL_HEADER = "X-Goog-Upload-Protocol"
+
+# The header specifying the protocol command.
+# Sent by the client on active requests (e.g. start, upload, finalize, query).
+UPLOAD_COMMAND_HEADER = "X-Goog-Upload-Command"
+
+# The header specifying the status of the upload.
+# Received from the server.
+UPLOAD_STATUS_HEADER = "X-Goog-Upload-Status"
+
+# The header providing the dedicated upload URL.
+# Received from the server in the start command response.
+UPLOAD_URL_HEADER = "X-Goog-Upload-URL"
+
+# The header specifying the byte offset of the current chunk.
+# Sent by the client during chunk uploads.
+UPLOAD_OFFSET_HEADER = "X-Goog-Upload-Offset"
+
+# The header specifying the number of bytes successfully persisted so far.
+# Received from the server, typically in query responses.
+UPLOAD_SIZE_RECEIVED_HEADER = "X-Goog-Upload-Size-Received"
+
+# The header specifying the required block alignment size for chunks.
+# Received from the server in the start command response.
+UPLOAD_CHUNK_GRANULARITY_HEADER = "X-Goog-Upload-Chunk-Granularity"
+
+# The value indicating the resumable upload protocol.
+# Sent by the client in the `UPLOAD_PROTOCOL_HEADER`.
+UPLOAD_PROTOCOL_VALUE = "resumable"
+
+class UploadCommand:
+    """HTTP Header values for the Resumable Upload command header."""
+    START = "start"
+    UPLOAD = "upload"
+    FINALIZE = "finalize"
+    QUERY = "query"
+    CANCEL = "cancel"
+
+class UploadStatus:
+    """HTTP Header values for the Resumable Upload status header."""
+    ACTIVE = "active"
+    FINAL = "final"
+    CANCELLED = "cancelled"

packages/google-api-core/tests/unit/resumable_media/test_common.py

@@ -0,0 +1,43 @@
+# Copyright 2026 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.
+
+import pytest
+
+from google.api_core.resumable_media import _common
+
+
+def test_constants():
+    assert _common.UPLOAD_PROTOCOL_HEADER == "X-Goog-Upload-Protocol"
+    assert _common.UPLOAD_COMMAND_HEADER == "X-Goog-Upload-Command"
+    assert _common.UPLOAD_STATUS_HEADER == "X-Goog-Upload-Status"
+    assert _common.UPLOAD_URL_HEADER == "X-Goog-Upload-URL"
+    assert _common.UPLOAD_OFFSET_HEADER == "X-Goog-Upload-Offset"
+    assert _common.UPLOAD_SIZE_RECEIVED_HEADER == "X-Goog-Upload-Size-Received"
+    assert _common.UPLOAD_CHUNK_GRANULARITY_HEADER == "X-Goog-Upload-Chunk-Granularity"
+    assert _common.UPLOAD_PROTOCOL_VALUE == "resumable"
+    assert _common.DEFAULT_CHUNK_SIZE == 10 * 1024 * 1024
+
+
+def test_upload_command():
+    assert _common.UploadCommand.START == "start"
+    assert _common.UploadCommand.UPLOAD == "upload"
+    assert _common.UploadCommand.FINALIZE == "finalize"
+    assert _common.UploadCommand.QUERY == "query"
+    assert _common.UploadCommand.CANCEL == "cancel"
+
+
+def test_upload_status():
+    assert _common.UploadStatus.ACTIVE == "active"
+    assert _common.UploadStatus.FINAL == "final"
+    assert _common.UploadStatus.CANCELLED == "cancelled"