Metadata-Version: 2.4
Name: ChatTea
Version: 0.1.1
Summary: ChatTea: ChatArch Python package
Author-email: ChatArch <1073853456@qq.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/ChatArch/ChatTea
Project-URL: Repository, https://github.com/ChatArch/ChatTea
Project-URL: Documentation, https://ChatArch.github.io/ChatTea
Keywords: chattea,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>=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/ChatTea">
        <img src="https://img.shields.io/pypi/v/ChatTea.svg" alt="PyPI version" />
    </a>
    <a href="https://github.com/ChatArch/ChatTea/actions/workflows/ci.yml">
        <img src="https://github.com/ChatArch/ChatTea/actions/workflows/ci.yml/badge.svg" alt="Tests" />
    </a>
    <a href="https://ChatArch.github.io/ChatTea">
        <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>

# ChatTea

ChatTea 是 ChatArch 的 Gitea 管理 CLI/API 包，第一版聚焦本地 Gitea 的安装、初始化、启动、token 配置和基础仓库操作。

## 快速开始

```bash
pip install -e ".[dev]"
chattea --help
python -m pytest -q
```

## 常用流程

### 安装并初始化 Gitea

```bash
chattea server install --version 1.26.4 --prefix ~/.local/share/chattea/gitea
chattea server init --work-path ~/gitea --http-port 3000
chattea server serve --work-path ~/gitea --config ~/gitea/custom/conf/app.ini
```

### 使用 user systemd 管理服务

```bash
chattea server start --work-path ~/gitea --config ~/gitea/custom/conf/app.ini
chattea server status
chattea server logs --lines 100
chattea server stop
```

### 配置 API token

```bash
chattea set-token --url http://127.0.0.1:3000 --token "$GITEA_TOKEN"
chattea server health
```

### 仓库操作

```bash
chattea repo list
chattea repo view gitea_admin/demo
chattea repo create --owner gitea_admin --name demo
chattea repo clone gitea_admin/demo
chattea repo migrate --clone-url https://github.com/ChatArch/ChatTea.git --owner gitea_admin --name ChatTea
```

## CLI 结构

```text
chattea
├── set-token
├── server
│   ├── install
│   ├── init
│   ├── serve
│   ├── start
│   ├── stop
│   ├── restart
│   ├── status
│   ├── logs
│   ├── version
│   └── health
└── repo
    ├── list
    ├── view
    ├── create
    ├── clone
    └── migrate
```

## 目录结构

- `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`。接口树见 `docs/interface-tree.md`。
