ChatLink 0.0.1__tar.gz

chatlink-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.

chatlink-0.0.1/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: ChatLink
+Version: 0.0.1
+Summary: ChatLink: ChatArch link utilities
+Author-email: ChatArch <1073853456@qq.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ChatArch/ChatLink
+Project-URL: Repository, https://github.com/ChatArch/ChatLink
+Project-URL: Documentation, https://ChatArch.github.io/ChatLink
+Keywords: chatlink,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.1.0
+Requires-Dist: chatenv>=0.1.1
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.4.0; extra == "docs"
+Requires-Dist: mkdocs-material>=9.0.0; extra == "docs"
+Requires-Dist: mike>=2.0.0; extra == "docs"
+Dynamic: license-file
+
+<div align="center">
+    <a href="https://pypi.python.org/pypi/ChatLink">
+        <img src="https://img.shields.io/pypi/v/ChatLink.svg" alt="PyPI version" />
+    </a>
+    <a href="https://github.com/ChatArch/ChatLink/actions/workflows/ci.yml">
+        <img src="https://github.com/ChatArch/ChatLink/actions/workflows/ci.yml/badge.svg" alt="Tests" />
+    </a>
+    <a href="https://ChatArch.github.io/ChatLink">
+        <img src="https://img.shields.io/badge/docs-mkdocs-blue.svg" alt="Documentation" />
+    </a>
+</div>
+
+<div align="center">
+
+[English](README.en.md) | [简体中文](README.md)
+</div>
+
+# ChatLink
+
+ChatLink: ChatArch link utilities
+
+## 快速开始
+
+```bash
+pip install -e ".[dev]"
+chatlink hello ChatArch
+python -m pytest -q
+python -m build
+```
+
+## CLI 规范
+
+这个模板默认依赖 `chatstyle>=0.1.0` 和 `chatenv>=0.1.1`，新的命令应优先使用：
+
+- `CommandSchema` / `CommandField` 描述输入。
+- `add_interactive_option()` 提供统一 `-i/-I`。
+- `resolve_command_inputs()` 统一缺参补问、默认值、TTY 与校验。
+
+## 目录结构
+
+- `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`。

chatlink-0.0.1/README.md

@@ -0,0 +1,49 @@
+<div align="center">
+    <a href="https://pypi.python.org/pypi/ChatLink">
+        <img src="https://img.shields.io/pypi/v/ChatLink.svg" alt="PyPI version" />
+    </a>
+    <a href="https://github.com/ChatArch/ChatLink/actions/workflows/ci.yml">
+        <img src="https://github.com/ChatArch/ChatLink/actions/workflows/ci.yml/badge.svg" alt="Tests" />
+    </a>
+    <a href="https://ChatArch.github.io/ChatLink">
+        <img src="https://img.shields.io/badge/docs-mkdocs-blue.svg" alt="Documentation" />
+    </a>
+</div>
+
+<div align="center">
+
+[English](README.en.md) | [简体中文](README.md)
+</div>
+
+# ChatLink
+
+ChatLink: ChatArch link utilities
+
+## 快速开始
+
+```bash
+pip install -e ".[dev]"
+chatlink hello ChatArch
+python -m pytest -q
+python -m build
+```
+
+## CLI 规范
+
+这个模板默认依赖 `chatstyle>=0.1.0` 和 `chatenv>=0.1.1`，新的命令应优先使用：
+
+- `CommandSchema` / `CommandField` 描述输入。
+- `add_interactive_option()` 提供统一 `-i/-I`。
+- `resolve_command_inputs()` 统一缺参补问、默认值、TTY 与校验。
+
+## 目录结构
+
+- `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`。

chatlink-0.0.1/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ChatLink"
+dynamic = ["version"]
+description = "ChatLink: ChatArch link utilities"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+dependencies = ["click>=8.0", "chatstyle>=0.1.0", "chatenv>=0.1.1"]
+authors = [{name = "ChatArch", email = "1073853456@qq.com"}]
+keywords = ["chatlink", "chatarch", "cli"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://github.com/ChatArch/ChatLink"
+Repository = "https://github.com/ChatArch/ChatLink"
+Documentation = "https://ChatArch.github.io/ChatLink"
+
+[project.scripts]
+chatlink = "chatlink.cli:main"
+
+[project.optional-dependencies]
+dev = ["build", "pytest", "twine"]
+docs = ["mkdocs>=1.4.0", "mkdocs-material>=9.0.0", "mike>=2.0.0"]
+
+[tool.setuptools.dynamic]
+version = {attr = "chatlink.__version__"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools]
+include-package-data = true

chatlink-0.0.1/setup.cfg

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

chatlink-0.0.1/src/ChatLink.egg-info/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: ChatLink
+Version: 0.0.1
+Summary: ChatLink: ChatArch link utilities
+Author-email: ChatArch <1073853456@qq.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ChatArch/ChatLink
+Project-URL: Repository, https://github.com/ChatArch/ChatLink
+Project-URL: Documentation, https://ChatArch.github.io/ChatLink
+Keywords: chatlink,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.1.0
+Requires-Dist: chatenv>=0.1.1
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.4.0; extra == "docs"
+Requires-Dist: mkdocs-material>=9.0.0; extra == "docs"
+Requires-Dist: mike>=2.0.0; extra == "docs"
+Dynamic: license-file
+
+<div align="center">
+    <a href="https://pypi.python.org/pypi/ChatLink">
+        <img src="https://img.shields.io/pypi/v/ChatLink.svg" alt="PyPI version" />
+    </a>
+    <a href="https://github.com/ChatArch/ChatLink/actions/workflows/ci.yml">
+        <img src="https://github.com/ChatArch/ChatLink/actions/workflows/ci.yml/badge.svg" alt="Tests" />
+    </a>
+    <a href="https://ChatArch.github.io/ChatLink">
+        <img src="https://img.shields.io/badge/docs-mkdocs-blue.svg" alt="Documentation" />
+    </a>
+</div>
+
+<div align="center">
+
+[English](README.en.md) | [简体中文](README.md)
+</div>
+
+# ChatLink
+
+ChatLink: ChatArch link utilities
+
+## 快速开始
+
+```bash
+pip install -e ".[dev]"
+chatlink hello ChatArch
+python -m pytest -q
+python -m build
+```
+
+## CLI 规范
+
+这个模板默认依赖 `chatstyle>=0.1.0` 和 `chatenv>=0.1.1`，新的命令应优先使用：
+
+- `CommandSchema` / `CommandField` 描述输入。
+- `add_interactive_option()` 提供统一 `-i/-I`。
+- `resolve_command_inputs()` 统一缺参补问、默认值、TTY 与校验。
+
+## 目录结构
+
+- `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`。

chatlink-0.0.1/src/ChatLink.egg-info/SOURCES.txt

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

chatlink-0.0.1/src/ChatLink.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

chatlink-0.0.1/src/ChatLink.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+chatlink = chatlink.cli:main

chatlink-0.0.1/src/ChatLink.egg-info/requires.txt

@@ -0,0 +1,13 @@
+click>=8.0
+chatstyle>=0.1.0
+chatenv>=0.1.1
+
+[dev]
+build
+pytest
+twine
+
+[docs]
+mkdocs>=1.4.0
+mkdocs-material>=9.0.0
+mike>=2.0.0

chatlink-0.0.1/src/ChatLink.egg-info/top_level.txt

@@ -0,0 +1 @@
+chatlink

chatlink-0.0.1/src/chatlink/__init__.py

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

chatlink-0.0.1/src/chatlink/cli.py

@@ -0,0 +1,40 @@
+"""CLI entrypoint for chatlink."""
+
+import click
+from chatstyle import (
+    CommandField,
+    CommandSchema,
+    add_interactive_option,
+    render_success,
+    resolve_command_inputs,
+)
+
+
+HELLO_SCHEMA = CommandSchema(
+    name="hello",
+    fields=(CommandField("name", prompt="name", required=True),),
+)
+
+
+@click.group()
+def main() -> None:
+    """chatlink command line interface."""
+
+
+@main.command()
+@click.argument("name", required=False)
+@add_interactive_option
+def hello(name: str | None, interactive: bool | None) -> None:
+    """Print a greeting with ChatStyle-backed input resolution."""
+
+    values = resolve_command_inputs(
+        schema=HELLO_SCHEMA,
+        provided={"name": name},
+        interactive=interactive,
+        usage="Usage: chatlink hello [NAME]",
+    )
+    render_success(f"Hello, {values['name']}!")
+
+
+if __name__ == "__main__":
+    main()

chatlink-0.0.1/tests/test_cli.py

@@ -0,0 +1,10 @@
+from click.testing import CliRunner
+
+from chatlink.cli import main
+
+
+def test_hello_command_accepts_explicit_name():
+    result = CliRunner().invoke(main, ["hello", "ChatArch"])
+
+    assert result.exit_code == 0
+    assert "Hello, ChatArch!" in result.output

chatlink-0.0.1/tests/test_version.py

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