Tag 0: Das Trainingsgelände
Ziel: uv, Python 3.14, ruff und pytest einrichten und das erste Tool
halloals uv-Projekt bauen · Dauer: ca. 45 min · Voraussetzung: keine
Briefing
- uv ersetzt pyenv, venv, pip und pipx: ein Binary, sehr schnell, mit Lockfile.
- Jedes Tool ist ein eigenes Projekt mit
pyproject.toml,src/-Layout und eigener.venv. uv run <befehl>synchronisiert die Umgebung und führt den Befehl darin aus – keinsource .venv/bin/activatenötig.- ruff prüft und formatiert, pytest testet. Beide sind Dev-Abhängigkeiten, nicht Teil des Tools.
uv init --package ──► pyproject.toml + src/hallo/
uv run hallo ──► .venv anlegen ──► Paket installieren ──► hallo:main()
uv add --dev ──► pyproject.toml [dependency-groups] + uv.lock
Drill 1: uv prüfen und Python 3.14 holen
uv --version || brew install uvErwartet (Version kann abweichen):
uv 0.9.26 (ee4f00362 2026-01-15)
Ohne Homebrew:
curl -LsSf https://astral.sh/uv/install.sh | sh
(installiert nach ~/.local/bin).
uv python install 3.14
uv python find 3.14Erwartet (gekürzt, kann je nach Version abweichen):
Installed Python 3.14.2 in 4.77s
+ cpython-3.14.2-macos-aarch64-none (python3.14)
/Users/thomas/.local/share/uv/python/cpython-3.14.2-macos-aarch64-none/bin/python3.14
Warum? uv verwaltet eigene Python-Builds unter
~/.local/share/uv/python. Das System-Python von macOS
bleibt unangetastet, und jedes Projekt pinnt seine Version.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Projekt anlegen
mkdir -p ~/py-lab && cd ~/py-lab
uv init --package --name hallo tag00-hallo
cd tag00-hallo
find . -type f -not -path './.git/*' | sortErwartet:
Initialized project `hallo` at `…/py-lab/tag00-hallo`
./.gitignore
./.python-version
./README.md
./pyproject.toml
./src/hallo/__init__.py
--package erzeugt ein installierbares Paket im
src/-Layout samt Konsolenskript; ohne die Option gäbe es
nur eine lose main.py. Ein Git-Repo legt uv gleich mit
an.
cat .python-version pyproject.tomlErwartet (authors stammt aus deiner git-Konfiguration):
3.14
[project]
name = "hallo"
version = "0.1.0"
description = "Add your description here"
readme = "README.md"
authors = [
{ name = "Thomas Zachmann", email = "[email protected]" }
]
requires-python = ">=3.14"
dependencies = []
[project.scripts]
hallo = "hallo:main"
[build-system]
requires = ["uv_build>=0.9.26,<0.10.0"]
build-backend = "uv_build"
Warum? [project.scripts] macht aus der Funktion
main im Modul hallo ein Kommando
hallo. uv_build ist das Build-Backend von uv;
mehr dazu an Tag 5.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Erster Lauf
uv run hallo
ls -aErwartet:
Using CPython 3.14.2
Creating virtual environment at: .venv
Building hallo @ file:///…/py-lab/tag00-hallo
Built hallo @ file:///…/py-lab/tag00-hallo
Installed 1 package in 2ms
Hello from hallo!
. .. .git .gitignore .python-version .venv README.md pyproject.toml src uv.lock
Beim ersten uv run entstehen .venv (die
Umgebung, nie committen) und uv.lock (exakte Versionen,
immer committen).
uv run python -c 'import sys; print(sys.version)'
uv run which pythonErwartet:
3.14.2 (main, Jan 14 2026, 23:37:46) [Clang 21.1.4 ]
…/py-lab/tag00-hallo/.venv/bin/python
Tipp:
uv run pythonstartet die REPL im Projekt. Zum Ausprobieren von Schnipseln ist das schneller als jede Datei.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Eigener Code
cat > src/hallo/__init__.py <<'EOF'
"""hallo – das erste Tool im Trainingslager."""
import sys
def greet(name: str = "Welt") -> str:
"""Gibt den Gruß zurück, statt ihn zu drucken – so ist er testbar."""
return f"Hallo, {name}!"
def main() -> None:
name = sys.argv[1] if len(sys.argv) > 1 else "Welt"
print(greet(name))
EOF
cat > src/hallo/__main__.py <<'EOF'
from hallo import main
main()
EOF
uv run hallo
uv run hallo Thomas
uv run python -m hallo LabErwartet:
Hallo, Welt!
Hallo, Thomas!
Hallo, Lab!
Warum? Logik (greet) und Ein-/Ausgabe
(main) sind getrennt: Funktionen, die Werte zurückgeben,
lassen sich testen. __main__.py macht
python -m hallo möglich, praktisch ohne installiertes
Skript. name: str und -> str sind
Typ-Hints: Python prüft sie nicht zur Laufzeit, aber Editor und mypy
(Tag 5) tun es.
Tipp: Kein Neuinstallieren nötig: uv installiert das eigene Paket editable, Änderungen in
src/wirken sofort.
Fortschritt speichern? Kostenlos registrieren
Drill 5: Dev-Werkzeuge und erster Test
uv add --dev pytest ruff
tail -6 pyproject.tomlErwartet (gekürzt):
+ pytest==9.1.1
+ ruff==0.17.0
[dependency-groups]
dev = [
"pytest>=9.1.1",
"ruff>=0.17.0",
]
Die Gruppe dev landet nicht in den Abhängigkeiten des
Pakets; wer hallo installiert, bekommt kein pytest.
mkdir -p tests
cat > tests/test_hallo.py <<'EOF'
from hallo import greet
def test_greet_default():
assert greet() == "Hallo, Welt!"
def test_greet_name():
assert greet("Thomas") == "Hallo, Thomas!"
EOF
uv run pytest -qErwartet:
.. [100%]
2 passed in 0.00s
Warum? pytest findet Dateien test_*.py und Funktionen
test_* von selbst. Ein schlichtes assert
reicht; scheitert es, zeigt pytest beide Seiten des Vergleichs.
Fortschritt speichern? Kostenlos registrieren
Drill 6: ruff – Lint und Format
Baue absichtlich eine unordentliche Datei:
cat > src/hallo/kaputt.py <<'EOF'
import os
def laut(text:str)->str:
return text.upper( )
EOF
uv run ruff check; echo "exit=$?"Erwartet (gekürzt):
I001 [*] Import block is un-sorted or un-formatted
--> src/hallo/kaputt.py:1:1
F401 [*] `os` imported but unused
--> src/hallo/kaputt.py:1:8
Found 2 errors.
[*] 2 fixable with `--fix`.
exit=1
uv run ruff check --fix
uv run ruff format
cat src/hallo/kaputt.pyErwartet:
Found 1 error (1 fixed, 0 remaining).
1 file reformatted, 4 files left unchanged
def laut(text: str) -> str:
return text.upper()
ruff check findet Fehler und schlechten Stil (Exit-Code
1, also CI-tauglich), ruff format formatiert wie Black.
Aufräumen:
rm src/hallo/kaputt.pyFortschritt speichern? Kostenlos registrieren
Drill 7: Das Tool ist fertig
cd ~/py-lab/tag00-hallo
uv run hallo Thomas
uv run pytest -q
uv run ruff check && uv run ruff format --check
uv treeErwartet:
Hallo, Thomas!
.. [100%]
2 passed in 0.00s
All checks passed!
4 files already formatted
Resolved 8 packages in 3ms
hallo v0.1.0
├── pytest v9.1.1 (group: dev)
│ ├── iniconfig v2.3.1
│ ├── packaging v26.3
│ ├── pluggy v1.6.0
│ └── pygments v2.21.0
└── ruff v0.17.0 (group: dev)
Dieser Dreiklang – uv run <tool>,
uv run pytest -q, uv run ruff check – schließt
ab jetzt jeden Tag ab.
Den fertigen Code jedes Tages gibt es zum Vergleichen im Begleitcode auf GitHub. Hol ihn jetzt; erst tippst du selbst, dann siehst du nach:
git clone https://github.com/thomaszachmann/python-zum-anfassen.git \
~/python-zum-anfassen
ls -1 ~/python-zum-anfassen/tag00-halloErwartet:
Cloning into '…/python-zum-anfassen'...
pyproject.toml
README.md
src
tests
Die Ordner heißen wie deine in ~/py-lab. Nach Tag 1
zeigt etwa
diff -r ~/py-lab/tag01-wc ~/python-zum-anfassen/tag01-wc,
wo du abweichst.
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
#!/usr/bin/env bash
check() { if eval "$2" >/dev/null 2>&1; then echo "✔ $1"; else echo "✘ $1"; fi; }
cd ~/py-lab/tag00-hallo
check "uv installiert" "uv --version"
check "Projekt nutzt Python 3.14" \
"uv run python -c 'import sys; assert sys.version_info[:2] == (3, 14)'"
check "hallo grüßt" "uv run hallo Lab | grep -q 'Hallo, Lab!'"
check "python -m hallo geht" "uv run python -m hallo | grep -q Welt"
check "Tests grün" "uv run pytest -q"
check "ruff sauber" "uv run ruff check && uv run ruff format --check"
check "uv.lock vorhanden" "test -f uv.lock"Erwartet:
✔ uv installiert
✔ Projekt nutzt Python 3.14
✔ hallo grüßt
✔ python -m hallo geht
✔ Tests grün
✔ ruff sauber
✔ uv.lock vorhanden
Challenge
Mach hallo mehrsprachig: Mit HALLO_LANG=en
grüßt es auf Englisch, mit da auf Dänisch, sonst auf
Deutsch. Ergänze einen Test.
Hinweis: Ein Dict bildet Sprache auf Gruß ab,
os.environ.get() liest die Variable mit Standardwert.
Lösung
cat > src/hallo/__init__.py <<'EOF'
"""hallo – das erste Tool im Trainingslager."""
import os
import sys
GREETINGS = {"de": "Hallo", "en": "Hello", "da": "Hej"}
def greet(name: str = "Welt", lang: str = "de") -> str:
"""Gibt den Gruß zurück, statt ihn zu drucken – so ist er testbar."""
return f"{GREETINGS.get(lang, 'Hallo')}, {name}!"
def main() -> None:
name = sys.argv[1] if len(sys.argv) > 1 else "Welt"
print(greet(name, os.environ.get("HALLO_LANG", "de")))
EOF
cat >> tests/test_hallo.py <<'EOF'
def test_greet_lang():
assert greet("Mette", "da") == "Hej, Mette!"
assert greet("Bob", "xx") == "Hallo, Bob!"
EOF
HALLO_LANG=en uv run hallo Thomas
HALLO_LANG=da uv run hallo Thomas
uv run pytest -qErwartet:
Hello, Thomas!
Hej, Thomas!
... [100%]
3 passed in 0.01s
dict.get(key, default) liefert den Standardwert statt
eines KeyError – unbekannte Sprachen fallen so auf Deutsch
zurück.
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
uv.lockund.python-versiongehören ins Repo; CI installiert mituv sync --lockedund bricht ab, wenn Lockfile undpyproject.tomlauseinanderlaufen.- Hinter einem Firmen-Proxy mit eigener CA:
uv --native-tlsbzw.UV_NATIVE_TLS=1, damit uv den System-Zertifikatsspeicher nutzt. - Interne Paketquellen (Artifactory, Nexus) über
[[tool.uv.index]]inpyproject.toml– Zugangsdaten nur per Umgebungsvariable, nie im Repo. - Python-Builds und Pakete cached uv unter
~/.cache/uv; in CI diesen Ordner cachen spart Minuten. - Freigegebene Python-Versionen zentral festlegen (z. B. 3.13 und
3.14) und in
requires-pythonabbilden.