clings 3.3.0

Rustlings-style C exercises CLI for OpenCamp C 2026 Summer

Clings — C 语言练习系统 CLI

C 语言版 Rustlings：通过修复编译错误、补全代码来学习 C 语言。 配套 OpenCamp C 2026 Summer 课程 Unit 0–4，共 121 道练习。

分支说明

分支	用途
cli (本分支, 默认)	CLI 工具源码 + 练习数据，CI 自动发布 pip 包
main	练习仓库 (学生 clone 用，已废弃，改用 clings init)

快速开始

# 1. 安装 (推荐 uvx，不污染系统环境)
uvx clings init unit1              # 一行搞定: 安装+初始化 (需要 uv)

# 或传统方式:
pip install clings                 # 安装到系统/虚拟环境
clings init unit1                  # 初始化 Unit 1 (24课49题)

# 2. 开始做题!
clings                             # 进入交互式 watch 模式 (uvx clings 亦可)

推荐使用 uv：uvx clings 会自动下载 clings 到隔离环境运行， 不影响系统 Python。安装 uv: curl -LsSf https://astral.sh/uv/install.sh | sh

命令参考

clings                        # 直接进入 watch 模式 (默认)
clings init [unit0|...|all]   # 初始化练习 (从包内释放到当前目录)
clings watch [selector]       # 交互式 watch (保存即验证)
clings run [exercise]         # 运行练习 (省略=下一道, 'random'=随机)
clings hint [exercise]        # 查看提示 (省略=下一道)
clings list [selector]        # 列出练习 + ✔/• 进度状态
clings check [selector]       # 批量验证
clings reset <exercise>       # 重置练习文件
clings reset progress         # 清除全部进度
clings doctor                 # 检查环境
clings -v                     # 显示版本号

开发

git clone https://cnb.cool/q.qq/opencamp-c-2026-summer/clings.git
cd clings/                     # 默认在 cli 分支
pip install -e .
clings check unit1 --solutions # 验证 49/49

CI/CD

push 到 cli 分支自动触发:

1. Install & Test: pip install → clings init all → check unit1 --solutions
2. Build & Publish: python -m build → twine upload 到 PyPI

架构

clings/ (cli 分支)
├── clings.py              # CLI 核心 (单文件, 零依赖, Python 3.11+)
├── pyproject.toml         # pip 打包 (exercises/ 嵌入 wheel)
├── clings.toml            # units 配置
├── .cnb.yml               # CI: cli 分支 push → test → publish
├── Dockerfile.ci          # Ubuntu 24.04 CI 环境
├── exercises/             # 121 道练习 (嵌入 pip 包, clings init 释放)
│   ├── 01_simplest_c_program/
│   │   ├── exercises.toml # 练习元数据 + 测试用例
│   │   ├── *.c            # 学生源码模板
│   │   └── README.md      # 课程参考
│   └── ...
├── solutions/             # Unit 1 参考答案 (CI 测试用, 不打包)
└── tools/                 # 维护脚本