python-patterns

Skill zawierający idiomatyczne wzorce Pythona, standardy PEP 8, type hints i najlepsze praktyki do budowania solidnych aplikacji. Obejmuje zasady czytelności kodu, jawności zamiast ukrytych efektów ubocznych, obsługę wyjątków w stylu EAFP oraz nowoczesne type hinty dla Python 3.9+. Aktywuj go podczas pisania nowego kodu, przeglądu istniejącego czy refaktoryzacji projektów.

1. Aktywuj skill python-patterns przed rozpoczęciem pracy nad kodem Pythona — szczególnie przydatny przy pisaniu nowych modułów, przeglądzie pull requestów lub refaktoryzacji istniejących aplikacji.
2. Kiedy piszesz funkcję, pamiętaj o trzech kluczowych zasadach: czytelność kodu powinna być priorytetem, kod powinien być jawny zamiast ukrywać logikę, a obsługę błędów lepiej realizować przez wyjątki (EAFP) niż warunkami wstępnymi (LBYL).
3. Dodaj type hints do swoich funkcji i zmiennych — używaj wbudowanych typów jak list[str] i dict[str, int] w Python 3.9+, lub importuj z modułu typing dla starszych wersji.
4. Strukturuj konfigurację jawnie, unikając ukrytych efektów ubocznych — zamiast wywoływać magiczne funkcje setup(), wyraźnie określ parametry logowania, połączeń czy inicjalizacji.
5. Przejrzyj swój kod pod kątem czytelności: zmienne powinny mieć jasne nazwy, funkcje powinny mieć docstringi wyjaśniające ich cel, a logika powinna być zrozumiała na pierwszy rzut oka.
6. Kiedy obsługujesz słowniki lub dostęp do danych, preferuj try-except zamiast sprawdzania warunku if key in dict — to bardziej pythoniczny sposób.