ChatNet 0.1.0__tar.gz

chatnet-0.1.0/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.

chatnet-0.1.0/PKG-INFO

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: ChatNet
+Version: 0.1.0
+Summary: ChatArch network and campus-network CLI
+Author-email: ChatArch <1073853456@qq.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ChatArch/ChatNet
+Project-URL: Repository, https://github.com/ChatArch/ChatNet
+Project-URL: Documentation, https://ChatArch.github.io/ChatNet
+Keywords: chatnet,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
+Requires-Dist: requests>=2.0
+Requires-Dist: pycryptodome>=3.0
+Provides-Extra: captcha
+Requires-Dist: ddddocr; extra == "captcha"
+Requires-Dist: numpy; extra == "captcha"
+Requires-Dist: pillow; extra == "captcha"
+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/ChatNet">
+        <img src="https://img.shields.io/pypi/v/ChatNet.svg" alt="PyPI version" />
+    </a>
+    <a href="https://github.com/ChatArch/ChatNet/actions/workflows/ci.yml">
+        <img src="https://github.com/ChatArch/ChatNet/actions/workflows/ci.yml/badge.svg" alt="Tests" />
+    </a>
+    <a href="https://ChatArch.github.io/ChatNet">
+        <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>
+
+# ChatNet
+
+ChatNet 是 ChatArch 系列的网络与校园网 CLI，当前提供 ECNU 自助服务平台登录、查询和访客管理能力。
+
+## 快速开始
+
+```bash
+pip install -e ".[dev]"
+chatnet hello ChatArch
+chatnet ecnu selftest
+python -m pytest -q
+python -m build
+```
+
+## ECNU CLI
+
+ECNU 自助服务平台能力统一挂在 `chatnet ecnu` 下，覆盖登录、会话、日志查询和访客管理。
+
+默认配置使用 chatenv 规范，位于 `~/.chatarch/envs/ECNU/.env`：
+
+```bash
+chatenv cat -t ecnu
+```
+
+```bash
+chatnet ecnu login-init
+chatnet ecnu login --username "$ECNU_USERNAME" --password "$ECNU_PASSWORD" --captcha ABCD
+chatnet ecnu home
+chatnet ecnu auth-log --limit 10
+chatnet ecnu visitor list
+chatnet ecnu visitor create --remark GuestB
+chatnet ecnu visitor update --id 10256703 --remark GuestB --password 'Temp!235'
+```
+
+自动验证码登录依赖可选 OCR extra：
+
+```bash
+pip install -e ".[captcha]"
+chatnet ecnu login-auto --username "$ECNU_USERNAME" --password "$ECNU_PASSWORD"
+```
+
+缺少可恢复参数时，命令会按 ChatArch 规范进入交互补问；`-i` 强制交互，`-I` 禁止交互并快速失败。密码、Cookie、短信验证码等敏感值不要写入文档或提交记录。
+
+完整使用文档见 [`docs/ecnu.md`](docs/ecnu.md)。
+
+## 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`。

chatnet-0.1.0/README.md

@@ -0,0 +1,81 @@
+<div align="center">
+    <a href="https://pypi.python.org/pypi/ChatNet">
+        <img src="https://img.shields.io/pypi/v/ChatNet.svg" alt="PyPI version" />
+    </a>
+    <a href="https://github.com/ChatArch/ChatNet/actions/workflows/ci.yml">
+        <img src="https://github.com/ChatArch/ChatNet/actions/workflows/ci.yml/badge.svg" alt="Tests" />
+    </a>
+    <a href="https://ChatArch.github.io/ChatNet">
+        <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>
+
+# ChatNet
+
+ChatNet 是 ChatArch 系列的网络与校园网 CLI，当前提供 ECNU 自助服务平台登录、查询和访客管理能力。
+
+## 快速开始
+
+```bash
+pip install -e ".[dev]"
+chatnet hello ChatArch
+chatnet ecnu selftest
+python -m pytest -q
+python -m build
+```
+
+## ECNU CLI
+
+ECNU 自助服务平台能力统一挂在 `chatnet ecnu` 下，覆盖登录、会话、日志查询和访客管理。
+
+默认配置使用 chatenv 规范，位于 `~/.chatarch/envs/ECNU/.env`：
+
+```bash
+chatenv cat -t ecnu
+```
+
+```bash
+chatnet ecnu login-init
+chatnet ecnu login --username "$ECNU_USERNAME" --password "$ECNU_PASSWORD" --captcha ABCD
+chatnet ecnu home
+chatnet ecnu auth-log --limit 10
+chatnet ecnu visitor list
+chatnet ecnu visitor create --remark GuestB
+chatnet ecnu visitor update --id 10256703 --remark GuestB --password 'Temp!235'
+```
+
+自动验证码登录依赖可选 OCR extra：
+
+```bash
+pip install -e ".[captcha]"
+chatnet ecnu login-auto --username "$ECNU_USERNAME" --password "$ECNU_PASSWORD"
+```
+
+缺少可恢复参数时，命令会按 ChatArch 规范进入交互补问；`-i` 强制交互，`-I` 禁止交互并快速失败。密码、Cookie、短信验证码等敏感值不要写入文档或提交记录。
+
+完整使用文档见 [`docs/ecnu.md`](docs/ecnu.md)。
+
+## 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`。

chatnet-0.1.0/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ChatNet"
+dynamic = ["version"]
+description = "ChatArch network and campus-network CLI"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+dependencies = [
+    "click>=8.0",
+    "chatstyle>=0.1.0",
+    "chatenv>=0.1.1",
+    "requests>=2.0",
+    "pycryptodome>=3.0",
+]
+authors = [{name = "ChatArch", email = "1073853456@qq.com"}]
+keywords = ["chatnet", "chatarch", "cli"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+
+[project.scripts]
+chatnet = "chatnet.cli:main"
+
+[project.entry-points."chatenv.configs"]
+chatnet = "chatnet.config"
+
+[project.urls]
+Homepage = "https://github.com/ChatArch/ChatNet"
+Repository = "https://github.com/ChatArch/ChatNet"
+Documentation = "https://ChatArch.github.io/ChatNet"
+
+[project.optional-dependencies]
+captcha = ["ddddocr", "numpy", "pillow"]
+dev = ["build", "pytest", "twine"]
+docs = ["mkdocs>=1.4.0", "mkdocs-material>=9.0.0", "mike>=2.0.0"]
+
+[tool.setuptools.dynamic]
+version = {attr = "chatnet.__version__"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools]
+include-package-data = true

chatnet-0.1.0/setup.cfg

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

chatnet-0.1.0/src/ChatNet.egg-info/PKG-INFO

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: ChatNet
+Version: 0.1.0
+Summary: ChatArch network and campus-network CLI
+Author-email: ChatArch <1073853456@qq.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ChatArch/ChatNet
+Project-URL: Repository, https://github.com/ChatArch/ChatNet
+Project-URL: Documentation, https://ChatArch.github.io/ChatNet
+Keywords: chatnet,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
+Requires-Dist: requests>=2.0
+Requires-Dist: pycryptodome>=3.0
+Provides-Extra: captcha
+Requires-Dist: ddddocr; extra == "captcha"
+Requires-Dist: numpy; extra == "captcha"
+Requires-Dist: pillow; extra == "captcha"
+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/ChatNet">
+        <img src="https://img.shields.io/pypi/v/ChatNet.svg" alt="PyPI version" />
+    </a>
+    <a href="https://github.com/ChatArch/ChatNet/actions/workflows/ci.yml">
+        <img src="https://github.com/ChatArch/ChatNet/actions/workflows/ci.yml/badge.svg" alt="Tests" />
+    </a>
+    <a href="https://ChatArch.github.io/ChatNet">
+        <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>
+
+# ChatNet
+
+ChatNet 是 ChatArch 系列的网络与校园网 CLI，当前提供 ECNU 自助服务平台登录、查询和访客管理能力。
+
+## 快速开始
+
+```bash
+pip install -e ".[dev]"
+chatnet hello ChatArch
+chatnet ecnu selftest
+python -m pytest -q
+python -m build
+```
+
+## ECNU CLI
+
+ECNU 自助服务平台能力统一挂在 `chatnet ecnu` 下，覆盖登录、会话、日志查询和访客管理。
+
+默认配置使用 chatenv 规范，位于 `~/.chatarch/envs/ECNU/.env`：
+
+```bash
+chatenv cat -t ecnu
+```
+
+```bash
+chatnet ecnu login-init
+chatnet ecnu login --username "$ECNU_USERNAME" --password "$ECNU_PASSWORD" --captcha ABCD
+chatnet ecnu home
+chatnet ecnu auth-log --limit 10
+chatnet ecnu visitor list
+chatnet ecnu visitor create --remark GuestB
+chatnet ecnu visitor update --id 10256703 --remark GuestB --password 'Temp!235'
+```
+
+自动验证码登录依赖可选 OCR extra：
+
+```bash
+pip install -e ".[captcha]"
+chatnet ecnu login-auto --username "$ECNU_USERNAME" --password "$ECNU_PASSWORD"
+```
+
+缺少可恢复参数时，命令会按 ChatArch 规范进入交互补问；`-i` 强制交互，`-I` 禁止交互并快速失败。密码、Cookie、短信验证码等敏感值不要写入文档或提交记录。
+
+完整使用文档见 [`docs/ecnu.md`](docs/ecnu.md)。
+
+## 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`。

chatnet-0.1.0/src/ChatNet.egg-info/SOURCES.txt

@@ -0,0 +1,18 @@
+LICENSE
+README.md
+pyproject.toml
+src/ChatNet.egg-info/PKG-INFO
+src/ChatNet.egg-info/SOURCES.txt
+src/ChatNet.egg-info/dependency_links.txt
+src/ChatNet.egg-info/entry_points.txt
+src/ChatNet.egg-info/requires.txt
+src/ChatNet.egg-info/top_level.txt
+src/chatnet/__init__.py
+src/chatnet/cli.py
+src/chatnet/config.py
+src/chatnet/ecnu/__init__.py
+src/chatnet/ecnu/captcha.py
+src/chatnet/ecnu/cli.py
+src/chatnet/ecnu/portal.py
+tests/test_cli.py
+tests/test_version.py

chatnet-0.1.0/src/ChatNet.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

chatnet-0.1.0/src/ChatNet.egg-info/entry_points.txt

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

chatnet-0.1.0/src/ChatNet.egg-info/requires.txt

@@ -0,0 +1,20 @@
+click>=8.0
+chatstyle>=0.1.0
+chatenv>=0.1.1
+requests>=2.0
+pycryptodome>=3.0
+
+[captcha]
+ddddocr
+numpy
+pillow
+
+[dev]
+build
+pytest
+twine
+
+[docs]
+mkdocs>=1.4.0
+mkdocs-material>=9.0.0
+mike>=2.0.0

chatnet-0.1.0/src/ChatNet.egg-info/top_level.txt

@@ -0,0 +1 @@
+chatnet

chatnet-0.1.0/src/chatnet/__init__.py

@@ -0,0 +1,5 @@
+"""ChatArch network and campus-network CLI."""
+
+__all__ = ["__version__"]
+
+__version__ = "0.1.0"

chatnet-0.1.0/src/chatnet/cli.py

@@ -0,0 +1,58 @@
+"""CLI entrypoint for chatnet."""
+
+from __future__ import annotations
+
+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),),
+)
+
+
+class ChatNetGroup(click.Group):
+    """Top-level group that loads heavier feature groups on demand."""
+
+    def list_commands(self, ctx: click.Context) -> list[str]:
+        commands = set(super().list_commands(ctx))
+        commands.add("ecnu")
+        return sorted(commands)
+
+    def get_command(self, ctx: click.Context, cmd_name: str) -> click.Command | None:
+        if cmd_name == "ecnu":
+            from chatnet.ecnu.cli import cli as ecnu_cli
+
+            return ecnu_cli
+        return super().get_command(ctx, cmd_name)
+
+
+@click.group(cls=ChatNetGroup)
+def main() -> None:
+    """chatnet 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: chatnet hello [NAME]",
+    )
+    render_success(f"Hello, {values['name']}!")
+
+
+if __name__ == "__main__":
+    main()

chatnet-0.1.0/src/chatnet/config.py

@@ -0,0 +1,21 @@
+"""ChatEnv configuration schemas provided by ChatNet."""
+
+from __future__ import annotations
+
+from chatenv.fields import BaseEnvConfig, EnvField
+
+
+class ECNUConfig(BaseEnvConfig):
+    """ECNU self-service portal environment variables."""
+
+    _title = "ECNU"
+    _aliases = ["ecnu", "chatnet-ecnu"]
+    _storage_dir = "ECNU"
+
+    ECNU_USERNAME = EnvField("ECNU_USERNAME", desc="ECNU username.")
+    ECNU_PASSWORD = EnvField("ECNU_PASSWORD", desc="ECNU password.", is_sensitive=True)
+    ECNU_COOKIE = EnvField("ECNU_COOKIE", desc="Authenticated ECNU portal Cookie header.", is_sensitive=True)
+    ECNU_BASE_URL = EnvField("ECNU_BASE_URL", default="https://login.ecnu.edu.cn:8800", desc="ECNU portal base URL.")
+
+
+__all__ = ["ECNUConfig"]

chatnet-0.1.0/src/chatnet/ecnu/__init__.py

@@ -0,0 +1,5 @@
+"""ECNU self-service portal integration for ChatNet."""
+
+from .portal import BASE_URL, PortalClient
+
+__all__ = ["BASE_URL", "PortalClient"]