dschlueter
3f688a72fb
- README.md: git clone URL auf Forgejo-Repo gesetzt - README.md: test-utils.ts, run-tests.sh und examples/ in Dateientabelle ergänzt - examples/README.md: git init -b main statt git init (verhindert master-Branch) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
74 lines
2.3 KiB
Markdown
74 lines
2.3 KiB
Markdown
# pi-coder Beispielprojekte
|
||
|
||
Vier kleine, eigenständige Projekte als Demonstrationsgrundlage für die pi-coder-Features.
|
||
Jedes Projekt startet bewusst unvollständig — genau der Ausgangspunkt, für den pi-coder gebaut ist.
|
||
|
||
## Übersicht
|
||
|
||
| Verzeichnis | Sprache | Demonstriert |
|
||
|---|---|---|
|
||
| `python-calculator/` | Python | `/optimize` mit `--test-cmd pytest` |
|
||
| `rust-wordcount/` | Rust | `/optimize` mit `--test-cmd "cargo test"` + `/version` |
|
||
| `go-fibonacci/` | Go | `/optimize --interactive` + `/continue` + `/shipit` |
|
||
| `c-linkedlist/` | C | `/quick_check` + `/fix` + `/patch` |
|
||
|
||
## Demo-Workflow
|
||
|
||
### Schritt 1 — Vorbereitung: Sub-Repos anlegen
|
||
|
||
Jedes Example braucht ein eigenes git-Repo, damit pi-coder commit-basierte
|
||
Features nutzen kann (Loop-Erkennung, Diff-Anzeige, `/version`):
|
||
|
||
```bash
|
||
for dir in python-calculator rust-wordcount go-fibonacci c-linkedlist; do
|
||
cd examples/$dir
|
||
git init -b main && git add -A && git commit -m "feat: initial $dir"
|
||
cd ../..
|
||
done
|
||
```
|
||
|
||
Für `/version` im rust-wordcount-Beispiel zusätzlich:
|
||
|
||
```bash
|
||
cd examples/rust-wordcount && git tag v0.1.0
|
||
```
|
||
|
||
### Schritt 2 — Demo ausführen
|
||
|
||
In pi das jeweilige Unterverzeichnis als Arbeitsverzeichnis öffnen.
|
||
Die genauen Befehle stehen im README.md des jeweiligen Examples.
|
||
Zeitmessung: Systemuhr notieren oder Terminal-Kommando `time` nutzen.
|
||
|
||
### Schritt 3 — Protokoll ausfüllen
|
||
|
||
Jedes Example enthält eine `PROTOKOLL.md`.
|
||
Startzeit, Endzeit, Rundenanzahl und Endergebnis eintragen.
|
||
|
||
### Schritt 4 — Ausgangszustand wiederherstellen
|
||
|
||
```bash
|
||
bash examples/restore-all.sh
|
||
```
|
||
|
||
Das Skript löscht Sub-Repos, restauriert alle Quelldateien aus dem Haupt-Repo
|
||
und bereinigt Build-Artefakte (`target/`, `__pycache__` etc.).
|
||
|
||
---
|
||
|
||
## Empfohlene Demo-Reihenfolge
|
||
|
||
| # | Beispiel | Geschätzte Dauer | Highlights |
|
||
|---|---|---|---|
|
||
| 1 | `python-calculator` | ~5–10 min | Einstieg, Test-Loop |
|
||
| 2 | `c-linkedlist` | ~5 min | `/quick_check` + `/fix`, kein Loop |
|
||
| 3 | `rust-wordcount` | ~10–15 min | Loop + `/version` |
|
||
| 4 | `go-fibonacci` | ~15–20 min | `--interactive` + `/shipit` |
|
||
|
||
---
|
||
|
||
## Weitere Details
|
||
|
||
[python-calculator](python-calculator/README.md) ·
|
||
[rust-wordcount](rust-wordcount/README.md) ·
|
||
[go-fibonacci](go-fibonacci/README.md) ·
|
||
[c-linkedlist](c-linkedlist/README.md)
|