environment-triage

Environment Triage to umiejętność diagnostyczna dla projektów Pythona, które używają uv lub venv. Gdy instalacja pakietów zachowuje się nieoczekiwanie lub import nie działa, narzędzie prowadzi Cię przez sprawdzenie rzeczywistego interpretera, wersji Pythona i zainstalowanych zależności. Rozwiązuje typowe problemy, gdzie system Python różni się od tego, który faktycznie używa uv — na przykład gdy .python-version wskazuje 3.11, ale pakiet wymaga 3.12+.

1. Uruchom polecenie uv run python --version, aby sprawdzić, jaki interpreter faktycznie używa uv w Twoim projekcie — nie ufaj systemowemu python3 --version.

2. Sprawdź plik .python-version w katalogu projektu (cat .python-version), aby zobaczyć, jaka wersja Pythona jest tam przypięta — ta wersja kontroluje wybór interpretera przez uv.

3. Jeśli wersja w .python-version nie pasuje do wymagań pakietu (np. pakiet wymaga 3.12+, a plik zawiera 3.11), zaktualizuj go poleceniem echo "3.13" > .python-version.

4. Wyczyść środowisko wirtualne i zsynchronizuj zależności: rm -rf .venv && uv venv && uv sync --all-extras — to zmusi uv do pobrania i zainstalowania pakietów dla nowej wersji Pythona.

5. Potwierdź, że pakiet jest zainstalowany i działa, uruchamiając uv pip show oraz uv run python -c "import ; print(.version)" — jeśli import się powiedzie, problem jest rozwiązany.