chattool 7.0.2__tar.gz → 7.0.3__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chattool
-Version: 7.0.2
+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.2 → 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.2 → chattool-7.0.3}/src/chattool/__init__.py

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

{chattool-7.0.2 → 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.2 → chattool-7.0.3/src/chattool.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chattool
-Version: 7.0.2
+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.2 → 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