Практическая проверка Python 3.15 RC1: как проверить inherit_class_doc и fallback_to_class_doc в inspect.getdoc Python 3.15 для документации API. Изолированный fixture, отрицательный контроль, таблица наблюдений, критерий остановки и безопасный пакет для поддержки.
Граница изменения: как проверить наследование docstring через inspect.getdoc
Python 3.15 добавляет параметры inherit_class_doc и fallback_to_class_doc в inspect.getdoc; gh-132686 описывает различия между inspect и pydoc при наследовании документации. Это подтверждает интерфейс Python 3.15 RC1, но не наличие проблемы в вашем проекте. Практический риск здесь конкретный: Автодокументация может приписать подклассу описание абстрактного либо generic базового класса. Обратная крайность — пустой текст там, где проект сознательно использует class doc как fallback. Перед опытом запишите версию Python, одну наблюдаемую величину и ожидаемую ветку. RC1 остаётся предварительным выпуском: установите его в отдельный virtual environment или контейнер, не поверх рабочего interpreter. Не переносите в стенд production-конфиги, реальные адреса, tokens, полные environment dumps и пользовательские данные.
Обратимый стенд для gh-132686
Рекомендуемый минимальный опыт: Создайте base и child с разными комбинациями docstring: оба заполнены, только base, только child и пустой overridden method. Для каждой комбинации вызовите getdoc с явными параметрами и сравните с ожидаемым источником строки, а не только с непустотой. Все входы должны быть синтетическими, короткими и воспроизводимыми. Каждый вариант получает новый объект, файл или процесс, если cache и global state способны изменить наблюдение. Ограничьте время, размер временных файлов и число повторов заранее; cleanup выполняйте в finally и удаляйте только созданный temp-root. Один запуск показывает конкретный результат, но не частоту проблемы и не готовность всего приложения к миграции.
Контроль и таблица наблюдений
Собирайте строки «объект | own __doc__ | параметры getdoc | возвращённый текст | ожидаемый owner doc | совпадение». Добавьте базовый doc с уникальной меткой BASE_ONLY и child без doc: так видно реальное наследование. Отдельный unrelated class доказывает, что кеш или registry документации не подмешивает текст. Порядок baseline, target, fresh baseline помогает увидеть загрязнение стенда. Пустое поле не равно нулю, отсутствие исключения не подтверждает правильный результат, а изменение двух независимых параметров сразу лишает опыт диагностической силы. Если повторы расходятся, сохраните все строки и пометьте результат unstable, не выбирая самый удобный прогон.
Зелёный критерий и стоп-линия
Passed допустим только если Каждая строка приходит от заранее указанного owner, отсутствие doc остаётся отсутствием там, где fallback запрещён, а pydoc/rendered output не меняется неожиданно. Статус not reproduced означает лишь отсутствие симптома на этом fixture; blocked — нехватку capability или источника; failed control возвращает проверку к стенду. Стоп-линия: Не включайте наследование глобально в генераторе документации, пока не проверены публичные классы, методы и явно скрытые внутренние docstrings. Нельзя получать зелёный результат broad except, отключением защиты, увеличением лимита до исчезновения ошибки или повторением до случайного успеха. Любая новая гипотеза получает отдельную строку, а не добавляется задним числом в объяснение уже выполненного опыта.
Минимальный пакет для поддержки
Передайте maintainer только четыре минимальных класса, таблица параметров getdoc, источник каждой строки и версия Python без документации продукта. Добавьте московский timestamp, точную версию 3.15.0rc1, команды воспроизведения и заранее заданный зелёный критерий. Удалите usernames, hostnames, IP, абсолютные домашние пути, токены, cookies, содержимое рабочих файлов и лишние строки журналов. Официальные и первичные источники подтверждают gh-132686 и change boundary, но не подтверждают результат вашего опыта, массовость боли, будущую индексацию или позиции страницы. Такой пакет позволяет повторить одну ветку без раскрытия данных и без смешения соседних причин.
Материал подготовлен редакцией VOne с помощью ИИ по открытым официальным и первичным источникам; факты, даты и ссылки перепроверены. Реальные пользовательские данные и вымышленные результаты тестов не использовались.
Источники и проверка
- What’s New in Python 3.15 проверено 2026-08-30
- CPython gh-132686 — inspect.getdoc inheritance controls проверено 2026-08-30
Информация актуальна на дату публикации. Правила сервисов, приложений и сетей могут меняться.