fufu-cloud-cli 0.9.3__tar.gz → 0.9.4__tar.gz

{fufu_cloud_cli-0.9.3/src/fufu_cloud_cli.egg-info → fufu_cloud_cli-0.9.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fufu-cloud-cli
-Version: 0.9.3
+Version: 0.9.4
 Summary: FUFU Cloud CLI for tenant-scoped mock cloud development and deployment
 License-Expression: LicenseRef-Proprietary
 Requires-Python: >=3.10
@@ -22,7 +22,9 @@ Dynamic: license-file
 `gcloud-fufu`、`az-fufu`、`wrangler-fufu`。這是 AWS、Google Cloud、Azure 與 Cloudflare 的**明確子集**，
 只供 FUFU mock 環境使用；不會把部署轉送到正式雲端。
 
-0.9.3 新增 gcloud 常用輸出投影、資源清單篩選／排序／limit、Cloud Run 設定與環境變數更新、Service Account 查詢／停用／啟用，以及 Pub/Sub attributes、分頁和 message ACK deadline。這些行為已用官方 gcloud、小用量真實 GCP 與隔離 Docker 驗收；不表示完整 Google IAM、SDK／ADC 或自動擴縮相容。新增後端能力需要同步更新 FUFU Console 和 compute worker。
+0.9.4 新增 GCS generation／metageneration 條件、`storage objects describe/update/list`、8 KiB 自訂 metadata 與二進位 `cat`。競爭寫入、過期條件、CLI metadata 和官方 gcloud 輸出欄位已對照驗收；不相符條件回傳 `PRECONDITION_FAILED`／HTTP 412。新功能需要同步更新 FUFU Console、GCS 儲存映像和 Cloud Shell。儲存升級前須停寫並備份完整 volume；新 metadata 格式可讀舊資料，回滾須還原升級前備份。
+
+0.9.3 的常用輸出投影、清單篩選／排序／limit、Cloud Run 設定更新、Service Account 啟停及 Pub/Sub attributes／ACK deadline 持續保留。僅明列子集經過官方 gcloud、小用量真實 GCP 與隔離 Docker 驗收；不表示完整 Google IAM、SDK／ADC 或自動擴縮相容。
 
 0.9.1 統一所有 CLI API 請求的 `User-Agent: fufu-cloud-cli`，涵蓋物件傳輸、
 Cloudflare 靜態檔案部署、IaC 遠端 state 與 Cloud Shell session，避免沿用
@@ -34,7 +36,7 @@ Python 預設識別而遇到 Cloudflare HTTP 403／1010。識別標頭不取代
 ## Cloudflare 前端部署與 R2
 
 ```bash
-pip install 'fufu-cloud-cli==0.9.3'
+pip install 'fufu-cloud-cli==0.9.4'
 export FUFU_CLOUDFLARE_CREDENTIAL_FILE=/run/secrets/fufu-cloudflare.json
 wrangler-fufu capabilities
 wrangler-fufu pages project create frontend --production-branch main
@@ -205,7 +207,8 @@ CLI 無法判斷任意原始碼或 ZIP 內的資料是否可以分享。
 | Cloud Run | 已核准 HTTP 容器或 API 自動建置 Python ASGI 來源；支援配置後的 HTTPS 入口、Invoker policy；無 autoscaling、traffic splitting、Jobs |
 | Cloud Run functions / Functions Gen 1 | Python 3.12 HTTP 函式；Gen 1 為相同 HTTP runtime 的模擬子集，無背景事件 |
 | AWS Lambda | Python 3.10 / 3.12 ZIP、同步 invoke、程式碼更新、BUFFERED Function URL；ZIP 50 MiB／解壓 250 MiB，同步 payload 6 MiB |
-| GCS / S3 | bucket 與 object 子集；分段上傳／串流下載，受主機磁碟限制；已驗證超過 1 GiB，無 versioning / signed URL |
+| GCS | bucket／object 子集、分段上傳／串流下載／binary cat、generation／metageneration 條件、metadata describe/update、前綴分頁；8 KiB custom metadata；無 versioning、signed URL、bucket IAM、一般 SDK 或 GCS IaC 資源 |
+| S3 | bucket 與 object 子集；分段上傳／串流下載，受主機磁碟限制；已驗證超過 1 GiB，無 versioning / signed URL |
 | DynamoDB / SQS / SSM | 明列資料操作；無完整交易、Streams、FIFO 或 KMS / SecureString |
 | AWS IAM / GCP IAM | 租戶內 role / service account / policy 子集；default deny、限定 session；無原生雲端全量 IAM 語義 |
 | API Gateway / Serverless profile | 簡化 HTTP Lambda proxy 和明確來源清單；不執行 plugins / CloudFormation |

{fufu_cloud_cli-0.9.3 → fufu_cloud_cli-0.9.4}/README.md

@@ -4,7 +4,9 @@
 `gcloud-fufu`、`az-fufu`、`wrangler-fufu`。這是 AWS、Google Cloud、Azure 與 Cloudflare 的**明確子集**，
 只供 FUFU mock 環境使用；不會把部署轉送到正式雲端。
 
-0.9.3 新增 gcloud 常用輸出投影、資源清單篩選／排序／limit、Cloud Run 設定與環境變數更新、Service Account 查詢／停用／啟用，以及 Pub/Sub attributes、分頁和 message ACK deadline。這些行為已用官方 gcloud、小用量真實 GCP 與隔離 Docker 驗收；不表示完整 Google IAM、SDK／ADC 或自動擴縮相容。新增後端能力需要同步更新 FUFU Console 和 compute worker。
+0.9.4 新增 GCS generation／metageneration 條件、`storage objects describe/update/list`、8 KiB 自訂 metadata 與二進位 `cat`。競爭寫入、過期條件、CLI metadata 和官方 gcloud 輸出欄位已對照驗收；不相符條件回傳 `PRECONDITION_FAILED`／HTTP 412。新功能需要同步更新 FUFU Console、GCS 儲存映像和 Cloud Shell。儲存升級前須停寫並備份完整 volume；新 metadata 格式可讀舊資料，回滾須還原升級前備份。
+
+0.9.3 的常用輸出投影、清單篩選／排序／limit、Cloud Run 設定更新、Service Account 啟停及 Pub/Sub attributes／ACK deadline 持續保留。僅明列子集經過官方 gcloud、小用量真實 GCP 與隔離 Docker 驗收；不表示完整 Google IAM、SDK／ADC 或自動擴縮相容。
 
 0.9.1 統一所有 CLI API 請求的 `User-Agent: fufu-cloud-cli`，涵蓋物件傳輸、
 Cloudflare 靜態檔案部署、IaC 遠端 state 與 Cloud Shell session，避免沿用
@@ -16,7 +18,7 @@ Python 預設識別而遇到 Cloudflare HTTP 403／1010。識別標頭不取代
 ## Cloudflare 前端部署與 R2
 
 ```bash
-pip install 'fufu-cloud-cli==0.9.3'
+pip install 'fufu-cloud-cli==0.9.4'
 export FUFU_CLOUDFLARE_CREDENTIAL_FILE=/run/secrets/fufu-cloudflare.json
 wrangler-fufu capabilities
 wrangler-fufu pages project create frontend --production-branch main
@@ -187,7 +189,8 @@ CLI 無法判斷任意原始碼或 ZIP 內的資料是否可以分享。
 | Cloud Run | 已核准 HTTP 容器或 API 自動建置 Python ASGI 來源；支援配置後的 HTTPS 入口、Invoker policy；無 autoscaling、traffic splitting、Jobs |
 | Cloud Run functions / Functions Gen 1 | Python 3.12 HTTP 函式；Gen 1 為相同 HTTP runtime 的模擬子集，無背景事件 |
 | AWS Lambda | Python 3.10 / 3.12 ZIP、同步 invoke、程式碼更新、BUFFERED Function URL；ZIP 50 MiB／解壓 250 MiB，同步 payload 6 MiB |
-| GCS / S3 | bucket 與 object 子集；分段上傳／串流下載，受主機磁碟限制；已驗證超過 1 GiB，無 versioning / signed URL |
+| GCS | bucket／object 子集、分段上傳／串流下載／binary cat、generation／metageneration 條件、metadata describe/update、前綴分頁；8 KiB custom metadata；無 versioning、signed URL、bucket IAM、一般 SDK 或 GCS IaC 資源 |
+| S3 | bucket 與 object 子集；分段上傳／串流下載，受主機磁碟限制；已驗證超過 1 GiB，無 versioning / signed URL |
 | DynamoDB / SQS / SSM | 明列資料操作；無完整交易、Streams、FIFO 或 KMS / SecureString |
 | AWS IAM / GCP IAM | 租戶內 role / service account / policy 子集；default deny、限定 session；無原生雲端全量 IAM 語義 |
 | API Gateway / Serverless profile | 簡化 HTTP Lambda proxy 和明確來源清單；不執行 plugins / CloudFormation |

{fufu_cloud_cli-0.9.3 → fufu_cloud_cli-0.9.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "fufu-cloud-cli"
-version = "0.9.3"
+version = "0.9.4"
 description = "FUFU Cloud CLI for tenant-scoped mock cloud development and deployment"
 readme = "README.md"
 requires-python = ">=3.10"

{fufu_cloud_cli-0.9.3 → fufu_cloud_cli-0.9.4}/src/fufu_cloud_cli/__init__.py

@@ -1,3 +1,3 @@
 """FUFU CLI 與本機部署工具；相容範圍見 capabilities.json。"""
 
-__version__ = "0.9.3"
+__version__ = "0.9.4"

{fufu_cloud_cli-0.9.3 → fufu_cloud_cli-0.9.4}/src/fufu_cloud_cli/api_backend.py

@@ -185,7 +185,7 @@ class ApiClient:
         except HTTPError as exc:
             status = exc.code
             exc.close()
-            codes = {401: "AUTHENTICATION_FAILED", 403: "ACCESS_DENIED", 404: "RESOURCE_NOT_FOUND", 409: "RESOURCE_CONFLICT", 410: "UPLOAD_EXPIRED", 413: "PAYLOAD_LIMIT", 429: "RATE_LIMITED", 507: "STORAGE_CAPACITY"}
+            codes = {401: "AUTHENTICATION_FAILED", 403: "ACCESS_DENIED", 404: "RESOURCE_NOT_FOUND", 409: "RESOURCE_CONFLICT", 410: "UPLOAD_EXPIRED", 412: "PRECONDITION_FAILED", 413: "PAYLOAD_LIMIT", 429: "RATE_LIMITED", 507: "STORAGE_CAPACITY"}
             if status == 507: raise FufuError('STORAGE_CAPACITY', 'FUFU 主機磁碟容量不足；這是目前可用空間的限制，並非雲端物件大小上限。') from None
             raise FufuError(codes.get(status, "API_REQUEST_FAILED"), f"FUFU API 拒絕請求（HTTP {status}）；未輸出憑證或原始回應。") from None
         except (URLError, TimeoutError, ConnectionError) as exc:
@@ -211,7 +211,8 @@ class ApiClient:
                 return json.loads(response.read(65537))
         except HTTPError as error:
             status = error.code; error.close()
-            raise FufuError('OBJECT_TRANSFER_FAILED', f'物件傳輸未完成（HTTP {status}）；未覆寫下載目的地。') from None
+            code = 'PRECONDITION_FAILED' if self.provider == 'gcp' and status == 412 else 'OBJECT_TRANSFER_FAILED'
+            raise FufuError(code, f'物件傳輸未完成（HTTP {status}）；未覆寫下載目的地。') from None
 
     def close(self):
         if self.token and self.owns_token:
@@ -243,6 +244,9 @@ def storage_path(value):
 
 
 def remote_command(provider, argv, Parser):
+    if provider == 'gcp' and argv[:1] == ['storage']:
+        from .gcs import command
+        return command(argv[1:], Parser)
     p = Parser(prog={"aws": "aws-fufu", "gcp": "gcloud-fufu", "azure": "az-fufu"}[provider],
                description="FUFU API 憑證與租戶資源操作子集；無原生雲端 IAM／部署相容承諾。")
     roots = p.add_subparsers(dest="service", required=True)

{fufu_cloud_cli-0.9.3 → fufu_cloud_cli-0.9.4}/src/fufu_cloud_cli/capabilities.json

@@ -188,16 +188,24 @@
       "operations": [
         "bucket-create-list-delete",
         "binary-object-upload-download-list-delete",
+        "generation-match-preconditions",
+        "metageneration-match-preconditions",
+        "metadata-describe-update-merge-delete",
+        "paginated-object-list",
+        "binary-cat",
         "UTF8-preview"
       ],
       "limitations": [
         "object-5TiB-policy-subject-to-host-disk-capacity",
         "chunked-upload-streaming-download",
+        "custom-metadata-8KiB",
         "filesystem-object-name-subset",
-        "preview-32KiB",
-        "first-100-objects",
+        "UI-preview-32KiB-CLI-cat-streams",
+        "requires-generation-metadata-storage-backend",
+        "single-writer-per-volume",
         "no-signed-URLs",
-        "no-versioning"
+        "no-versioning-retention-ACL-KMS",
+        "no-GCS-Terraform-or-Pulumi-resource-adapter"
       ]
     },
     "azure-catalog-api": {

{fufu_cloud_cli-0.9.3 → fufu_cloud_cli-0.9.4}/src/fufu_cloud_cli/cli.py

@@ -477,7 +477,7 @@ def entry(provider, argv=None):
                 if output_filter or output_sort or output_limit is not None:
                     list_commands = [('run', 'services', 'list'), ('functions', 'list'), ('iam', 'service-accounts', 'list'),
                                      ('pubsub', 'topics', 'list'), ('pubsub', 'subscriptions', 'list'), ('secrets', 'list'),
-                                     ('secrets', 'versions', 'list'), ('storage', 'buckets', 'list')]
+                                     ('secrets', 'versions', 'list'), ('storage', 'buckets', 'list'), ('storage', 'objects', 'list')]
                     require(any(tuple(argv[:len(command)]) == command for command in list_commands), 'UNSUPPORTED_ARGUMENT', '清單選取旗標只適用於資源 list；未執行操作。')
                 if output_format and argv[:2] == ['functions', 'call']:
                     require(output_format == 'json', 'UNSUPPORTED_FORMAT', 'Functions call 目前只支援 JSON 回應。')

fufu_cloud_cli-0.9.4/src/fufu_cloud_cli/gcs.py

@@ -0,0 +1,137 @@
+"""GCS CLI subset with atomic generation and metadata preconditions."""
+import mimetypes
+import re
+import sys
+import time
+from pathlib import Path
+from urllib.parse import quote, urlencode, urlsplit
+
+from .api_backend import ApiClient
+from .errors import require
+from .gcloud_environment import dictionary
+from .object_transfer import upload_file, download_file
+
+
+def location(value):
+    parsed = urlsplit(value)
+    require(parsed.scheme == 'gs' and parsed.netloc and not parsed.query and not parsed.username and not parsed.password,
+            'INVALID_RESOURCE', '請指定 gs://bucket/object。')
+    generation = parsed.fragment or None
+    if generation:
+        require(re.fullmatch(r'[1-9][0-9]{0,18}', generation) and int(generation) <= 2**63-1,
+                'INVALID_RESOURCE', '物件版本必須是正整數 generation。')
+    return parsed.netloc, parsed.path.removeprefix('/'), generation
+
+
+def conditions(args):
+    result = {}
+    for flag, field in [('if_generation_match', 'ifGenerationMatch'), ('if_metageneration_match', 'ifMetagenerationMatch')]:
+        raw = getattr(args, flag, None)
+        if raw is not None:
+            require(re.fullmatch(r'0|[1-9][0-9]{0,18}', raw) and int(raw) <= 2**63-1,
+                    'INVALID_INPUT', 'Generation 條件必須是非負的 64-bit 整數。')
+            result[field] = raw
+    return result
+
+
+def display(obj):
+    mapping = {'bucket': 'bucket', 'name': 'name', 'generation': 'generation', 'metageneration': 'metageneration', 'size': 'size',
+               'contentType': 'content_type', 'cacheControl': 'cache_control', 'contentDisposition': 'content_disposition',
+               'contentLanguage': 'content_language', 'contentEncoding': 'content_encoding', 'storageClass': 'storage_class',
+               'timeCreated': 'creation_time', 'timeStorageClassUpdated': 'storage_class_update_time', 'updated': 'update_time',
+               'crc32c': 'crc32c_hash', 'md5Hash': 'md5_hash', 'etag': 'etag', 'metadata': 'custom_fields'}
+    result = {target: obj[source] for source, target in mapping.items() if source in obj}
+    for field in ['size', 'metageneration']:
+        if field in result: result[field] = int(result[field])
+    result['storage_url'] = 'gs://' + obj['bucket'] + '/' + obj['name'] + '#' + obj['generation']
+    return result
+
+
+def pages(api, path, params=None):
+    params = dict(params or {}); rows, seen, deadline = [], set(), time.monotonic()+300
+    while True:
+        require(time.monotonic() < deadline, 'LIST_TIMEOUT', '清單超過五分鐘；請縮小物件前綴範圍。')
+        page = api.request('GET', path + '?' + urlencode(params))
+        rows.extend(page.get('items', [])); token = page.get('nextPageToken')
+        if not token: return rows
+        require(isinstance(token, str) and token not in seen, 'INVALID_PAGINATION', 'Storage 回傳重複分頁；未提供不完整清單。')
+        seen.add(token); params['pageToken'] = token
+
+
+def command(argv, Parser):
+    parser = Parser(prog='gcloud-fufu storage', description='GCS 物件與 generation 條件子集；不支援歷史版本保留、ACL、保留政策或 KMS。')
+    root = parser.add_subparsers(dest='action', required=True)
+    buckets = root.add_parser('buckets').add_subparsers(dest='verb', required=True)
+    buckets.add_parser('list')
+    for verb in ['create', 'delete']: buckets.add_parser(verb).add_argument('url')
+    objects = root.add_parser('objects').add_subparsers(dest='verb', required=True)
+    for verb in ['list', 'describe', 'update']:
+        p = objects.add_parser(verb); p.add_argument('url')
+        if verb in ['list', 'describe']: p.add_argument('--raw', action='store_true')
+        else:
+            for flag in ['content-type', 'cache-control', 'content-disposition', 'content-language', 'content-encoding',
+                         'update-custom-metadata', 'remove-custom-metadata', 'if-generation-match', 'if-metageneration-match']:
+                p.add_argument('--'+flag)
+            p.add_argument('--clear-custom-metadata', action='store_true')
+    root.add_parser('ls').add_argument('url')
+    for action in ['cp', 'rm', 'cat']:
+        p = root.add_parser(action)
+        if action == 'cp':
+            p.add_argument('source'); p.add_argument('destination'); p.add_argument('--content-type'); p.add_argument('--custom-metadata')
+        else: p.add_argument('url')
+        for flag in ['if-generation-match', 'if-metageneration-match']: p.add_argument('--'+flag)
+    args = parser.parse_args(argv); preconditions = conditions(args)
+    downloading = args.action == 'cp' and args.source.startswith('gs://')
+    readonly = args.action in ['ls', 'cat'] or downloading or getattr(args, 'verb', None) in ['list', 'describe']
+    with ApiClient('gcp', read_only=readonly) as api:
+        if args.action == 'buckets' and args.verb == 'list': return pages(api, '/storage/buckets')
+        url = args.source if downloading else args.destination if args.action == 'cp' else args.url
+        bucket, key, generation = location(url); path = '/storage/buckets/' + quote(bucket, safe='')
+        if generation:
+            require(args.action != 'cp' or downloading, 'INVALID_RESOURCE', '上傳目的地不能指定歷史 generation。')
+            preconditions['generation'] = generation
+        if args.action == 'buckets':
+            require(not key and not generation, 'INVALID_RESOURCE', 'Bucket 操作不接受物件路徑或版本。')
+            return api.request('POST', '/storage/buckets', {'name': bucket}) if args.verb == 'create' else api.request('DELETE', path)
+        if args.action == 'ls' or args.action == 'objects' and args.verb == 'list':
+            require(not generation, 'UNSUPPORTED_ARGUMENT', '清單不接受單一 generation。')
+            prefix = key[:-2] if key.endswith('**') else key
+            require(not any(c in prefix for c in '*?[]'), 'UNSUPPORTED_ARGUMENT', '目前清單支援 bucket、名稱前綴及結尾 **。')
+            rows = pages(api, path+'/objects', {'prefix': prefix})
+            return rows if getattr(args, 'raw', False) else [display(row) for row in rows]
+        if args.action == 'cp' and not downloading and (not key or key.endswith('/')): key += Path(args.source).name
+        require(bool(key), 'INVALID_RESOURCE', '請指定 object 名稱。')
+        target = path+'/metadata?'+urlencode({'name': key, **preconditions})
+        if args.action == 'objects':
+            if args.verb == 'describe':
+                obj = api.request('GET', target)
+                return obj if args.raw else display(obj)
+            body = {}
+            for flag, field in [('content_type', 'contentType'), ('cache_control', 'cacheControl'), ('content_disposition', 'contentDisposition'),
+                                ('content_language', 'contentLanguage'), ('content_encoding', 'contentEncoding')]:
+                if getattr(args, flag) is not None: body[field] = getattr(args, flag) or None
+            require(not args.clear_custom_metadata or not (args.update_custom_metadata or args.remove_custom_metadata),
+                    'CONFLICTING_ARGUMENTS', '清空自訂 metadata 不可與更新／移除並用。')
+            if args.clear_custom_metadata: body['metadata'] = None
+            elif args.update_custom_metadata is not None or args.remove_custom_metadata is not None:
+                values = {name: None for name in (args.remove_custom_metadata or '').split(',') if name}
+                values.update(dictionary(args.update_custom_metadata or '')); body['metadata'] = values
+            require(bool(body), 'INVALID_INPUT', '請指定至少一項 metadata 更新。')
+            return display(api.request('PATCH', target, body))
+        if args.action == 'rm': return api.request('DELETE', path+'/object?'+urlencode({'name': key, **preconditions}))
+        if args.action == 'cat':
+            deadline = time.monotonic()+3600
+            with api.binary('GET', '/objects/download?'+urlencode({'bucket': bucket, 'key': key, **preconditions})) as response:
+                while True:
+                    require(time.monotonic() < deadline, 'TRANSFER_TIMEOUT', 'Storage cat 超過一小時。')
+                    data = response.read(65536)
+                    if not data: break
+                    sys.stdout.buffer.write(data)
+            return 0
+        if downloading:
+            require(not args.destination.startswith('gs://') and args.content_type is None and args.custom_metadata is None,
+                    'UNSUPPORTED_ARGUMENT', '下載不接受上傳 metadata；目前支援本機與 GCS 之間傳輸。')
+            return download_file(api, args.destination, bucket, key, conditions=preconditions)
+        return upload_file(api, args.source, bucket, key, conditions=preconditions,
+                           content_type=args.content_type or mimetypes.guess_type(args.source)[0] or 'application/octet-stream',
+                           metadata=dictionary(args.custom_metadata) if args.custom_metadata is not None else None)

{fufu_cloud_cli-0.9.3 → fufu_cloud_cli-0.9.4}/src/fufu_cloud_cli/object_transfer.py

@@ -19,8 +19,9 @@ class FileRange:
         return data
 
 
-def upload(api, stream, size, bucket, key, *, content_type=None, metadata=None):
+def upload(api, stream, size, bucket, key, *, content_type=None, metadata=None, conditions=None):
     body = {'bucket': bucket, 'key': key, 'size': size}
+    if conditions: body.update(conditions)
     if content_type is not None: body['contentType'] = content_type
     if metadata is not None: body['metadata'] = metadata
     transfer = api.request('POST', '/objects/uploads', body)
@@ -52,13 +53,13 @@ def upload_file(api, filename, bucket, key, **options):
         return upload(api, stream, os.fstat(stream.fileno()).st_size, bucket, key, **options)
 
 
-def download_file(api, filename, bucket, key):
+def download_file(api, filename, bucket, key, *, conditions=None):
     path = Path(filename)
     if path.exists() or path.is_symlink() or not path.parent.is_dir():
         raise ValueError('Object download requires a new destination file')
     descriptor, temporary = tempfile.mkstemp(prefix='.fufu-download-', dir=path.parent)
     try:
-        with os.fdopen(descriptor, 'wb') as output, api.binary('GET', '/objects/download?'+urlencode({'bucket': bucket, 'key': key})) as response:
+        with os.fdopen(descriptor, 'wb') as output, api.binary('GET', '/objects/download?'+urlencode({'bucket': bucket, 'key': key, **(conditions or {})})) as response:
             expected, received, digest = int(response.headers['Content-Length']), 0, hashlib.sha256()
             deadline = time.monotonic()+3600
             while True:

{fufu_cloud_cli-0.9.3 → fufu_cloud_cli-0.9.4/src/fufu_cloud_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fufu-cloud-cli
-Version: 0.9.3
+Version: 0.9.4
 Summary: FUFU Cloud CLI for tenant-scoped mock cloud development and deployment
 License-Expression: LicenseRef-Proprietary
 Requires-Python: >=3.10
@@ -22,7 +22,9 @@ Dynamic: license-file
 `gcloud-fufu`、`az-fufu`、`wrangler-fufu`。這是 AWS、Google Cloud、Azure 與 Cloudflare 的**明確子集**，
 只供 FUFU mock 環境使用；不會把部署轉送到正式雲端。
 
-0.9.3 新增 gcloud 常用輸出投影、資源清單篩選／排序／limit、Cloud Run 設定與環境變數更新、Service Account 查詢／停用／啟用，以及 Pub/Sub attributes、分頁和 message ACK deadline。這些行為已用官方 gcloud、小用量真實 GCP 與隔離 Docker 驗收；不表示完整 Google IAM、SDK／ADC 或自動擴縮相容。新增後端能力需要同步更新 FUFU Console 和 compute worker。
+0.9.4 新增 GCS generation／metageneration 條件、`storage objects describe/update/list`、8 KiB 自訂 metadata 與二進位 `cat`。競爭寫入、過期條件、CLI metadata 和官方 gcloud 輸出欄位已對照驗收；不相符條件回傳 `PRECONDITION_FAILED`／HTTP 412。新功能需要同步更新 FUFU Console、GCS 儲存映像和 Cloud Shell。儲存升級前須停寫並備份完整 volume；新 metadata 格式可讀舊資料，回滾須還原升級前備份。
+
+0.9.3 的常用輸出投影、清單篩選／排序／limit、Cloud Run 設定更新、Service Account 啟停及 Pub/Sub attributes／ACK deadline 持續保留。僅明列子集經過官方 gcloud、小用量真實 GCP 與隔離 Docker 驗收；不表示完整 Google IAM、SDK／ADC 或自動擴縮相容。
 
 0.9.1 統一所有 CLI API 請求的 `User-Agent: fufu-cloud-cli`，涵蓋物件傳輸、
 Cloudflare 靜態檔案部署、IaC 遠端 state 與 Cloud Shell session，避免沿用
@@ -34,7 +36,7 @@ Python 預設識別而遇到 Cloudflare HTTP 403／1010。識別標頭不取代
 ## Cloudflare 前端部署與 R2
 
 ```bash
-pip install 'fufu-cloud-cli==0.9.3'
+pip install 'fufu-cloud-cli==0.9.4'
 export FUFU_CLOUDFLARE_CREDENTIAL_FILE=/run/secrets/fufu-cloudflare.json
 wrangler-fufu capabilities
 wrangler-fufu pages project create frontend --production-branch main
@@ -205,7 +207,8 @@ CLI 無法判斷任意原始碼或 ZIP 內的資料是否可以分享。
 | Cloud Run | 已核准 HTTP 容器或 API 自動建置 Python ASGI 來源；支援配置後的 HTTPS 入口、Invoker policy；無 autoscaling、traffic splitting、Jobs |
 | Cloud Run functions / Functions Gen 1 | Python 3.12 HTTP 函式；Gen 1 為相同 HTTP runtime 的模擬子集，無背景事件 |
 | AWS Lambda | Python 3.10 / 3.12 ZIP、同步 invoke、程式碼更新、BUFFERED Function URL；ZIP 50 MiB／解壓 250 MiB，同步 payload 6 MiB |
-| GCS / S3 | bucket 與 object 子集；分段上傳／串流下載，受主機磁碟限制；已驗證超過 1 GiB，無 versioning / signed URL |
+| GCS | bucket／object 子集、分段上傳／串流下載／binary cat、generation／metageneration 條件、metadata describe/update、前綴分頁；8 KiB custom metadata；無 versioning、signed URL、bucket IAM、一般 SDK 或 GCS IaC 資源 |
+| S3 | bucket 與 object 子集；分段上傳／串流下載，受主機磁碟限制；已驗證超過 1 GiB，無 versioning / signed URL |
 | DynamoDB / SQS / SSM | 明列資料操作；無完整交易、Streams、FIFO 或 KMS / SecureString |
 | AWS IAM / GCP IAM | 租戶內 role / service account / policy 子集；default deny、限定 session；無原生雲端全量 IAM 語義 |
 | API Gateway / Serverless profile | 簡化 HTTP Lambda proxy 和明確來源清單；不執行 plugins / CloudFormation |

{fufu_cloud_cli-0.9.3 → fufu_cloud_cli-0.9.4}/src/fufu_cloud_cli.egg-info/SOURCES.txt

@@ -15,6 +15,7 @@ src/fufu_cloud_cli/docker_backend.py
 src/fufu_cloud_cli/errors.py
 src/fufu_cloud_cli/gcloud_environment.py
 src/fufu_cloud_cli/gcloud_output.py
+src/fufu_cloud_cli/gcs.py
 src/fufu_cloud_cli/http_runtime.py
 src/fufu_cloud_cli/iac_state.py
 src/fufu_cloud_cli/lambda_adapter.py