hap-cli 0.9.4__tar.gz → 0.9.5__tar.gz

{hap_cli-0.9.4 → hap_cli-0.9.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hap-cli
-Version: 0.9.4
+Version: 0.9.5
 Summary: CLI harness for Mingdao HAP - Enterprise no-code platform
 Author: hap-cli
 License: Apache-2.0

{hap_cli-0.9.4 → hap_cli-0.9.5}/hap_cli/__init__.py

@@ -3,7 +3,7 @@
 import sys as _sys
 import types as _types
 
-__version__ = "0.9.4"
+__version__ = "0.9.5"
 
 # The command tree used to live in hap_cli/hap_cli.py. A module named
 # after the package it sits in shadows that package: run python with the

{hap_cli-0.9.4 → hap_cli-0.9.5}/hap_cli/commands/post_cmd.py

@@ -131,6 +131,19 @@ def _resolve_markers(
     return out
 
 
+def _simplify_attachments(items: Any) -> list[dict[str, Any]]:
+    out = []
+    for a in items or []:
+        if not isinstance(a, dict):
+            continue
+        out.append({
+            "id": a.get("fileID"),
+            "name": f"{a.get('originalFilename') or ''}{a.get('ext') or ''}",
+            "size": a.get("filesize"),
+        })
+    return out
+
+
 def _simplify_comment(c: dict[str, Any]) -> dict[str, Any]:
     text = _resolve_markers(
         c.get("message") or "",
@@ -152,6 +165,9 @@ def _simplify_comment(c: dict[str, Any]) -> dict[str, Any]:
         }
     if c.get("withAttachment") and str(c["withAttachment"]) != "0":
         out["has_attachment"] = True
+    files = _simplify_attachments(c.get("attachments"))
+    if files:
+        out["attachments"] = files
     return out
 
 
@@ -203,6 +219,9 @@ def _simplify_post(p: dict[str, Any]) -> dict[str, Any]:
     m_groups = [_simplify_group_ref(g) for g in (p.get("rGroupList") or [])]
     if m_groups:
         out["mentioned_groups"] = m_groups
+    files = _simplify_attachments(p.get("attachments"))
+    if files:
+        out["attachments"] = files
     return out
 
 
@@ -377,6 +396,8 @@ def _render_post_detail(detail: dict[str, Any]) -> None:
     click.echo("")
     for line in (detail.get("text") or "").splitlines() or [""]:
         click.echo(f"  {line}")
+    for f in detail.get("attachments") or []:
+        click.echo(f"  📎 {f.get('name')}")
     click.echo("")
 
     stats = (
@@ -414,6 +435,8 @@ def _render_post_detail(detail: dict[str, Any]) -> None:
             click.echo(header)
             for line in (c.get("text") or "").splitlines() or [""]:
                 click.echo(f"    {line}")
+            for f in c.get("attachments") or []:
+                click.echo(f"    📎 {f.get('name')}")
             click.echo("")
 
 
@@ -669,7 +692,13 @@ def post_get(ctx, post_id):
     default=0,
     type=int,
     show_default=True,
-    help="Post type: 0=text, 3=link, 5=vote, 7=file",
+    help="Post type. Leave at 0 (text); adding --file makes it an "
+         "attachment post on its own.",
+)
+@click.option(
+    "--file", "-f", "files", multiple=True,
+    help="Attach a file: a local path or an http(s) address. Repeat for "
+         "several. Videos, pictures and documents all work.",
 )
 @click.option(
     "--to-group",
@@ -694,15 +723,20 @@ def post_get(ctx, post_id):
 @click.option("--dry-run", is_flag=True,
               help="Show the audience and what would be sent, without publishing.")
 @pass_context
-def post_create(ctx, org_id, message, post_type, share_group_ids, share_org_ids,
-                legacy_group_ids, legacy_org_ids, card_group_ids, dry_run):
+def post_create(ctx, org_id, message, post_type, files, share_group_ids,
+                share_org_ids, legacy_group_ids, legacy_org_ids,
+                card_group_ids, dry_run):
     """Create a new post in the given organization.
 
     Audience is set with --to-group / --to-org and defaults to everyone in
     --org-id when neither is given. Who can see a post is covered in
     `hap guide post audience`; the group-chat card is `hap guide post card`.
+    Files given with --file are uploaded and attached to the post.
     """
     try:
+        if post_type == post_mod.POST_TYPE_ATTACHMENT and not files:
+            raise click.UsageError(
+                "An attachment post needs at least one --file.")
         share_group_ids = tuple(share_group_ids) + tuple(legacy_group_ids)
         share_org_ids = tuple(share_org_ids) + tuple(legacy_org_ids)
         if dry_run:
@@ -712,11 +746,14 @@ def post_create(ctx, org_id, message, post_type, share_group_ids, share_org_ids,
             ) or [f"org:{org_id or '<current>'} (everyone, default)"]
             ctx.output(
                 {"audience": audience, "cardToGroups": list(card_group_ids),
-                 "message": message, "published": False},
+                 "message": message, "files": list(files),
+                 "published": False},
                 lambda d: click.echo(
                     "Would publish to: " + ", ".join(d["audience"])
                     + (f"; card to groups: {', '.join(d['cardToGroups'])}"
-                       if d["cardToGroups"] else "")),
+                       if d["cardToGroups"] else "")
+                    + (f"; files: {', '.join(d['files'])}"
+                       if d["files"] else "")),
             )
             return
         session = ctx.get_session()
@@ -741,6 +778,8 @@ def post_create(ctx, org_id, message, post_type, share_group_ids, share_org_ids,
                     + ". Pick a group whose feed is on, or send a card to the "
                       "chat instead with --card-to-group.")
         pid = require_api_project_id(session, org_id)
+        attachments = (post_mod.upload_post_files(session, list(files))
+                       if files else None)
         raw = post_mod.add_post(
             session,
             project_id=pid,
@@ -748,6 +787,7 @@ def post_create(ctx, org_id, message, post_type, share_group_ids, share_org_ids,
             post_type=post_type,
             share_group_ids=list(share_group_ids) or None,
             share_project_ids=list(share_org_ids) or None,
+            attachments=attachments,
         )
         post_obj = raw.get("post") if isinstance(raw, dict) else None
         summary = _simplify_post(post_obj) if post_obj else {"raw": raw}
@@ -821,14 +861,22 @@ def post_delete(ctx, post_id, yes):
     default="",
     help="Member id being replied to (optional; pairs with --reply-id)",
 )
+@click.option(
+    "--file", "-f", "files", multiple=True,
+    help="Attach a file: a local path or an http(s) address. Repeat for "
+         "several. Videos, pictures and documents all work.",
+)
 @pass_context
-def post_comment(ctx, post_id, message, reply_id, reply_account_id):
-    """Add a comment to a post."""
+def post_comment(ctx, post_id, message, reply_id, reply_account_id, files):
+    """Add a comment to a post, optionally with files attached."""
     try:
         session = ctx.get_session()
+        attachments = (post_mod.upload_post_files(session, list(files))
+                       if files else None)
         raw = post_mod.add_comment(
             session, post_id, message,
             reply_id=reply_id, reply_account_id=reply_account_id,
+            attachments=attachments,
         )
         comment_obj = raw.get("comment") if isinstance(raw, dict) else None
         summary = _simplify_comment(comment_obj) if comment_obj else {"raw": raw}
@@ -864,6 +912,8 @@ def post_comments(ctx, post_id):
                 click.echo(header)
                 for line in (c.get("text") or "").splitlines() or [""]:
                     click.echo(f"  {line}")
+                for f in c.get("attachments") or []:
+                    click.echo(f"  📎 {f.get('name')}")
                 click.echo(f"  id: {c.get('id')}")
                 click.echo("")
         ctx.output(comments, _render)

{hap_cli-0.9.4 → hap_cli-0.9.5}/hap_cli/core/post.py

@@ -24,6 +24,7 @@ Response envelopes (from a live probe on SaaS):
   * ``GetPostDetail`` → bare post object (with ``success: "1"``)
 """
 
+import json
 import logging
 from typing import Any, Optional
 
@@ -219,6 +220,40 @@ def get_post_detail(session: Session, post_id: str) -> dict[str, Any]:
     return session.api_call("Post", "GetPostDetail", {"postId": post_id})
 
 
+# postType of a post carrying uploaded files ("pic and doc"). The feed's
+# own types: 0 text, 1 link, 2 picture, 3 document, 7 vote, 9 attachments
+# (MDPublic src/pages/feed/components/post/postComponent/factory.jsx:18-41,
+# createFeed/index.js:18-22).
+POST_TYPE_ATTACHMENT = 9
+
+
+def _attachment_fields(attachments: list[dict[str, Any]]) -> dict[str, str]:
+    """The two attachment keys, as JSON strings — the server takes strings
+    here, not arrays. Knowledge-center references are not supported, so
+    that list is always empty, as the composer sends it when none are
+    picked."""
+    return {
+        "attachments": json.dumps(attachments, ensure_ascii=False),
+        "knowledgeAttach": "[]",
+    }
+
+
+def upload_post_files(session: Session, sources: list[str]) -> list[dict[str, Any]]:
+    """Upload local paths / http(s) addresses and return attachment items
+    for :func:`add_post` / :func:`add_comment`.
+
+    No organization is named for the upload credential: the feed mounts
+    its uploader without a projectId (MDPublic createFeed/
+    CreateFeedContent.jsx:124-136), same as chat does here.
+    """
+    from hap_cli.core import upload as upload_mod
+
+    descriptors = upload_mod.upload_files(
+        session, upload_mod.source_descriptors(list(sources)))
+    logger.info("post: uploaded %d attachment(s)", len(descriptors))
+    return upload_mod.attachment_items(descriptors)
+
+
 def add_post(
     session: Session,
     project_id: str,
@@ -228,9 +263,16 @@ def add_post(
     share_group_ids: Optional[list[str]] = None,
     share_project_ids: Optional[list[str]] = None,
     radio_project_ids: str = "",
+    attachments: Optional[list[dict[str, Any]]] = None,
 ) -> dict[str, Any]:
     """Create a post via ``Post.AddPost``.
 
+    ``attachments`` are uploaded-file items (see :func:`upload_post_files`).
+    Files make it an attachment post — ``postType`` 9 — and travel as JSON
+    strings next to an empty knowledge-center list, exactly as the feed's
+    composer sends them (MDPublic src/pages/feed/components/createFeed/
+    index.js:18-22 and :163-180; pd-openweb identical).
+
     ``scope`` is a ``PostShareScopeReq`` object — not an int — and it is
     what decides **who can see the post**. The frontend
     (``pd-openweb/src/pages/feed/components/createFeed/index.js``) posts
@@ -261,15 +303,16 @@ def add_post(
             "shareGroupIds": groups,
             "shareProjectIds": orgs,
         }
-    return session.api_call(
-        "Post", "AddPost",
-        {
-            "projectId": project_id,
-            "postType": post_type,
-            "postMsg": message,
-            "scope": scope,
-        },
-    )
+    data: dict[str, Any] = {
+        "projectId": project_id,
+        "postType": post_type,
+        "postMsg": message,
+        "scope": scope,
+    }
+    if attachments:
+        data["postType"] = POST_TYPE_ATTACHMENT
+        data.update(_attachment_fields(attachments))
+    return session.api_call("Post", "AddPost", data)
 
 
 def edit_post(
@@ -304,17 +347,22 @@ def add_comment(
     message: str,
     reply_id: str = "",
     reply_account_id: str = "",
+    attachments: Optional[list[dict[str, Any]]] = None,
 ) -> dict[str, Any]:
     """Add a comment via ``Post.AddPostComment``.
 
     Uses ``postID`` / ``replyID`` (capital ID) to match the documented
-    spelling in ``src/api/post.js``.
+    spelling in ``src/api/post.js``. ``attachments`` go in the same JSON
+    string form as on a post (MDPublic src/pages/feed/components/post/
+    comment/postCommentInput.jsx:181-192; pd-openweb identical).
     """
     data: dict[str, Any] = {"postID": post_id, "message": message}
     if reply_id:
         data["replyID"] = reply_id
     if reply_account_id:
         data["replyAccountId"] = reply_account_id
+    if attachments:
+        data.update(_attachment_fields(attachments))
     return _require_post_success(
         session.api_call("Post", "AddPostComment", data), action="comment")
 

{hap_cli-0.9.4 → hap_cli-0.9.5}/hap_cli/core/upload.py

@@ -427,12 +427,15 @@ def upload_files(
     return out
 
 
-def record_attachment_cell(descriptors: list[dict[str, Any]]) -> dict[str, Any]:
-    """Wrap uploaded-file descriptors into a worksheet Attachment (type 14)
-    cell value: ``{attachmentData, attachments, knowledgeAtts}``."""
-    attachments = []
-    for i, d in enumerate(descriptors):
-        attachments.append({
+def attachment_items(descriptors: list[dict[str, Any]]) -> list[dict[str, Any]]:
+    """Uploaded-file descriptors as the attachment items the uploader hands
+    to whatever it is attached to — the ``formatResponseData`` shape
+    (MDPublic src/utils/platform/file/attachment.js:93-111; pd-openweb
+    src/components/UploadFiles/utils.js). Posts and post comments send a
+    JSON string of these; record cells wrap them further."""
+    items = []
+    for d in descriptors:
+        item = {
             "fileID": d.get("fileID"),
             "fileSize": d.get("fileSize"),
             "serverName": d.get("serverName"),
@@ -443,12 +446,20 @@ def record_attachment_cell(descriptors: list[dict[str, Any]]) -> dict[str, Any]:
             "key": d.get("key"),
             "url": d.get("url"),
             "oldOriginalFileName": d.get("originalFileName"),
-            "index": i,
-            "isEdit": False,
-        })
+        }
         # Carried, not recomputed: the descriptor already decided this at
         # upload time — see _download_permission().
         for key in ("allowDown", "docVersionID"):
             if key in d:
-                attachments[-1][key] = d[key]
+                item[key] = d[key]
+        items.append(item)
+    return items
+
+
+def record_attachment_cell(descriptors: list[dict[str, Any]]) -> dict[str, Any]:
+    """Wrap uploaded-file descriptors into a worksheet Attachment (type 14)
+    cell value: ``{attachmentData, attachments, knowledgeAtts}``."""
+    attachments = []
+    for i, item in enumerate(attachment_items(descriptors)):
+        attachments.append({**item, "index": i, "isEdit": False})
     return {"attachmentData": [], "attachments": attachments, "knowledgeAtts": []}

{hap_cli-0.9.4 → hap_cli-0.9.5}/hap_cli/guide/en/post.md

@@ -106,6 +106,8 @@ hap post list                      # list posts
 hap post search -k "kw" --scope myself   # only your own posts
 hap post get <postId>              # one post with its comments
 hap post comment <postId> -m "..."  # comment
+hap post create -m "demo" -f ./demo.mp4   # attach a file (repeat -f for more)
+hap post comment <postId> -m "..." -f ./notes.pdf   # comment with a file
 hap post delete <postId>           # delete
 ```
 

{hap_cli-0.9.4 → hap_cli-0.9.5}/hap_cli/guide/zh-Hans/post.md

@@ -94,6 +94,8 @@ hap post list                      # 动态列表
 hap post search -k "关键字" --scope myself   # 只搜自己发的
 hap post get <动态ID>              # 查看某条动态及评论
 hap post comment <动态ID> -m "..."  # 评论
+hap post create -m "演示" -f ./demo.mp4   # 附带文件（多个就重复 -f）
+hap post comment <动态ID> -m "..." -f ./notes.pdf   # 评论附带文件
 hap post delete <动态ID>           # 删除
 ```
 

{hap_cli-0.9.4 → hap_cli-0.9.5}/hap_cli/locale/messages.json

@@ -4420,8 +4420,12 @@
       "zh-Hans": "以 JSON 格式输出"
     },
     "post comment": {
-      "en": "Add a comment to a post.",
-      "zh-Hans": "为动态添加评论"
+      "en": "Add a comment to a post, optionally with files attached.",
+      "zh-Hans": "为动态添加评论，可同时附带文件。"
+    },
+    "post comment --file": {
+      "en": "Attach a file: a local path or an http(s) address. Repeat for several. Videos, pictures and documents all work.",
+      "zh-Hans": "附带文件：本地路径或 http(s) 地址，可重复指定多个。视频、图片、文档都可以。"
     },
     "post comment --json": {
       "en": "Output in JSON format",
@@ -4460,8 +4464,8 @@
       "zh-Hans": "以 JSON 格式输出"
     },
     "post create": {
-      "en": "Create a new post in the given organization.\n\nAudience is set with --to-group / --to-org and defaults to everyone in\n--org-id when neither is given. Who can see a post is covered in\n`hap guide post audience`; the group-chat card is `hap guide post card`.",
-      "zh-Hans": "在指定组织中发布新动态。用 --to-group / --to-org 指定发布范围（即谁能看到这条动态），两者都不给时默认发给 --org-id 组织的全体同事。谁能看到这条动态见 `hap guide post audience`；群聊卡片是另一回事，见 `hap guide post card`。"
+      "en": "Create a new post in the given organization.\n\nAudience is set with --to-group / --to-org and defaults to everyone in\n--org-id when neither is given. Who can see a post is covered in\n`hap guide post audience`; the group-chat card is `hap guide post card`.\nFiles given with --file are uploaded and attached to the post.",
+      "zh-Hans": "在指定组织中发布新动态。用 --to-group / --to-org 指定发布范围（即谁能看到这条动态），两者都不给时默认发给 --org-id 组织的全体同事。谁能看到这条动态见 `hap guide post audience`；群聊卡片是另一回事，见 `hap guide post card`。用 --file 指定的文件会上传并作为附件随动态发布。"
     },
     "post create --card-to-group": {
       "en": "After publishing, also send a card linking to the post into this group chat (repeatable). This is a chat message and does not change who can see the post.",
@@ -4471,6 +4475,10 @@
       "en": "Show the audience and what would be sent, without publishing.",
       "zh-Hans": "仅显示发布范围和将要发送的内容，不实际发布。"
     },
+    "post create --file": {
+      "en": "Attach a file: a local path or an http(s) address. Repeat for several. Videos, pictures and documents all work.",
+      "zh-Hans": "附带文件：本地路径或 http(s) 地址，可重复指定多个。视频、图片、文档都可以。"
+    },
     "post create --json": {
       "en": "Output in JSON format",
       "zh-Hans": "以 JSON 格式输出"
@@ -4492,8 +4500,8 @@
       "zh-Hans": "发布范围：该组织的全体同事能看到这条动态（可重复指定），即公司范围。"
     },
     "post create --type": {
-      "en": "Post type: 0=text, 3=link, 5=vote, 7=file",
-      "zh-Hans": "动态类型：0=文本，3=链接，5=投票，7=文件"
+      "en": "Post type. Leave at 0 (text); adding --file makes it an attachment post on its own.",
+      "zh-Hans": "动态类型。保持 0（文本）即可；加了 --file 会自动成为附件动态。"
     },
     "post delete": {
       "en": "Delete a post.",

hap_cli-0.9.5/hap_cli/tests/test_post_attachments.py

@@ -0,0 +1,182 @@
+"""Files attached to a post (动态) or a post comment.
+
+The feed sends uploaded files as ``attachments`` — a JSON *string* of the
+items ``formatResponseData`` builds — plus ``knowledgeAttach`` for files
+referenced from the knowledge center, and a post carrying files is
+``postType: 9`` (MDPublic src/pages/feed/components/createFeed/index.js:
+18-22, 163-180; comments: src/pages/feed/components/post/comment/
+postCommentInput.jsx:181-192; item shape: src/utils/platform/file/
+attachment.js:93-111). pd-openweb is identical on every payload key.
+"""
+
+import json
+from unittest.mock import MagicMock, patch
+
+from click.testing import CliRunner
+
+from hap_cli._entry import cli
+from hap_cli.core import post as post_mod
+from hap_cli.core import upload as upload_mod
+
+
+def _descriptor(name="clip.mp4", ext=".mp4"):
+    d = {
+        "fileID": "o1", "fileSize": 2048, "etag": "e", "bucket": 3,
+        "serverName": "https://d.example/", "filePath": "pid/2026/",
+        "fileName": "abc", "fileExt": ext, "originalFileName": name[: -len(ext)],
+        "key": "pid/2026/abc" + ext, "url": "https://d.example/signed",
+        "urlExpiresAt": None,
+    }
+    d.update(upload_mod._download_permission(ext))
+    return d
+
+
+class TestAttachmentItems:
+    def test_matches_format_response_data(self):
+        items = upload_mod.attachment_items([_descriptor()])
+        assert items == [{
+            "fileID": "o1", "fileSize": 2048,
+            "serverName": "https://d.example/", "filePath": "pid/2026/",
+            "fileName": "abc", "fileExt": ".mp4", "originalFileName": "clip",
+            "key": "pid/2026/abc.mp4", "url": "https://d.example/signed",
+            "oldOriginalFileName": "clip",
+            "allowDown": True, "docVersionID": "",
+        }]
+
+    def test_picture_carries_no_download_flag(self):
+        item = upload_mod.attachment_items([_descriptor("a.png", ".png")])[0]
+        assert "allowDown" not in item and "docVersionID" not in item
+
+
+class TestAddPostAttachments:
+    def _body(self, session):
+        return session.api_call.call_args[0][2]
+
+    def test_attachments_make_an_attachment_post(self):
+        session = MagicMock()
+        session.api_call.return_value = {"success": True}
+        items = upload_mod.attachment_items([_descriptor()])
+        post_mod.add_post(session, "org1", "看视频", attachments=items)
+        body = self._body(session)
+        assert body["postType"] == 9
+        assert json.loads(body["attachments"]) == items
+        assert body["knowledgeAttach"] == "[]"
+
+    def test_text_post_sends_no_attachment_keys(self):
+        session = MagicMock()
+        session.api_call.return_value = {"success": True}
+        post_mod.add_post(session, "org1", "hi")
+        body = self._body(session)
+        assert body["postType"] == 0
+        assert "attachments" not in body and "knowledgeAttach" not in body
+
+
+class TestAddCommentAttachments:
+    def test_comment_carries_attachments(self):
+        session = MagicMock()
+        session.api_call.return_value = {"success": True}
+        items = upload_mod.attachment_items([_descriptor()])
+        post_mod.add_comment(session, "p1", "附件", attachments=items)
+        body = session.api_call.call_args[0][2]
+        assert json.loads(body["attachments"]) == items
+        assert body["knowledgeAttach"] == "[]"
+
+    def test_plain_comment_unchanged(self):
+        session = MagicMock()
+        session.api_call.return_value = {"success": True}
+        post_mod.add_comment(session, "p1", "hi")
+        body = session.api_call.call_args[0][2]
+        assert "attachments" not in body
+
+
+class TestUploadPostFiles:
+    def test_paths_and_urls_upload_to_attachment_items(self):
+        """The feed uploader asks for credentials with no organization
+        (UploadFiles is mounted without projectId), so none is passed."""
+        session = MagicMock()
+        with patch("hap_cli.core.upload.upload_files",
+                   return_value=[_descriptor()]) as up:
+            items = post_mod.upload_post_files(
+                session, ["./clip.mp4", "https://x.example/a.pdf"])
+        files, = up.call_args[0][1:]
+        assert files == [{"path": "./clip.mp4"},
+                         {"url": "https://x.example/a.pdf"}]
+        assert items[0]["oldOriginalFileName"] == "clip"
+
+
+class TestPostCreateFileCli:
+    def _invoke(self, args):
+        runner = CliRunner()
+        with patch("hap_cli.context.Context.get_session"), \
+                patch("hap_cli.commands.post_cmd.require_api_project_id",
+                      return_value="org1"), \
+                patch("hap_cli.core.post.upload_post_files",
+                      return_value=[{"fileID": "o1"}]) as up, \
+                patch("hap_cli.core.post.add_post") as add:
+            add.return_value = {"post": {"postID": "p1"}}
+            result = runner.invoke(cli, args)
+        return result, up, add
+
+    def test_file_is_uploaded_and_attached(self):
+        result, up, add = self._invoke(
+            ["post", "create", "-m", "看视频", "--file", "clip.mp4"])
+        assert result.exit_code == 0, result.output
+        assert up.call_args[0][1] == ["clip.mp4"]
+        assert add.call_args[1]["attachments"] == [{"fileID": "o1"}]
+
+    def test_without_file_nothing_is_uploaded(self):
+        result, up, add = self._invoke(["post", "create", "-m", "hi"])
+        assert result.exit_code == 0, result.output
+        assert not up.called
+        assert add.call_args[1].get("attachments") is None
+
+    def test_dry_run_lists_files_without_uploading(self):
+        runner = CliRunner()
+        with patch("hap_cli.context.Context.get_session") as sess, \
+                patch("hap_cli.core.post.upload_post_files") as up:
+            result = runner.invoke(cli, [
+                "--json", "post", "create", "-m", "hi", "-f", "clip.mp4",
+                "--dry-run"])
+        assert result.exit_code == 0, result.output
+        assert json.loads(result.output)["files"] == ["clip.mp4"]
+        assert not up.called and not sess.called
+
+
+class TestPostCommentFileCli:
+    def test_comment_file_is_uploaded_and_attached(self):
+        runner = CliRunner()
+        with patch("hap_cli.context.Context.get_session"), \
+                patch("hap_cli.core.post.upload_post_files",
+                      return_value=[{"fileID": "o1"}]) as up, \
+                patch("hap_cli.core.post.add_comment") as add:
+            add.return_value = {"comment": {"commentID": "c1"}}
+            result = runner.invoke(cli, [
+                "post", "comment", "p1", "-m", "附件", "-f", "clip.mp4"])
+        assert result.exit_code == 0, result.output
+        assert up.call_args[0][1] == ["clip.mp4"]
+        assert add.call_args[1]["attachments"] == [{"fileID": "o1"}]
+
+
+class TestAttachmentsInOutput:
+    """Shape read back live from GetPostDetail / GetMorePostComments on
+    2026-10-10: each attachment has fileID, originalFilename (no
+    extension), ext and filesize."""
+
+    _ATT = {"fileID": "f1", "originalFilename": "clip", "ext": ".mp4",
+            "filesize": 15063, "viewType": 6}
+
+    def test_post_lists_its_files(self):
+        from hap_cli.commands.post_cmd import _simplify_post
+        out = _simplify_post({"postID": "p1", "attachments": [self._ATT]})
+        assert out["attachments"] == [
+            {"id": "f1", "name": "clip.mp4", "size": 15063}]
+
+    def test_comment_lists_its_files(self):
+        from hap_cli.commands.post_cmd import _simplify_comment
+        out = _simplify_comment({"commentID": "c1", "withAttachment": 1,
+                                 "attachments": [self._ATT]})
+        assert out["attachments"][0]["name"] == "clip.mp4"
+
+    def test_no_files_no_key(self):
+        from hap_cli.commands.post_cmd import _simplify_post
+        assert "attachments" not in _simplify_post({"postID": "p1"})

{hap_cli-0.9.4 → hap_cli-0.9.5}/hap_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hap-cli
-Version: 0.9.4
+Version: 0.9.5
 Summary: CLI harness for Mingdao HAP - Enterprise no-code platform
 Author: hap-cli
 License: Apache-2.0

{hap_cli-0.9.4 → hap_cli-0.9.5}/hap_cli.egg-info/SOURCES.txt

@@ -291,6 +291,7 @@ hap_cli/tests/test_page_filters_group_update.py
 hap_cli/tests/test_page_save_page_id.py
 hap_cli/tests/test_parameter_conventions.py
 hap_cli/tests/test_parameter_mapping_registry.py
+hap_cli/tests/test_post_attachments.py
 hap_cli/tests/test_post_scope_cli.py
 hap_cli/tests/test_record_batch_v3_semantic_cli.py
 hap_cli/tests/test_record_business_rules.py