Python — один из самых читаемых языков программирования, но читаемость не приходит автоматически. Вот несколько простых приёмов, которые помогут сделать ваш код лучше.
1. Используйте f-строки вместо конкатенации
f-строки появились в Python 3.6 и стали стандартом де-факто для форматирования строк. Они читабельнее и быстрее старых методов.
# Плохо
name = "World"
greeting = "Hello, " + name + "!"
# Хорошо
greeting = f"Hello, {name}!"
2. Предпочитайте enumerate() счётчику
Если вам нужен индекс при переборе списка, используйте enumerate() вместо ручного счётчика.
# Плохо
i = 0
for item in items:
print(i, item)
i += 1
# Хорошо
for i, item in enumerate(items):
print(i, item)
3. Используйте dataclasses для структур данных
Вместо обычных классов с __init__ и набором атрибутов используйте @dataclass — это экономит код и добавляет repr/eq бесплатно.
4. Пишите маленькие функции
Функция должна делать одно дело и делать его хорошо. Если функция занимает больше 20–30 строк — подумайте о её разбиении.
5. Документируйте публичный API
Добавляйте docstring к публичным функциям и классам. Это помогает и коллегам, и вам самому через полгода.
Следование этим простым правилам сделает ваш код более поддерживаемым и приятным для чтения.