# rtcn_library

**Repository Path**: rtccn_mc/rtcn_library

## Basic Information

- **Project Name**: rtcn_library
- **Description**: rtcn_library
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-22
- **Last Updated**: 2026-08-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# rtcn_library

面向 Termux(Android) 的**中文 Python 工具库**，核心全部基于标准库，免安装额外依赖。

把常用的文件、时间、日志、JSON、随机、加密、网络、SQLite、正则、多线程等能力，以及 Termux:GUI 图形界面和 2D 游戏框架，统一封装成中文接口，一条命令安装、任意目录调用。

## 特性

- 全中文方法名（`读文件`、`随机字符串`、`画圆`、`碰撞`…），对新手友好
- 核心零第三方依赖，Termux 免安装
- 六大模块 + 统一入口，一次导入全部可用
- 内置 Termux:GUI 图形界面封装与 2D 游戏框架（画布/精灵/动画/粒子/场景/摄像机/瓦片地图）
- 可 `pip install` 的标准包结构，任意目录 `import`

## 安装

方式一，直接从 Gitee 安装（仓库需为公开）：

```bash
pip install git+https://gitee.com/rtccn_mc/rtcn_library.git@master
# Termux 环境加参数
pip install --break-system-packages git+https://gitee.com/rtccn_mc/rtcn_library.git@master
```

方式二，克隆后本地可编辑安装：

```bash
git clone https://gitee.com/rtccn_mc/rtcn_library.git
cd rtcn_library
pip install -e .
# Termux 环境
pip install --break-system-packages -e .
```

## 快速上手

```python
import rtcn_library as rtc

# 通用工具
rtc.rt.写文件("a.txt", "你好世界")
print(rtc.rt.读文件("a.txt"))           # 你好世界
print(rtc.rt.随机字符串(8))              # 8 位随机串
print(rtc.rt.MD5("hello"))              # 5d41402abc4b2a76b9719d911017c592

# 中文标准库
print(rtc.数学.平方根(16))               # 4.0
print(rtc.常用.去重([3, 1, 2, 1, 3]))    # [3, 1, 2]

# 正则
print(rtc.正则.邮箱("a@b.com"))          # True
```

也支持按需导入：

```python
from rtcn_library import rt, GUI, 游戏, SQLite, 数学, 正则, 常用
```

## 目录结构

```
rtcn_library/
├── pyproject.toml   # 打包配置
├── README.md        # 本文件
├── rtcn_library_README.md  # 完整能力清单
└── rtcn_library/    # 包目录
    ├── __init__.py  # 统一入口，导出全部符号
    ├── core.py      # 通用工具库
    ├── gui.py       # Termux GUI 封装
    ├── game.py      # 2D 游戏框架
    ├── sql.py       # SQLite 数据库
    ├── regular.py   # 正则 + 多线程
    └── stdlib.py    # 中文标准库
```

## 能力概览

| 模块 | 主要能力 |
|------|---------|
| `core.py` | 文件/时间/日志/命令/JSON/随机/字符串/加密/网络 + `KV存储` `计时器` `随机密码器` `CSV工具` `任务队列` |
| `gui.py` | Termux GUI 窗口控件、`命名事件`(点击自动打印)、对话框 `模板`、非阻塞 `进度框` |
| `game.py` | `画布`逐像素绘制、`游戏`主循环、`精灵`/`精灵组`、`动画`、`粒子系统`、`场景管理器`、`摄像机`、`瓦片地图`、`音效`、`文本输入器` |
| `sql.py` | SQLite 增删改查/事务/统计，返回 dict |
| `regular.py` | `正则`(含邮箱/手机号/IP 等预设) + `多线程`/`线程安全队列`/`线程锁` |
| `stdlib.py` | 数学/容器/组合/函数式/路径/序列化/压缩/安全/堆/二分 等 23 类中文标准库封装 + `常用` 实用函数 |

完整方法清单见 [rtcn_library_README.md](./rtcn_library_README.md)。

## 环境要求

- Python ≥ 3.8
- GUI 与游戏模块需 Android 8.1+ 的 Termux:GUI 与 Termux:API（未安装时导入不报错，仅对应功能不可用）
- 其余模块纯标准库，任何平台均可使用

## 许可证

MIT