Skip to content

docs(claude-md): venv je Rechner außerhalb des Repo-Ordners (Abschnitt 3) - #322

Merged
Jaegerfeld merged 1 commit into
mainfrom
docs/claude-md-venv
Nov 18, 2026
Merged

Jaegerfeld merged 1 commit into
mainfrom
docs/claude-md-venv

Conversation

@Jaegerfeld

Copy link
Copy Markdown
Owner

Was sich ändert

CLAUDE.md, Abschnitt 3 (Tests und Werkzeuge): Die Python-Umgebung liegt je Rechner außerhalb des Repo-Ordners unter ~/.venvs/situation-report. Entscheidung Robert, 18.11.2026.

Warum

Der Repo-Ordner wird über OneDrive zwischen zwei Rechnern geteilt. Eine venv darin zeigt auf den Python-Pfad des Rechners, der sie zuletzt gebaut hat. Am 18.11.2026 startete sie auf dem Desktop nicht mehr, weil der Laptop sie neu angelegt hatte; ein Neubau hier hätte sie dort wieder gebrochen.

Neuer Text

  • Python nur aus der venv dieses Rechners, außerhalb des Repo-Ordners:
    ~/.venvs/situation-report/Scripts/python.exe -m pytest tests --basetemp=.pytest_tmp -p no:cacheprovider;
    das globale python hat weder pytest noch mypy. Grund (Entscheidung Robert 18.11.2026): Der Repo-Ordner
    wird über OneDrive zwischen zwei Rechnern geteilt, und eine venv darin zeigt auf den Python-Pfad des
    Rechners, der sie zuletzt gebaut hat — auf dem anderen startet sie nicht. Eine .venv im Repo-Ordner ist
    nur noch Rückfall.
  • Fehlt die venv auf einem Rechner: py -3.14 -m venv ~/.venvs/situation-report, dann die Pakete aus
    pyproject.toml installieren (dependencies sowie die Extras dev und docs).
  • Vor jedem Commit: ruff check . und mypy aus derselben venv (der Pre-Commit-Hook tut es auch und sucht
    die venv zuerst unter ~/.venvs/situation-report).

Nicht geändert

  • README.md und docs/development*.md empfehlen Mitwirkenden weiter python -m venv .venv. Das stimmt für alle, die den Ordner nicht über einen Synchronisationsdienst teilen.
  • Der Pre-Commit-Hook liegt lokal unter .git/hooks und ist bereits umgestellt (neuer Ort zuerst, .venv als Rückfall).
  • beta/ux-redesign trägt denselben Abschnitt 3 und bekommt die Änderung, wenn der Branch main nachholt.

Prüfung

Reine Textänderung an CLAUDE.md, kein Code. Der Feature-PR #321 wurde bereits mit der neuen Umgebung gebaut und getestet (2 057 Tests, Hook lief aus ~/.venvs/situation-report).

🤖 Generated with Claude Code

…tt 3)

Der Repo-Ordner wird ueber OneDrive zwischen zwei Rechnern geteilt. Eine
venv darin zeigt auf den Python-Pfad des Rechners, der sie zuletzt gebaut
hat, und startet auf dem anderen nicht (Befund 18.11.2026). Abschnitt 3
nennt jetzt ~/.venvs/situation-report als Ort, den Weg zum Anlegen und
dass der Pre-Commit-Hook dort zuerst sucht. Entscheidung Robert 18.11.2026.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@Jaegerfeld
Jaegerfeld merged commit 6639297 into main Nov 18, 2026
3 checks passed
@Jaegerfeld
Jaegerfeld deleted the docs/claude-md-venv branch November 18, 2026 13:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant