---
name: python-conventions
description: Konwencje kodu Python obowiązujące przy modyfikacjach plików *.py
applyTo: "**/*.py"
---

# Konwencje Python

- Zachowuj istniejący styl pliku (cudzysłowy, długość linii, układ importów). Nie uruchamiaj
  formatera na całym pliku.
- Type hints obowiązkowe w nowym i modyfikowanym kodzie publicznym.
- Preferuj menedżery kontekstu (`with`) dla zasobów zamiast ręcznego `close()`.
- Nie zmieniaj publicznych sygnatur funkcji bez odnotowania tego w planie jako `breaking`.
- Import stdlib > third-party > lokalne, rozdzielone pustą linią.