Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 0: Das Trainingsgelände

Ziel: uv, Python 3.14, ruff und pytest einrichten und das erste Tool hallo als 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 – kein source .venv/bin/activate nö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 uv

Erwartet (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.14

Erwartet (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/*' | sort

Erwartet:

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.toml

Erwartet (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 -a

Erwartet:

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 python

Erwartet:

3.14.2 (main, Jan 14 2026, 23:37:46) [Clang 21.1.4 ]
…/py-lab/tag00-hallo/.venv/bin/python

Tipp: uv run python startet 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 Lab

Erwartet:

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.toml

Erwartet (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 -q

Erwartet:

..                                                                       [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.py

Erwartet:

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.py

Fortschritt 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 tree

Erwartet:

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-hallo

Erwartet:

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 -q

Erwartet:

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.lock und .python-version gehören ins Repo; CI installiert mit uv sync --locked und bricht ab, wenn Lockfile und pyproject.toml auseinanderlaufen.
  • Hinter einem Firmen-Proxy mit eigener CA: uv --native-tls bzw. UV_NATIVE_TLS=1, damit uv den System-Zertifikatsspeicher nutzt.
  • Interne Paketquellen (Artifactory, Nexus) über [[tool.uv.index]] in pyproject.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-python abbilden.