ChatLogin 0.0.1__tar.gz

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

chatlogin-0.0.1/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: ChatLogin
+Version: 0.0.1
+Summary: ChatLogin: ChatArch Python package scaffold; login features are not implemented yet.
+Author-email: ChatArch <1073853456@qq.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ChatArch/ChatLogin
+Project-URL: Repository, https://github.com/ChatArch/ChatLogin
+Project-URL: Documentation, https://arch.gh.wzhecnu.cn/ChatLogin/
+Keywords: chatlogin,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.3.0,>=0.2.0
+Requires-Dist: chatenv<0.3.0,>=0.2.11
+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/ChatLogin">
+        <img src="https://img.shields.io/pypi/v/ChatLogin.svg" alt="PyPI version" />
+    </a>
+    <a href="https://github.com/ChatArch/ChatLogin/actions/workflows/ci.yml">
+        <img src="https://github.com/ChatArch/ChatLogin/actions/workflows/ci.yml/badge.svg" alt="Tests" />
+    </a>
+    <a href="https://arch.gh.wzhecnu.cn/ChatLogin/">
+        <img src="https://img.shields.io/badge/docs-mkdocs-blue.svg" alt="Documentation" />
+    </a>
+</div>
+
+<div align="center">
+
+[英文版](README.en.md) | [简体中文](README.md)
+</div>
+
+# ChatLogin
+
+ChatLogin 是面向网站集成的 ChatArch Python 包。当前版本只提供标准包结构、命令行和配置扩展入口，尚未实现登录、用户管理或鉴权功能。
+
+
+文档入口：<https://arch.gh.wzhecnu.cn/ChatLogin/>
+
+按场景选择文档：
+
+| 场景 | 文档 |
+| --- | --- |
+| 第一次安装、运行命令行、确认包可用 | [CLI 树](docs/cli-tree.md) |
+| 校对当前包有哪些一等能力和边界 | [能力地图](docs/capability-map.md) |
+| 从 Python 代码调用包能力 | [接口树](docs/interface-tree.md) |
+
+## 快速开始
+
+安装已发布的初始模板：
+
+```bash
+pip install ChatLogin
+chatlogin --version
+chatlogin --tree
+```
+
+开发安装与测试：
+
+```bash
+pip install -e ".[dev]"
+chatlogin --help
+chatlogin --version
+chatlogin --tree
+chatlogin --tree-brief
+python -m pytest -q
+python -m build
+```
+
+## 命令行规范
+
+这个模板默认依赖 `chatstyle>=0.2.0,<0.3.0` 和 `chatenv>=0.2.11,<0.3.0`，新增命令应优先使用：
+
+- `add_tree_option()` 提供共享的 `--tree` / `--tree-brief`，`render_click_tree()` 从已注册 Click 元数据生成命令树。
+- `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`。

chatlogin-0.0.1/README.md

@@ -0,0 +1,75 @@
+<div align="center">
+    <a href="https://pypi.python.org/pypi/ChatLogin">
+        <img src="https://img.shields.io/pypi/v/ChatLogin.svg" alt="PyPI version" />
+    </a>
+    <a href="https://github.com/ChatArch/ChatLogin/actions/workflows/ci.yml">
+        <img src="https://github.com/ChatArch/ChatLogin/actions/workflows/ci.yml/badge.svg" alt="Tests" />
+    </a>
+    <a href="https://arch.gh.wzhecnu.cn/ChatLogin/">
+        <img src="https://img.shields.io/badge/docs-mkdocs-blue.svg" alt="Documentation" />
+    </a>
+</div>
+
+<div align="center">
+
+[英文版](README.en.md) | [简体中文](README.md)
+</div>
+
+# ChatLogin
+
+ChatLogin 是面向网站集成的 ChatArch Python 包。当前版本只提供标准包结构、命令行和配置扩展入口，尚未实现登录、用户管理或鉴权功能。
+
+
+文档入口：<https://arch.gh.wzhecnu.cn/ChatLogin/>
+
+按场景选择文档：
+
+| 场景 | 文档 |
+| --- | --- |
+| 第一次安装、运行命令行、确认包可用 | [CLI 树](docs/cli-tree.md) |
+| 校对当前包有哪些一等能力和边界 | [能力地图](docs/capability-map.md) |
+| 从 Python 代码调用包能力 | [接口树](docs/interface-tree.md) |
+
+## 快速开始
+
+安装已发布的初始模板：
+
+```bash
+pip install ChatLogin
+chatlogin --version
+chatlogin --tree
+```
+
+开发安装与测试：
+
+```bash
+pip install -e ".[dev]"
+chatlogin --help
+chatlogin --version
+chatlogin --tree
+chatlogin --tree-brief
+python -m pytest -q
+python -m build
+```
+
+## 命令行规范
+
+这个模板默认依赖 `chatstyle>=0.2.0,<0.3.0` 和 `chatenv>=0.2.11,<0.3.0`，新增命令应优先使用：
+
+- `add_tree_option()` 提供共享的 `--tree` / `--tree-brief`，`render_click_tree()` 从已注册 Click 元数据生成命令树。
+- `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`。

chatlogin-0.0.1/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ChatLogin"
+dynamic = ["version"]
+description = "ChatLogin: ChatArch Python package scaffold; login features are not implemented yet."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+dependencies = ["click>=8.0", "chatstyle>=0.2.0,<0.3.0", "chatenv>=0.2.11,<0.3.0"]
+authors = [{name = "ChatArch", email = "1073853456@qq.com"}]
+keywords = ["chatlogin", "chatarch", "cli"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://github.com/ChatArch/ChatLogin"
+Repository = "https://github.com/ChatArch/ChatLogin"
+Documentation = "https://arch.gh.wzhecnu.cn/ChatLogin/"
+
+[project.scripts]
+chatlogin = "chatlogin.cli:main"
+
+[project.entry-points."chatenv.configs"]
+chatlogin = "chatlogin.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 = "chatlogin.__version__"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools]
+include-package-data = true

chatlogin-0.0.1/setup.cfg

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

chatlogin-0.0.1/src/ChatLogin.egg-info/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: ChatLogin
+Version: 0.0.1
+Summary: ChatLogin: ChatArch Python package scaffold; login features are not implemented yet.
+Author-email: ChatArch <1073853456@qq.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ChatArch/ChatLogin
+Project-URL: Repository, https://github.com/ChatArch/ChatLogin
+Project-URL: Documentation, https://arch.gh.wzhecnu.cn/ChatLogin/
+Keywords: chatlogin,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.3.0,>=0.2.0
+Requires-Dist: chatenv<0.3.0,>=0.2.11
+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/ChatLogin">
+        <img src="https://img.shields.io/pypi/v/ChatLogin.svg" alt="PyPI version" />
+    </a>
+    <a href="https://github.com/ChatArch/ChatLogin/actions/workflows/ci.yml">
+        <img src="https://github.com/ChatArch/ChatLogin/actions/workflows/ci.yml/badge.svg" alt="Tests" />
+    </a>
+    <a href="https://arch.gh.wzhecnu.cn/ChatLogin/">
+        <img src="https://img.shields.io/badge/docs-mkdocs-blue.svg" alt="Documentation" />
+    </a>
+</div>
+
+<div align="center">
+
+[英文版](README.en.md) | [简体中文](README.md)
+</div>
+
+# ChatLogin
+
+ChatLogin 是面向网站集成的 ChatArch Python 包。当前版本只提供标准包结构、命令行和配置扩展入口，尚未实现登录、用户管理或鉴权功能。
+
+
+文档入口：<https://arch.gh.wzhecnu.cn/ChatLogin/>
+
+按场景选择文档：
+
+| 场景 | 文档 |
+| --- | --- |
+| 第一次安装、运行命令行、确认包可用 | [CLI 树](docs/cli-tree.md) |
+| 校对当前包有哪些一等能力和边界 | [能力地图](docs/capability-map.md) |
+| 从 Python 代码调用包能力 | [接口树](docs/interface-tree.md) |
+
+## 快速开始
+
+安装已发布的初始模板：
+
+```bash
+pip install ChatLogin
+chatlogin --version
+chatlogin --tree
+```
+
+开发安装与测试：
+
+```bash
+pip install -e ".[dev]"
+chatlogin --help
+chatlogin --version
+chatlogin --tree
+chatlogin --tree-brief
+python -m pytest -q
+python -m build
+```
+
+## 命令行规范
+
+这个模板默认依赖 `chatstyle>=0.2.0,<0.3.0` 和 `chatenv>=0.2.11,<0.3.0`，新增命令应优先使用：
+
+- `add_tree_option()` 提供共享的 `--tree` / `--tree-brief`，`render_click_tree()` 从已注册 Click 元数据生成命令树。
+- `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`。

chatlogin-0.0.1/src/ChatLogin.egg-info/SOURCES.txt

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

chatlogin-0.0.1/src/ChatLogin.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

chatlogin-0.0.1/src/ChatLogin.egg-info/entry_points.txt

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

chatlogin-0.0.1/src/ChatLogin.egg-info/requires.txt

@@ -0,0 +1,14 @@
+click>=8.0
+chatstyle<0.3.0,>=0.2.0
+chatenv<0.3.0,>=0.2.11
+
+[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

chatlogin-0.0.1/src/ChatLogin.egg-info/top_level.txt

@@ -0,0 +1 @@
+chatlogin

chatlogin-0.0.1/src/chatlogin/__init__.py

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

chatlogin-0.0.1/src/chatlogin/cli.py

@@ -0,0 +1,22 @@
+"""CLI entrypoint for chatlogin."""
+
+from __future__ import annotations
+
+import click
+from chatstyle import add_tree_option
+
+from chatlogin import __version__
+
+
+@click.group(name="chatlogin", invoke_without_command=True, no_args_is_help=True)
+@click.version_option(__version__, prog_name="chatlogin")
+@add_tree_option(renderer_options={"root_name": "chatlogin"})
+def main() -> None:
+    """chatlogin command line interface."""
+    # Add package-specific commands here. Prefer ChatStyle helpers for
+    # interactive input when a command needs recoverable user input.
+    pass
+
+
+if __name__ == "__main__":
+    main()

chatlogin-0.0.1/src/chatlogin/config.py

@@ -0,0 +1,19 @@
+"""ChatEnv extension point for ChatLogin; no login configuration yet."""
+
+from chatenv import BaseEnvConfig
+
+
+class ChatLoginConfig(BaseEnvConfig):
+    """Namespace reserved for future, explicitly defined login settings."""
+
+    _title = "ChatLogin Configuration"
+    _aliases = ["chatlogin"]
+    _storage_dir = "ChatLogin"
+
+    @classmethod
+    def test(cls) -> None:
+        """Validate schema registration without network or storage writes."""
+        print("ChatLogin schema loaded; login features are not implemented yet.")
+
+
+__all__ = ["ChatLoginConfig"]

chatlogin-0.0.1/tests/test_cli.py

@@ -0,0 +1,39 @@
+from click.testing import CliRunner
+
+from chatlogin import __version__
+from chatlogin.cli import main
+
+
+def test_version_option_reports_package_version():
+    result = CliRunner().invoke(main, ["--version"])
+
+    assert result.exit_code == 0
+    assert f"chatlogin, version {__version__}" in result.output
+
+
+def test_help_lists_shared_tree_options():
+    result = CliRunner().invoke(main, ["--help"])
+
+    assert result.exit_code == 0
+    assert "--tree" in result.output
+    assert "--tree-brief" in result.output
+
+
+def test_tree_option_prints_registered_cli_tree():
+    result = CliRunner().invoke(main, ["--tree"])
+
+    assert result.exit_code == 0, result.output
+    assert result.output.startswith("chatlogin\n")
+    assert "├── --help" in result.output
+    assert "├── --version" in result.output
+    assert "├── --tree" in result.output
+    assert "└── --tree-brief" in result.output
+
+
+def test_tree_brief_option_prints_registered_cli_tree():
+    result = CliRunner().invoke(main, ["--tree-brief"])
+
+    assert result.exit_code == 0, result.output
+    assert result.output.startswith("chatlogin\n")
+    assert "├── --tree" in result.output
+    assert "└── --tree-brief" in result.output

chatlogin-0.0.1/tests/test_version.py

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