Телеграм канал «Постоянный репозиторий по Python»

Как выглядят современные аннотации в Python: ключевые правила Когда инструменты настроены, важно правильно писать сам код. Современные аннотации должны быть понятными, лаконичными и максимально полезными для статических анализаторов. 🔹 1. Аннотации обязательны для всех публичных функций def get_balance(user_id: int) -> float: ... Сигнатура должна говорить всё: что принимает и что возвращает. 🔹 2. Используем новый синтаксис коллекций Современный стиль: items: list[str] = ["apple", "banana"] prices: dict[str, float] = {"apple": 1.2} Устаревший стиль: from typing import List, Dict items: List[str] Новый вариант проще, лучше читается и полностью поддерживается анализаторами. 🔹 3. Корректная работа с опциональными значениями Больше никаких «пустых строк» или магических значений. def find_user(name: str) -> User | None: ... Анализатор понимает этот контракт и подсветит ошибки, если вы забыли обработать None. Такие простые правила дают удивительно много: код становится самодокументируемым и безопасным. ➡️ В следующем посте — о типизации данных: модели через `TypedDict, dataclasses и Pydantic. (следите за обновлениями и поддержите канал через boost https://t.me/boost/phytonrepoz)

Современный Python-проект: что обязательно должно быть в конфигурации Типизация работает лучше всего тогда, когда проект правильно настроен. И это как раз то, что складывается в основу чек-листа. Первое, с чего начинается современный проект – это структурированная конфигурация. 🔹 1. pyproject.toml как главный файл настроек Сегодня это стандарт де-факто. В нём описываются зависимости, линтеры, форматтеры и статические анализаторы. Минимальный пример: [project] requires-python = ">=3.12" [tool.mypy] strict = true python_version = "3.12" Такая конфигурация включает строгий анализ и снижает вероятность появления “скрытых” ошибок типов. 🔹 2. Обязательные инструменты: mypy/pyright, ruff, black Современный стек выглядит так: • pyright → очень быстрый анализатор • mypy → глубокий строгий анализ • ruff → быстрый линтер, заменяющий flake8 + isort • black → стабильное форматирование Пример настройки ruff: [tool.ruff] line-length = 100 target-version = "py312" 🔹 3. CI — проверка типов как обязательный этап Каждый Pull Request должен прогоняться через статический анализ: mypy src/ pyright ruff check . pytest Таким образом ошибки ловятся до того, как код попадёт в ветку разработки. Эти базовые инструменты – фундамент типизированного проекта. ➡️ В следующем посте – как должны выглядеть сами аннотации и код с типами (следите за обновлениями и поддержите канал через boost)