chattool 7.0.1__tar.gz → 7.0.3__tar.gz

{chattool-7.0.1/src/chattool.egg-info → chattool-7.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chattool
-Version: 7.0.1
+Version: 7.0.3
 Summary: Toolkit for Chat API
 Author-email: Rex Wang <1073853456@qq.com>
 License: MIT license
@@ -248,6 +248,16 @@ chattool explore arxiv get
 
 交互终端里，`chattool explore arxiv get` 缺少 arXiv ID 时会自动补问。
 
+### 本地服务 (`chattool serve`)
+
+```bash
+chattool serve local ./cli-tree.html --host 127.0.0.1 --port 8765
+chattool serve local ./reports --html cli-tree.html --port 8765
+chattool serve local . --html index.html --dry-run
+```
+
+`serve local` 可用本地端口打开 HTML 文件或目录；省略目标时默认使用当前目录，`-i` 会进入统一交互补问。
+
 ### 其他工具
 
 | 工具 | 命令 | 说明 |

{chattool-7.0.1 → chattool-7.0.3}/README.md

@@ -158,6 +158,16 @@ chattool explore arxiv get
 
 交互终端里，`chattool explore arxiv get` 缺少 arXiv ID 时会自动补问。
 
+### 本地服务 (`chattool serve`)
+
+```bash
+chattool serve local ./cli-tree.html --host 127.0.0.1 --port 8765
+chattool serve local ./reports --html cli-tree.html --port 8765
+chattool serve local . --html index.html --dry-run
+```
+
+`serve local` 可用本地端口打开 HTML 文件或目录；省略目标时默认使用当前目录，`-i` 会进入统一交互补问。
+
 ### 其他工具
 
 | 工具 | 命令 | 说明 |

{chattool-7.0.1 → chattool-7.0.3}/src/chattool/__init__.py

@@ -4,7 +4,7 @@ import importlib
 
 __author__ = """Rex Wang"""
 __email__ = "1073853456@qq.com"
-__version__ = "7.0.1"
+__version__ = "7.0.3"
 
 from dotenv import load_dotenv
 

{chattool-7.0.1 → chattool-7.0.3}/src/chattool/serve/cli.py

@@ -27,6 +27,12 @@ def _load_lark():
     return command
 
 
+def _load_local():
+    command = _load_attr("chattool.serve.local", "local")
+    command.short_help = "Serve a local directory or HTML file."
+    return command
+
+
 def _load_svg2gif():
     command = _load_attr("chattool.serve.svg2gif", "svg2gif_app")
     command.short_help = "Run the SVG-to-GIF conversion service."
@@ -44,6 +50,7 @@ serve_cli._lazy_commands.update(
         "capture": _load_capture,
         "cert": _load_cert,
         "lark": _load_lark,
+        "local": _load_local,
         "svg2gif": _load_svg2gif,
     }
 )
@@ -52,6 +59,7 @@ serve_cli._lazy_command_help.update(
         "capture": "Run the screenshot capture server.",
         "cert": "Run the certificate service.",
         "lark": "Run the Lark webhook service.",
+        "local": "Serve a local directory or HTML file.",
         "svg2gif": "Run the SVG-to-GIF conversion service.",
     }
 )

chattool-7.0.3/src/chattool/serve/local.py

@@ -0,0 +1,109 @@
+from __future__ import annotations
+
+from pathlib import Path
+from urllib.parse import quote
+
+import click
+
+from chattool.interaction.command_schema import (
+    CommandField,
+    CommandSchema,
+    add_interactive_option,
+    resolve_command_inputs,
+)
+
+
+LOCAL_SCHEMA = CommandSchema(
+    name="serve-local",
+    fields=(
+        CommandField(
+            "target",
+            prompt="HTML file or directory",
+            kind="path",
+            default=".",
+            prompt_if_missing=True,
+        ),
+    ),
+)
+
+
+def resolve_local_target(target: str | None, html_name: str | None) -> dict[str, str]:
+    """Resolve a directory or HTML file into a static root and URL path."""
+
+    raw_target = Path(target or ".").expanduser()
+    target_path = raw_target.resolve()
+
+    if target_path.is_file():
+        if html_name:
+            raise click.UsageError("--html can only be used when TARGET is a directory.")
+        root = target_path.parent
+        html_path = target_path
+    elif target_path.is_dir():
+        root = target_path
+        html_path = (root / (html_name or "index.html")).resolve()
+        try:
+            html_path.relative_to(root)
+        except ValueError as exc:
+            raise click.UsageError("--html must resolve inside TARGET directory.") from exc
+    else:
+        raise click.UsageError(f"TARGET does not exist: {raw_target}")
+
+    if not html_path.exists():
+        raise click.UsageError(f"HTML file does not exist: {html_path}")
+    if not html_path.is_file():
+        raise click.UsageError(f"HTML path is not a file: {html_path}")
+
+    return {
+        "root": str(root),
+        "html": str(html_path),
+        "path": "/" + quote(str(html_path.relative_to(root)).replace("\\", "/")),
+    }
+
+
+@click.command(name="local")
+@click.argument("target", required=False)
+@click.option("--html", "html_name", default=None, help="HTML file inside TARGET directory. Defaults to index.html.")
+@click.option("--host", default="127.0.0.1", show_default=True, help="Bind host.")
+@click.option("--port", default=8765, show_default=True, type=int, help="Bind port.")
+@click.option("--open/--no-open", "open_browser", default=True, show_default=True, help="Open the URL in a browser.")
+@click.option("--dry-run", is_flag=True, help="Print resolved server info without starting the server.")
+@add_interactive_option
+def local(
+    target: str | None,
+    html_name: str | None,
+    host: str,
+    port: int,
+    open_browser: bool,
+    dry_run: bool,
+    interactive: bool | None,
+) -> None:
+    """Serve a local directory or HTML file over HTTP."""
+
+    values = resolve_command_inputs(
+        schema=LOCAL_SCHEMA,
+        provided={"target": target},
+        interactive=interactive,
+        usage="Usage: chattool serve local [TARGET] [--html FILE] [--host HOST] [--port PORT] [-i|-I]",
+    )
+    resolved = resolve_local_target(values["target"], html_name)
+    url = f"http://{host}:{port}{resolved['path']}"
+    click.echo(f"Root: {resolved['root']}")
+    click.echo(f"HTML: {resolved['html']}")
+    click.echo(f"URL:  {url}")
+    if dry_run:
+        return
+
+    import http.server
+    import socketserver
+    import webbrowser
+    from functools import partial
+
+    handler = partial(http.server.SimpleHTTPRequestHandler, directory=resolved["root"])
+    with socketserver.TCPServer((host, port), handler) as httpd:
+        click.echo("Press Ctrl+C to stop.")
+        if open_browser:
+            webbrowser.open(url)
+        try:
+            httpd.serve_forever()
+        except KeyboardInterrupt:
+            click.echo("\nStopped.")

{chattool-7.0.1 → chattool-7.0.3}/src/chattool/tools/pypi/main.py

@@ -339,6 +339,8 @@ def _build_chatarch_pyproject_content(
     email: str | None,
     include_mkdocs: bool = True,
 ) -> str:
+    repo_slug = _chatarch_repo_slug(package_name)
+    docs_url = _chatarch_docs_url(package_name)
     lines = [
         "[build-system]",
         'requires = ["setuptools>=61.0", "wheel"]',
@@ -368,6 +370,16 @@ def _build_chatarch_pyproject_content(
             '    "Programming Language :: Python :: 3",',
             '    "Operating System :: OS Independent",',
             "]",
+            "",
+            "[project.urls]",
+            f'Homepage = "https://github.com/{_toml_escape(repo_slug)}"',
+            f'Repository = "https://github.com/{_toml_escape(repo_slug)}"',
+        ]
+    )
+    if include_mkdocs:
+        lines.append(f'Documentation = "{_toml_escape(docs_url)}"')
+    lines.extend(
+        [
             "",
             "[project.scripts]",
             f'{module_name} = "{module_name}.cli:main"',
@@ -395,9 +407,19 @@ def _build_chatarch_pyproject_content(
     return "\n".join(lines)
 
 
+def _chatarch_repo_slug(package_name: str) -> str:
+    return f"ChatArch/{package_name}"
+
+
+def _chatarch_docs_url(package_name: str) -> str:
+    return f"https://ChatArch.github.io/{package_name}"
+
+
 def _chatarch_badge_block(
     package_name: str, *, include_mkdocs: bool, include_workflows: bool
 ) -> str:
+    repo_slug = _chatarch_repo_slug(package_name)
+    docs_url = _chatarch_docs_url(package_name)
     lines = [
         '<div align="center">',
         f'    <a href="https://pypi.python.org/pypi/{package_name}">',
@@ -407,15 +429,15 @@ def _chatarch_badge_block(
     if include_workflows:
         lines.extend(
             [
-                '    <a href="https://github.com/OWNER/REPO/actions/workflows/ci.yml">',
-                '        <img src="https://github.com/OWNER/REPO/actions/workflows/ci.yml/badge.svg" alt="Tests" />',
+                f'    <a href="https://github.com/{repo_slug}/actions/workflows/ci.yml">',
+                f'        <img src="https://github.com/{repo_slug}/actions/workflows/ci.yml/badge.svg" alt="Tests" />',
                 "    </a>",
             ]
         )
     if include_mkdocs:
         lines.extend(
             [
-                '    <a href="https://OWNER.github.io/REPO">',
+                f'    <a href="{docs_url}">',
                 '        <img src="https://img.shields.io/badge/docs-mkdocs-blue.svg" alt="Documentation" />',
                 "    </a>",
             ]
@@ -707,12 +729,14 @@ def _build_chatarch_docs_index_en(package_name: str) -> str:
 
 
 def _build_chatarch_mkdocs_yml(package_name: str) -> str:
+    repo_slug = _chatarch_repo_slug(package_name)
+    docs_url = _chatarch_docs_url(package_name)
     return (
         textwrap.dedent(
             f"""
             site_name: {package_name} 文档
-            site_url: https://OWNER.github.io/REPO
-            repo_url: https://github.com/OWNER/REPO
+            site_url: {docs_url}
+            repo_url: https://github.com/{repo_slug}
             theme:
               name: material
               language: zh
@@ -940,9 +964,8 @@ def scaffold_package(
 
                     on:
                       push:
-                        branches:
-                          - main
-                          - master
+                        tags:
+                          - "v*"
                       workflow_dispatch:
 
                     permissions:
@@ -981,15 +1004,14 @@ def scaffold_package(
                                   print(f"version={version}", file=output)
                                   print(f"tag=v{version}", file=output)
                               PY
-                          - name: Check release tag
-                            id: tag
+                          - name: Check tag matches package version
+                            if: github.event_name == 'push'
                             env:
                               RELEASE_TAG: ${{ steps.meta.outputs.tag }}
                             run: |
-                              if git ls-remote --exit-code --tags origin "refs/tags/${RELEASE_TAG}" >/dev/null 2>&1; then
-                                echo "exists=true" >> "$GITHUB_OUTPUT"
-                              else
-                                echo "exists=false" >> "$GITHUB_OUTPUT"
+                              if [ "${GITHUB_REF_NAME}" != "${RELEASE_TAG}" ]; then
+                                echo "Tag ${GITHUB_REF_NAME} does not match package version ${RELEASE_TAG}."
+                                exit 1
                               fi
                           - name: Check PyPI version
                             id: pypi
@@ -1018,15 +1040,6 @@ def scaffold_package(
                               with open(os.environ["GITHUB_OUTPUT"], "a", encoding="utf-8") as output:
                                   print(f"exists={exists}", file=output)
                               PY
-                          - name: Create release tag
-                            if: steps.pypi.outputs.exists == 'false' && steps.tag.outputs.exists == 'false'
-                            env:
-                              RELEASE_TAG: ${{ steps.meta.outputs.tag }}
-                            run: |
-                              git config user.name github-actions[bot]
-                              git config user.email 41898282+github-actions[bot]@users.noreply.github.com
-                              git tag -a "${RELEASE_TAG}" -m "Release ${RELEASE_TAG}"
-                              git push origin "${RELEASE_TAG}"
                           - name: Stop when version is already on PyPI
                             if: steps.pypi.outputs.exists == 'true'
                             run: echo "{package_name} ${{ steps.meta.outputs.version }} is already on PyPI; skipping publish."

{chattool-7.0.1 → chattool-7.0.3/src/chattool.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chattool
-Version: 7.0.1
+Version: 7.0.3
 Summary: Toolkit for Chat API
 Author-email: Rex Wang <1073853456@qq.com>
 License: MIT license
@@ -248,6 +248,16 @@ chattool explore arxiv get
 
 交互终端里，`chattool explore arxiv get` 缺少 arXiv ID 时会自动补问。
 
+### 本地服务 (`chattool serve`)
+
+```bash
+chattool serve local ./cli-tree.html --host 127.0.0.1 --port 8765
+chattool serve local ./reports --html cli-tree.html --port 8765
+chattool serve local . --html index.html --dry-run
+```
+
+`serve local` 可用本地端口打开 HTML 文件或目录；省略目标时默认使用当前目录，`-i` 会进入统一交互补问。
+
 ### 其他工具
 
 | 工具 | 命令 | 说明 |

{chattool-7.0.1 → chattool-7.0.3}/src/chattool.egg-info/SOURCES.txt

@@ -71,6 +71,7 @@ src/chattool/serve/capture.py
 src/chattool/serve/cert_server.py
 src/chattool/serve/cli.py
 src/chattool/serve/lark_serve.py
+src/chattool/serve/local.py
 src/chattool/serve/svg2gif.py
 src/chattool/setup/__init__.py
 src/chattool/setup/alias.py