Home en

SimpleRCS Wiki

SimpleRCS is a lightweight, stream-based version control library for a single document. It borrows the reverse-delta storage model from classic RCS, then rebuilds it around modern concerns: stream-centric I/O, O(1) HEAD access, unified handling of text and binary content, and an optional hash chain with GPG signing on top.

This wiki exists so someone new to the codebase can figure out what's going on and how things actually run, without spelunking through 5,000 lines of Python first. The source is still the ground truth — this is just the readable map of it.

Reading order

If you're starting from scratch, go top to bottom.

1. System Overview — what SimpleRCS does and why it's shaped this way
2. Source Code Map — package layout, what each file is responsible for
3. Storage Format — the .srcs file format, block structure, hash chain
4. Diff Engines — StreamSequenceMatcher vs. the Myers implementations, and which one actually runs
5. CLI Tools — the command-line helpers under tools/

Design notes / experiments

• Wiki Backend Design (Korean only) — what it takes to use SimpleRCS as the version engine behind a wiki, with real storage-backend benchmarks

Korean

• 홈
• 시스템 개요
• 소스 코드 지도
• 저장 포맷
• Diff 엔진
• CLI 도구

Links

• Repository: https://github.com/wkpark/SimpleRCS
• License: Apache License 2.0
• Requires Python 3.13+, uses uv for dependency management