debugging-streamlit

Umiejętność debugowania zmian w aplikacjach Streamlit zarówno po stronie frontendu (React/Vite) jak i backendu (Python). Uruchamiasz jedno polecenie make debug, a narzędzie automatycznie przeładowuje kod podczas edycji — zmiany w interfejsie pojawiają się w kilka sekund, a modyfikacje skryptu aplikacji wyzwalają ponowne uruchomienie. Logi z obu warstw zapisywane są w dedykowanych plikach, co ułatwia śledzenie błędów i analizę zachowania aplikacji.

1. Przejdź do katalogu projektu Streamlit i uruchom polecenie make debug moja_aplikacja.py, gdzie moja_aplikacja.py to nazwa Twojego skryptu. System automatycznie uruchomi backend (Python/Streamlit) i frontend (Vite/React) z włączonym hot-reload.

2. Po uruchomieniu sprawdź wiadomość startową — zawiera adres URL aplikacji (domyślnie http://localhost:3001; jeśli port jest zajęty, system użyje 3002 lub wyższego). Otwórz ten adres w przeglądarce.

3. Edytuj kod frontendu w katalogu frontend/ — zmiany pojawią się w aplikacji w ciągu kilku sekund bez konieczności ręcznego odświeżania.

4. Modyfikuj skrypt aplikacji (moja_aplikacja.py) — każda zmiana automatycznie wyzwoli ponowne uruchomienie backendu. Jeśli zmieniasz kod samej biblioteki Streamlit (lib/streamlit/), musisz ręcznie zatrzymać i ponownie uruchomić make debug.

5. Aby śledzić błędy, sprawdzaj logi w katalogu work-tmp/debug/latest/ — plik backend.log zawiera wyniki print(), logi Streamlit i błędy Pythona, a frontend.log zawiera komunikaty z konsoli przeglądarki i błędy React. Dla szybkiego wyszukiwania użyj narzędzia rg z wzorem, np. rg "ERROR:" work-tmp/debug/latest/backend.log.