debugging-streamlit

Debug Streamlit frontend and backend changes using make debug with hot-reload. Use when testing code changes, investigating bugs, checking UI behavior, or needing screenshots of the running app.

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.