post-process-logo

Umożliwia szybkie przetwarzanie oryginalnych plików logo do ujednoliconego formatu 256x256 PNG, idealnego dla metadanych protokołów vault. Narzędzie automatycznie wybiera najbardziej kwadratowy wariant logo spośród dostępnych plików, wykrywa format i wymiary, a następnie dodaje wypełnienie w razie potrzeby. Obsługuje warianty light, dark i generic, pracuje z plikami SVG, PNG, JPG i WEBP. Wymaga zainstalowanej biblioteki Python Pillow do analizy obrazów.

1. Przygotuj środowisko: upewnij się, że masz zainstalowane zależności Python za pomocą polecenia poetry install --with dev oraz bibliotekę Pillow do obsługi formatów obrazów.

2. Zbierz wymagane informacje od użytkownika: ścieżkę do folderu zawierającego oryginalne pliki logo (np. eth_defi/data/vaults/original_logos/protocol-name/), ścieżkę do folderu docelowego, gdzie mają być zapisane przetworzone loga (np. eth_defi/data/vaults/formatted_logos/), oraz opcjonalnie preferencję wariantu: generic, light, dark lub all.

3. Zainwentaryzuj loga wejściowe: wylistuj wszystkie pliki obrazów w folderze źródłowym i sklasyfikuj je według wariantu na podstawie nazwy pliku (np. {slug}.light.png dla wariantu light, {slug}.dark.svg dla dark). Preferuj brand marks (samo logo bez tekstu nazwy) zamiast word marks.

4. Sprawdź proporcje każdego logo: zidentyfikuj format pliku (SVG, PNG, JPG, WEBP) i wymiary. Narzędzie automatycznie wybierze najbardziej kwadratowy wariant spośród dostępnych plików.

5. Uruchom przetwarzanie: narzędzie przekonwertuje wybrane loga do formatu PNG 256x256 pikseli, automatycznie dodając wypełnienie (padding) jeśli potrzebne, aby uzyskać idealny kwadrat. Wynik zostanie zapisany w folderze docelowym.

6. Zweryfikuj wyniki: sprawdź folder wyjściowy, aby potwierdzić, że wszystkie loga zostały przetworzone w poprawnym formacie i wymiarach.