ChatVoice 0.0.1__tar.gz

chatvoice-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ChatArch
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

chatvoice-0.0.1/PKG-INFO

@@ -0,0 +1,91 @@
+Metadata-Version: 2.4
+Name: ChatVoice
+Version: 0.0.1
+Summary: ChatArch voice recording, transcription, and meeting-notes toolkit.
+Author-email: ChatArch <rex@chatarch.org>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ChatArch/ChatVoice
+Project-URL: Repository, https://github.com/ChatArch/ChatVoice
+Project-URL: Documentation, https://arch.gh.wzhecnu.cn/ChatVoice/
+Keywords: chatvoice,chatarch,cli
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Requires-Dist: chatstyle<0.2.0,>=0.1.0
+Requires-Dist: chatenv<0.3.0,>=0.2.0
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs<2.0,>=1.6; extra == "docs"
+Requires-Dist: mkdocs-material<9.7,>=9.5; extra == "docs"
+Requires-Dist: mkdocs-static-i18n<2.0,>=1.2; extra == "docs"
+Requires-Dist: mike<3.0,>=2.0; extra == "docs"
+Dynamic: license-file
+
+<div align="center">
+    <a href="https://pypi.python.org/pypi/ChatVoice">
+        <img src="https://img.shields.io/pypi/v/ChatVoice.svg" alt="PyPI version" />
+    </a>
+    <a href="https://github.com/ChatArch/ChatVoice/actions/workflows/ci.yml">
+        <img src="https://github.com/ChatArch/ChatVoice/actions/workflows/ci.yml/badge.svg" alt="Tests" />
+    </a>
+    <a href="https://arch.gh.wzhecnu.cn/ChatVoice/">
+        <img src="https://img.shields.io/badge/docs-mkdocs-blue.svg" alt="Documentation" />
+    </a>
+</div>
+
+<div align="center">
+
+[英文版](README.en.md) | [简体中文](README.md)
+</div>
+
+# ChatVoice
+
+ChatArch voice recording, transcription, and meeting-notes toolkit.
+
+
+文档入口：<https://arch.gh.wzhecnu.cn/ChatVoice/>
+
+按场景选择文档：
+
+| 场景 | 文档 |
+| --- | --- |
+| 第一次安装、运行命令行、确认包可用 | [CLI 树](docs/cli-tree.md) |
+| 校对当前包有哪些一等能力和边界 | [能力地图](docs/capability-map.md) |
+| 从 Python 代码调用包能力 | [接口树](docs/interface-tree.md) |
+
+## 快速开始
+
+```bash
+pip install -e ".[dev]"
+chatvoice --help
+chatvoice --version
+python -m pytest -q
+python -m build
+```
+
+## 命令行规范
+
+这个模板默认依赖 `chatstyle>=0.1.0,<0.2.0` 和 `chatenv>=0.2.0,<0.3.0`，新增命令应优先使用：
+
+- `CommandSchema` / `CommandField` 描述输入。
+- `add_interactive_option()` 提供统一 `-i/-I`。
+- `resolve_command_inputs()` 统一缺参补问、默认值、TTY 与校验。
+- 默认生成 `config.py` 和 `chatenv.configs` 入口点，使包可被 ChatEnv 发现；只有明确不需要 ChatEnv 接入时才使用 `--without-chatenv-provider`。
+
+## 目录结构
+
+- `src/`：包源码
+- `tests/code-tests/`：代码测试和历史测试迁移
+- `tests/cli-tests/`：真实 CLI 测试，doc-first
+- `tests/mock-cli-tests/`：mock/fake CLI 测试，doc-first
+- `docs/`：长期维护文档，由 mkdocs 构建
+
+## 开发说明
+
+扩展脚手架前，先阅读 `DEVELOP.md` 和 `AGENTS.md`。

chatvoice-0.0.1/README.md

@@ -0,0 +1,62 @@
+<div align="center">
+    <a href="https://pypi.python.org/pypi/ChatVoice">
+        <img src="https://img.shields.io/pypi/v/ChatVoice.svg" alt="PyPI version" />
+    </a>
+    <a href="https://github.com/ChatArch/ChatVoice/actions/workflows/ci.yml">
+        <img src="https://github.com/ChatArch/ChatVoice/actions/workflows/ci.yml/badge.svg" alt="Tests" />
+    </a>
+    <a href="https://arch.gh.wzhecnu.cn/ChatVoice/">
+        <img src="https://img.shields.io/badge/docs-mkdocs-blue.svg" alt="Documentation" />
+    </a>
+</div>
+
+<div align="center">
+
+[英文版](README.en.md) | [简体中文](README.md)
+</div>
+
+# ChatVoice
+
+ChatArch voice recording, transcription, and meeting-notes toolkit.
+
+
+文档入口：<https://arch.gh.wzhecnu.cn/ChatVoice/>
+
+按场景选择文档：
+
+| 场景 | 文档 |
+| --- | --- |
+| 第一次安装、运行命令行、确认包可用 | [CLI 树](docs/cli-tree.md) |
+| 校对当前包有哪些一等能力和边界 | [能力地图](docs/capability-map.md) |
+| 从 Python 代码调用包能力 | [接口树](docs/interface-tree.md) |
+
+## 快速开始
+
+```bash
+pip install -e ".[dev]"
+chatvoice --help
+chatvoice --version
+python -m pytest -q
+python -m build
+```
+
+## 命令行规范
+
+这个模板默认依赖 `chatstyle>=0.1.0,<0.2.0` 和 `chatenv>=0.2.0,<0.3.0`，新增命令应优先使用：
+
+- `CommandSchema` / `CommandField` 描述输入。
+- `add_interactive_option()` 提供统一 `-i/-I`。
+- `resolve_command_inputs()` 统一缺参补问、默认值、TTY 与校验。
+- 默认生成 `config.py` 和 `chatenv.configs` 入口点，使包可被 ChatEnv 发现；只有明确不需要 ChatEnv 接入时才使用 `--without-chatenv-provider`。
+
+## 目录结构
+
+- `src/`：包源码
+- `tests/code-tests/`：代码测试和历史测试迁移
+- `tests/cli-tests/`：真实 CLI 测试，doc-first
+- `tests/mock-cli-tests/`：mock/fake CLI 测试，doc-first
+- `docs/`：长期维护文档，由 mkdocs 构建
+
+## 开发说明
+
+扩展脚手架前，先阅读 `DEVELOP.md` 和 `AGENTS.md`。

chatvoice-0.0.1/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ChatVoice"
+dynamic = ["version"]
+description = "ChatArch voice recording, transcription, and meeting-notes toolkit."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+dependencies = ["click>=8.0", "chatstyle>=0.1.0,<0.2.0", "chatenv>=0.2.0,<0.3.0"]
+authors = [{name = "ChatArch", email = "rex@chatarch.org"}]
+keywords = ["chatvoice", "chatarch", "cli"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://github.com/ChatArch/ChatVoice"
+Repository = "https://github.com/ChatArch/ChatVoice"
+Documentation = "https://arch.gh.wzhecnu.cn/ChatVoice/"
+
+[project.scripts]
+chatvoice = "chatvoice.cli:main"
+
+[project.entry-points."chatenv.configs"]
+chatvoice = "chatvoice.config"
+
+[project.optional-dependencies]
+dev = ["build", "pytest", "twine"]
+docs = ["mkdocs>=1.6,<2.0", "mkdocs-material>=9.5,<9.7", "mkdocs-static-i18n>=1.2,<2.0", "mike>=2.0,<3.0"]
+
+[tool.setuptools.dynamic]
+version = {attr = "chatvoice.__version__"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools]
+include-package-data = true

chatvoice-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

chatvoice-0.0.1/src/ChatVoice.egg-info/PKG-INFO

@@ -0,0 +1,91 @@
+Metadata-Version: 2.4
+Name: ChatVoice
+Version: 0.0.1
+Summary: ChatArch voice recording, transcription, and meeting-notes toolkit.
+Author-email: ChatArch <rex@chatarch.org>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ChatArch/ChatVoice
+Project-URL: Repository, https://github.com/ChatArch/ChatVoice
+Project-URL: Documentation, https://arch.gh.wzhecnu.cn/ChatVoice/
+Keywords: chatvoice,chatarch,cli
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Requires-Dist: chatstyle<0.2.0,>=0.1.0
+Requires-Dist: chatenv<0.3.0,>=0.2.0
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs<2.0,>=1.6; extra == "docs"
+Requires-Dist: mkdocs-material<9.7,>=9.5; extra == "docs"
+Requires-Dist: mkdocs-static-i18n<2.0,>=1.2; extra == "docs"
+Requires-Dist: mike<3.0,>=2.0; extra == "docs"
+Dynamic: license-file
+
+<div align="center">
+    <a href="https://pypi.python.org/pypi/ChatVoice">
+        <img src="https://img.shields.io/pypi/v/ChatVoice.svg" alt="PyPI version" />
+    </a>
+    <a href="https://github.com/ChatArch/ChatVoice/actions/workflows/ci.yml">
+        <img src="https://github.com/ChatArch/ChatVoice/actions/workflows/ci.yml/badge.svg" alt="Tests" />
+    </a>
+    <a href="https://arch.gh.wzhecnu.cn/ChatVoice/">
+        <img src="https://img.shields.io/badge/docs-mkdocs-blue.svg" alt="Documentation" />
+    </a>
+</div>
+
+<div align="center">
+
+[英文版](README.en.md) | [简体中文](README.md)
+</div>
+
+# ChatVoice
+
+ChatArch voice recording, transcription, and meeting-notes toolkit.
+
+
+文档入口：<https://arch.gh.wzhecnu.cn/ChatVoice/>
+
+按场景选择文档：
+
+| 场景 | 文档 |
+| --- | --- |
+| 第一次安装、运行命令行、确认包可用 | [CLI 树](docs/cli-tree.md) |
+| 校对当前包有哪些一等能力和边界 | [能力地图](docs/capability-map.md) |
+| 从 Python 代码调用包能力 | [接口树](docs/interface-tree.md) |
+
+## 快速开始
+
+```bash
+pip install -e ".[dev]"
+chatvoice --help
+chatvoice --version
+python -m pytest -q
+python -m build
+```
+
+## 命令行规范
+
+这个模板默认依赖 `chatstyle>=0.1.0,<0.2.0` 和 `chatenv>=0.2.0,<0.3.0`，新增命令应优先使用：
+
+- `CommandSchema` / `CommandField` 描述输入。
+- `add_interactive_option()` 提供统一 `-i/-I`。
+- `resolve_command_inputs()` 统一缺参补问、默认值、TTY 与校验。
+- 默认生成 `config.py` 和 `chatenv.configs` 入口点，使包可被 ChatEnv 发现；只有明确不需要 ChatEnv 接入时才使用 `--without-chatenv-provider`。
+
+## 目录结构
+
+- `src/`：包源码
+- `tests/code-tests/`：代码测试和历史测试迁移
+- `tests/cli-tests/`：真实 CLI 测试，doc-first
+- `tests/mock-cli-tests/`：mock/fake CLI 测试，doc-first
+- `docs/`：长期维护文档，由 mkdocs 构建
+
+## 开发说明
+
+扩展脚手架前，先阅读 `DEVELOP.md` 和 `AGENTS.md`。

chatvoice-0.0.1/src/ChatVoice.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+src/ChatVoice.egg-info/PKG-INFO
+src/ChatVoice.egg-info/SOURCES.txt
+src/ChatVoice.egg-info/dependency_links.txt
+src/ChatVoice.egg-info/entry_points.txt
+src/ChatVoice.egg-info/requires.txt
+src/ChatVoice.egg-info/top_level.txt
+src/chatvoice/__init__.py
+src/chatvoice/cli.py
+src/chatvoice/config.py
+tests/test_cli.py
+tests/test_version.py

chatvoice-0.0.1/src/ChatVoice.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

chatvoice-0.0.1/src/ChatVoice.egg-info/entry_points.txt

@@ -0,0 +1,5 @@
+[chatenv.configs]
+chatvoice = chatvoice.config
+
+[console_scripts]
+chatvoice = chatvoice.cli:main

chatvoice-0.0.1/src/ChatVoice.egg-info/requires.txt

@@ -0,0 +1,14 @@
+click>=8.0
+chatstyle<0.2.0,>=0.1.0
+chatenv<0.3.0,>=0.2.0
+
+[dev]
+build
+pytest
+twine
+
+[docs]
+mkdocs<2.0,>=1.6
+mkdocs-material<9.7,>=9.5
+mkdocs-static-i18n<2.0,>=1.2
+mike<3.0,>=2.0

chatvoice-0.0.1/src/ChatVoice.egg-info/top_level.txt

@@ -0,0 +1 @@
+chatvoice

chatvoice-0.0.1/src/chatvoice/__init__.py

@@ -0,0 +1,5 @@
+"""ChatVoice package."""
+
+__all__ = ["__version__"]
+
+__version__ = "0.0.1"

chatvoice-0.0.1/src/chatvoice/cli.py

@@ -0,0 +1,94 @@
+"""CLI entrypoint for chatvoice."""
+
+from __future__ import annotations
+
+import inspect
+
+import click
+
+from chatvoice import __version__
+
+
+def _purpose(command: click.Command) -> str:
+    text = command.short_help or inspect.getdoc(command.callback) or ""
+    return " ".join(text.strip().split()).rstrip(".")
+
+
+def _parameter_piece(parameter: click.Parameter) -> str | None:
+    if getattr(parameter, "hidden", False) or parameter.name == "help":
+        return None
+    if isinstance(parameter, click.Argument):
+        piece = parameter.name.upper().replace("_", "-")
+        if not parameter.required:
+            piece = f"[{piece}]"
+        if parameter.nargs == -1:
+            piece = f"{piece}..."
+        return piece
+    if not isinstance(parameter, click.Option):
+        return None
+    option_names = [name for name in (*parameter.opts, *parameter.secondary_opts) if name.startswith("--")]
+    if not option_names:
+        option_names = [name for name in (*parameter.opts, *parameter.secondary_opts) if name.startswith("-")]
+    if not option_names:
+        return None
+    if parameter.is_flag or parameter.flag_value is not None:
+        piece = "/".join(option_names)
+    else:
+        metavar = parameter.metavar or parameter.name.upper().replace("_", "-")
+        piece = f"{'/'.join(option_names)} {metavar}"
+    if not parameter.required:
+        piece = f"[{piece}]"
+    return piece
+
+
+def _command_signature(name: str, command: click.Command) -> str:
+    pieces = [piece for piece in (_parameter_piece(parameter) for parameter in command.params) if piece]
+    return " ".join([name, *pieces])
+
+
+def _render_command_tree(command: click.Command, name: str, prefix: str, is_last: bool, lines: list[str]) -> None:
+    connector = "└── " if is_last else "├── "
+    line = f"{prefix}{connector}{_command_signature(name, command)}"
+    purpose = _purpose(command)
+    if purpose:
+        line = f"{line}  # {purpose}"
+    lines.append(line)
+    if not isinstance(command, click.Group):
+        return
+    children = [(child_name, child) for child_name, child in command.commands.items() if not child.hidden]
+    child_prefix = prefix + ("    " if is_last else "│   ")
+    for index, (child_name, child) in enumerate(children):
+        _render_command_tree(child, child_name, child_prefix, index == len(children) - 1, lines)
+
+
+def _render_cli_tree(root: click.Group) -> str:
+    children = [(name, command) for name, command in root.commands.items() if not command.hidden]
+    lines = [f"chatvoice  # {_purpose(root)}"]
+    root_options = [
+        ("--help", "Show help for the current command."),
+        ("--version", "Show package version."),
+        ("--tree", "Print the registered CLI tree."),
+    ]
+    for index, (option, purpose) in enumerate(root_options):
+        is_last = not children and index == len(root_options) - 1
+        lines.append(f"{'└──' if is_last else '├──'} {option}  # {purpose}")
+    for index, (child_name, child) in enumerate(children):
+        _render_command_tree(child, child_name, "", index == len(children) - 1, lines)
+    return "\n".join(lines)
+
+
+@click.group(invoke_without_command=True, no_args_is_help=True)
+@click.version_option(__version__, prog_name="chatvoice")
+@click.option("--tree", "show_tree", is_flag=True, is_eager=True, help="Print the registered CLI tree.")
+@click.pass_context
+def main(ctx: click.Context, show_tree: bool) -> None:
+    """chatvoice command line interface."""
+    # Add package-specific commands here. Prefer ChatStyle helpers for
+    # interactive input when a command needs recoverable user input.
+    if show_tree:
+        click.echo(_render_cli_tree(ctx.command))
+        ctx.exit()
+
+
+if __name__ == "__main__":
+    main()

chatvoice-0.0.1/src/chatvoice/config.py

@@ -0,0 +1,27 @@
+"Typed environment configuration for ChatVoice."
+
+from chatenv import BaseEnvConfig, EnvField
+
+
+class ChatvoiceConfig(BaseEnvConfig):
+    "ChatVoice ChatEnv configuration."
+
+    _title = "ChatVoice Configuration"
+    _aliases = ["chatvoice"]
+    _storage_dir = "Chatvoice"
+
+    @classmethod
+    def test(cls) -> None:
+        """Validate schema registration without external side effects."""
+
+        print(f"Testing {cls._title}...")
+        print("Schema loaded; no network test is required.")
+
+    CHATVOICE_API_KEY = EnvField(
+        "CHATVOICE_API_KEY",
+        desc="API key",
+        is_sensitive=True,
+    )
+
+
+__all__ = ["ChatvoiceConfig"]

chatvoice-0.0.1/tests/test_cli.py

@@ -0,0 +1,21 @@
+from click.testing import CliRunner
+
+from chatvoice import __version__
+from chatvoice.cli import main
+
+
+def test_version_option_reports_package_version():
+    result = CliRunner().invoke(main, ["--version"])
+
+    assert result.exit_code == 0
+    assert f"chatvoice, version {__version__}" in result.output
+
+
+def test_tree_option_prints_registered_cli_tree():
+    result = CliRunner().invoke(main, ["--tree"])
+
+    assert result.exit_code == 0, result.output
+    assert "chatvoice  # chatvoice command line interface" in result.output
+    assert "├── --help  # Show help for the current command." in result.output
+    assert "├── --version  # Show package version." in result.output
+    assert "└── --tree  # Print the registered CLI tree." in result.output

chatvoice-0.0.1/tests/test_version.py

@@ -0,0 +1,5 @@
+from chatvoice import __version__
+
+
+def test_version_present():
+    assert __version__ == "0.0.1"