ChatGlance 0.1.0__tar.gz

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

chatglance-0.1.0/PKG-INFO

@@ -0,0 +1,123 @@
+Metadata-Version: 2.4
+Name: ChatGlance
+Version: 0.1.0
+Summary: ChatArch Glance dashboard generation CLI.
+Author-email: ChatArch <1073853456@qq.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ChatArch/ChatGlance
+Project-URL: Repository, https://github.com/ChatArch/ChatGlance
+Keywords: chatglance,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: PyYAML<7.0,>=6.0
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+    <a href="https://pypi.python.org/pypi/ChatGlance">
+        <img src="https://img.shields.io/pypi/v/ChatGlance.svg" alt="PyPI version" />
+    </a>
+    <a href="https://github.com/ChatArch/ChatGlance/actions/workflows/ci.yml">
+        <img src="https://github.com/ChatArch/ChatGlance/actions/workflows/ci.yml/badge.svg" alt="Tests" />
+    </a>
+</div>
+
+<div align="center">
+
+[English](README.en.md) | [简体中文](README.md)
+</div>
+
+# ChatGlance
+
+`ChatGlance` 是 ChatArch/WZHECNU Glance dashboard 的 Python 生成与运维包，提供 `chatglance` CLI。
+
+它不是 NPM 项目，也不是重新实现 Glance 后端：上游 Glance 仍然是 Go 单二进制 dashboard server；`ChatGlance` 负责把 ChatArch 项目清单、Glance YAML 页面、inline HTML 表格和安全运维补丁组织成可复用的 Python 包/CLI。
+
+## 当前能力
+
+- 从 repository inventory JSON 生成 Glance `项目` page。
+- 当前 page tabs 固定为：`最近提交`、`待处理 PR / Issue`、`分类`、`一览表`。
+- `待处理 PR / Issue` 只显示 PR/Issue 非 0 的仓库，并按 `(PR, Issue, 最近提交)` 降序。
+- 生成 config 副本时清理 legacy generated pages：`Projects`、`ChatArch Projects`、`ChatArch Projects List`。
+- 为 Glance `server-stats` 写入 root-only Disk 配置：`hide-mountpoints-by-default: true` + `mountpoints: /`，避免 snap/loop mount 出现在 Disk popover。
+- 维护 durable runtime：一次性 `runtime maintain` 可原子更新 live config、备份、校验，并在内容变化时可选重启 systemd user service。
+- 渲染 systemd user units：主服务仍直接启动 upstream Glance Go binary；维护任务是独立 oneshot/timer，不是 Python wrapper。
+
+## 快速开始
+
+```bash
+pip install -e ".[dev]"
+chatglance --help
+chatglance --tree
+chatglance --version
+python -m pytest -q
+python -m build
+```
+
+## CLI 示例
+
+只生成 `项目` page YAML：
+
+```bash
+chatglance projects render-page \
+  --data /path/to/chatarch-projects.json \
+  --output playground/projects-page.yml
+```
+
+把生成页写入一个 Glance config 副本：
+
+```bash
+chatglance projects update-config \
+  --data /path/to/chatarch-projects.json \
+  --config /path/to/glance.yml \
+  --output playground/glance.with-projects.yml
+```
+
+把 `server-stats` Disk 改成只显示 root 分区，写入 config 副本：
+
+```bash
+chatglance disks root-only \
+  --config /path/to/glance.yml \
+  --output playground/glance.root-disk.yml
+```
+
+维护一个 durable Glance runtime（默认 `~/.chatarch/glance`）：
+
+```bash
+chatglance runtime maintain \
+  --runtime-home ~/.chatarch/glance \
+  --restart-service chatarch-glance.service
+```
+
+生成推荐 systemd user units：
+
+```bash
+chatglance runtime render-systemd \
+  --runtime-home ~/.chatarch/glance \
+  --chatglance-bin ~/.chatarch/venv/bin/chatglance \
+  --output-dir playground/systemd
+```
+
+## 运行态边界
+
+推荐拓扑是 **systemd 直接运行 Glance，chatglance 只做维护**：
+
+- 主服务：`chatarch-glance.service` 直接执行 `~/.chatarch/glance/bin/glance -config ~/.chatarch/glance/config/glance.yml`。
+- 内容数据：repository inventory JSON、缓存和生成快照放在 `~/.chatarch/glance/data/` 或 `~/.chatarch/glance/cache/`。
+- live config：`~/.chatarch/glance/config/glance.yml`；更新前写备份到 `~/.chatarch/glance/config/backups/`。
+- 维护：`chatglance runtime maintain` 是 oneshot，可由 `chatarch-glance-maintenance.timer` 周期触发。
+- 不建议加 Python 长驻 wrapper：wrapper 会把 server 生命周期和内容生成耦合，反而不利于 systemd 重启、日志、健康检查和回滚。
+
+## 安全边界
+
+- CLI 默认写 output file，不默认覆盖 live `glance.yml`。
+- 不保存或输出 Glance auth、password hash、GitHub token、proxy credential。
+- live runtime、logs、backups、全量实时 JSON 快照默认不进源码仓库。
+- 后续如需动态表格、搜索、中英文切换，再考虑增加小型静态前端层；当前 Python CLI 是基础层。

chatglance-0.1.0/README.md

@@ -0,0 +1,101 @@
+<div align="center">
+    <a href="https://pypi.python.org/pypi/ChatGlance">
+        <img src="https://img.shields.io/pypi/v/ChatGlance.svg" alt="PyPI version" />
+    </a>
+    <a href="https://github.com/ChatArch/ChatGlance/actions/workflows/ci.yml">
+        <img src="https://github.com/ChatArch/ChatGlance/actions/workflows/ci.yml/badge.svg" alt="Tests" />
+    </a>
+</div>
+
+<div align="center">
+
+[English](README.en.md) | [简体中文](README.md)
+</div>
+
+# ChatGlance
+
+`ChatGlance` 是 ChatArch/WZHECNU Glance dashboard 的 Python 生成与运维包，提供 `chatglance` CLI。
+
+它不是 NPM 项目，也不是重新实现 Glance 后端：上游 Glance 仍然是 Go 单二进制 dashboard server；`ChatGlance` 负责把 ChatArch 项目清单、Glance YAML 页面、inline HTML 表格和安全运维补丁组织成可复用的 Python 包/CLI。
+
+## 当前能力
+
+- 从 repository inventory JSON 生成 Glance `项目` page。
+- 当前 page tabs 固定为：`最近提交`、`待处理 PR / Issue`、`分类`、`一览表`。
+- `待处理 PR / Issue` 只显示 PR/Issue 非 0 的仓库，并按 `(PR, Issue, 最近提交)` 降序。
+- 生成 config 副本时清理 legacy generated pages：`Projects`、`ChatArch Projects`、`ChatArch Projects List`。
+- 为 Glance `server-stats` 写入 root-only Disk 配置：`hide-mountpoints-by-default: true` + `mountpoints: /`，避免 snap/loop mount 出现在 Disk popover。
+- 维护 durable runtime：一次性 `runtime maintain` 可原子更新 live config、备份、校验，并在内容变化时可选重启 systemd user service。
+- 渲染 systemd user units：主服务仍直接启动 upstream Glance Go binary；维护任务是独立 oneshot/timer，不是 Python wrapper。
+
+## 快速开始
+
+```bash
+pip install -e ".[dev]"
+chatglance --help
+chatglance --tree
+chatglance --version
+python -m pytest -q
+python -m build
+```
+
+## CLI 示例
+
+只生成 `项目` page YAML：
+
+```bash
+chatglance projects render-page \
+  --data /path/to/chatarch-projects.json \
+  --output playground/projects-page.yml
+```
+
+把生成页写入一个 Glance config 副本：
+
+```bash
+chatglance projects update-config \
+  --data /path/to/chatarch-projects.json \
+  --config /path/to/glance.yml \
+  --output playground/glance.with-projects.yml
+```
+
+把 `server-stats` Disk 改成只显示 root 分区，写入 config 副本：
+
+```bash
+chatglance disks root-only \
+  --config /path/to/glance.yml \
+  --output playground/glance.root-disk.yml
+```
+
+维护一个 durable Glance runtime（默认 `~/.chatarch/glance`）：
+
+```bash
+chatglance runtime maintain \
+  --runtime-home ~/.chatarch/glance \
+  --restart-service chatarch-glance.service
+```
+
+生成推荐 systemd user units：
+
+```bash
+chatglance runtime render-systemd \
+  --runtime-home ~/.chatarch/glance \
+  --chatglance-bin ~/.chatarch/venv/bin/chatglance \
+  --output-dir playground/systemd
+```
+
+## 运行态边界
+
+推荐拓扑是 **systemd 直接运行 Glance，chatglance 只做维护**：
+
+- 主服务：`chatarch-glance.service` 直接执行 `~/.chatarch/glance/bin/glance -config ~/.chatarch/glance/config/glance.yml`。
+- 内容数据：repository inventory JSON、缓存和生成快照放在 `~/.chatarch/glance/data/` 或 `~/.chatarch/glance/cache/`。
+- live config：`~/.chatarch/glance/config/glance.yml`；更新前写备份到 `~/.chatarch/glance/config/backups/`。
+- 维护：`chatglance runtime maintain` 是 oneshot，可由 `chatarch-glance-maintenance.timer` 周期触发。
+- 不建议加 Python 长驻 wrapper：wrapper 会把 server 生命周期和内容生成耦合，反而不利于 systemd 重启、日志、健康检查和回滚。
+
+## 安全边界
+
+- CLI 默认写 output file，不默认覆盖 live `glance.yml`。
+- 不保存或输出 Glance auth、password hash、GitHub token、proxy credential。
+- live runtime、logs、backups、全量实时 JSON 快照默认不进源码仓库。
+- 后续如需动态表格、搜索、中英文切换，再考虑增加小型静态前端层；当前 Python CLI 是基础层。

chatglance-0.1.0/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ChatGlance"
+dynamic = ["version"]
+description = "ChatArch Glance dashboard generation CLI."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+dependencies = ["click>=8.0", "PyYAML>=6.0,<7.0"]
+authors = [{name = "ChatArch", email = "1073853456@qq.com"}]
+keywords = ["chatglance", "chatarch", "cli"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://github.com/ChatArch/ChatGlance"
+Repository = "https://github.com/ChatArch/ChatGlance"
+
+[project.scripts]
+chatglance = "chatglance.cli:main"
+
+[project.optional-dependencies]
+dev = ["build", "pytest", "twine"]
+
+[tool.setuptools.dynamic]
+version = {attr = "chatglance.__version__"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools]
+include-package-data = true

chatglance-0.1.0/setup.cfg

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

chatglance-0.1.0/src/ChatGlance.egg-info/PKG-INFO

@@ -0,0 +1,123 @@
+Metadata-Version: 2.4
+Name: ChatGlance
+Version: 0.1.0
+Summary: ChatArch Glance dashboard generation CLI.
+Author-email: ChatArch <1073853456@qq.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ChatArch/ChatGlance
+Project-URL: Repository, https://github.com/ChatArch/ChatGlance
+Keywords: chatglance,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: PyYAML<7.0,>=6.0
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+    <a href="https://pypi.python.org/pypi/ChatGlance">
+        <img src="https://img.shields.io/pypi/v/ChatGlance.svg" alt="PyPI version" />
+    </a>
+    <a href="https://github.com/ChatArch/ChatGlance/actions/workflows/ci.yml">
+        <img src="https://github.com/ChatArch/ChatGlance/actions/workflows/ci.yml/badge.svg" alt="Tests" />
+    </a>
+</div>
+
+<div align="center">
+
+[English](README.en.md) | [简体中文](README.md)
+</div>
+
+# ChatGlance
+
+`ChatGlance` 是 ChatArch/WZHECNU Glance dashboard 的 Python 生成与运维包，提供 `chatglance` CLI。
+
+它不是 NPM 项目，也不是重新实现 Glance 后端：上游 Glance 仍然是 Go 单二进制 dashboard server；`ChatGlance` 负责把 ChatArch 项目清单、Glance YAML 页面、inline HTML 表格和安全运维补丁组织成可复用的 Python 包/CLI。
+
+## 当前能力
+
+- 从 repository inventory JSON 生成 Glance `项目` page。
+- 当前 page tabs 固定为：`最近提交`、`待处理 PR / Issue`、`分类`、`一览表`。
+- `待处理 PR / Issue` 只显示 PR/Issue 非 0 的仓库，并按 `(PR, Issue, 最近提交)` 降序。
+- 生成 config 副本时清理 legacy generated pages：`Projects`、`ChatArch Projects`、`ChatArch Projects List`。
+- 为 Glance `server-stats` 写入 root-only Disk 配置：`hide-mountpoints-by-default: true` + `mountpoints: /`，避免 snap/loop mount 出现在 Disk popover。
+- 维护 durable runtime：一次性 `runtime maintain` 可原子更新 live config、备份、校验，并在内容变化时可选重启 systemd user service。
+- 渲染 systemd user units：主服务仍直接启动 upstream Glance Go binary；维护任务是独立 oneshot/timer，不是 Python wrapper。
+
+## 快速开始
+
+```bash
+pip install -e ".[dev]"
+chatglance --help
+chatglance --tree
+chatglance --version
+python -m pytest -q
+python -m build
+```
+
+## CLI 示例
+
+只生成 `项目` page YAML：
+
+```bash
+chatglance projects render-page \
+  --data /path/to/chatarch-projects.json \
+  --output playground/projects-page.yml
+```
+
+把生成页写入一个 Glance config 副本：
+
+```bash
+chatglance projects update-config \
+  --data /path/to/chatarch-projects.json \
+  --config /path/to/glance.yml \
+  --output playground/glance.with-projects.yml
+```
+
+把 `server-stats` Disk 改成只显示 root 分区，写入 config 副本：
+
+```bash
+chatglance disks root-only \
+  --config /path/to/glance.yml \
+  --output playground/glance.root-disk.yml
+```
+
+维护一个 durable Glance runtime（默认 `~/.chatarch/glance`）：
+
+```bash
+chatglance runtime maintain \
+  --runtime-home ~/.chatarch/glance \
+  --restart-service chatarch-glance.service
+```
+
+生成推荐 systemd user units：
+
+```bash
+chatglance runtime render-systemd \
+  --runtime-home ~/.chatarch/glance \
+  --chatglance-bin ~/.chatarch/venv/bin/chatglance \
+  --output-dir playground/systemd
+```
+
+## 运行态边界
+
+推荐拓扑是 **systemd 直接运行 Glance，chatglance 只做维护**：
+
+- 主服务：`chatarch-glance.service` 直接执行 `~/.chatarch/glance/bin/glance -config ~/.chatarch/glance/config/glance.yml`。
+- 内容数据：repository inventory JSON、缓存和生成快照放在 `~/.chatarch/glance/data/` 或 `~/.chatarch/glance/cache/`。
+- live config：`~/.chatarch/glance/config/glance.yml`；更新前写备份到 `~/.chatarch/glance/config/backups/`。
+- 维护：`chatglance runtime maintain` 是 oneshot，可由 `chatarch-glance-maintenance.timer` 周期触发。
+- 不建议加 Python 长驻 wrapper：wrapper 会把 server 生命周期和内容生成耦合，反而不利于 systemd 重启、日志、健康检查和回滚。
+
+## 安全边界
+
+- CLI 默认写 output file，不默认覆盖 live `glance.yml`。
+- 不保存或输出 Glance auth、password hash、GitHub token、proxy credential。
+- live runtime、logs、backups、全量实时 JSON 快照默认不进源码仓库。
+- 后续如需动态表格、搜索、中英文切换，再考虑增加小型静态前端层；当前 Python CLI 是基础层。

chatglance-0.1.0/src/ChatGlance.egg-info/SOURCES.txt

@@ -0,0 +1,20 @@
+LICENSE
+README.md
+pyproject.toml
+src/ChatGlance.egg-info/PKG-INFO
+src/ChatGlance.egg-info/SOURCES.txt
+src/ChatGlance.egg-info/dependency_links.txt
+src/ChatGlance.egg-info/entry_points.txt
+src/ChatGlance.egg-info/requires.txt
+src/ChatGlance.egg-info/top_level.txt
+src/chatglance/__init__.py
+src/chatglance/cli.py
+src/chatglance/glance_config.py
+src/chatglance/projects.py
+src/chatglance/runtime.py
+src/chatglance/systemd.py
+tests/test_cli.py
+tests/test_projects.py
+tests/test_publish_workflow.py
+tests/test_runtime_systemd.py
+tests/test_version.py

chatglance-0.1.0/src/ChatGlance.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

chatglance-0.1.0/src/ChatGlance.egg-info/entry_points.txt

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

chatglance-0.1.0/src/ChatGlance.egg-info/requires.txt

@@ -0,0 +1,7 @@
+click>=8.0
+PyYAML<7.0,>=6.0
+
+[dev]
+build
+pytest
+twine

chatglance-0.1.0/src/ChatGlance.egg-info/top_level.txt

@@ -0,0 +1 @@
+chatglance

chatglance-0.1.0/src/chatglance/__init__.py

@@ -0,0 +1,5 @@
+"""chatglance package."""
+
+__all__ = ["__version__"]
+
+__version__ = "0.1.0"