Git-Grundlagen

Eine Historie, zu der Sie zurückkehren können

Git zeichnet die Historie eines Projekts als Folge von Commits auf: Momentaufnahmen aller verfolgten Dateien, jeweils mit Autor, Zeit und Nachricht. Damit sehen Sie, was sich wann und warum geändert hat, probieren Ideen ohne Angst aus und kehren zu einer funktionierenden Version zurück. Ein Ordner unter Git-Kontrolle ist ein Repository. Quantitative Arbeit stützt sich stark darauf: Ein Ergebnis ist nur vertrauenswürdig, wenn Sie genau sagen können, welche Codeversion es erzeugt hat.

# Start tracking a project (once)
git init

# See what changed, stage it, record it
git status
git add main.py README.md
git commit -m "Add the first backtest loop"

# Look back
git log --oneline
git diff                      # changes not yet staged

Die drei Orte, an denen eine Änderung lebt

Eine Änderung durchläuft drei Bereiche. Sie bearbeiten Dateien im Arbeitsverzeichnis. git add kopiert die gewählten Änderungen in die Staging-Area (die nächste Momentaufnahme in Vorbereitung). git commit hält die vorbereitete Momentaufnahme in der Repository-Historie fest. So committen Sie nur zusammengehörige Änderungen gemeinsam, auch wenn Sie viele Dateien bearbeitet haben. git status zeigt jede Datei in ihrem Bereich: geändert, vorgemerkt oder nicht verfolgt (neu und Git noch unbekannt).

# git status --porcelain prints two status letters, a space, then the path
status = """ M main.py
A  notes.md
?? scratch.txt
D  old.py"""

for line in status.splitlines():
    code, path = line[:2], line[3:]
    print(repr(code), path)
# ' M' main.py     (modified, not staged)
# 'A ' notes.md    (new, staged)
# '??' scratch.txt (untracked)
# 'D ' old.py      (deleted, staged)

Branches

Ein Branch ist ein beweglicher Name für eine Linie von Commits. Legen Sie für jede Idee oder Korrektur einen an (git switch -c fee-model), committen Sie darauf frei und holen Sie ihn, wenn es funktioniert, mit git merge in die Hauptlinie (meist vom Branch main aus). Branch-Namen dürfen Buchstaben, Ziffern, -, _, / und . enthalten, aber keine Leerzeichen und keines von ~ ^ : ? * [ \, und sie dürfen nicht mit / beginnen oder enden und nicht auf . enden. Git meldet Konflikte, wenn zwei Branches dieselben Zeilen geändert haben, und Sie lösen sie von Hand.

# Try an idea on its own branch, then bring it back
git switch -c fee-model
git commit -am "Use tiered fees"
git switch main
git merge fee-model

# List branches (the current one has a star)
git branch

Was Sie auslassen, und wie Sie rückgängig machen

Eine .gitignore-Datei listet Muster auf, die Git nicht verfolgen soll: .venv/ (ein Ordner, mit Schrägstrich am Ende geschrieben), *.log (jede zu einem Platzhalter passende Datei), secrets.env. Lassen Sie virtuelle Umgebungen, Caches, große Datendateien und vor allem Geheimnisse wie API-Schlüssel draußen: Alles Committete bleibt in der Historie, auch wenn Sie es später löschen. Zum Rückgängigmachen verwirft git restore datei nicht committete Änderungen an einer Datei, und git revert <commit> fügt einen neuen Commit hinzu, der einen alten aufhebt, was auf geteilten Branches sicher ist. git push und git pull tauschen Commits mit einer entfernten Kopie aus, etwa auf GitHub.

# .gitignore
.venv/
__pycache__/
*.log
secrets.env

# Undo safely
git restore main.py            # drop uncommitted edits to one file
git revert 3f2a9c1             # new commit that cancels an old one

# Share
git push origin main
git pull

• git init, git status, git add, git commit -m "...", git log --oneline.
• Ein Branch pro Idee: git switch -c name, dann git merge.
• Nutzen Sie .gitignore für .venv/, Caches, Daten und Geheimnisse; machen Sie mit restore oder revert rückgängig.

Als Nächstes: Jupyter-Notebooks, zum interaktiven Erkunden von Daten und wie Sie sie unter Git ordentlich halten.

Lab: Was bewertet wird

• Mit parse_status die Dateien eines git status-Berichts einsortieren25 Pkt.
• Mit parse_log eine git log --oneline-Liste lesen25 Pkt.
• Mit is_valid_branch_name einen Branch-Namen gegen Gits Regeln prüfen25 Pkt.
• Mit not_ignored eine .gitignore auf eine Dateiliste anwenden25 Pkt.