Zen of Python
18.6K subscribers
1.52K photos
202 videos
38 files
3.73K links
Полный Дзен Пайтона в одном канале

Разместить рекламу: @tproger_sales_bot

Правила общения: https://tprg.ru/rules

Другие каналы: @tproger_channels

Сайт: https://tprg.ru/site

Регистрация в перечне РКН: https://tprg.ru/xZOL
Download Telegram
Decimal в тайм-ауте не делает ожидание точнее

Тайм-аут может прийти в программу как Decimal из конфигурации или как Fraction после вычисления. В Python 3.15 функции с аргументами timestamp и timeout принимают любые вещественные числа, а не только int и float.

В описании изменения отдельно оговорено: точность от этого не повышается. Изменение позволяет передавать уже вычисленное значение без преобразования на стороне вызывающего кода.

Что именно ограничивает тайм-аут и когда функция возвращает управление, по-прежнему зависит от её контракта. Допустимый числовой тип этих правил не меняет.
❤1
Стартовый код пакета переезжает из .pth в .start

Файл .pth может не только расширять sys.path. При запуске Python модуль site исполняет найденные в нём строки, начинающиеся с import. Этот код выполняется ещё до первой строки приложения.

В Python 3.15 PEP 829 вводит файлы .start с явными точками входа в форме pkg.mod:callable. Функция вызывается без аргументов, возвращённое значение отбрасывается. У PEP статус Final.

Если рядом есть одноимённый .start, строки import из соответствующего .pth игнорируются. Добавление путей из .pth сохраняется. Это позволяет переносить стартовую инициализацию отдельно от настройки путей, сохраняя старый файл для прежних интерпретаторов.
Обновление Python не обновляет pip в старых venv

В Python 3.15.1 обновили комплектный pip до 26.2.2. В его состав входит certifi 2026.10.19 с изменениями после инцидента с центрами сертификации eMudhra / emSign. Но установка нового интерпретатора сама по себе не обновляет инструменты внутри уже созданных виртуальных окружений.

На странице релиза отдельно просят обновить pip и uv в существующих venv до последних версий. Там же приведены ссылка на wheel pip с SHA-256 и отдельная инструкция по обновлению сертификатов для установки на macOS.

Проверяйте версию pip внутри нужного окружения. Версия системного Python этого не показывает. Для обновления сертификатов выбирайте инструкции релиза, относящиеся к вашему способу установки.
❤2
Unicode-идентификатор начинается и продолжается по разным правилам

Если вы пишете токенизатор или подсветку для языка с Unicode-именами, проверки «это буква или цифра» может оказаться недостаточно. У Unicode есть отдельные свойства для начальной и последующих позиций идентификатора.

В Python 3.15 эти проверки добавили в unicodedata. Функция isxidstart проверяет свойство XID_Start, а isxidcontinue — XID_Continue по UAX #31. Каждая принимает один символ. Модуль использует базу Unicode 17.0.0.

Так можно проверять свойства символов без собственного списка диапазонов, который придётся обновлять вместе с Unicode. Для проверки целого имени нужны ещё правила конкретного языка. Например, эти функции не проверяют, является ли имя зарезервированным словом.
Установщик Python 3.15 для macOS ставит обе сборки по умолчанию

В установщике Python 3.15 с python.org для macOS free-threaded сборка отмечена по умолчанию. Она ставится рядом с обычной, в отдельный PythonT.framework, и запускается командой python3.15t. Отключить этот компонент можно через Customize.

У сборок отдельные каталоги site-packages и собственные экземпляры pip. Наличие пакета в обычном Python поэтому не означает, что он установлен и во free-threaded варианте. В инструкции для macOS рекомендуют использовать виртуальные окружения, чтобы не путать интерпретаторы.

Эта настройка относится к официальному установщику, а не ко всем дистрибутивам Python для Mac. Нативные расширения могут ещё не поддерживать работу без GIL и включать его обратно. Перед запуском приложения во второй сборке проверьте совместимость его зависимостей.
abi3t сокращает число сборок нативного расширения

Нативному расширению обычно нужны отдельные сборки под версии CPython, а free-threaded варианты ещё увеличивают их число. Начиная с CPython 3.15, Stable ABI для free threading, или abi3t, позволяет одной сборке на платформу поддерживать несколько версий. Она совместима и с обычными сборками CPython 3.15+.

Для этого придётся ограничиться доступной частью C API и, возможно, пожертвовать скоростью. Руководство рекомендует сначала подготовить расширение к free threading. Если оно использует генератор кода или биндинги, стоит дождаться поддержки abi3t в соответствующем инструменте.

Расширения с собственными типами переменного размера нельзя перенести на abi3t 3.15. А совместимость ABI не исключает изменений поведения между версиями: тесты нужно запускать на каждой поддерживаемой версии, в обычной и free-threaded сборках Python.
Как посмотреть локальные переменные после ошибки в REPL

Вызов в интерактивном Python завершился исключением, а по traceback непонятно, какое значение привело к ошибке. Пока эта сессия открыта, можно посмотреть локальные переменные в месте ошибки без повторного запуска вызова.

Импортируйте pdb и выполните pdb.pm(). Функция берёт последнее необработанное исключение из sys.last_exc и открывает отладчик на кадре, где оно возникло. Команда p x покажет значение x в этом кадре. На карточке — выполненный пример: после f(0) виден локальный x = 0. Такой сценарий есть и в документации pdb.

Это просмотр сохранённого traceback в том же живом REPL. Продолжить исходный вызов, завершившийся исключением, нельзя. После выхода из интерпретатора этот приём уже не поможет.
ZIP с Zstandard может не открыться у получателя

Архив успешно собрался и распаковался вашим Python, но это ещё не проверка совместимости с утилитой получателя. Для ZIP с Zstandard важны и поддержка алгоритма, и его числовой идентификатор в архиве.

В Python 3.14 появился zipfile.ZIP_ZSTANDARD. По документации zipfile, модуль читает Zstandard с ID 20 и 93, а записывает только 93. Старый ID 20 заменили в спецификации, чтение сохранили ради совместимости. Локальный пример на CPython 3.14.4 подтвердил запись 93 и восстановление исходных байтов.

Нужна сборка Python с необязательным модулем compression.zstd. Если архив уйдёт за пределы вашей среды, проверьте распаковку именно инструментом получателя: часть утилит, включая старые версии Python, Zstandard в ZIP не поддерживает.
🎉1
pytest --sw возвращает к последнему упавшему тесту

После правки несколько тестов падают подряд. Если исправляете их по одному, pytest --sw помогает не прогонять уже пройденное начало набора при каждой попытке. Он останавливается на первом падении и сохраняет позицию между запусками.

Следующий запуск с --sw начинает с того же упавшего теста. Если вы его починили, pytest идёт дальше до следующей ошибки. В нашем проверенном примере первый прогон остановился на test_b, а после исправления второй повторил test_b и дошёл до падения test_c. Это отличается от --lf, который выбирает ранее упавшие тесты. Механизм описан в документации pytest.

Позиция хранится в кэше, а не в памяти остановленного процесса. Ранние успешные тесты после ваших правок могли сломаться. Когда закончите исправления, запустите весь набор обычным pytest.
Как читать BLOB из SQLite по частям

Если вложение хранится в SQLite, не обязательно получать его целиком как один bytes. Начиная с Python 3.11, Connection.blobopen() открывает существующий BLOB по имени таблицы, столбца и rowid. У полученного объекта есть файловые операции чтения и записи.

Размер задаётся заранее: zeroblob(8) создаёт восемь нулевых байтов, которые затем можно перезаписать частями. На карточке — фрагмент проверенного примера: после двух записей по четыре байта чтение с read(4) выдаёт два блока. Для большого объекта выбирайте подходящий размер блока и обрабатывайте каждый сразу, не собирая их обратно в список.

Без аргумента read() прочитает весь остаток до конца. Сам BLOB через этот интерфейс увеличить нельзя, а таблицы WITHOUT ROWID не поддерживаются. Контекстный менеджер закрывает BLOB-дескриптор. Детали — в описании Blob.
Как узнать, какие тесты выполняли строку кода

Зелёная строка в coverage-отчёте показывает, что код выполнялся. Чтобы увидеть, в каких тестах это происходило, у pytest-cov есть --cov-context=test. Он сохраняет ID теста и фазу выполнения: setup, run или teardown.

Запустите pytest --cov=calc --cov-context=test --cov-report=html, заменив calc именем своего модуля. В .coveragerc включите [html] show_contexts = True. В нашем запуске coverage 7.17.2 на CPython 3.14.4 понадобился ещё [run] core = ctrace: стандартный sysmon предупреждал о неполных контекстах. По документации pytest-cov, нажатие на число у покрытой строки раскрывает список контекстов. У параметризованных случаев будут разные test ID, включая заданные вами имена.

В проверенном примере два случая neg и pos дали шесть контекстов у одной строки: её вызывали в каждой из трёх фаз. Число контекстов не равно числу тестов. И такой отчёт показывает выполнение кода, а не качество проверок результата.
Placeholder оставляет место перед связанным аргументом

У str.replace исходная строка стоит перед заменяемым фрагментом. Если нужен колбэк, удаляющий дефисы из любой строки, хотелось бы заранее задать второй и третий позиционные аргументы, оставив первый свободным. В Python 3.14 это делает functools.Placeholder.

Импортируйте его как _ и создайте partial(str.replace, _, "-", ""). При вызове strip_dash("a-b-c") строка займёт пропуск, и получится "abc". Раньше partial тоже связывал аргументы по имени, но позиционные пропуски позволяют фиксировать аргументы после свободного места, включая параметры, которые нельзя передать по имени.

Если пропусков несколько, входящие позиционные аргументы заполняют их слева направо. Все пропуски нужно заполнить при вызове, иначе будет TypeError. Передать сам Placeholder как именованный аргумент в partial нельзя.
Как закрыть asyncio.Queue без стоп-сигнала в данных

В Python 3.13 у asyncio.Queue появился shutdown(). После вызова очередь больше не принимает элементы: новые и уже ожидающие put() получают QueueShutDown. Для завершения конвейера не нужен специальный объект, который потребители должны отличать от обычных данных.

При обычном завершении оставшиеся элементы можно забрать через get(). Когда очередь опустеет, он тоже вызовет QueueShutDown — потребитель может перехватить исключение и выйти. Для каждого обработанного элемента по-прежнему нужен task_done(), чтобы дождаться join(). Завершения самих задач потребителей ждите отдельно.

Режим immediate=True отбрасывает лежащие в очереди элементы. Уже взятая работа остаётся незавершённой: в проверенном примере join() ждал её task_done(). Возврат из него не доказывает, что отброшенные элементы обработаны. Различия режимов описаны в документации shutdown.
PEP 639 разделяет лицензию и файлы с её текстом

В метаданных пакета нужно различать обозначение лицензии и файлы с юридическими текстами. Финальная спецификация PEP 639 вводит для Core Metadata 2.4 поле License-Expression с выражением SPDX и отдельные поля License-File.

В pyproject.toml строка license = "MIT" задаёт выражение, а license-files = ["LICENSE"] указывает файлы для включения в дистрибутив. Это пример записи, а не выбор лицензии за автора. Каждый явно заданный шаблон должен найти хотя бы один файл. Старые таблицы license = {text = ...} и {file = ...} объявлены устаревшими.

Карточка показывает схему спецификации. Мы проверили разбор TOML и наличие файла в учебной папке, но это не проверка поддержки сборочным backend. В своём пакете проверьте метаданные и файлы уже собранных wheel и sdist. Выражение SPDX не заменяет лицензионные тексты и само по себе не предоставляет новых прав.
Process.interrupt() даёт дочернему процессу KeyboardInterrupt

В Python 3.14 у multiprocessing.Process появился interrupt(). На POSIX он посылает дочернему процессу SIGINT. При стандартном обработчике в нём возникает KeyboardInterrupt, а стек Python разворачивается с выполнением блоков finally.

В нашем проверенном примере родитель дождался готовности собственного дочернего процесса, вызвал interrupt() и сделал join(3). Дочерний процесс оставил файл из finally и завершился с exitcode == 1, как при неперехваченном исключении. У terminate() такой гарантии выполнения finally нет.

Это не гарантия остановки: второй тестовый процесс перехватил KeyboardInterrupt и продолжил работать до отдельного разрешения на выход. Обработчик сигнала тоже может изменить поведение. После ожидания проверяйте is_alive(). На Windows поведение метода не определено — это ограничение прямо указано в документации interrupt.
Почему batch_size не ограничивает всю подготовку bulk_update

В bulk_update(objects, fields, batch_size=100) размер пачки ограничивает число объектов в одном SQL-запросе. Но Django заранее готовит WHEN-выражения для всех переданных объектов, включая следующие пачки. Маленький batch_size не делает один большой вызов потоковым.

В документации Django 6.0 предлагают внешний цикл: взять порцию ID через islice, загрузить только её модели, изменить поля и вызвать bulk_update() для этой порции. В проверенном примере шесть строк обновились за три отдельных вызова по две модели. Внутри каждого batch_size=1 дал два UPDATE-запроса. Это два разных уровня разбиения.

Если заранее собрать все модели в список, внешний цикл не вернёт уже занятую ими память. И массовое обновление не вызывает save() и сигналы pre_save/post_save. Учитывайте это, если там находится нужная вам логика.
❤1
os.cpu_count() может считать больше, чем доступно потоку

Число логических CPU в системе и число CPU, на которых разрешено работать текущему потоку, могут различаться. Начиная с Python 3.13, os.process_cpu_count() возвращает второе. По документации Python, оно может быть меньше os.cpu_count() из-за CPU affinity. Если определить число не удалось, результатом будет None.

Есть важная поправка для диагностики: параметр запуска -X cpu_count=n или переменная PYTHON_CPU_COUNT переопределяет результат обеих функций. В отдельном проверенном процессе с -X cpu_count=2 обе вернули 2. Это заданная настройка, а не измерение оборудования или демонстрация ограничения affinity.

Проверяйте конфигурацию запуска, прежде чем выбирать размер пула по этому числу. API не считает физические ядра и не обещает универсально определять квоты cgroup. Оптимальное число воркеров всё ещё зависит от вашей нагрузки.
Как разрешить только один NULL в уникальном поле Django

Уникальность поля не всегда запрещает несколько строк с NULL. В UniqueConstraint параметр nulls_distinct=None выбирает правило базы данных, а на большинстве backend строки с NULL считаются различными. Поэтому несколько таких строк могут пройти проверку уникальности в базе.

Если «позиция пока не задана» допустима только у одной записи, для ограничения на единственное поле ordering можно указать nulls_distinct=False. В примере Django 6.0 такое ограничение допускает лишь одну строку с NULL в этом столбце. На карточке — декларация и правило из документации.

Условие принципиальное: нужны PostgreSQL 15 или новее. На остальных backend ограничения с nulls_distinct игнорируются. Успешное создание Python-объекта ограничения не доказывает, что база применяет это правило. После миграции проверьте повторную вставку NULL на вашей рабочей СУБД.
Как получить аннотации с ещё не определённым типом

Интроспектору не всегда нужно сразу разрешать все типы. Если у функции аннотации n: int и x: Missing, а имя Missing ещё не определено, обычное вычисление аннотаций завершится NameError. В Python 3.14 у annotationlib для этого есть формат FORWARDREF.

Вызов get_annotations(f, format=Format.FORWARDREF) возвращает смешанный словарь: для n — настоящий int, для x — объект ForwardRef с именем Missing. Так можно изучить доступную часть сигнатуры, сохранив неразрешённую ссылку. Это ещё не проверка типов и не гарантия, что зависимость позднее найдётся.

Формат не подавляет любые ошибки: аннотация 1 / 0 по-прежнему вызывает ZeroDivisionError. Вычисление аннотаций может запускать код, поэтому FORWARDREF нельзя считать песочницей для недоверенных данных. Примеры и ограничения есть в документации annotationlib.
Как подключить свой класс к copy.replace()

С Python 3.13 copy.replace(obj, **changes) умеет работать не только с dataclass и именованными кортежами. Обычный класс может поддержать протокол __replace__: метод получает заменяемые поля и создаёт новый объект того же типа.

В примере класс Job хранит retries и список tags. Его __replace__ собирает текущие значения, накладывает изменения и вызывает конструктор. После replace(job, retries=3) у исходного объекта остаётся 1, у нового — 3. Неизвестные поля отклоняет наш метод, отрицательное число попыток — конструктор. Эти проверки написал автор класса, функция замены не добавляет их автоматически.

В этой реализации список tags передаётся по той же ссылке: его изменение видно обоим объектам. Сам факт вызова copy.replace() не делает класс неизменяемым и не обещает глубокую копию. Правила замены и сохранения вложенных данных задаёт ваш __replace__.
❤1