15 lines
595 B
Markdown
15 lines
595 B
Markdown
---
|
|
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ą.
|