Changelog¶

Амортизация¶

• #10012: Обновите pytest.PytestUnhandledCoroutineWarning на deprecation; он будет вызывать ошибку в pytest 8.

• #10396: pytest больше не зависит от библиотеки py. pytest предоставляет вендорные копии модулей py.error и py.path, но будет использовать библиотеку py, если она установлена. Если вам нужны другие модули py.*, продолжайте устанавливать устаревшую библиотеку py отдельно, в противном случае ее обычно можно удалить как зависимость.

• #4562: Исчезнуть конфигурирование hook specs/impls с помощью атрибутов/маркеров.

  Вместо этого используйте pytest.hookimpl() и pytest.hookspec(). Более подробную информацию см. в docs.

• #9886: Функциональность для запуска тестов, написанных для nose, была официально устаревшей.

  Сюда входят:

  • Простые функции и методы setup и teardown: это может застать пользователей врасплох, поскольку setup() и teardown() не являются идиомами pytest, а являются частью поддержки nose.

  • Установка/снятие с помощью декоратора @with_setup.

  Для получения более подробной информации обратитесь к deprecation docs.

• #7337: Предупреждение об устаревании теперь выдается, если тестовая функция возвращает что-то, отличное от None. Это предотвращает распространенную ошибку среди новичков, которые ожидают, что возвращение bool (например, return foo(a, b) == result) приведет к прохождению или провалу теста, вместо того, чтобы использовать assert. В будущем планируется сделать возврат не None из тестов ошибкой.

Характеристики¶

• #9897: В testpaths добавлена поддержка подстановочных знаков в стиле shell.

Улучшения¶

• #10218: @pytest.mark.parametrize() (и подобные функции) теперь принимают любые Sequence[str] для имен аргументов, вместо только list[str] и tuple[str, ...].

  (Обратите внимание, что str, который сам по себе является Sequence[str], по-прежнему рассматривается как список имен, разделенный запятыми, как и раньше).

• #10381: Был добавлен флаг --no-showlocals. Его можно передавать непосредственно в тесты для переопределения --showlocals, объявленных через addopts.

• #3426: Ошибки утверждения со строками в формах NFC и NFD, которые нормализуются в одну и ту же строку, теперь имеют специальное сообщение об ошибке, подробно описывающее проблему, и вместо этого выражается их представление utf-8.

• #8508: Введено многострочное отображение для предупреждающего сопоставления через pytest.warns() и улучшено сопоставление для _pytest._code.ExceptionInfo.match(), возвращаемое pytest.raises().

• #8646: Улучшение pytest.raises(). Ранее передача пустого кортежа приводила к непонятной ошибке. Теперь мы сразу же выдаем более полезное сообщение.

• #9741: В Python 3.11 для разбора TOML используйте tomllib из стандартной библиотеки.

  tomli больше не является зависимостью от Python 3.11.

• #9742: Вывести сообщение утверждения без символов новой строки с -vv.

• #9823: Улучшено сообщение об ошибке, которое показывается, если для заданного файла не найден коллектор.

• #9873: В краткое резюме теста добавлены некоторые цвета.

• #9883: Нормализовать описание справки для всех опций командной строки.

• #9920: Отображение полных сообщений о сбоях в short test summary info при запуске в среде CI.

• #9987: Добавлена поддержка скрытого конфигурационного файла путем разрешения .pytest.ini в качестве альтернативы pytest.ini.

Исправления ошибок¶

• #10150: sys.stdin теперь содержит все ожидаемые методы файлоподобного объекта при включенном захвате.

• #10382: Не разбивайте pdb, когда raise unittest.SkipTest() появляется на верхнем уровне в файле.

• #7792: Теперь метки наследуются в соответствии с полным MRO в тестовых классах. Ранее, если тестовый класс наследовался от двух или более классов, применялись только метки первого суперкласса.

  При наследовании знаков от суперклассов знаки подклассов теперь упорядочиваются перед знаками суперклассов в порядке MRO. Ранее было наоборот.

  При наследовании меток от суперклассов атрибут pytestmark подкласса теперь содержит только те метки, которые непосредственно применяются к нему. Ранее он также содержал метки от суперклассов. Обратите внимание, что обычно к этому атрибуту не следует обращаться напрямую; вместо этого используйте pytest.Node.iter_markers().

• #9159: Показ внутренних исключений путем принудительного нативного отображения в ExceptionGroups даже при использовании опций отображения, отличных от --tb=native. Временный шаг перед полной реализацией pytest-native отображения внутренних исключений в ExceptionGroups.

• #9877: Убедитесь, что caplog.get_records(when) возвращает текущие/корректные данные после вызова caplog.clear().

Улучшенная документация¶

• #10344: Обновите информацию о написании плагинов для использования pyproject.toml вместо setup.py.

• #9248: Документация теперь строится с использованием Sphinx 5.x (по сравнению с 3.x ранее).

• #9291: Обновление документации о том, как pytest.warns() влияет на DeprecationWarning.

Тривиальные/внутренние изменения¶

• #10313: Сделали _pytest.doctest.DoctestItem экспортом pytest.DoctestItem для проверки типов и целей выполнения. Заставил _pytest.doctest использовать внутренние API, чтобы избежать циклического импорта.

• #9906: Сделал _pytest.compat реэкспорт importlib_metadata в глазах программ проверки типов.

• #9910: Исправьте предупреждение о кодировке по умолчанию (EncodingWarning) в cacheprovider

• #9984: Улучшите сообщение об ошибке при попытке получить доступ к приспособлению, которое было снесено. Добавьте дополнительное предложение в строку документации, объясняющее, когда не стоит вызывать getfixturevalue.

Исправления ошибок¶

• #10060: При запуске с --pdb, TestCase.tearDown больше не вызывается для тестов, когда класс был пропущен через unittest.skip или pytest.mark.skip.

• #10190: Недопустимые символы XML в сообщениях об ошибках установки или разрушения теперь правильно экранируются для отчетов JUnit XML.

• #10230: Игнорировать файлы .py, созданные редактируемыми сборками на основе pyproject.toml, представленными в pip 21.3.

• #3396: Доктесты теперь уважают флаг --import-mode.

• #9514: Аннотируйте FixtureRequest.param как Any в качестве временной меры, пока issue #8073 не будет исправлено.

• #9791: Исправлен код обработки путей в rewrite.py, который вроде бы работает нормально, но был некорректен и не работает в некоторых системах.

• #9917: Исправлено представление строки для pytest.approx() при использовании для сравнения кортежей.

Улучшенная документация¶

• #9937: Явное указание на то, что крепление tmpdir не рекомендуется в пользу tmp_path.

Тривиальные/внутренние изменения¶

• #10114: Замените atomicwrites зависимость от windows с помощью os.replace.

Исправления ошибок¶

• #9726: Удален ненужный импорт numpy внутри pytest.approx().

• #9820: Исправьте сравнение dataclasses с InitVar.

• #9869: Увеличьте stacklevel для деплоя NODE_CTOR_FSPATH_ARG, чтобы он указывал на код пользователя, а не на pytest.

• #9871: Исправление странной (и, к счастью, редкой) ошибки, когда приспособление temp_path могло вызвать внутреннюю ошибку при попытке получить имя пользователя текущего пользователя.

Исправления ошибок¶

• #9767: Исправлена ошибка в pytest 7.1.0, когда некоторые файлы conftest.py вне дерева исходников (например, в каталоге site-packages) не подхватывались.

Разрывные изменения¶

• #8838: В соответствии с нашей политикой, следующие функции были устаревшими в серии 6.X и теперь удалены:

  • pytest._fillfuncargs функция.

  • Хук pytest_warning_captured - используйте вместо него pytest_warning_recorded.

  • Синтаксис -k -foobar - вместо него используйте -k 'not foobar'.

  • -k foobar: синтаксис.

  • Модуль pytest.collect - импортировать из pytest напрямую.

  Для получения дополнительной информации обратитесь к Deprecations and Removals в документации.

• #9437: Прекращена поддержка Python 3.6, который достиг end-of-life в 2021-12-23.

Улучшения¶

• #5192: Исправлен тестовый вывод для некоторых типов данных, где -v показывал меньше информации.

  Также, при отображении различий для последовательностей, -q выдавал полные различия вместо ожидаемых.

• #9362: pytest теперь избегает специализированного форматирования утверждений, когда обнаруживается, что стандартное __eq__ переопределено в attrs или dataclasses.

• #9536: Если в командной строке указано -vv, показывать причины пропуска и xfail полностью, а не усекать их для соответствия ширине терминала.

• #9644: Дополнительную информацию о расположении ресурсов, которые заставили Python поднять ResourceWarning, теперь можно получить, включив tracemalloc.

  Для получения дополнительной информации см. раздел Предупреждения о ресурсах.

• #9678: Теперь в аргументе ids для @pytest.mark.parametrize принимается больше типов. Ранее принимались только str, float, int and bool were accepted; now bytes, complex, re.Pattern, Enum and anything with a __имя__.

• #9692: pytest.approx() теперь выдает TypeError, когда задается неупорядоченная последовательность (например, set).

  Обратите внимание, что это означает, что пользовательские классы, которые реализуют только __iter__ и __len__, больше не поддерживаются, поскольку они не гарантируют порядок.

Исправления ошибок¶

• #8242: Устранение возможности поднимать unittest.SkipTest для пропуска сбора тестов на этапе сбора pytest отменено - теперь это снова поддерживается.

• #9493: Символьные компоненты ссылок больше не разрешаются в путях контестов. Это означает, что если контест появляется дважды в дереве коллекции, используя симлинки, он будет выполнен дважды. Например, задано

  tests/real/conftest.py tests/real/test_it.py tests/link -> tests/real

  выполнение pytest tests теперь импортирует conftest дважды, один раз как tests/real/conftest.py и один раз как tests/link/conftest.py. Это исправление соответствует аналогичному изменению, внесенному в саму коллекцию тестов в pytest 6.0 (подробности см. в pull request #6523).

• #9626: Исправлен подсчет выбранных тестов в сводке коллекции терминалов при наличии ошибок или пропущенных модулей.

  Если при сборе были ошибки или пропущенные модули, pytest ошибочно вычитал их из выбранного количества.

• #9645: Исправлена регрессия, когда --import-mode=importlib, использованный вместе с PYTHONPATH или pythonpath, приводил к ошибкам импорта в тестовых наборах.

• #9708: pytester теперь запрашивает фикстуру monkeypatch вместо того, чтобы создавать ее внутри. Это решает некоторые проблемы с тестами, в которых используются переменные окружения pytest.

• #9730: Неправильно сформированные файлы pyproject.toml теперь выдают более четкое сообщение об ошибке.

Исправления ошибок¶

• #9608: Исправление некорректного импорта importlib.readers в Python 3.9.

• #9610: Восстановите UnitTestFunction.obj to return unbound rather than bound method. Fixes a crash during a failed teardown in unittest TestCases with non-default __init__. Устранено в pytest 7.0.0.

• #9636: Плагин pythonpath был переименован в python_path. Это позволяет избежать конфликта с плагином pytest-pythonpath.

• #9642: Исправление запуска тестов по id с :: в части параметризации.

• #9643: Задержите выдачу PytestWarning о наследовании бриллиантов с участием Item и Collector, чтобы его можно было отфильтровать с помощью standard warning filters.

Амортизация¶

• #9488: Если пользовательские подклассы узлов типа pytest.Item переопределяют метод __init__, они должны принимать **kwargs. Подробности см. в разделе Конструкторы пользовательских подклассов pytest.Node должны принимать **kwargs.

  Обратите внимание, что предупреждение об исправлении выдается только в том случае, если существует конфликт в аргументах, которые pytest ожидал передать. Это исправление уже было частью pytest 7.0.0rc1, но не было задокументировано.

Исправления ошибок¶

• #9355: Исправлено сообщение об ошибке, печатающее декораторы функций при использовании assert в Python 3.8 и выше.

• #9396: Убедитесь, что pytest.Config.inifile доступен во время хука pytest_cmdline_main (регрессия во время 7.0.0rc1).

Улучшенная документация¶

• #9404: Добавлена дополнительная документация по альтернативам распространенных случаев неправильного использования pytest.warns(None) в преддверии его депривации.

• #9505: Уточните, где находятся файлы конфигурации. Во избежание путаницы в документации упоминается, что конфигурационный файл находится в корне хранилища.

Тривиальные/внутренние изменения¶

• #9521: Добавьте покрытие тестов в путь перезаписи утверждений.

Разрывные изменения¶

• #7259: Тип первого возвращаемого значения функции Node.reportinfo() был расширен с py.path.local | str до os.PathLike[str] | str.

  Большинство плагинов, которые ссылаются на reportinfo(), определяют его только как часть пользовательской реализации pytest.Item. Поскольку py.path.local является os.PathLike[str], эти плагины не имеют с ним ничего общего.

  Плагины и пользователи, которые вызывают reportinfo(), используют первое возвращаемое значение и взаимодействуют с ним как с py.path.local, должны будут адаптироваться, вызывая py.path.local(fspath). Хотя предпочтительнее избегать унаследованного py.path.local и использовать pathlib.Path, или использовать item.location или item.path, вместо этого.

  Примечание: pytest не смог предоставить период устаревания для этого изменения.

• #8246: --version теперь записывает информацию о версии в stdout, а не в stderr.

• #8733: Удалите обходное решение для pyreadline, которое заставляло его работать с --pdb.

  Обходной путь был представлен в #1281 в 2015 году, однако с тех пор pyreadline seems to have gone unmaintained, является generating warnings, и перестанет работать на Python 3.10.

• #9061: Использование pytest.approx() в булевом контексте теперь вызывает ошибку, подсказывающую правильное использование.

  Очевидно, что пользователи часто ошибочно используют pytest.approx таким образом:

  assert pytest.approx(actual, expected)
  

  Хотя правильное использование - это:

  assert actual == pytest.approx(expected)
  

  Новое сообщение об ошибке помогает выявить эти ошибки.

• #9277: Коллекторный тип pytest.Instance был удален. Импорт pytest.Instance или _pytest.python.Instance возвращает фиктивный тип и выдает предупреждение об устаревании. Подробности см. в Коллектор pytest.Instance.

• #9308: PytestRemovedIn7Warning deprecation warnings теперь по умолчанию являются ошибками..

  Следуя нашему плану по удалению устаревших функций с минимальными нарушениями, все предупреждения типа PytestRemovedIn7Warning теперь по умолчанию генерируют ошибки вместо предупреждений.

  Затронутые функции будут фактически удалены в pytest 7.1, поэтому обратитесь к разделу Амортизация и удаление в документации за указаниями по обновлению существующего кода.

  В серии pytest 7.0.X можно изменить ошибки обратно на предупреждения в качестве временной меры, добавив это в ваш файл pytest.ini:

  [pytest]
  filterwarnings =
      ignore::pytest.PytestRemovedIn7Warning
  

  Но это перестанет работать, когда выйдет pytest 7.1.

  Если у вас есть опасения по поводу удаления конкретной функции, пожалуйста, добавьте комментарий по адресу issue #9308.

Амортизация¶

• #7259: py.path.local аргументы для крючков были устаревшими. Подробную информацию смотрите в the deprecation note.

  py.path.local аргументы конструкторов Node были устаревшими. Подробную информацию смотрите в the deprecation note.

  Примечание

  Название аргументов и атрибутов Node (новый атрибут - path) является противоположностью ситуации для крючков (старый аргумент - path).

  Это досадный артефакт, вызванный историческими причинами, который должен быть устранен в будущих версиях, поскольку мы постепенно избавляемся от зависимости py (см. issue #9283 для более подробного обсуждения).

• #7469: Прямое конструирование следующих классов теперь устарело:

  • _pytest.mark.structures.Mark

  • _pytest.mark.structures.MarkDecorator

  • _pytest.mark.structures.MarkGenerator

  • _pytest.python.Metafunc

  • _pytest.runner.CallInfo

  • _pytest._code.ExceptionInfo

  • _pytest.config.argparsing.Parser

  • _pytest.config.argparsing.OptionGroup

  • _pytest.pytester.HookRecorder

  Эти конструкторы всегда считались приватными, но теперь выдают предупреждение об устаревании, которое может стать жесткой ошибкой в pytest 8.

• #8242: Поднятие unittest.SkipTest для пропуска сбора тестов на этапе сбора pytest устарело. Вместо этого используйте pytest.skip().

  Замечание: Это устаревание относится только к использованию unittest.SkipTest во время сбора тестов. Скорее всего, вы этого не делаете. Обычное использование unittest.SkipTest / unittest.TestCase.skipTest() / unittest.skip() в unittest тестах полностью поддерживается.

  Примечание

  Эта ошибка была исправлена в pytest 7.1.0.

• #8315: Некоторые поведения Parser.addoption теперь запланированы к удалению в pytest 8 (deprecated с pytest 2.4.0):

  • parser.addoption(..., help=".. %default ..") - используйте вместо этого %(default)s.

  • parser.addoption(..., type="int/string/float/complex") - используйте вместо этого type=int и т.д.

• #8447: Определение пользовательского типа узла pytest, который является одновременно pytest.Item и pytest.Collector (например, pytest.File), теперь выдает предупреждение. Это никогда разумно не поддерживалось и вызывало трудноотлаживаемые ошибки.

  Подробную информацию см. в разделе the deprecation note.

• #8592: pytest_cmdline_preparse был официально устаревшим. Он будет удален в одном из будущих выпусков. Вместо него используйте pytest_load_initial_conftests.

  Подробную информацию см. в разделе the deprecation note.

• #8645: pytest.warns(None) теперь устарел, потому что многие использовали его для обозначения «этот код не выдает предупреждений», но на самом деле он проверял, что код выдает хотя бы одно предупреждение любого типа - как pytest.warns() или pytest.warns(Warning).

• #8948: Сигнатуры pytest.skip(msg=...), pytest.fail(msg=...) и pytest.exit(msg=...) теперь принимают аргумент reason вместо msg. Использование msg по-прежнему работает, но является устаревшим и будет удалено в одном из будущих выпусков.

  Это было изменено для согласованности с pytest.mark.skip и pytest.mark.xfail, которые оба принимают reason в качестве аргумента.

• #8174: В типы, достижимые через pytest.ExceptionInfo.traceback, были внесены следующие изменения:

  • Свойство path от _pytest.code.Code возвращает Path вместо py.path.local.

  • Свойство path от _pytest.code.TracebackEntry возвращает Path вместо py.path.local.

  Для этого изменения не было периода амортизации (извините!).

Характеристики¶

• #5196: Тесты теперь упорядочены по порядку определения в большем количестве случаев.

  В иерархии классов тесты из базовых классов теперь последовательно упорядочены перед тестами, определенными для их подклассов (обратный порядок MRO).

• #7132: Добавлены две переменные окружения PYTEST_THEME и PYTEST_THEME_MODE для того, чтобы пользователи могли настроить используемую тему pygments.

• #7259: Добавлено cache.mkdir(), которое аналогично существующему cache.makedir(), но возвращает pathlib.Path вместо унаследованного py.path.local.

  Добавлен тип paths к parser.addini(), как в parser.addini("mypaths", "my paths", type="paths"), который аналогичен существующему pathlist, но возвращает список pathlib.Path вместо унаследованного py.path.local.

• #7469: Типы объектов, используемые в API pytest, теперь экспортируются, чтобы их можно было использовать в аннотациях типов.

  Новыми экспортируемыми типами являются:

  • pytest.Config для Config.

  • pytest.Mark для marks.

  • pytest.MarkDecorator для mark decorators.

  • pytest.MarkGenerator для синглтона pytest.mark.

  • pytest.Metafunc для аргумента metafunc к крючку pytest_generate_tests.

  • pytest.CallInfo для типа CallInfo, передаваемого различным крючкам.

  • pytest.PytestPluginManager для PytestPluginManager.

  • pytest.ExceptionInfo для типа ExceptionInfo, возвращаемого из pytest.raises() и передаваемого различным хукам.

  • pytest.Parser для типа Parser, переданного в крючок pytest_addoption.

  • pytest.OptionGroup для типа OptionGroup, возвращаемого из метода parser.addgroup.

  • pytest.HookRecorder для типа HookRecorder, возвращаемого из Pytester.

  • pytest.RecordedHookCall для типа RecordedHookCall, возвращаемого из HookRecorder.

  • pytest.RunResult для типа RunResult, возвращаемого из Pytester.

  • pytest.LineMatcher для типа LineMatcher, используемого в RunResult и других.

  • pytest.TestReport для типа TestReport, используемого в различных крючках.

  • pytest.CollectReport для типа CollectReport, используемого в различных крючках.

  Конструирование большинства из них напрямую не поддерживается; они предназначены только для использования в аннотациях типов. Это приведет к предупреждению об устаревании и может стать жесткой ошибкой в pytest 8.0.

  Их подклассы также не поддерживаются. В настоящее время это не соблюдается во время выполнения, но обнаруживается программами проверки типов, такими как mypy.

• #7856: –import-mode=importlib теперь работает с функциями, которые зависят от модулей на sys.modules, такими как pickle и dataclasses.

• #8144: Следующие крючки теперь получают дополнительный аргумент pathlib.Path, эквивалентный существующему аргументу py.path.local:

  • pytest_ignore_collect - Параметр collection_path (эквивалентен существующему параметру path).

  • pytest_collect_file - Параметр file_path (эквивалентен существующему параметру path).

  • pytest_pycollect_makemodule - Параметр module_path (эквивалентен существующему параметру path).

  • pytest_report_header - Параметр start_path (эквивалентен существующему параметру startdir).

  • pytest_report_collectionfinish - Параметр start_path (эквивалентен существующему параметру startdir).

  Примечание

  Название аргументов и атрибутов Node (новый атрибут - path) является противоположностью ситуации для крючков (старый аргумент - path).

  Это досадный артефакт, вызванный историческими причинами, который должен быть устранен в будущих версиях, поскольку мы постепенно избавляемся от зависимости py (см. issue #9283 для более подробного обсуждения).

• #8251: Реализуйте Node.path как pathlib.Path. Как старый fspath, так и этот новый атрибут устанавливается независимо от того, передается ли конструктору path или fspath (deprecated). Это замена атрибута fspath (который представляет тот же путь, что и py.path.local). Хотя fspath еще не устарел из-за продолжающегося перехода на такие методы, как reportinfo(), мы ожидаем, что он будет устаревшим в одном из будущих выпусков.

  Примечание

  Название аргументов и атрибутов Node (новый атрибут - path) является противоположностью ситуации для крючков (старый аргумент - path).

  Это досадный артефакт, вызванный историческими причинами, который должен быть устранен в будущих версиях, поскольку мы постепенно избавляемся от зависимости py (см. issue #9283 для более подробного обсуждения).

• #8421: pytest.approx() теперь работает на Decimal в связках/дискретах и последовательностях/списках.

• #8606: вызовы pytest с --fixtures-per-test и --fixtures были обогащены:

  • Путь расположения приспособления печатается с именем приспособления.

  • Первый раздел документальной строки приспособления, выводимый под именем приспособления.

  • Целая документальная строка приспособления, выведенная под именем приспособления с помощью опции --verbose.

• #8761: Новый атрибут pytest.version_tuple, который упрощает пользователям возможность делать что-то в зависимости от версии pytest (например, объявлять хуки, которые появляются в более поздних версиях).

• #8789: Переключение парсера TOML с toml на tomli для поддержки TOML v1.0.0 в pyproject.toml.

• #8920: Добавлена pytest.Stash, возможность для плагинов хранить свои данные на Config и Nodeв безопасной и свободной от конфликтов манере. Подробности смотрите в Хранение данных об элементах через функции hook.

• #8953: RunResult метод assert_outcomes теперь принимает аргумент warnings для утверждения общего количества перехваченных предупреждений.

• #8954: Флаг --debug теперь принимает файл str для маршрутизации журналов отладки, по умолчанию остается pytestdebug.log.

• #9023: Теперь для утверждений равенства итераций всегда показываются полные диффы, если в окружении найдено CI или BUILD_NUMBER, даже если -v не используется.

• #9113: RunResult метод assert_outcomes теперь принимает аргумент deselected для подтверждения общего количества отмененных тестов.

• #9114: Добавлена настройка pythonpath, которая добавляет перечисленные пути в sys.path на время тестовой сессии. Если вы сейчас используете плагины pytest-pythonpath или pytest-srcpaths, вы можете заменить их встроенной настройкой pythonpath.

Улучшения¶

• #7480: Изъятие, которое планируется удалить в основной версии X (например, pytest 7, 8, 9, …), теперь использует категорию предупреждений PytestRemovedInXWarning, подкласс PytestDeprecationWarning, вместо PytestDeprecationWarning напрямую.

  Более подробную информацию см. в разделе Политика обратной совместимости.

• #7864: Улучшены сообщения об ошибках при разборе предупреждающих фильтров.

  Ранее pytest показывал внутренний откат трассировки, который кроме того, что был некрасивым, иногда скрывал причину проблемы (например, ImportError при импорте определенного типа предупреждения).

• #8335: Улучшены сообщения утверждения pytest.approx() для последовательностей чисел.

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

  >       assert [1, 2, 3, 4] == pytest.approx([1, 3, 3, 5])
  E       assert comparison failed for 2 values:
  E         Index | Obtained | Expected
  E         1     | 2        | 3 +- 3.0e-06
  E         3     | 4        | 5 +- 5.0e-06
  

• #8403: По умолчанию pytest будет усекать длинные строки в ошибках assert, чтобы они не слишком загромождали вывод, сейчас по умолчанию это 240 символов.

  Однако в некоторых случаях более длинный вывод помогает или даже имеет решающее значение для диагностики сбоя. Использование -v теперь увеличит порог усечения до 2400 символов, а -vv и выше полностью отключит усечение.

• #8509: Исправлена проблема, при которой unittest.TestCase.setUpClass() не вызывался, если тест имеет / в своем имени, начиная с pytest 6.2.0.

  Это относится к части пути в идентификаторах узлов pytest, например, TestClass::test_it в идентификаторе узла tests/test_file.py::TestClass::test_it.

  Теперь вместо предположения, что имя теста не содержит /, предполагается, что путь теста не содержит ::. Мы планируем надеяться, что оба эти варианта будут работать в будущем.

• #8803: Теперь можно добавлять цвета к пользовательским уровням журнала в журнале cli.

  Используя add_color_level с крючка pytest_configure, можно добавить цвета:

  logging_plugin = config.pluginmanager.get_plugin('logging-plugin')
  logging_plugin.log_cli_handler.formatter.add_color_level(logging.INFO, 'cyan')
  logging_plugin.log_cli_handler.formatter.add_color_level(logging.SPAM, 'blue')
  

  Для получения дополнительной информации см. раздел Настройка цветов.

• #8822: При отображении путей к фикстурам в --fixtures или --fixtures-by-test, фикстуры, приходящие из самого pytest, теперь отображают элиминированный путь, а не полный путь к файлу в каталоге site-packages.

• #8898: Комплексные числа теперь обрабатываются как плавающие и целые числа при генерации идентификаторов параметризации.

• #9062: --stepwise-skip теперь неявно включает --stepwise и может использоваться самостоятельно.

• #9205: pytest.Cache.set() теперь сохраняет порядок ключей при сохранении матриц.

Исправления ошибок¶

• #7124: Исправлена проблема, при которой __main__.py вызывал ошибку ImportError, когда было предоставлено --doctest-modules.

• #8061: Исправлена ошибка с ошибками в тестовых случаях staticmethod, если они наследуются от родительского тестового класса.

• #8192: testdir.makefile теперь молча принимает значения, которые не начинаются с . для поддержания обратной совместимости со старыми версиями pytest.

  pytester.makefile теперь выдает более четкую ошибку, если . отсутствует в аргументе ext.

• #8258: Исправлена проблема, из-за которой поддержка faulthandler в pytest не выводила трассировку при сбоях, если модуль faulthandler уже был включен во время запуска pytest (например, с помощью python -X dev -m pytest).

• #8317: Исправлена проблема, при которой недопустимые символы каталога, полученные из getpass.getuser(), вызывали ошибку OSError.

• #8367: Исправьте Class.from_parent так, чтобы он передавал лишние аргументы ключевых слов в конструктор.

• #8377: Опции выбора теста pytest -k и pytest -m теперь поддерживают сопоставление имен, содержащих символы прямой косой черты (/).

• #8384: Декоратор @pytest.mark.skip теперь правильно обрабатывает свои аргументы. Когда аргумент reason случайно задан и как позиционный, и как ключевое слово (например, потому что его перепутали с skipif), теперь происходит проверка TypeError. Раньше такие проверки молча пропускались, а позиционный аргумент игнорировался. Кроме того, reason теперь правильно документируется как позиционное или ключевое слово (а не только как ключевое слово).

• #8394: Используйте приватные имена для внутренних фикстур, которые обрабатывают классическую установку/исчезновение, чтобы они не отображались при вызове --fixtures по умолчанию (но они по-прежнему отображаются при --fixtures -v).

• #8456: Опция конфигурации required_plugins теперь работает корректно, когда установлены предварительные версии плагинов, вместо того, чтобы ошибочно утверждать, что эти плагины вообще не установлены.

• #8464: -c <config file> теперь также правильно определяет rootdir как каталог, содержащий <config file>.

• #8503: pytest.MonkeyPatch.syspath_prepend() больше не срабатывает, если setuptools не установлен. Теперь он вызывает pkg_resources.fixup_namespace_packages() только если pkg_resources был ранее импортирован, поскольку в противном случае он не нужен.

• #8548: Введено исправление для обработки точной ширины в log-cli-format в свою очередь для исправления раскраски вывода для некоторых форматов.

• #8796: Исправлена внутренняя ошибка при пропуске доктестов.

• #8983: Опции выбора теста pytest -k и pytest -m теперь поддерживают сопоставление имен, содержащих символы обратной косой черты (`\`). Обратные косые черты воспринимаются буквально, а не как экранирующие символы (значения, с которыми производится сравнение, уже экранированы).

• #8990: Исправление падения pytest -vv с внутренним исключением AttributeError: 'str' object has no attribute 'relative_to' в некоторых случаях.

• #9077: Исправлено непонятное сообщение об ошибке, когда доступ к request.fspath / request.path осуществлялся из фикстуры, скопированной на сессию.

• #9131: Исправлен URL, используемый --pastebin, на использование bpa.st.

• #9163: Номер конечной строки и смещение конечного столбца теперь правильно устанавливаются для переписанных утверждений assert.

• #9169: Поддержка API files из importlib.resources внутри переписанных файлов.

• #9272: Фиксы setup() и teardown() на уровне модуля совместимости с носом теперь вызываются только один раз на модуль, а не для каждой тестовой функции. Теперь они вызываются, даже если определены setup/teardown на уровне объекта.

Улучшенная документация¶

• #4320: Улучшена документация для pytester.copy_example.

• #5105: Добавить автоматически сгенерированный Список плагинов. Список обновляется по периодическому расписанию.

• #8337: Рекомендуйте модуль numpy.testing на pytest.approx() документации.

• #8655: Текст справки для --pdbcls более точно отражает поведение опции.

• #9210: Удалите неверную информацию в документации о том, что confcutdir является опцией конфигурации: она может быть установлена только через опцию командной строки --confcutdir.

• #9242: Обновите конфигурацию readthedocs, чтобы использовать newer Ubuntu version <https://blog.readthedocs.com/new-build-specification/>`__ с лучшей поддержкой юникода для PDF-документов.

• #9341: Различные методы, обычно используемые для Работа с непитоновскими тестами, теперь правильно документированы в справочной документации. Ранее они были недокументированы.

Тривиальные/внутренние изменения¶

• #8133: Переход на setuptools_scm 6.x для использования SETUPTOOLS_SCM_PRETEND_VERSION_FOR_PYTEST для более надежного инструментария выпуска.

• #8174: Следующие изменения были внесены во внутренние типы/функции pytest:

  • Функция _pytest.code.getfslineno() возвращает Path вместо py.path.local.

  • Функция _pytest.python.path_matches_patterns() принимает Path вместо py.path.local.

  • Функция _pytest._code.Traceback.cut() принимает любые os.PathLike[str], а не только py.path.local.

• #8248: Внутренняя реструктуризация: пусть python.PyObjMixin наследуется от nodes.Node, чтобы перенести информацию о типизации.

• #8432: улучшено сообщение об ошибке, когда pytest.skip() используется на уровне модуля без передачи allow_module_level=True.

• #8818: Убедитесь, что regendoc отказывается от выбора кэшира TOX_ENV, чтобы обеспечить независимый запуск теста примера.

• #8913: Атрибут private CallSpec2._arg2scopenum был удален после внутренней рефакторинга.

• #8967: pytest_assertion_pass больше не считается экспериментальным, и будущие изменения в нем будут рассматриваться более тщательно.

• #9202: Добавьте действие github для загрузки отчета о покрытии в codecov вместо загрузчика bash.

• #9225: Изменена команда, используемая для создания артефактов sdist и wheel: используется пакет build вместо setup.py.

• #9351: Исправьте незначительные опечатки в doc/en/example/special.rst.

Тривиальные/внутренние изменения¶

• issue #8494: Теперь поддерживается Python 3.10.

• issue #9040: Включить совместимость с pluggy 1.0 или более поздней версией.

Исправления ошибок¶

• issue #8539: Исправлена перезапись утверждений в Python 3.10.

Исправления ошибок¶

• issue #8414: pytest создавал каталоги под именем /tmp с правами на чтение, доступными для всего мира. Это означает, что любой пользователь в системе мог прочитать информацию, записанную тестами во временных каталогах (например, созданных фикстурой tmp_path/tmpdir). Теперь каталоги создаются с закрытыми правами доступа.

  Раньше pytest молча использовал уже существующий каталог /tmp/pytest-of-<username>, даже если он принадлежал другому пользователю. Это означало, что другой пользователь мог предварительно создать такой каталог и получить контроль над временным каталогом другого пользователя. Теперь такое условие приводит к ошибке.

Исправления ошибок¶

• issue #8152: Исправлено отображение «(<Пропущенный экземпляр>)» в качестве причины пропуска в строке краткой сводки теста, когда причина пуста.

• issue #8249: Исправьте плагин faulthandler для случаев, когда он работает с twisted.logger и использует pytest --capture=no.

Исправления ошибок¶

• issue #7678: Исправлена ошибка, при которой ImportPathMismatchError возникала ошибка для файлов, скомпилированных в хосте и загруженных позже из UNC смонтированного пути (Windows).

• issue #8132: Исправлена регрессия в approx: в 6.2.0 approx больше не вызывает TypeError при работе с нечисловыми типами, возвращаясь к нормальному сравнению. До версии 6.2.0 типы массивов, такие как tf.DeviceArray, переходили в скалярный случай и корректно сравнивались со скаляром, если имели только один элемент. После 6.2.0 эти типы начали давать сбой, поскольку они не унаследовали ни от стандартной иерархии чисел Python, ни от numpy.ndarray.

  approx теперь преобразует аргументы в numpy.ndarray, если они используют протокол массивов и не являются скалярами. Это позволяет обращаться с массивоподобными объектами как с массивами numpy, независимо от размера.

Разрывные изменения¶

• issue #7808: pytest теперь поддерживает только python3.6+.

Амортизация¶

• issue #7469: Прямое построение/вызов следующих классов/функций теперь устарело:

  • _pytest.cacheprovider.Cache

  • _pytest.cacheprovider.Cache.for_config()

  • _pytest.cacheprovider.Cache.clear_cache()

  • _pytest.cacheprovider.Cache.cache_dir_from_config()

  • _pytest.capture.CaptureFixture

  • _pytest.fixtures.FixtureRequest

  • _pytest.fixtures.SubRequest

  • _pytest.logging.LogCaptureFixture

  • _pytest.pytester.Pytester

  • _pytest.pytester.Testdir

  • _pytest.recwarn.WarningsRecorder

  • _pytest.recwarn.WarningsChecker

  • _pytest.tmpdir.TempPathFactory

  • _pytest.tmpdir.TempdirFactory

  Они всегда считались приватными, но теперь выдают предупреждение об устаревании, которое может стать жесткой ошибкой в pytest 8.0.0.

• issue #7530: Опция командной строки --strict была устаревшей, вместо нее используйте --strict-markers.

  Мы планируем, возможно, в будущем снова ввести --strict и сделать его всеобъемлющим флагом для всех опций, связанных со строгостью (--strict-markers и --strict-config на данный момент, в будущем могут быть введены другие).

• issue #7988: Декоратор/функция @pytest.yield_fixture теперь устарела. Вместо него используйте pytest.fixture().

  yield_fixture уже очень давно является псевдонимом для fixture, поэтому его можно смело искать/заменять.

Характеристики¶

• issue #5299: pytest теперь предупреждает о невыводимых исключениях и необработанных исключениях потока, возникающих в тестах на Python>=3.8. Смотрите Предупреждение о невыполнимых исключениях и необработанных исключениях потока для получения дополнительной информации.

• issue #7425: Новое приспособление pytester, которое идентично testdir, но его методы возвращают pathlib.Path при необходимости вместо py.path.local.

  Это часть движения к использованию pathlib.Path объектов внутри, чтобы устранить зависимость от py в будущем.

  Внутренне, старый Testdir теперь является тонкой оберткой вокруг Pytester, сохраняя старый интерфейс.

• issue #7695: Был добавлен новый хук pytest_markeval_namespace, который должен возвращать словарь. Этот словарь будет использоваться для дополнения «глобальных» переменных, доступных для оценки маркеров skipif/xfail/xpass.

  Псевдопример

  conftest.py:

  def pytest_markeval_namespace():
      return {"color": "red"}
  

  test_func.py:

  @pytest.mark.skipif("color == 'blue'", reason="Color is not red")
  def test_func():
      assert False
  

• issue #8006: Теперь можно сконструировать объект MonkeyPatch непосредственно как pytest.MonkeyPatch(), в случаях, когда нельзя использовать приспособление monkeypatch. Ранее некоторые пользователи импортировали его из частного пространства имен _pytest.monkeypatch.MonkeyPatch.

  Кроме того, MonkeyPatch.context теперь является методом класса и может быть использован как with MonkeyPatch.context() as mp: .... Это рекомендуемый способ прямого использования MonkeyPatch, поскольку в отличие от приспособления monkeypatch, экземпляр, созданный напрямую, не undo()-руется автоматически.

Улучшения¶

• issue #1265: Добавлена реализация __str__ в класс LineMatcher, который возвращается из pytester.run_pytest().stdout и подобных. Она возвращает весь вывод, как и существующий метод str().

• issue #2044: Режим Verbose теперь показывает причину, по которой тест был пропущен, в терминальной строке теста после «SKIPPED», «XFAIL» или «XPASS».

• issue #7469 Типы встроенных приспособлений pytest теперь экспортируются, чтобы их можно было использовать в аннотациях типов тестовых функций. Новые экспортированные типы:

  • pytest.FixtureRequest для приспособления request.

  • pytest.Cache для приспособления cache.

  • pytest.CaptureFixture[str] для фиксаторов capfd и capsys.

  • pytest.CaptureFixture[bytes] для фиксаторов capfdbinary и capsysbinary.

  • pytest.LogCaptureFixture для приспособления caplog.

  • pytest.Pytester для приспособления pytester.

  • pytest.Testdir для приспособления testdir.

  • pytest.TempdirFactory для приспособления tmpdir_factory.

  • pytest.TempPathFactory для приспособления tmp_path_factory.

  • pytest.MonkeyPatch для приспособления monkeypatch.

  • pytest.WarningsRecorder для приспособления recwarn.

  Конструирование их не поддерживается (за исключением MonkeyPatch); они предназначены только для использования в аннотациях типов. Это приведет к предупреждению об устаревании, а в pytest 8.0 может стать жесткой ошибкой.

  Их подклассы также не поддерживаются. В настоящее время это не соблюдается во время выполнения, но обнаруживается программами проверки типов, такими как mypy.

• issue #7527: Когда сравнение между namedtuple экземплярами одного и того же типа завершается неудачей, pytest теперь показывает имена различных полей (возможно, вложенных) вместо их индексов.

• issue #7615: Node.warn теперь допускает любой подкласс Warning, а не только PytestWarning.

• issue #7701: Улучшена отчетность при использовании --collected-only. Теперь в сводной статистике будет показано количество собранных тестов.

• issue #7710: Используйте строгое сравнение равенства для нечисловых типов в pytest.approx() вместо повышения TypeError.

  До версии 3.7 это было недокументированное поведение, но теперь это официально поддерживаемая функция.

• issue #7938: Новый аргумент --sw-skip, который является сокращением для --stepwise-skip.

• issue #8023: Добавлено 'node_modules' к значению по умолчанию для norecursedirs.

• issue #8032: doClassCleanups (введенный в unittest в Python и 3.8) теперь называется соответствующим образом.

Исправления ошибок¶

• issue #4824: Исправлено квадратичное поведение и улучшена производительность сбора элементов с помощью autouse fixtures и xunit fixtures.

• issue #7758: Исправлена проблема, из-за которой некоторые файлы в пакетах терялись из --lf, даже если они содержали тесты, которые не прошли. Устранено в pytest 5.4.0.

• issue #7911: Каталоги, созданные с помощью tmp_path и tmpdir, теперь считаются устаревшими после 3 дней без изменений (предыдущее значение было 3 часа), чтобы избежать удаления каталогов, все еще используемых в давно работающих наборах тестов.

• issue #7913: Исправлено падение или зависание в pytester.spawn, когда задействован модуль readline.

• issue #7951: Исправлена обработка рекурсивных симлинков при сборе тестов.

• issue #7981: Исправлено, что каталоги с симлинками не отслеживались во время сбора. Исправлено в pytest 6.1.0.

• issue #8016: Исправлен сбор только одного теста при использовании pytest --doctest-modules path/to/an/__init__.py.

Улучшенная документация¶

• issue #7429: Добавьте больше информации и примеров использования о пропуске доктестов.

• issue #7780: Классы, от которых не следует наследоваться, теперь помечены final class в справке API.

• issue #7872: _pytest.config.argparsing.Parser.addini() принимает явные None и "string".

• issue #7878: В разделе pull request просим фиксировать после редактирования журнала изменений и файла авторов.

Тривиальные/внутренние изменения¶

• issue #7802: Требование зависимости attrs теперь >=19.2.0 вместо >=17.4.0.

• issue #8014: файлы .pyc, создаваемые при переписывании утверждений в pytest, теперь соответствуют более новому формату PEP 552 на Python>=3.7. (Эти файлы являются внутренними и интерпретируются только самим pytest).

Исправления ошибок¶

• issue #7758: Исправлена проблема, из-за которой некоторые файлы в пакетах терялись из --lf, даже если они содержали тесты, которые не прошли. Устранено в pytest 5.4.0.

• issue #7911: Каталоги, созданные tmpdir, теперь считаются устаревшими после 3 дней без изменений (предыдущее значение было 3 часа), чтобы избежать удаления каталогов, все еще используемых в давно работающих наборах тестов.

Улучшенная документация¶

• issue #7815: Улучшено предупреждение об устаревании для pytest._fillfuncargs().

Исправления ошибок¶

• issue #7807: Исправлена регрессия в pytest 6.1.0, приводившая к неправильному определению rootdir в некоторых нетривиальных случаях, когда родительские каталоги содержат также и конфигурационные файлы.

• issue #7814: Исправлен сбой в отчете о заголовках, когда используется testpaths и содержит абсолютные пути (регрессия в 6.1.0).

Разрывные изменения¶

• issue #5585: В соответствии с нашей политикой, следующие функции, которые были устаревшими в серии 5.X, теперь удалены:

  • Свойство funcargnames только для чтения классов FixtureRequest, Metafunc и Function. Используйте атрибут fixturenames.

  • @pytest.fixture больше не поддерживает позиционные аргументы, вместо этого передавайте все аргументы по ключевому слову.

  • Прямое построение подклассов Node теперь вызывает ошибку, вместо этого используйте from_parent.

  • Значение по умолчанию для junit_family изменилось на xunit2. Если вам нужен старый формат, добавьте junit_family=xunit1 в ваш конфигурационный файл.

  • У TerminalReporter больше нет атрибута writer. Авторы плагинов могут использовать публичные функции TerminalReporter вместо прямого доступа к объекту TerminalWriter.

  • Опция --result-log была удалена. Вместо нее пользователям рекомендуется использовать плагин pytest-reportlog.

  Для получения дополнительной информации обратитесь к Амортизация и удаление в документации.

Амортизация¶

• issue #6981: Модуль pytest.collect устарел: все его имена могут быть импортированы из pytest напрямую.

• issue #7097: Функция pytest._fillfuncargs устарела. Эта функция была сохранена для обратной совместимости со старым плагином.

  Его функциональность не предназначена для прямого использования, но если вы должны заменить его, используйте function._request._fillfixtures() вместо него, хотя обратите внимание, что это не публичный API и может сломаться в будущем.

• issue #7210: Специальный синтаксис -k '-expr' к -k является устаревшим. Вместо него используйте -k 'not expr'.

  Специальный синтаксис -k 'expr:' к -k устарел. Пожалуйста, откройте проблему, если вы используете его и хотите замену.

• issue #7255: Хук pytest_warning_captured устарел в пользу pytest_warning_recorded и будет удален в будущей версии.

• issue #7648: Методы gethookproxy() и isinitpath() из FSCollector и Package устарели; вместо них используйте self.session.gethookproxy() и self.session.isinitpath(). Это должно работать на всех версиях pytest.

Характеристики¶

• issue #7667: Новый флаг командной строки --durations-min управляет минимальной длительностью для включения в самый медленный список тестов, показанный --durations. Ранее это значение было жестко закодировано в 0.005s.

Улучшения¶

• issue #6681: Внутренние предупреждения pytest, выдаваемые на ранних стадиях инициализации, теперь обрабатываются должным образом и могут фильтроваться через filterwarnings или --pythonwarnings/-W.

  Это также исправляет ряд давно существующих проблем: issue #2891, issue #7620, issue #7426.

• issue #7572: Если плагин, указанный в required_plugins, отсутствует или неизвестный ключ конфигурации используется в --strict-config, теперь вместо трассировки отображается простое сообщение об ошибке.

• issue #7685: Добавлены два новых атрибута rootpath и inipath к Config. Эти атрибуты являются pathlib.Path версиями существующих атрибутов rootdir и inifile, и им следует отдавать предпочтение, когда это возможно.

• issue #7780: Публичные классы, которые не предназначены для наследования, теперь помечены @final. Код, наследующий от этих классов, будет вызывать ошибку проверки типов (например, mypy), но при этом будет работать во время выполнения. В настоящее время обозначение final не появляется в API Reference, но, надеюсь, появится в будущем.

Исправления ошибок¶

• issue #1953: Исправлена ошибка при перезаписи параметризованного приспособления, при этом повторно используется значение суперприспособления.

  # conftest.py
  import pytest
  
  
  @pytest.fixture(params=[1, 2])
  def foo(request):
      return request.param
  
  
  # test_foo.py
  import pytest
  
  
  @pytest.fixture
  def foo(foo):
      return foo * 2
  

• issue #4984: Исправлен сбой внутренней ошибки IndexError: list index out of range при сборе модуля, который начинается с декорированной функции, декоратор поднимается, а перезапись утверждений включена.

• issue #7591: pylint больше не должен жаловаться на нереализованные абстрактные методы при наследовании от File.

• issue #7628: Исправлен сбор тестов, когда в pytest на Windows передавался полный путь без буквы диска (например, \projects\tests\test.py вместо c:\projects\tests\pytest.py).

• issue #7638: Исправьте обработку опций командной строки, которые отображаются как пути, но вызывают синтаксическую ошибку на уровне ОС в Windows, например, опции, используемые внутри pytest-xdist.

• issue #7742: Исправлен INTERNALERROR при обращении к локальным / глобальным файлам с неисправным exec.

Улучшенная документация¶

• issue #1477: Удален файл faq.rst и его ссылка в файле contents.rst.

Тривиальные/внутренние изменения¶

• issue #7536: Внутренний плагин junitxml был переписан для использования xml.etree.ElementTree. Порядок атрибутов в элементах XML может отличаться. Некоторые ненужные экранирования больше не выполняются.

• issue #7587: Зависимость от пакета more-itertools была удалена.

• issue #7631: Тип результата capfd.readouterr() (и подобных) больше не является именованным кортежем, но должен вести себя как именованный кортеж во всех отношениях. Это было сделано по техническим причинам.

• issue #7671: При сборе тестов pytest находит тестовые классы и функции, изучая атрибуты объектов python (модулей, классов и экземпляров). Чтобы ускорить этот процесс, pytest теперь игнорирует встроенные атрибуты (такие как __class__, __delattr__ и __new__), не обращаясь к опциям конфигурации python_classes и python_functions и не передавая их плагинам с помощью хука pytest_pycollect_makeitem.

Исправления ошибок¶

• issue #7148: Исправлено --log-cli, которое могло привести к заглатыванию несвязанного вывода print.

• issue #7672: Исправлено некорректное восстановление уровня захвата журнала, если caplog.set_level вызывается более одного раза.

• issue #7686: Исправлено использование NotSetType.token в качестве идентификатора параметра, когда список параметризации пуст. Устранено в pytest 6.0.0.

• issue #7707: Исправление внутренней ошибки при обработке некоторых исключений, которые содержат несколько строк или стиль использует несколько строк (например, --tb=line).

Исправления ошибок¶

• issue #7394: Передача пустого значения help в Parser.add_option теперь принимается вместо сбоя при выполнении pytest --help. Передача None вызывает более информативный TypeError.

• issue #7558: Исправьте pylint not-callable lint на pytest.mark.parametrize() и другие встроенные метки: skip, skipif, xfail, usefixtures, filterwarnings.

• issue #7559: Исправление регрессии в плагинах, использующих TestReport.longreprtext (например, pytest-html), когда TestReport.longrepr не является строкой.

• issue #7569: Исправление того, что уровень обработчика захвата журнала не сбрасывался при разрыве после вызова caplog.set_level().

Разрывные изменения¶

• issue #5584: PytestDeprecationWarning теперь являются ошибками по умолчанию..

  В соответствии с нашим планом по удалению устаревших функций с минимальными нарушениями, все предупреждения типа PytestDeprecationWarning теперь генерируют ошибки вместо предупреждений.

  Затронутые функции будут фактически удалены в pytest 6.1, поэтому, пожалуйста, обратитесь к разделу Амортизация и удаление в документации за указаниями по обновлению существующего кода.

  В серии pytest 6.0.X можно изменить ошибки обратно на предупреждения в качестве временной меры, добавив это в ваш файл pytest.ini:

  [pytest]
  filterwarnings =
      ignore::pytest.PytestDeprecationWarning
  

  Но это перестанет работать, когда выйдет pytest 6.1.

  Если у вас есть опасения по поводу удаления конкретной функции, пожалуйста, добавьте комментарий по адресу issue #5584.

• issue #7472: Методы exec_() и is_true() в _pytest._code.Frame были удалены.

Характеристики¶

• issue #7464: Добавлена поддержка переменных окружения NO_COLOR и FORCE_COLOR для управления цветным выводом.

Улучшения¶

• issue #7467: --log-file CLI опция и log_file ini маркер теперь создают поддиректории, если это необходимо.

• issue #7489: Функция pytest.raises() имеет более четкое сообщение об ошибке, когда match равна полученной строке, но не является совпадением с regex. В этом случае предлагается экранировать regex.

Исправления ошибок¶

• issue #7392: Исправьте сообщение о местоположении тестов, пропущенных с помощью @pytest.mark.skip при использовании --runxfail.

• issue #7491: tmpdir и tmp_path больше не вызывают ошибку, если блокировка для проверки устаревших временных каталогов недоступна.

• issue #7517: Сохранять окончания строк при захвате через capfd.

• issue #7534: Восстановлено прежнее форматирование TracebackEntry.__str__, которое было изменено случайно.

Улучшенная документация¶

• issue #7422: Уточнено, когда метка usefixtures может применять приспособления для тестирования.

• issue #7441: Добавьте примечание об опции -q, используемой в руководстве по началу работы.

Тривиальные/внутренние изменения¶

• issue #7389: Область применения приспособления package больше не считается экспериментальной.

Разрывные изменения¶

• issue #1316: TestReport.longrepr теперь всегда является экземпляром ReprExceptionInfo. Ранее это был str, когда тест проваливался с pytest.fail(..., pytrace=False).

• issue #5965: симлинки больше не разрешаются во время сбора и сопоставления файлов conftest.py с путями к тестовым файлам.

  Разрешение симлинков для текущего каталога и во время сбора было представлено как исправление в версии 3.9.0, но на самом деле это новая функция, которая привела к печальным последствиям в Windows и удивительным результатам на других платформах.

  Команда решила отказаться от разрешения симлинков вообще, планируя пересмотреть этот вопрос в будущем с более надежным решением (подробнее см. обсуждение в pull request #6523).

  Это может нарушить работу тестовых наборов, которые использовали эту возможность; исправление заключается в создании симлинка для всего дерева тестов, а не только для частичных файлов/тестов, как это было возможно ранее.

• issue #6505: Testdir.run().parseoutcomes() теперь всегда возвращает разобранные существительные в форме множественного числа.

  Первоначально parseoutcomes() всегда возвращало существительные во множественном числе, но изменение, призванное улучшить сводку терминала за счет использования одиночных элементов в единственном числе (1 warning или 1 error), вызвало непреднамеренный регресс, изменив ключи, возвращаемые parseoutcomes().

  Теперь API гарантирует, что всегда будет возвращаться форма множественного числа, поэтому вызовы, подобные этому:

  result = testdir.runpytest()
  result.assert_outcomes(error=1)
  

  Необходимо изменить на:

  result = testdir.runpytest()
  result.assert_outcomes(errors=1)
  

• issue #6903: Теперь предполагается, что функция os.dup() существует. Мы не знаем ни одной поддерживаемой реализации Python 3, которая бы ее не предоставляла.

• issue #7040: -k больше не сопоставляет имена каталогов вне корня тестовой сессии.

  Кроме того, pytest.Package.name теперь является просто именем каталога, содержащего файл пакета __init__.py, вместо полного пути. Это соответствует тому, как названы другие узлы, а также является одной из причин, почему -k будет соответствовать любой директории, содержащей тестовый пакет.

• issue #7122: Выражения, заданные в опциях -m и -k, больше не оцениваются с помощью Python’овского eval(). Формат поддерживает or, and, not, скобки и общие идентификаторы для сравнения. Константы, ключевые слова и другие операторы Python больше не оцениваются по-другому.

• issue #7135: Pytest теперь использует свой собственный класс TerminalWriter вместо класса из библиотеки py. Плагины обычно обращаются к этому классу через TerminalReporter.writer, TerminalReporter.write() (и подобные методы) или _pytest.config.create_terminal_writer().

  Были внесены следующие изменения:

  • Вывод (метод write() и другие) больше не промывается неявно; поведение промывки базового файла соблюдается. Для явного промывания (например, если вы хотите, чтобы вывод был показан до печати конца строки), используйте write(flush=True) или terminal_writer.flush().

  • Явная поддержка консоли Windows была удалена и передана библиотеке colorama.

  • Удалена поддержка записи bytes.

  • Метод reline и свойство chars_on_current_line были удалены.

  • Аргументы stringio и encoding были удалены.

  • Удалена поддержка передачи вызываемого файла вместо файла.

• issue #7224: Атрибуты item.catch_log_handler и item.catch_log_handlers, устанавливаемые плагином логирования и никогда не предназначенные для публичного использования, больше не доступны.

  Удалены устаревшие опции --no-print-logs и log_print ini. Вместо них используйте --show-capture.

• issue #7226: Удален неиспользуемый параметр args из pytest.Function.__init__.

• issue #7418: Удалена спецификация хука pytest_doctest_prepare_content. Этот хук не вызывался pytest уже как минимум 10 лет.

• issue #7438: Некоторые изменения были внесены во внутренний _pytest._code.source, приведенные здесь для пользы авторов плагинов, которые могут его использовать:

  • Аргумент deindent в Source() был удален, теперь он всегда истинен.

  • Поддержка нулевых или множественных аргументов для Source() была удалена.

  • Удалена поддержка сравнения Source с str.

  • Методы Source.isparseable() и Source.putaround() были удалены.

  • Метод Source.compile() и функция _pytest._code.compile() были удалены; вместо них используйте обычные compile().

  • Функция _pytest._code.source.getsource() была удалена; вместо нее используйте непосредственно Source().

Амортизация¶

• issue #7210: Специальный синтаксис -k '-expr' к -k является устаревшим. Вместо него используйте -k 'not expr'.

  Специальный синтаксис -k 'expr:' к -k устарел. Пожалуйста, откройте проблему, если вы используете его и хотите замену.

• issue #4049: pytest_warning_captured устарел в пользу хука pytest_warning_recorded.

Характеристики¶

• issue #1556: pytest теперь поддерживает pyproject.toml файлы для конфигурации.

  Параметры конфигурации аналогичны тем, что доступны в других форматах, но должны быть определены в таблице [tool.pytest.ini_options], чтобы быть подхваченными pytest:

  # pyproject.toml
  [tool.pytest.ini_options]
  minversion = "6.0"
  addopts = "-ra -q"
  testpaths = [
      "tests",
      "integration",
  ]
  

  Более подробную информацию можно найти in the docs.

• issue #3342: pytest теперь включает аннотации типов inline и открывает их для пользовательских программ. Охвачена большая часть API, ориентированного на пользователя, а также внутренний код.

  Если вы используете в своих тестах программу проверки типов, такую как mypy, вы можете начать замечать ошибки типов, указывающие на их неправильное использование. Если вы столкнулись с ошибкой, которую вы считаете неправильной, пожалуйста, сообщите нам об этом в проблеме.

  Типы были разработаны для версии mypy 0.780. Известно, что версии до 0.750 не работают. Мы рекомендуем использовать последнюю версию. Другие средства проверки типов также могут работать, но они еще официально не подтверждены pytest.

• issue #4049: Введен новый хук pytest_warning_recorded для передачи информации о предупреждениях, перехваченных внутренним плагином предупреждений pytest.

  Этот хук предназначен для замены pytest_warning_captured, который устарел и будет удален в будущем релизе.

• issue #6471: Новые флаги командной строки:

  • --no-header: отключает начальный заголовок, включая платформу, версию и плагины.

  • --no-summary: отключает итоговое резюме теста, включая предупреждения.

• issue #6856: Теперь при чтении неизвестного ключа из INI-файла конфигурации выдается предупреждение.

  Флаг --strict-config был добавлен, чтобы рассматривать эти предупреждения как ошибки.

• issue #6906: Добавлена опция командной строки --code-highlight для включения/выключения подсветки кода в выводе терминала.

• issue #7245: Новая опция --import-mode=importlib, которая использует importlib для импорта тестовых модулей.

  Традиционно pytest использовал __import__, изменяя sys.path для импорта тестовых модулей (что также изменяет sys.modules как побочный эффект), что работает, но имеет ряд недостатков, например, требует, чтобы тестовые модули, которые не живут в пакетах, имели уникальные имена (поскольку они должны находиться под уникальным именем в sys.modules).

  --import-mode=importlib использует более тонкие механизмы импорта из importlib, которые не требуют от pytest изменения sys.path или sys.modules вообще, устраняя большую часть недостатков предыдущего режима.

  Мы намерены сделать --import-mode=importlib по умолчанию в будущих версиях, поэтому пользователям рекомендуется попробовать новый режим и оставить отзыв (как положительный, так и отрицательный) в выпуске issue #7245.

  Подробнее об этой опции вы можете прочитать в the documentation.

• issue #7305: Новый параметр конфигурации required_plugins позволяет пользователю указать список плагинов, включая информацию о версии, которые необходимы для работы pytest. Если при запуске pytest не будет найден ни один из требуемых плагинов, будет выдана ошибка.

Улучшения¶

• issue #4375: Команда pytest теперь подавляет сообщение об ошибке BrokenPipeError, которое печатается на stderr, когда вывод pytest передается по трубопроводу, а трубопровод закрывается программой-трубопроводом (обычные примеры - less и head).

• issue #4391: Улучшена точность измерения продолжительности теста. У элементов CallInfo теперь есть новый атрибут <CallInfo>.duration, созданный с помощью time.perf_counter(). Этот атрибут используется для заполнения атрибута <TestReport>.duration, который является более точным, чем предыдущие <CallInfo>.stop - <CallInfo>.start (поскольку они основаны на time.time()).

• issue #4675: Богатое сравнение для классов данных и attrs-классов теперь рекурсивно.

• issue #6285: Раскрыто исключение pytest.FixtureLookupError, которое вызывается request.getfixturevalue() (где request является фикстурой FixtureRequest), когда фикстура с заданным именем не может быть возвращена.

• issue #6433: Если при форматировании сообщения в вызове логирования возникает ошибка, например logging.warning("oh no!: %s: %s", "first") (отсутствует второй аргумент), pytest теперь распространяет ошибку, что может привести к неудаче теста.

  Ранее такая ошибка приводила к печати ошибки в stderr, которая по умолчанию не отображается при прохождении тестов. Это изменение делает ошибку видимой во время тестирования.

  Вы можете временно или постоянно подавить это поведение, установив logging.raiseExceptions = False.

• issue #6817: Сохраняются явные новые строки в текстах справки по опциям командной строки, что позволяет плагинам лучше контролировать справку, отображаемую пользователям.

• issue #6940: При использовании опции --duration вывод сообщений терминала теперь более точно указывает количество и продолжительность скрытых элементов.

• issue #6991: Собранные файлы отображаются после любых отчетов от хуков, например, статус от --lf.

• issue #7091: Когда используется захват fd через --capture=fd или через фиксаторы capfd и capfdbinary, и дескриптор файла (0, 1, 2) не может быть продублирован, захват FD все равно выполняется. Ранее прямая запись в дескрипторы файлов в этом случае не выполнялась или терялась.

• issue #7119: Выход с ошибкой, если аргумент --basetemp пуст, является текущим рабочим каталогом или одним из родительских каталогов. Это сделано для защиты от случайной потери данных, так как любой каталог, переданный в этом аргументе, очищается.

• issue #7128: pytest --version теперь показывает только версию pytest, в то время как pytest --version --version отображает более подробную информацию, включая плагины. Это больше соответствует тому, как другие инструменты показывают --version.

• issue #7133: caplog.set_level() теперь будет переопределять любые log_level, установленные через CLI или конфигурационный файл.

• issue #7159: caplog.set_level() и caplog.at_level() больше не влияют на уровень журналов, которые отображаются в разделе отчета Отчет о захваченных журналах.

• issue #7348: Улучшение рекурсивного отчета diff для утверждений сравнения на классах данных / атрибутах.

• issue #7385: --junitxml теперь включает причину исключения в XML-атрибут message для сбоев при установке и разрушении.

  Ранее:

  <error message="test setup failure">
  

  Сейчас:

  <error message="failed on setup with &quot;ValueError: Some error during setup&quot;">
  

Исправления ошибок¶

• issue #1120: Исправление проблемы, при которой каталоги из tmpdir не удалялись должным образом, когда несколько экземпляров pytest работают параллельно.

• issue #4583: Предотвращение сбоев и предоставление удобной для пользователя ошибки, когда маркерное выражение (-m), вызывающее eval(), вызывает какое-либо исключение.

• issue #4677: Путь, показанный в сводном отчете для ПРОПУЩЕННЫХ тестов, теперь всегда является относительным. Ранее он иногда был абсолютным.

• issue #5456: Исправление возможного состояния гонки при попытке удалить файлы блокировки, используемые для контроля доступа к папкам, созданным tmp_path и tmpdir.

• issue #6240: Устранена проблема, при которой ведение журнала на этапе сбора приводило к дублированию сообщений журнала в stderr.

• issue #6428: Пути, появляющиеся в сообщениях об ошибках, теперь корректны в случае, если текущий рабочий каталог изменился с момента начала сеанса.

• issue #6755: Пути, появляющиеся в сообщениях об ошибках, теперь корректны в случае, если текущий рабочий каталог изменился с момента начала сеанса.

• issue #6871: Исправление сбоя с захваченным выводом при использовании capsysbinary.

• issue #6909: Верните изменение, внесенное pull request #6330, которое требовало, чтобы все аргументы для @pytest.mark.parametrize были явно определены в сигнатуре функции.

  Цель первоначального изменения заключалась в том, чтобы удалить то, что, как ожидалось, было непреднамеренным/ неожиданным поведением, но оказалось, что многие люди полагались на это, поэтому ограничение было отменено.

• issue #6910: Исправление сбоя, когда плагины возвращали неизвестную статистику при использовании опции --reportlog.

• issue #6924: Убедитесь, что unittest.IsolatedAsyncioTestCase действительно ожидается.

• issue #6925: Исправьте экземпляры TerminalRepr, чтобы они снова были хэшируемыми.

• issue #6947: Исправление регрессии, когда функции, зарегистрированные с unittest.TestCase.addCleanup(), не вызывались при ошибках тестирования.

• issue #6951: Позволяет пользователям по-прежнему устанавливать устаревший атрибут TerminalReporter.writer.

• issue #6956: Запретить pytest печатать ConftestImportFailure трассировку возврата в stdout.

• issue #6991: Исправление регрессий, связанных со слишком сильной фильтрацией --lf с pytest 5.4.

• issue #6992: Пересмотрите «tmpdir: очистить перенаправление через конфигурацию для фабрик» issue #6767, так как это нарушает pytest-xdist.

• issue #7061: Когда приспособление для выхода не выдает значение, вместо сбоя сообщайте об ошибке настройки теста.

• issue #7076: Путь к файлу, пропущенному @pytest.mark.skip в отчете SKIPPED, теперь указывается относительно каталога вызова. Ранее он был относительно корневого каталога.

• issue #7110: Исправлена регрессия: asyncbase.TestCase тесты снова выполняются правильно.

• issue #7126: --setup-show теперь не вызывает ошибку, когда значение байта используется в качестве параметра parametrize, когда Python вызывается с флагом -bb.

• issue #7143: Исправьте pytest.File.from_parent() так, чтобы он передавал лишние аргументы ключевых слов в конструктор.

• issue #7145: Классы с неработающими методами __getattribute__ корректно отображаются при сбоях.

• issue #7150: Предотвращает скрытие основного исключения при возникновении ConfTestImportFailure.

• issue #7180: Исправление _is_setup_py для файлов с кодировкой, отличной от локали.

• issue #7215: Исправление регрессии, когда при запуске с --pdb вызывался unittest.TestCase.tearDown() для пропущенных тестов.

• issue #7253: При использовании pytest.fixture в функции напрямую, как в pytest.fixture(func), если также переданы аргументы autouse или params, функция больше не игнорируется, а помечается как приспособление.

• issue #7360: Исправление возможной некорректной оценки строковых выражений, переданных в pytest.mark.skipif и pytest.mark.xfail, в редких случаях, когда используется одна и та же строка, но ссылающаяся на разные глобальные значения.

• issue #7383: Исправлены причины возникновения исключений по всей кодовой базе, т.е. используйте raise new_exception from old_exception при обертывании исключения.

Улучшенная документация¶

• issue #7202: Руководство по разработке теперь ссылается на раздел документации по внесению вклада и RELEASING.rst на GitHub.

• issue #7233: Добавить примечание о --strict и --strict-markers и предпочтении последнего.

• issue #7345: Объясните косвенную параметризацию и маркеры для приспособлений.

Тривиальные/внутренние изменения¶

• issue #7035: Атрибут originalname в _pytest.python.Function теперь по умолчанию равен name, если не указан явно, и всегда установлен.

• issue #7264: Зависимость от пакета wcwidth была удалена.

• issue #7291: Замените py.iniconfig на iniconfig.

• issue #7295: src/_pytest/config/__init__.py теперь использует модуль warnings для сообщения о предупреждениях вместо sys.stderr.write.

• issue #7356: Удалите последние внутренние использования устаревшего термина slave из старого pytest-xdist.

• issue #7357: ``py``=1.8.2 теперь требуется.

Исправления ошибок¶

• issue #6428: Пути, появляющиеся в сообщениях об ошибках, теперь корректны в случае, если текущий рабочий каталог изменился с момента начала сеанса.

• issue #6755: Поддержка удаления путей длиной более 260 символов в окнах, созданных внутри tmpdir.

• issue #6956: Запретить pytest печатать отслеживание ConftestImportFailure в stdout.

• issue #7150: Предотвращает скрытие основного исключения при возникновении ConfTestImportFailure.

• issue #7215: Исправление регрессии, когда при запуске с --pdb вызывались методы tearDown подклассов unittest.TestCase для пропущенных тестов.

Исправления ошибок¶

• issue #6871: Исправление сбоя с захваченным выводом при использовании capsysbinary fixture.

• issue #6924: Убедитесь, что unittest.IsolatedAsyncioTestCase действительно ожидается.

• issue #6925: Исправьте экземпляры TerminalRepr, чтобы они снова были хэшируемыми.

• issue #6947: Исправление регрессии, когда функции, зарегистрированные с TestCase.addCleanup, не вызывались при ошибках тестирования.

• issue #6951: Позволяет пользователям по-прежнему устанавливать устаревший атрибут TerminalReporter.writer.

• issue #6992: Отмена «tmpdir: очистить перенаправление через конфигурацию для фабрик» #6767, так как это ломает pytest-xdist.

• issue #7110: Исправлена регрессия: asyncbase.TestCase тесты снова выполняются правильно.

• issue #7143: Исправьте File.from_parent так, чтобы он передавал лишние аргументы ключевых слов в конструктор.

• issue #7145: Классы с неработающими методами __getattribute__ корректно отображаются при сбоях.

• issue #7180: Исправление _is_setup_py для файлов с кодировкой, отличной от локали.

Исправления ошибок¶

• issue #6909: Верните изменение, внесенное pull request #6330, которое требовало, чтобы все аргументы для @pytest.mark.parametrize были явно определены в сигнатуре функции.

  Цель первоначального изменения заключалась в том, чтобы удалить то, что, как ожидалось, было непреднамеренным/ неожиданным поведением, но оказалось, что многие люди полагались на это, поэтому ограничение было отменено.

• issue #6910: Исправление сбоя, когда плагины возвращали неизвестную статистику при использовании опции --reportlog.

Разрывные изменения¶

• issue #6316: Сопоставление -k EXPRESSION с именами тестов теперь не чувствительно к регистру.

• issue #6443: Плагины, указанные с -p, теперь загружаются после внутренних плагинов, что приводит к тому, что их хуки вызываются перед внутренними.

  Это делает поведение -p согласованным с PYTEST_PLUGINS.

• issue #6637: Удален давно устаревший хук pytest_itemstart.

  Этот хук был помечен как устаревший и даже не вызывался pytest уже более 10 лет.

• issue #6673: Пересмотрено/исправлено значение «+/-» в диффах ошибок. «-» означает, что в результате отсутствует что-либо ожидаемое, а «+» означает, что в результате есть неожиданные дополнения.

• issue #6737: Атрибут cached_result в FixtureDef теперь устанавливается в None, когда результат недоступен, а не удаляется.

  Если ваш плагин выполняет проверки типа hasattr(fixturedef, 'cached_result'), например, в реализации хука pytest_fixture_post_finalizer, замените его на fixturedef.cached_result is not None. Если вы del атрибут, установите вместо него значение None.

Амортизация¶

• issue #3238: Опция --no-print-logs является устаревшей и будет удалена в будущем релизе. Если вы используете --no-print-logs, пожалуйста, попробуйте --show-capture и оставьте отзыв.

  Опция командной строки --show-capture была добавлена в pytest 3.5.0 и позволяет указать, как отображать захваченный вывод при неудачных тестах: no, stdout, stderr, log или all (по умолчанию).

• issue #571: Исправьте неиспользуемый/сломанный хук pytest_collect_directory. Он был неправильно настроен после удаления коллектора Directory в 2010 году и стал некорректным/неиспользуемым, как только сбор был отделен от выполнения тестов.

• issue #5975: Откажитесь от использования прямых конструкторов для Nodes.

  Вместо этого они теперь строятся через Node.from_parent.

  Этот переходный механизм позволяет нам распутать очень интенсивно запутанные отношения Node путем введения более контролируемых моделей создания/конфигурации.

  В рамках этого изменения параметры session/config уже запрещены, и по мере работы над деталями нам, возможно, потребуется запретить еще несколько параметров.

  Ожидается, что подклассы будут использовать super().from_parent, если они намерены расширить создание Nodes.

• issue #6779: Атрибут TerminalReporter.writer был устаревшим и больше не должен использоваться. Он был непреднамеренно раскрыт как часть публичного API этого плагина и слишком сильно связывает его с py.io.TerminalWriter.

Характеристики¶

• issue #4597: Новая опция –capture=tee-sys позволяет печатать и захватывать тестовый вывод.

• issue #5712: Теперь все аргументы для @pytest.mark.parametrize должны быть явно объявлены в сигнатуре функции или через indirect. Ранее можно было опустить аргумент, если существовало приспособление с таким же именем, что было просто случайностью реализации и не являлось частью API.

• issue #6454: Изменено значение по умолчанию для -r на fE, которое отображает сбои и ошибки в short test summary. -rN может быть использован для отключения этого (старое поведение).

• issue #6469: К опции junit_logging добавлены новые опции: log, out-err и all.

• issue #6834: Избыточные сводки предупреждений теперь сворачиваются в файл, чтобы обеспечить читабельное отображение сводок предупреждений.

Улучшения¶

• issue #1857: pytest.mark.parametrize снова принимает целые числа для ids, преобразуя их в строки.

• issue #449: Используйте «желтый» основной цвет с любыми тестами XPASSED.

• issue #4639: Пересмотрите «Теперь выдается предупреждение, когда утверждения делаются для None».

  Предупреждение оказалось менее полезным, чем ожидалось изначально, и имело довольно много случаев ложного срабатывания.

• issue #5686: tmpdir_factory.mktemp теперь не работает при задании абсолютных и ненормализованных путей.

• issue #5984: крючок pytest_warning_captured теперь получает параметр location с местом кода, который выдал предупреждение.

• issue #6213: pytester: приспособление testdir соблюдает настройки окружения из приспособления monkeypatch для внутренних запусков.

• issue #6247: --fulltrace соблюдается при ошибках сбора.

• issue #6384: Заставьте --showlocals работать также с --tb=short.

• issue #6653: Добавьте поддержку сопоставления строк, идущих последовательно с LineMatcher“fnmatch_lines() и re_match_lines().

• issue #6658: Код теперь выделяется в трассировках, когда установлен pygments.

  Пользователям предлагается установить pygments в свою среду и оставить отзыв, поскольку в будущем планируется сделать pygments регулярной зависимостью.

• issue #6795: Сообщение об ошибке использования импорта с недопустимой опцией -o.

• issue #759: pytest.mark.parametrize поддерживает итераторы и генераторы для ids.

Исправления ошибок¶

• issue #310: Добавьте поддержку вызова pytest.xfail() и pytest.importorskip() с помощью доктестов.

• issue #3823: --trace теперь работает с нетестами.

• issue #4445: Исправлены некоторые сообщения о предупреждениях, выдаваемые pytest, чтобы они указывали на правильное местоположение предупреждения в коде пользователя.

• issue #5301: Исправьте --last-failed для сбора новых тестов из файлов с известными сбоями.

• issue #5928: Сообщайте PytestUnknownMarkWarning на уровне кода пользователя, а не pytest.

• issue #5991: Исправьте взаимодействие с --pdb и unittests: не используйте TestCase.debug() unittest’а.

• issue #6334: Исправление двойного отображения итоговых записей, когда символы отчета f/F и s/S использовались одновременно в опции командной строки -r (например, -rFf).

  Варианты с верхним регистром никогда не документировались, и предпочтительной формой должен быть нижний регистр.

• issue #6409: Возврат к зеленому цвету (вместо желтого) для не последних элементов без предыдущих проходов с цветным индикатором выполнения терминала.

• issue #6454: --disable-warnings уважается с -ra и -rA.

• issue #6497: Исправьте ошибку в сравнении ключа запроса с кэшированным ключом в приспособлении.

  Конструкция if key == cached_key: может не сработать либо потому, что == явно запрещена, либо, например, для массивов NumPy, где результат a == b в общем случае не может быть преобразован в bool. Реализованное исправление заменяет == на is.

• issue #6557: Заставить метод capture output streams .write() возвращать то же возвращаемое значение, что и исходные потоки.

• issue #6566: Исправьте EncodedFile.writelines для вызова метода writelines базового буфера.

• issue #6575: Исправление внутреннего сбоя, когда faulthandler запускается инициализированным (например, с установленной переменной окружения PYTHONFAULTHANDLER=1) и faulthandler_timeout определен в конфигурационном файле.

• issue #6597: Исправьте идентификаторы узлов, которые содержат параметризованную переменную с пустой строкой.

• issue #6646: Крючки перезаписи утверждений (пере)сохраняются для текущего элемента, что исправляет их использование после, например, pytester’s testdir.runpytest и т.д.

• issue #6660: pytest.exit() обрабатывается, когда выдается из хука pytest_sessionfinish. Это включает выход из отладчика.

• issue #6752: Когда pytest.raises() используется как функция (в отличие от менеджера контекста), аргумент ключевого слова match теперь передается в тестируемую функцию. Ранее он проглатывался и игнорировался (регрессия в pytest 5.1.0).

• issue #6801: Не отображать пустые строки между трассировками для неожиданных исключений с doctests.

• issue #6802: testdir fixture теперь работает внутри доктестов.

Улучшенная документация¶

• issue #6696: Добавить список приспособлений в начало главы о приспособлениях.

• issue #6742: Разверните первое предложение о креплениях в абзац.

Тривиальные/внутренние изменения¶

• issue #6404: Удалите использование модуля parser, устаревшего в Python 3.9.

Исправления ошибок¶

• issue #6517: Исправление регрессии в pytest 5.3.4, вызывающей INTERNALERROR из-за неверного утверждения.

Исправления ошибок¶

• issue #6496: Revert issue #6436: к сожалению, это изменение вызвало ряд регрессий во многих наборах, поэтому команда решила вернуть это изменение и сделать новый выпуск, пока мы продолжаем искать решение.

Исправления ошибок¶

• issue #2780: Захваченный вывод во время разрыва показан с -rP.

• issue #5971: Исправьте ошибку pytest-xdist при работе с исключениями, возникающими в подпроцессах, созданных модулем multiprocessing.

• issue #6436: Объекты FixtureDef теперь правильно регистрируют свои финализаторы с автодома и параметризованными фикстурами, которые выполняются перед ними в стеке фикстур, так что они срываются в нужное время и в нужном порядке.

• issue #6532: Исправление разбора исходов, содержащих множественные ошибки с результатами testdir (регрессия в 5.3.0).

Тривиальные/внутренние изменения¶

• issue #6350: Оптимизировано автоматическое переименование идентификаторов тестовых параметров.

Улучшения¶

• issue #4639: Пересмотрите «Теперь выдается предупреждение, когда утверждения делаются для None».

  Предупреждение оказалось менее полезным, чем ожидалось изначально, и имело довольно много случаев ложного срабатывания.

Исправления ошибок¶

• issue #5430: junitxml: Логи для неудачного теста теперь передаются в отчет junit в случае, если тест не прошел во время фазы вызова.

• issue #6290: вспомогательные файлы в каталоге .pytest_cache сохраняются с помощью --cache-clear, который теперь только очищает кэшированные значения.

• issue #6301: Исправление перезаписи утверждений для дистрибутивов на основе яиц и установок editable (pip install --editable).

Улучшения¶

• issue #6231: Улучшена проверка на неправильное написание pytest.mark.parametrize.

• issue #6257: Обработка pytest.exit(), используемого через pytest_internalerror, например, при выходе из pdb из post mortem.

Исправления ошибок¶

• issue #5914: pytester: исправление no_fnmatch_line() при использовании после положительного совпадения.

• issue #6082: Исправьте определение строк для примеров doctest внутри property docstrings, как обходной путь для bpo-17446.

• issue #6254: Исправление совместимости с pytest-parallel (регрессия в pytest 5.3.0).

• issue #6255: Очистите атрибуты sys.last_traceback, sys.last_type и sys.last_value, удалив их вместо того, чтобы установить их в None. Это лучше соответствует поведению стандартной библиотеки Python.

Амортизация¶

• issue #6179: Значение по умолчанию опции junit_family изменится на "xunit2" в pytest 6.0, учитывая, что именно эта версия поддерживается по умолчанию в современных инструментах, манипулирующих этим типом файлов.

  Чтобы сгладить переход, pytest будет выдавать предупреждение в случае, если опция --junitxml задана в командной строке, но junit_family не настроена явно в pytest.ini.

  Для получения дополнительной информации see the docs.

Характеристики¶

• issue #4488: Команда pytest создала плагин pytest-reportlog, который предоставляет новую опцию --report-log=FILE, записывающую логи отчетов в файл по мере выполнения тестовой сессии.

  Каждая строка журнала отчетов содержит самодостаточный объект JSON, соответствующий событию тестирования, такому как коллекция или отчет о результатах тестирования. После записи каждой строки файл гарантированно промывается, поэтому системы могут читать и обрабатывать события в режиме реального времени.

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

• issue #4730: Если установлено значение sys.pycache_prefix (Python 3.8+), оно будет использоваться pytest для кэширования тестовых файлов, измененных механизмом перезаписи утверждений.

  Это облегчает использование кэшированных файлов .pyc даже на файловых системах без прав доступа.

• issue #5515: Разрешить выборочное автоиндентирование многострочных сообщений журнала.

  Добавляет опцию командной строки --log-auto-indent, опцию конфигурации log_auto_indent и поддержку настройки поведения отступов для каждого вхождения при вызове logging.log().

  Изменяет значение по умолчанию для автозамещения с "on" на "off". Это восстанавливает старое поведение, существовавшее до версии 4.6.0. Этот возврат к более раннему поведению был сделан потому, что лучше активировать новые возможности, которые могут привести к поломке тестов, явно, а не неявно.

• issue #5914: testdir изучил две новые функции, no_fnmatch_line() и no_re_match_line().

  Эти функции используются для проверки того, что захваченный текст не соответствует заданному шаблону.

  Предыдущая идиома заключалась в использовании re.match():

  result = testdir.runpytest()
  assert re.match(pat, result.stdout.str()) is None
  

  Или оператор in:

  result = testdir.runpytest()
  assert text in result.stdout.str()
  

  Но новые функции дают лучший результат при неудаче.

• issue #6057: Добавлены допуски к сложным значениям при печати pytest.approx.

  Например, repr(pytest.approx(3+4j)) возвращает (3+4j) ± 5e-06 ∠ ±180°. Это полярная нотация, обозначающая круг вокруг ожидаемого значения с радиусом 5e-06. Чтобы сравнение approx возвращало True, фактическое значение должно попадать в этот круг.

• issue #6061: Добавил pluginmanager в качестве аргумента к pytest_addoption, чтобы можно было вызывать хуки при настройке опций командной строки. Это полезно для того, чтобы один плагин сообщал другому плагину, например, значения по умолчанию или набор опций командной строки для добавления.

Улучшения¶

• issue #5061: Используйте несколько цветов в сводной статистике терминала.

• issue #5630: Выход из отладчика теперь правильно обрабатывается в элементах doctest.

• issue #5924: Улучшен вывод verbose diff с последовательностями.

  До:

  E   AssertionError: assert ['version', '...version_info'] == ['version', '...version', ...]
  E     Right contains 3 more items, first extra item: ' '
  E     Full diff:
  E     - ['version', 'version_info', 'sys.version', 'sys.version_info']
  E     + ['version',
  E     +  'version_info',
  E     +  'sys.version',
  E     +  'sys.version_info',
  E     +  ' ',
  E     +  'sys.version',
  E     +  'sys.version_info']
  

  После:

  E   AssertionError: assert ['version', '...version_info'] == ['version', '...version', ...]
  E     Right contains 3 more items, first extra item: ' '
  E     Full diff:
  E       [
  E        'version',
  E        'version_info',
  E        'sys.version',
  E        'sys.version_info',
  E     +  ' ',
  E     +  'sys.version',
  E     +  'sys.version_info',
  E       ]
  

• issue #5934: repr объектов ExceptionInfo была улучшена для соблюдения метода __repr__ основного исключения.

• issue #5936: Отображение неусеченного сообщения об утверждении с -vv.

• issue #5990: Исправлено несоответствие множественности в сводке тестов (например, отображение «1 ошибка» вместо «1 ошибки»).

• issue #6008: Config.InvocationParams.args теперь всегда tuple, чтобы лучше передать, что он должен быть неизменяемым и избегать случайных модификаций.

• issue #6023: pytest.main теперь возвращает экземпляр pytest.ExitCode, за исключением случаев, когда используются пользовательские коды выхода (тогда он возвращает int).

• issue #6026: Выравнивание префиксов в выводе pytester’s LineMatcher.

• issue #6059: Ошибки сбора сообщаются как ошибки (а не сбои, как раньше) в краткой сводке теста в терминале.

• issue #6069: pytester.spawn больше не пропускает/xfail тесты на FreeBSD безоговорочно.

• issue #6097: Индикатор «[…%]» в сводке теста теперь окрашен в соответствии с основным цветом финальной (новой) многоцветной линии.

• issue #6116: Добавлено --co в качестве синонима к --collect-only.

• issue #6148: atomicwrites теперь используется только в Windows, исправляя регресс производительности при перезаписи утверждений на Unix.

• issue #6152: Теперь параметризация будет использовать атрибут __name__ любого объекта для id, если он присутствует. Ранее она использовала __name__ только для функций и классов.

• issue #6176: Улучшен отчет об ошибках при использовании pytester’s Hookrecorder.assertoutcome.

• issue #6181: Причина остановки сессии, например, с помощью --maxfail / -x, теперь сообщается в резюме теста.

• issue #6206: Улучшена надежность и производительность cache.set.

Исправления ошибок¶

• issue #2049: Исправлено --setup-plan, показывающее неточную информацию о сроках службы приспособлений.

• issue #2548: Исправлено несоответствие смещения строки пропущенных тестов в сводке терминала.

• issue #6039: PytestDoctestRunner теперь правильно аннулируется при снятии конфигурации плагина doctest.

  Это важно при использовании pytester с runpytest_inprocess.

• issue #6047: BaseExceptions теперь обрабатываются в saferepr, который включает pytest.fail.Exception и т.д.

• issue #6074: pytester: исправлен порядок аргументов в предупреждении rm_rf при очистке временных каталогов, и не выдаются предупреждения для ошибок с os.open.

• issue #6189: Исправлен результат метода getmodpath.

Тривиальные/внутренние изменения¶

• issue #4901: RunResult из pytester теперь отображает мнемонику атрибута ret, когда он является допустимым значением pytest.ExitCode.

Исправления ошибок¶

• issue #6194: Исправление некорректного обнаружения нетестовых файлов __init__.py.

• issue #6197: Пересмотр «Первый тест в пакете (__init__.py), помеченный @pytest.mark.skip, теперь правильно пропускается.».

Исправления ошибок¶

• issue #5830: Первый тест в пакете (__init__.py), помеченный @pytest.mark.skip, теперь правильно пропускается.

• issue #6099: Исправьте --trace при использовании с параметризованными функциями.

• issue #6183: Использование request в качестве имени параметра в @pytest.mark.parametrize теперь выдает более удобную для пользователя ошибку.

Исправления ошибок¶

• issue #5206: Исправьте --nf, чтобы не забывать об известных узлах при частичном выборе теста.

• issue #5906: Исправление сбоя при KeyboardInterrupt во время --setup-show.

• issue #5946: Исправлена проблема при параметризации приспособлений с помощью массивов numpy (и, возможно, других типов, подобных последовательности).

• issue #6044: Правильно игнорировать исключения FileNotFoundError при попытке удаления старых временных каталогов, например, когда несколько процессов пытаются удалить один и тот же каталог (часто встречается, например, в pytest-xdist).

Исправления ошибок¶

• issue #5902: Исправьте предупреждения об устаревшем атрибуте cmp в attrs>=19.2.

Амортизация¶

• issue #1682: Передача аргументов в pytest.fixture() как позиционных аргументов устарела - вместо этого передавайте их как аргумент ключевого слова.

Характеристики¶

• issue #1682: Параметр scope в @pytest.fixture теперь может быть вызываемой переменной, которая получает имя приспособления и объект config в качестве параметров только для ключевого слова. Дополнительную информацию см. в разделе the docs.

• issue #5764: Новое поведение опции --pastebin: сообщается об ошибках при подключении к серверу pastebin, без отказа выполнения pytest

Исправления ошибок¶

• issue #5806: Исправьте «lexer», используемый при загрузке на bpaste.net с --pastebin на «text».

• issue #5884: Исправьте --setup-only и --setup-show для пользовательских элементов pytest.

Тривиальные/внутренние изменения¶

• issue #5056: HelpFormatter использует py.io.get_terminal_width для лучшего определения ширины.

Исправления ошибок¶

• issue #5807: Исправьте pypy3.6 (nightly) на windows.

• issue #5811: Правильно обрабатывайте --fulltrace с pytest.raises.

• issue #5819: Windows: Исправление регрессии с conftest, чье квалифицированное имя содержит символы верхнего регистра (введено в #5792).

Исправления ошибок¶

• issue #2270: Исправлена ссылка self в функционально-скопированных фикстурах, определяющих классы плагинов: ранее self была ссылкой на класс test, а не на класс plugin.

• issue #570: Исправлена давняя проблема, из-за которой не соблюдалась область видимости приспособлений, когда при параметризации использовались косвенные приспособления.

• issue #5782: Исправление ошибки декодирования при печати ответа на ошибку от --pastebin.

• issue #5786: Цепочки исключений в отчетах тестов и коллекций теперь правильно сериализуются, что позволяет плагинам типа pytest-xdist правильно их отображать.

• issue #5792: Windows: Исправление ошибки, возникающей в определенных обстоятельствах при загрузке conftest.py из рабочего каталога, имеющего корпус, отличный от хранящегося в файловой системе (например, c:\test вместо C:\test).

Исправления ошибок¶

• issue #5751: Исправлено TypeError при импорте pytest на Python 3.5.0 и 3.5.1.

Перемещение¶

• issue #5180: В соответствии с нашей политикой, следующие функции были устаревшими в серии 4.X и теперь удалены:

  • Request.getfuncargvalue: используйте Request.getfixturevalue вместо этого.

  • pytest.raises и pytest.warns больше не поддерживают строки в качестве второго аргумента.

  • message параметр pytest.raises.

  • pytest.raises, pytest.warns и ParameterSet.param теперь используют родной синтаксис только для ключевых слов. Это может изменить сообщение об исключении из предыдущих версий, но они, как и раньше, поднимают TypeError при неизвестных аргументах ключевых слов.

  • pytest.config глобальная переменная.

  • tmpdir_factory.ensuretemp метод.

  • pytest_logwarning крючок.

  • RemovedInPytest4Warning тип предупреждения.

  • request теперь является зарезервированным именем для фиксаторов.

  Для получения дополнительной информации обратитесь к Амортизация и удаление в документации.

• issue #5565: Удален неиспользуемый код поддержки для unittest2.

  Модуль бэкпорта unittest2 больше не нужен с Python 3.3+, и небольшое количество кода в pytest для его поддержки также, похоже, не используется: после удаления все тесты проходят без изменений.

  Хотя наша политика заключается в том, чтобы вводить период амортизации перед удалением каких-либо функций или поддержки сторонних библиотек, поскольку этот код, по-видимому, вообще не используется (даже если unittest2 используется тестовым набором, выполняемым pytest), было решено удалить его в этом релизе.

  Если у вас возникнет регресс из-за этого, пожалуйста, file an issue.

• issue #5615: pytest.fail, pytest.xfail и pytest.skip больше не поддерживают байты для аргумента сообщения.

  Это поддерживалось в Python 2, где было заманчиво использовать "message" вместо u"message".

  Код Python 3 вряд ли будет передавать bytes в эти функции. Если вы это сделаете, пожалуйста, предварительно декодируйте его в str.

Характеристики¶

• issue #5564: Новый атрибут Config.invocation_args, содержащий неизменные аргументы, переданные в pytest.main().

• issue #5576: Новая опция NUMBER для doctests, позволяющая игнорировать несущественные различия в числах с плавающей точкой. Вдохновлено расширением numtest для doctest Себастьяна Буажеро.

Улучшения¶

• issue #5471: JUnit XML теперь включает метку времени и имя хоста в тег testsuite.

• issue #5707: Время, затраченное на выполнение набора тестов, теперь включает человекочитаемое представление, когда оно занимает более 60 секунд, например:

  ===== 2 failed in 102.70s (0:01:42) =====
  

Исправления ошибок¶

• issue #4344: Исправьте RuntimeError/StopIteration при попытке собрать пакет только с «__init__.py».

• issue #5115: Предупреждения, выдаваемые во время pytest_configure, явно не рассматриваются как ошибки, даже если они настроены как таковые, потому что иначе это полностью ломает pytest.

• issue #5477: XML-файл, создаваемый --junitxml, теперь правильно содержит корневой элемент <testsuites>.

• issue #5524: Исправление проблемы, когда tmp_path и tmpdir не удаляли каталоги, содержащие файлы, помеченные как доступные только для чтения, что могло привести к аварийному завершению pytest при выполнении во второй раз с опцией --basetemp.

• issue #5537: Замените importlib_metadata backport на importlib.metadata из стандартной библиотеки на Python 3.8+.

• issue #5578: Улучшена проверка типов для некоторых функций, вызывающих исключения (pytest.xfail, pytest.skip и т.д.), чтобы они выдавали лучшие сообщения об ошибках, когда пользователи хотели использовать знаки (например, @pytest.xfail вместо @pytest.mark.xfail).

• issue #5606: Исправлена внутренняя ошибка, когда тестовые функции исправлялись с объектами, которые нельзя сравнивать на истинность с другими, например, с массивами numpy.

• issue #5634: pytest.exit теперь правильно обрабатывается в unittest случаях. Это заставляет случаи unittest правильно обрабатывать quit из pdb pytest.

• issue #5650: Улучшен вывод при неудачном разборе конфигурационного файла ini.

• issue #5701: Исправьте коллекцию объектов staticmethod, определенных с помощью functools.partial.

• issue #5734: Пропустите тестовые функции генератора async и обновите предупреждение, чтобы оно ссылалось на функции async def.

Улучшенная документация¶

• issue #5669: Добавьте docstring для Testdir.copy_example.

Тривиальные/внутренние изменения¶

• issue #5095: XML файлы семейства xunit2 теперь проверяются на соответствие схеме собственным набором тестов pytest, чтобы избежать будущих регрессий.

• issue #5516: Функция разделения узлов кэша, которая может улучшить производительность сбора в очень больших наборах тестов.

• issue #5603: Упрощен внутренний класс SafeRepr и удален некоторый мертвый код.

• issue #5664: При вызове собственного набора тестов pytest с помощью PYTHONDONTWRITEBYTECODE=1 тест test_xfail_handling больше не завершается неудачей.

• issue #5684: Замените ручную обработку OSError.errno в кодовой базе новыми подклассами OSError (PermissionError, FileNotFoundError и т.д.).

Исправления ошибок¶

• issue #5479: улучшено цитирование в сообщении о неудачном совпадении raises.

• issue #5523: Исправлено использование нескольких коротких опций вместе в командной строке (например, -vs) в Python 3.8+.

• issue #5547: --step-wise теперь правильно обрабатывает маркеры xfail(strict=True).

Улучшенная документация¶

• issue #5517: Улучшение раздела «Объявление новых хуков» в главе «Написание плагинов»

Важно¶

Этот выпуск предназначен только для Python3.5+.

Для получения более подробной информации см. наш Python 2.7 and 3.4 support plan.

Перемещение¶

• issue #1149: Pytest больше не принимает префиксы аргументов командной строки, например, вводя pytest --doctest-mod вместо --doctest-modules. Ранее это допускалось, если ArgumentParser считался однозначным, но это могло быть неверно из-за задержки разбора опций для плагинов. Смотрите, например, проблемы issue #1149, issue #3413 и issue #4009.

• issue #5402: PytestDeprecationWarning теперь являются ошибками по умолчанию..

  В соответствии с нашим планом по удалению устаревших функций с минимальными нарушениями, все предупреждения типа PytestDeprecationWarning теперь генерируют ошибки вместо предупреждений.

  Затронутые функции будут фактически удалены в pytest 5.1, поэтому, пожалуйста, обратитесь к разделу Амортизация и удаление в документации за указаниями по обновлению существующего кода.

  В серии pytest 5.0.X можно изменить ошибки обратно на предупреждения в качестве временной меры, добавив это в ваш файл pytest.ini:

  [pytest]
  filterwarnings =
      ignore::pytest.PytestDeprecationWarning
  

  Но это перестанет работать, когда выйдет pytest 5.1.

  Если у вас есть опасения по поводу удаления конкретной функции, пожалуйста, добавьте комментарий по адресу issue #5402.

• issue #5412: Объекты ExceptionInfo (возвращаемые pytest.raises) теперь имеют такое же представление str, как и repr, что позволяет избежать некоторой путаницы, когда пользователи используют print(e) для осмотра объекта.

  Это означает код типа:

  with pytest.raises(SomeException) as e:
      ...
  assert "some message" in str(e)
  

  Должно быть изменено на:

  with pytest.raises(SomeException) as e:
      ...
  assert "some message" in str(e.value)
  

Амортизация¶

• issue #4488: Удаление опции и модуля --result-log было отложено до (предварительно) pytest 6.0, поскольку команда пока не смогла реализовать хорошую альтернативу для него.

• issue #466: Атрибут funcargnames был псевдонимом для fixturenames со времен pytest 2.3, и теперь он также устарел в коде.

Характеристики¶

• issue #3457: Новый хук pytest_assertion_pass, вызываемый с информацией о контексте, когда утверждение проходит.

  Этот крючок все еще экспериментальный, поэтому используйте его с осторожностью.

• issue #5440: Модуль стандартной библиотеки faulthandler теперь включен по умолчанию, чтобы помочь пользователям диагностировать сбои в модулях C.

  Эта функциональность была предоставлена путем интеграции внешнего плагина pytest-faulthandler в ядро, поэтому пользователям следует удалить этот плагин из своих требований, если он используется.

  Для получения дополнительной информации см. документацию: Обработчик неисправностей.

• issue #5452: Когда предупреждения настроены как ошибки, предупреждения pytest теперь отображаются как исходящие от pytest. вместо внутреннего модуля _pytest.warning_types..

• issue #5125: Session.exitcode значения теперь кодируются в pytest.ExitCode, an IntEnum. Это делает код выхода доступным для потребительского кода и более явным, чем просто документация. Определенные пользователем коды выхода все еще действительны, но должны использоваться с осторожностью.

  Команда не ожидает, что это изменение нарушит работу тестовых наборов или плагинов в целом, за исключением эзотерических/специфических сценариев.

  Пользователи pytest-xdist должны перейти на версию 1.29.0 или более позднюю, поскольку pytest-xdist требует исправления совместимости из-за этого изменения.

Исправления ошибок¶

• issue #1403: Переключение с imp на importlib.

• issue #1671: Имя файлов .pyc, кэшируемых составителем утверждений, теперь включает версию pytest, чтобы избежать устаревших кэшей.

• issue #2761: Честь PEP 235 на файловых системах, не чувствительных к регистру.

• issue #5078: Тестовый модуль больше не импортируется дважды при использовании --pyargs.

• issue #5260: Улучшено сравнение байтовых строк.

  При сравнении байтов используется утверждающее сообщение, показывающее числовое значение байта при отображении различий:

      def test():
  >       assert b'spam' == b'eggs'
  E       AssertionError: assert b'spam' == b'eggs'
  E         At index 0 diff: 115 != 101
  E         Use -v to get the full diff
  

  Теперь вместо него отображается фактическое представление ascii, что зачастую более удобно:

      def test():
  >       assert b'spam' == b'eggs'
  E       AssertionError: assert b'spam' == b'eggs'
  E         At index 0 diff: b's' != b'e'
  E         Use -v to get the full diff
  

• issue #5335: Раскрашивает имена уровней, когда уровень в формате логирования имеет формат „%(levelname).Xs“ (усеченное выравнивание по фиксированной ширине), где X - целое число.

• issue #5354: Исправьте pytest.mark.parametrize, когда argvalues является итератором.

• issue #5370: Верните разворачивание all(), чтобы исправить NameError на вложенных постижениях.

• issue #5371: Верните разворачивание all(), чтобы исправить неправильную обработку генераторов с if.

• issue #5372: Верните разворачивание all() для исправления неверного утверждения при использовании all() в выражении.

• issue #5383: -q снова влияет на стиль собранных предметов (--collect-only), когда используется --log-cli-level.

• issue #5389: Исправление регрессий pull request #5063 для importlib_metadata.PathDistribution, у которых атрибут files является None.

• issue #5390: Исправление регрессии, при которой атрибут obj у элементов TestCase больше не привязывался к методам.

• issue #5404: Выдавать предупреждение, когда попытка развернуть сломанный объект приводит к исключению, для облегчения отладки (issue #5080).

• issue #5432: Предотвращение предупреждений «already imported» от assertion rewriter при многократном вызове pytest in-process.

• issue #5433: Исправление перезаписи утверждений в пакетах (__init__.py).

• issue #5444: Исправьте режим --stepwise, когда первый файл, переданный в командной строке, не удается собрать.

• issue #5482: Исправление ошибки, появившейся в версии 4.6.0, которая приводила к ошибкам сбора при передаче более 2 позиционных аргументов в pytest.mark.parametrize.

• issue #5505: Исправление сбоя при неудачном обнаружении при использовании -p no:terminal.

Улучшенная документация¶

• issue #5315: Расширьте документацию по мокингу классов и словарей с помощью monkeypatch.

• issue #5416: Исправьте PytestUnknownMarkWarning в примере run/skip.

Исправления ошибок¶

• issue #6334: Исправление двойного отображения итоговых записей, когда символы отчета f/F и s/S использовались одновременно в опции командной строки -r (например, -rFf).

  Варианты с верхним регистром никогда не документировались, и предпочтительной формой должен быть нижний регистр.

• issue #7310: Исправьте UnboundLocalError: local variable 'letter' referenced before assignment в _pytest.terminal.pytest_report_teststatus(), когда плагины возвращают объекты отчетов в нестандартном состоянии.

  Это заставляло pytest_report_teststatus() пропускать ветви if-блока, которые объявляют переменную letter.

  Исправление заключалось в установке начального значения letter перед каскадом if-блоков, чтобы он всегда имел значение.

Характеристики¶

• issue #6870: Новый атрибут Config.invocation_args, содержащий неизменные аргументы, переданные в pytest.main().

  Замечание: хотя технически это новая функция, и согласно нашему policy она не должна была быть перенесена, мы сделали исключение в данном конкретном случае, поскольку она исправляет серьезное взаимодействие с pytest-xdist, поэтому ее также можно считать исправлением.

Тривиальные/внутренние изменения¶

• issue #6404: Удалите использование модуля parser, устаревшего в Python 3.9.

Исправления ошибок¶

• issue #6301: Исправление перезаписи утверждений для дистрибутивов на основе яиц и установок editable (pip install --editable).

Характеристики¶

• issue #5471: JUnit XML теперь включает метку времени и имя хоста в тег testsuite.

Исправления ошибок¶

• issue #5430: junitxml: Логи для неудачного теста теперь передаются в отчет junit в случае, если тест не прошел во время фазы вызова.

Тривиальные/внутренние изменения¶

• issue #6345: Привязка colorama к 0.4.1 только для Python 3.4, чтобы более новые версии Python могли получать обновления colorama.

Исправления ошибок¶

• issue #5477: XML-файл, создаваемый --junitxml, теперь правильно содержит корневой элемент <testsuites>.

• issue #6044: Правильно игнорировать исключения FileNotFoundError (OSError.errno == NOENT в Python 2) при попытке удаления старых временных каталогов, например, когда несколько процессов пытаются удалить один и тот же каталог (часто встречается, например, pytest-xdist).

Исправления ошибок¶

• issue #5523: Исправлено использование нескольких коротких опций вместе в командной строке (например, -vs) в Python 3.8+.

• issue #5537: Замените importlib_metadata backport на importlib.metadata из стандартной библиотеки на Python 3.8+.

• issue #5806: Исправьте «lexer», используемый при загрузке на bpaste.net с --pastebin на «text».

• issue #5902: Исправьте предупреждения об устаревшем атрибуте cmp в attrs>=19.2.

Тривиальные/внутренние изменения¶

• issue #5801: Исправляет проверку версии python (определяемую flake8-2020) на случай, если python4 станет вещью.

Исправления ошибок¶

• issue #4344: Исправьте RuntimeError/StopIteration при попытке собрать пакет только с «__init__.py».

• issue #5478: Исправление ошибки кодирования при использовании строк unicode в исключениях с pytest.raises.

• issue #5524: Исправление проблемы, когда tmp_path и tmpdir не удаляли каталоги, содержащие файлы, помеченные как доступные только для чтения, что могло привести к аварийному завершению pytest при выполнении во второй раз с опцией --basetemp.

• issue #5547: --step-wise теперь правильно обрабатывает маркеры xfail(strict=True).

• issue #5650: Улучшен вывод при неудачном разборе конфигурационного файла ini.

Исправления ошибок¶

• issue #5404: Выдавать предупреждение, когда попытка развернуть сломанный объект приводит к исключению, для облегчения отладки (issue #5080).

• issue #5444: Исправьте режим --stepwise, когда первый файл, переданный в командной строке, не удается собрать.

• issue #5482: Исправление ошибки, появившейся в версии 4.6.0, которая приводила к ошибкам сбора при передаче более 2 позиционных аргументов в pytest.mark.parametrize.

• issue #5505: Исправление сбоя при неудачном обнаружении при использовании -p no:terminal.

Исправления ошибок¶

• issue #5383: -q снова влияет на стиль собранных предметов (--collect-only), когда используется --log-cli-level.

• issue #5389: Исправление регрессий pull request #5063 для importlib_metadata.PathDistribution, у которых атрибут files является None.

• issue #5390: Исправление регрессии, при которой атрибут obj у элементов TestCase больше не привязывался к методам.

Исправления ошибок¶

• issue #5370: Верните разворачивание all(), чтобы исправить NameError на вложенных постижениях.

• issue #5371: Верните разворачивание all(), чтобы исправить неправильную обработку генераторов с if.

• issue #5372: Верните разворачивание all() для исправления неверного утверждения при использовании all() в выражении.

Исправления ошибок¶

• issue #5354: Исправьте pytest.mark.parametrize, когда argvalues является итератором.

• issue #5358: Исправьте переписывание утверждений в вызовах all() для работы с негенераторами.

Важно¶

Серия 4.6.X будет последней серией, поддерживающей Python 2 и Python 3.4.

Для получения более подробной информации см. наш Python 2.7 and 3.4 support plan.

Характеристики¶

• issue #4559: Добавлено значение ini junit_log_passing_tests, которое можно использовать для включения или отключения протоколирования результатов прохождения теста в XML-файле Junit.

• issue #4956: pytester’s testdir.spawn использует tmpdir как каталог HOME/USERPROFILE.

• issue #5062: Разверните вызовы all в полные for-циклы с перезаписью утверждений для улучшения сообщений о сбоях, особенно при использовании Generator Expressions.

• issue #5063: Переход от pkg_resources к importlib-metadata для определения точки входа для улучшения производительности и времени импорта.

• issue #5091: Улучшен вывод ini-опций в --help.

• issue #5269: pytest.importorskip включает ImportError, который сейчас находится в reason по умолчанию.

• issue #5311: Захваченные журналы, которые выводятся для каждого неудачного теста, форматируются с помощью ColoredLevelFormatter.

• issue #5312: Улучшено форматирование многострочных сообщений журнала в Python 3.

Исправления ошибок¶

• issue #2064: Плагин отладки теперь импортирует обернутый класс Pdb (--pdbcls) по требованию.

• issue #4908: Хук pytest_enter_pdb вызывается вместе с post-mortem (--pdb).

• issue #5036: Исправление проблемы, когда приспособления, зависящие от других параметризованных приспособлений, ошибочно параметризовались.

• issue #5256: Обработка внутренней ошибки из-за того, что одинокий суррогатный символ юникода не может быть представлен в Jython.

• issue #5257: Убедитесь, что sys.stdout.mode не включает 'b', поскольку это текстовый поток.

• issue #5278: Внутренний python-плагин Pytest можно отключить, снова используя -p no:python.

• issue #5286: Исправление проблемы с неработающей опцией disable_test_id_escaping_and_forfeit_all_rights_to_community_support при использовании списка идентификаторов тестов в параметризованных тестах.

• issue #5330: Показывать собираемый тестовый модуль при выдаче сообщений PytestCollectionWarning для тестовых классов с методами __init__ и __new__, чтобы было легче определить проблему.

• issue #5333: Исправление регрессии в 4.5.0, когда --lf не выполнял повторно все тесты с известными отказами из невыбранных тестов.

Улучшенная документация¶

• issue #5250: Расширение документации по использованию setenv и delenv с monkeypatch.

Характеристики¶

• issue #4826: Теперь выдается предупреждение, когда в качестве декоратора используются неизвестные знаки. Часто это происходит из-за опечатки, что может привести к молчаливому нарушению тестов.

• issue #4907: Показывать причину XFail как часть поля сообщения JUnitXML.

• issue #5013: Сообщения из отчетов о сбоях теперь отображаются в сводках тестов, усеченные до ширины терминала.

• issue #5023: Новый флаг --strict-markers, который вызывает ошибку, когда в тестовом наборе используются неизвестные маркеры (например, не зарегистрированные с помощью опции markers в конфигурационном файле).

  Существующая опция --strict имеет такое же поведение в настоящее время, но может быть дополнена в будущем для дополнительных проверок.

• issue #5026: Сообщения об отказе утверждения для последовательностей и массивов теперь содержат количество различных элементов.

• issue #5034: Улучшение отчетности при --lf и --ff (запуск по последнему отказу).

• issue #5035: Опция/действие --cache-show принимает необязательный glob, чтобы показать только совпадающие записи кэша.

• issue #5059: Стандартный ввод (stdin) может быть передан на Testdir.run() и Testdir.popen() в pytester.

• issue #5068: Опция -r узнала о A для отображения всех отчетов (включая пройденные) в кратком резюме теста.

• issue #5108: Краткое резюме теста отображается после прохождения с выводом (-rP).

• issue #5172: Опция --last-failed (--lf) стала умнее и теперь будет пропускать целые файлы, если все тесты этого тестового файла прошли в предыдущих запусках, что значительно ускоряет сбор.

• issue #5177: Введены новые специфические подклассы предупреждений PytestWarning, чтобы упростить фильтрацию предупреждений на основе класса, а не сообщения. Новыми подклассами являются:

  • PytestAssertRewriteWarning

  • PytestCacheWarning

  • PytestCollectionWarning

  • PytestConfigWarning

  • PytestUnhandledCoroutineWarning

  • PytestUnknownMarkWarning

• issue #5202: Новое приспособление record_testsuite_property, скопированное на сессию, позволяет пользователям регистрировать <property> теги на testsuite уровне с помощью плагина junitxml.

  Сгенерированный XML совместим с последним стандартом xunit, в отличие от свойств, записанных record_property и record_xml_attribute.

• issue #5214: Для улучшения читабельности был изменен формат протоколирования по умолчанию. Вот пример предыдущего сообщения журнала:

  test_log_cli_enabled_disabled.py    3 CRITICAL critical message logged by test
  

  Теперь это стало:

  CRITICAL root:test_log_cli_enabled_disabled.py:3 critical message logged by test
  

  Форматирование можно изменить с помощью параметра конфигурации log_format.

• issue #5220: --fixtures теперь также показывает область применения приспособления для диапазонов, отличных от "function".

Исправления ошибок¶

• issue #5113: Теперь правильно сообщается о невыбранных элементах из плагинов, использующих pytest_collect_modifyitems в качестве хукаппера.

• issue #5144: При ошибках использования exitstatus устанавливается в EXIT_USAGEERROR в хуке pytest_sessionfinish теперь, как и ожидалось.

• issue #5235: outcome.exit больше не используется с EOF в обертке pdb, а только с quit.

Улучшенная документация¶

• issue #4935: Расширение документации о регистрации знаков и эффекте --strict.

Тривиальные/внутренние изменения¶

• issue #4942: logging.raiseExceptions больше не устанавливается на False.

• issue #5013: pytest теперь зависит от wcwidth для правильного отслеживания размеров символов юникода для более точного вывода в терминале.

• issue #5059: pytester’s Testdir.popen() использует stdout и stderr через аргументы ключевых слов, теперь по умолчанию (subprocess.PIPE).

• issue #5069: Код для краткого резюме теста в терминале был перенесен в плагин терминала.

• issue #5082: Улучшена проверка kwargs для различных методов в плагине pytester.

• issue #5202: record_property теперь выдает PytestWarning при использовании с junit_family=xunit2: приспособление генерирует теги property как дочерние теги testcase, что не разрешено согласно самому recent schema.

• issue #5239: Привяжите pluggy к < 1.0, чтобы мы не обновлялись до 1.0 автоматически, когда он выйдет: планируются разрывные изменения, и мы хотим убедиться, что pytest правильно поддерживает pluggy 1.0.

Исправления ошибок¶

• issue #5089: Исправление сбоя, вызванного ошибкой в функции __repr__ с включенным showlocals и вербальным выводом.

• issue #5139: Устранение зависимости ядра от плагина „terminal“.

• issue #5229: Require pluggy>=0.11.0, который возвращает зависимость importlib-metadata, добавленную в 0.10.0. Пакет importlib-metadata не может быть импортирован при установке в виде яйца и вызывает проблемы, если полагаться на setup.py для установки тестовых зависимостей.

Улучшенная документация¶

• issue #5171: Док: pytest_ignore_collect, pytest_collect_directory, pytest_collect_file и pytest_pycollect_makemodule документированный тип параметра „path“ крючков теперь py.path.local

• issue #5188: Улучшена помощь для флага --runxfail.

Тривиальные/внутренние изменения¶

• issue #5182: Удалены внутренние и неиспользуемые _pytest.deprecated.MARK_INFO_ATTRIBUTE.

Исправления ошибок¶

• issue #5031: Переменные окружения правильно восстанавливаются при использовании приспособления pytester testdir.

• issue #5039: Исправление регрессии с --pdbcls, которая перестала работать с локальными модулями в версии 4.0.0.

• issue #5092: Выдавать предупреждение при передаче неизвестных ключевых слов в pytest.param(...).

• issue #5098: аннулируйте кэши импорта с помощью monkeypatch.syspath_prepend, что необходимо при использовании пакетов пространства имен.

Характеристики¶

• issue #2224: async тестовые функции пропускаются и выдается предупреждение, если не установлен подходящий плагин async (например, pytest-asyncio или pytest-trio).

  Ранее функции async вообще не выполнялись, но при этом помечались как «пройденные».

• issue #2482: Включите новую опцию disable_test_id_escaping_and_forfeit_all_rights_to_community_support для отключения ascii-escaping в параметризованных значениях. Это может вызвать ряд проблем, и, как ясно из названия, используйте ее на свой страх и риск.

• issue #4718: Опция -p теперь может быть использована для ранней загрузки плагинов также по имени точки входа, а не только по имени модуля.

  Это делает возможным раннюю загрузку внешних плагинов типа pytest-cov в командной строке:

  pytest -p pytest_cov
  

• issue #4855: Опция --pdbcls теперь обрабатывает классы через атрибуты модуля (например, pdb:pdb.Pdb с pdbpp), и улучшена ее валидация.

• issue #4875: Опция конфигурации testpaths теперь отображается рядом со строками rootdir и inifile в заголовке pytest, если опция действует, т.е. имена каталогов или файлов не были явно переданы в командной строке.

  Кроме того, inifile отображается только при наличии файла конфигурации, вместо пустой строки inifile:.

• issue #4911: Доктесты теперь можно пропускать динамически с помощью pytest.skip().

• issue #4920: Были произведены внутренние рефакторинги, чтобы сделать возможной реализацию плагина pytest-subtests, который добавляет поддержку подтестов unittest и новое приспособление subtests, как обсуждалось в issue #1367.

  Подробную информацию о внутренних рефакторингах можно найти в соответствующем PR.

• issue #4931: pytester’s LineMatcher утверждает, что переданные строки являются последовательностью.

• issue #4936: Обращайтесь к -p plug после -p no:plug.

  Это можно использовать для отмены заблокированного плагина (например, в «addopts») из командной строки и т.д.

• issue #4951: Захват вывода обрабатывается правильно, если захват осуществляется только через фикстуры (capsys, capfs) с pdb.set_trace().

• issue #4956: pytester устанавливает $HOME и $USERPROFILE во временный каталог во время тестовых запусков.

  Это позволяет не загружать файлы конфигурации из домашнего каталога реального пользователя.

• issue #4980: Пакеты пространства имен лучше обрабатываются с помощью monkeypatch.syspath_prepend и testdir.syspathinsert (через pkg_resources.fixup_namespace_packages).

• issue #4993: Плагин stepwise теперь сообщает информацию о состоянии.

• issue #5008: Если файл setup.cfg содержит [tool:pytest], а также более не поддерживаемую секцию [pytest], pytest будет использовать [tool:pytest], игнорируя [pytest]. Ранее он безоговорочно выдавал ошибку.

  Это упрощает поддержку плагинами старых версий pytest.

Исправления ошибок¶

• issue #1895: Исправление ошибки, при которой фикстуры, запрашиваемые динамически через request.getfixturevalue(), могли быть разрушены раньше запрашивающей фикстуры.

• issue #4851: pytester unsets PYTEST_ADDOPTS теперь не использует внешние опции с testdir.runpytest().

• issue #4903: Используйте правильное измененное время для лет после 2038 года в переписанных файлах .pyc.

• issue #4928: Исправьте смещения строк с ошибками ScopeMismatch.

• issue #4957: -p no:plugin теперь корректно обрабатывается для плагинов по умолчанию (внутренних), например, с -p no:capture.

  Ранее они загружались (импортировались) всегда, делая доступным, например, приспособление capfd.

• issue #4968: Команда pdb quit обрабатывается правильно при использовании после команды debug с командой pdbpp.

• issue #4975: Исправьте интерпретацию опции -qq, когда она рассматривалась как -v.

• issue #4978: outcomes.Exit больше не заглатывается в assertrepr_compare.

• issue #4988: Явное закрытие обработчика файлов логирования при завершении сеанса.

• issue #5003: Исправьте смещение строки с ошибкой сбора меток (смещение на единицу).

Улучшенная документация¶

• issue #4974: Обновите документацию для крючка pytest_cmdline_parse, чтобы отметить ограничения доступности

Тривиальные/внутренние изменения¶

• issue #4718: pluggy>=0.9 теперь требуется.

• issue #4815: funcsigs>=1.0 теперь требуется для Python 2.7.

• issue #4829: Удалены некоторые остатки внутреннего кода, связанные с тестами yield.

• issue #4890: Удалите внутренне неиспользуемое приспособление anypython из плагина pytester.

• issue #4912: Удалите устаревшую директиву Sphinx, add_description_unit(), добавьте sphinx-removed-in к версии >= 0.2.0 для поддержки Sphinx 2.0.

• issue #4913: Исправьте вызов тестов pytest с пользовательскими PYTHONPATH.

• issue #4965: Новые pytest_report_to_serializable и pytest_report_from_serializable экспериментальные крючки.

  Эти хуки будут использоваться pytest-xdist, pytest-subtests и заменой resultlog для сериализации и настройки отчетов.

  Они являются экспериментальными, то есть их детали могут измениться или даже быть полностью удалены в будущих выпусках патчей без предупреждения.

  Отзывы приветствуются как от авторов плагинов, так и от пользователей.

• issue #4987: Collector.repr_failure соблюдает опцию --tb, но по умолчанию теперь только short (с auto).

Исправления ошибок¶

• issue #4810: Сообщения журнала внутри pytest_runtest_logreport() теперь правильно перехватываются и отображаются.

• issue #4861: Улучшена проверка содержимого, записываемого в захваченный вывод, чтобы он вел себя так же, как при отключенном захвате.

• issue #4898: Исправьте ошибку AttributeError: FixtureRequest has no 'confg' attribute в testdir.copy_example.

Тривиальные/внутренние изменения¶

• issue #4768: Избегайте импорта pkg_resources на верхнем уровне.

Амортизация¶

• issue #4724: pytest.warns() теперь выдает предупреждение при получении неизвестных аргументов ключевых слов.

  В будущем это будет заменено на ошибку.

Характеристики¶

• issue #2753: Ошибки использования от argparse отображаются на ошибки pytest’s UsageError.

• issue #3711: Добавьте параметр --ignore-glob для исключения тестовых модулей с подстановочными знаками в стиле Unix shell. Добавьте параметр collect_ignore_glob для conftest.py, чтобы исключить тестовые модули с подстановочными знаками в стиле Unix shell.

• issue #4698: Предупреждение о том, что Python 2.7 и 3.4 не поддерживаются в pytest 5.0, было удалено.

  В конце концов, это было сочтено скорее неудобством, чем реальной пользой, и у пользователей этих версий Python не должно возникнуть проблем, поскольку pip не будет устанавливать pytest 5.0 на эти интерпретаторы.

• issue #4707: С помощью нового метода set_log_path() появилась возможность устанавливать log_file пути из хуков.

Исправления ошибок¶

• issue #4651: --help и --version обрабатываются с помощью UsageError.

• issue #4782: Исправление AssertionError со сбором битых симлинков с пакетами.

Исправления ошибок¶

• issue #2895: крючок pytest_report_collectionfinish теперь также вызывается с помощью --collect-only.

• issue #3899: Не поднимать UsageError, когда импортируемый пакет имеет pytest_plugins.py дочерний модуль.

• issue #4347: Исправьте захват вывода при использовании pdb++ с рекурсивной отладкой.

• issue #4592: Исправьте обработку collect_ignore через родителя conftest.py.

• issue #4700: Исправление регрессии, когда setUpClass всегда вызывался в подклассах, даже если все тесты были пропущены декоратором unittest.skip(), примененным в подклассе.

• issue #4739: Исправьте parametrize(... ids=<function>), когда функция возвращает нестроки.

• issue #4745: Исправьте/улучшите сбор args при передаче __init__.py и тестового файла.

• issue #4770: more_itertools теперь ограничивается значением <6.0.0, когда это требуется для совместимости с Python 2.7.

• issue #526: Исправление исключений «ValueError: Plugin already registered» исключения при запуске в каталогах сборки с симлинками на реальный исходный код.

Улучшенная документация¶

• issue #3899: Добавить примечание к plugins.rst о том, что pytest_plugins не должно использоваться в качестве имени для пользовательского модуля, содержащего плагины.

• issue #4324: Документируйте, как использовать raises и does_not_raise для написания параметризованных тестов с условным повышением.

• issue #4709: Документируйте, как настраивать сообщения об отказе теста при использовании pytest.warns.

Тривиальные/внутренние изменения¶

• issue #4741: Некоторые атрибуты плагина TerminalReporter, связанные с многословностью, теперь являются свойствами только для чтения.

Характеристики¶

• issue #3094: Classic xunit-style функции и методы теперь подчиняются области видимости autouse фиксаторов.

  Это устраняет ряд неожиданных проблем, например, setup_method вызывается до сессионных фиксов autouse (см. пример issue #517).

• issue #4627: Выводить сообщение в конце сеанса тестирования при работе под Python 2.7 и 3.4 о том, что pytest 5.0 больше не будет поддерживать эти версии Python.

• issue #4660: Количество выбранных тестов теперь также отображается при использовании флагов -k или -m.

• issue #4688: Хук pytest_report_teststatus теперь также может принимать параметр config.

• issue #4691: Хук pytest_terminal_summary теперь также может принимать параметр config.

Исправления ошибок¶

• issue #3547: --junitxml может выдавать XML, совместимый с Jenkins xUnit. Опция junit_family INI принимает legacy|xunit1, который производит вывод в старом стиле, и xunit2, который более строго соответствует https://github.com/jenkinsci/xunit-plugin/blob/xunit-2.3.2/src/main/resources/org/jenkinsci/plugins/xunit/types/model/xsd/junit-10.xsd.

• issue #4280: улучшено завершение работы из pdb, особенно при использовании --trace.

  Использование q[quit] после pdb.set_trace() также приведет к выходу из pytest.

• issue #4402: Сводка предупреждений теперь группирует предупреждения по сообщениям, а не по идентификатору теста.

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

• issue #4536: monkeypatch.delattr обрабатывает дескрипторы классов типа staticmethod/classmethod.

• issue #4649: Восстановление того, чтобы метки считались ключевыми словами для выражений с ключевыми словами.

• issue #4653: tmp_path приспособление и другие связанные с ним обеспечивает разрешенный путь (он же реальный путь)

• issue #4667: pytest_terminal_summary использует результат от хука pytest_report_teststatus, а не жестко закодированные строки.

• issue #4669: Корректная обработка исключения unittest.SkipTest, содержащего неасксичные символы, на Python 2.

• issue #4680: Убедитесь, что папки tmpdir и tmp_path находятся в одной и той же папке.

• issue #4681: Убедитесь, что tmp_path всегда является реальным путем.

Тривиальные/внутренние изменения¶

• issue #4643: Используйте a.item() вместо устаревшего np.asscalar(a) в pytest.approx.

  np.asscalar был deprecated в numpy 1.16..

• issue #4657: Скопируйте saferepr из pylib

• issue #4668: Словесное обозначение ожидаемых сбоев в отчете о состоянии теста изменено с xfail на XFAIL, чтобы соответствовать другим результатам тестирования.

Исправления ошибок¶

• issue #2256: Показать полное повторение с assert a==b и -vv.

• issue #3456: Расширение Doctest-модулей для игнорирования mock-объектов.

• issue #4617: Исправлена ошибка pytest.warns при повторном использовании менеджера контекста (например, многократная параметризация).

• issue #4631: Не переписывайте утверждение, когда __getattr__ нарушено

Улучшенная документация¶

• issue #3375: Документируйте, что использование setup.cfg может привести к сбою других инструментов или вызвать трудно отслеживаемые проблемы, поскольку он использует другой парсер, чем файлы pytest.ini или tox.ini.

Тривиальные/внутренние изменения¶

• issue #4602: Удалите hypothesis в regen tox env.

Перемещение¶

• issue #2169: pytest.mark.parametrize: в предыдущих версиях ошибки, вызванные функциями id, подавлялись и заменялись на предупреждения. Теперь исключения распространяются вместе с сообщением pytest, информирующим об узле, значении параметра и индексе, где произошло исключение.

• issue #3078: Удалите устаревшую систему внутренних предупреждений: config.warn, Node.warn. pytest_logwarning теперь выдает предупреждение при выполнении.

  Информацию о том, как обновить код, см. на нашем сайте docs.

• issue #3079: Удалена поддержка тестов yield - они принципиально неработоспособны, поскольку не поддерживают фикстуры должным образом с тех пор, как сбор и выполнение тестов были разделены.

  Информацию о том, как обновить код, см. на нашем сайте docs.

• issue #3082: Удалена поддержка применения меток непосредственно к значениям в @pytest.mark.parametrize. Вместо этого используйте pytest.param.

  Информацию о том, как обновить код, см. на нашем сайте docs.

• issue #3083: Удалено Metafunc.addcall. Это был механизм-предшественник @pytest.mark.parametrize.

  Информацию о том, как обновить код, см. на нашем сайте docs.

• issue #3085: Удалена поддержка передачи строк в pytest.main. Теперь вместо этого всегда передавайте список строк.

  Информацию о том, как обновить код, см. на нашем сайте docs.

• issue #3086: Секция [pytest] в файлах setup.cfg больше не поддерживается, вместо нее используйте [tool:pytest]. Файлы setup.cfg предназначены для использования с distutils, а секция pytest печально известна как источник конфликтов и ошибок.

  Обратите внимание, что для файлов pytest.ini и tox.ini секция остается [pytest].

• issue #3616: Удалены устаревшие свойства compat для node.Class/Function/Module - теперь используйте pytest.Class/Function/Module.

  Информацию о том, как обновить код, см. на нашем сайте docs.

• issue #4421: Удалена реализация хука pytest_namespace.

  Информацию о том, как обновить код, см. на нашем сайте docs.

• issue #4489: Удалено request.cached_setup. Это был механизм-предшественник современных приспособлений.

  Информацию о том, как обновить код, см. на нашем сайте docs.

• issue #4535: Удален устаревший метод PyCollector.makeitem. Этот метод был обнародован по ошибке давным-давно.

• issue #4543: Удалена поддержка определения светильников с помощью префикса pytest_funcarg__. Вместо этого используйте декоратор @pytest.fixture.

  Информацию о том, как обновить код, см. на нашем сайте docs.

• issue #4545: Вызов фикстур напрямую теперь всегда приводит к ошибке, а не к предупреждению.

  Информацию о том, как обновить код, см. на нашем сайте docs.

• issue #4546: Удалить Node.get_marker(name) возвращаемое значение было непригодно для использования более чем для проверки существования.

  Используйте Node.get_closest_marker(name) в качестве замены.

• issue #4547: Устаревшее приспособление record_xml_property было удалено, вместо него используйте более универсальное record_property.

  Более подробную информацию см. на нашем сайте docs.

• issue #4548: Теперь выдается ошибка, если переменная pytest_plugins определена в файле conftest.py не верхнего уровня (т.е. не находится в rootdir).

  Более подробную информацию см. на нашем сайте docs.

• issue #891: Удалите атрибуты testfunction.markername - используйте Node.iter_markers(name=None) для их итерации.

Амортизация¶

• issue #3050: Утратил силу глобал pytest.config.

  Обоснование см. в pytest.config глобальный.

• issue #3974: Передача параметра message в pytest.raises теперь выдает DeprecationWarning.

  Частой ошибкой является мнение, что этот параметр будет соответствовать сообщению об исключении, в то время как на самом деле он служит только для предоставления пользовательского сообщения в случае, если проверка pytest.raises не прошла. Чтобы избежать этой ошибки и поскольку считается, что этот параметр мало используется, pytest его деприватизирует, не предоставляя на данный момент альтернативы.

  Если у вас есть сомнения по этому поводу, пожалуйста, напишите в комментариях issue #3974.

• issue #4435: Утратили силу raises(..., 'code(as_a_string)') и warns(..., 'code(as_a_string)').

  Обоснование и примеры см. в raises / warns со строкой в качестве второго аргумента.

Характеристики¶

• issue #3191: Теперь выдается предупреждение, когда утверждения делаются для None.

  Это частый источник путаницы среди новых пользователей, которые пишут:

  assert mocked_object.assert_called_with(3, 4, 5, key="value")
  

  Когда они должны писать:

  mocked_object.assert_called_with(3, 4, 5, key="value")
  

  Потому что метод assert_called_with объекта mock уже выполняет утверждение.

  Это предупреждение не будет выдано, если явно проверяется None. Утверждение типа:

  assert variable is None
  

  не будет выдавать предупреждение.

• issue #3632: Более богатая интроспекция сравнения равенств на AssertionError для объектов, созданных с помощью attrs или dataclasses (Python 3.7+, backported to 3.6).

• issue #4278: CACHEDIR.TAG файлы теперь создаются внутри каталогов кэша.

  Эти файлы являются частью каталога Cache Directory Tagging Standard, и могут использоваться программами резервного копирования или синхронизации для определения каталога кэша pytest как такового.

• issue #4292: pytest.outcomes.Exit выводится из SystemExit вместо KeyboardInterrupt. Это позволяет нам лучше обрабатывать выход из pdb.

• issue #4371: Обновлена опция --collect-only для отображения описаний тестов при запуске с помощью --verbose.

• issue #4386: Реструктурировано построение объекта ExceptionInfo и обеспечено, чтобы неполные экземпляры имели repr/str.

• issue #4416: pdb: добавлена поддержка аргументов с ключевыми словами pdb.set_trace.

  Он обрабатывает header аналогично тому, как это делает Python 3.7, и направляет любые другие аргументы ключевых слов в конструктор Pdb.

  Это позволяет __import__("pdb").set_trace(skip=["foo.*"]).

• issue #4483: Добавлен ini-параметр junit_duration_report для опционального отчета о длительности тестовых вызовов, исключая время установки и разрыва.

  Спецификация JUnit XML и поведение pytest по умолчанию предусматривают включение времени установки и завершения в отчет о продолжительности теста. Вы можете включить только длительность вызовов (без учета установки и разрыва), добавив это в ваш файл pytest.ini:

  [pytest]
  junit_duration_report = call
  

• issue #4532: -ra теперь будет показывать ошибки и сбои последними, а не первыми в сводке.

  Это облегчает получение списка ошибок и сбоев для выборочного запуска тестов.

• issue #4599: pytest.importorskip теперь поддерживает параметр reason, который будет показан, когда запрашиваемый модуль не может быть импортирован.

Исправления ошибок¶

• issue #3532: -p теперь принимает аргумент без пробела между значениями, например -pmyplugin.

• issue #4327: approx снова работает с более общими контейнерами, точнее, с экземплярами Iterable и Sized вместо более ограничительного Sequence.

• issue #4397: Убедитесь, что идентификаторы узлов доступны для печати.

• issue #4435: Исправлено имя файла кадра raises(..., 'code(string)').

• issue #4458: Отображение фактических идентификаторов тестов в --collect-only.

Улучшенная документация¶

• issue #4557: Страница документации примера маркеров обновлена для поддержки последней версии pytest.

• issue #4558: Обновите пример документации по кэшу, чтобы правильно показывать попадания и промахи кэша.

• issue #4580: Улучшена документация по подробным сводным отчетам.

Тривиальные/внутренние изменения¶

• issue #4447: Изменен тип депривации --result-log на PytestDeprecationWarning.

  Было решено убрать эту функцию в следующем крупном пересмотре.

Исправления ошибок¶

• issue #4265: Проверять аргументы из переменной окружения PYTEST_ADDOPTS и опции ini addopts отдельно.

• issue #4435: Исправьте имя файла кадра raises(..., 'code(string)').

• issue #4500: Когда приспособление выходит из строя и после выполнения теста происходит вызов журнала, а также, если тест прерывается, атрибуты захвата None.

• issue #4538: Поднимите TypeError для with raises(..., match=<non-None falsey value>).

Улучшенная документация¶

• issue #1495: Документирование распространенных «подводных камней» структуры дерева каталогов приспособления doctest

Исправления ошибок¶

• issue #3952: Снова отображение предупреждений перед «краткой информацией о тесте», но все еще более поздние предупреждения в конце.

• issue #4386: Обработка неинициализированного исключения exceptioninfo в repr/str.

• issue #4393: Не создавайте файлы .gitignore/README.md в существующих каталогах кэша.

• issue #4400: Перестройте обработку предупреждений для ошибок теста доходности, чтобы корректно работал отказ от использования в 4.0.x.

• issue #4405: Исправьте сбор тест-путей с --pyargs.

• issue #4412: Исправление перезаписи утверждений, включающих Starred + побочные эффекты.

• issue #4425: Убедитесь, что мы разрешаем абсолютный путь, когда заданный --basetemp является относительным путем.

Тривиальные/внутренние изменения¶

• issue #4315: Используйте pkg_resources.parse_version вместо LooseVersion при проверке минверсии.

• issue #4440: Настройте уровень стека некоторых внутренних предупреждений pytest.

Перемещение¶

• issue #3737: RemovedInPytest4Warnings теперь по умолчанию являются ошибками..

  В соответствии с нашим планом по удалению устаревших функций с минимальными нарушениями, все предупреждения типа RemovedInPytest4Warnings теперь генерируют ошибки вместо предупреждений.

  Затронутые функции будут фактически удалены в pytest 4.1, поэтому, пожалуйста, обратитесь к разделу Амортизация и удаление в документации за указаниями по обновлению существующего кода.

  В серии pytest 4.0.X можно изменить ошибки обратно на предупреждения в качестве временной меры, добавив это в ваш файл pytest.ini:

  [pytest]
  filterwarnings =
      ignore::pytest.RemovedInPytest4Warning
  

  Но это перестанет работать, когда выйдет pytest 4.1.

  Если у вас есть опасения по поводу удаления конкретной функции, пожалуйста, добавьте комментарий по адресу issue #4348.

• issue #4358: Убрать обозначение ::() для обозначения экземпляра тестового класса в идентификаторах узлов.

  Ранее идентификаторы узлов, содержащие экземпляры тестов, использовали ::() для обозначения экземпляра следующим образом:

  test_foo.py::Test::()::test_bar
  

  Дополнительные ::() вызывали недоумение у большинства пользователей и были удалены, так что теперь идентификатор теста становится:

  test_foo.py::Test::test_bar
  

  Это изменение не могло сопровождаться периодом амортизации, как это обычно происходит при изменении функциональности, ориентированной на пользователя, поскольку было невозможно определить, когда функциональность используется явно.

  Лишний ::() мог быть удален в некоторых местах, что привело к путанице в тех местах, где он ожидался, например, с --deselect (issue #4127).

  Экземпляры тестовых классов также больше не перечисляются с --collect-only.

Характеристики¶

• issue #4270: Опция cache_dir использует $TOX_ENV_DIR в качестве префикса (если он установлен в окружении).

  По умолчанию используется разный кэш для каждого окружения tox.

Исправления ошибок¶

• issue #3554: Исправьте CallInfo.__repr__ для случаев, когда вызов еще не завершен.

Исправления ошибок¶

• issue #4287: Исправьте вложенное использование отладочного плагина (pdb), например, с pytester’s testdir.runpytest.

• issue #4304: Заблокируйте плагин stepwise, если cacheprovider также заблокирован, так как один зависит от другого.

• issue #4306: Разбирайте minversion как фактическую версию, а не как строки, разделенные точками.

• issue #4310: Исправление дублирующего сбора из-за того, что несколько args соответствуют одним и тем же пакетам.

• issue #4321: Исправьте item.nodeid с разрешенными симлинками.

• issue #4325: Исправьте сбор файлов с прямыми симлинками, где цель не совпадает с python_files.

• issue #4329: Исправьте TypeError в report_collect с _collect_report_last_write.

Тривиальные/внутренние изменения¶

• issue #4305: Замените байтовые/юникодовые помощники в test_capture на синтаксис уровня python.

Характеристики¶

• issue #2619: Возобновите захват вывода после continue с помощью __import__("pdb").set_trace().

  Это также добавляет новый хук pytest_leave_pdb и передает pdb в существующий хук pytest_enter_pdb.

• issue #4147: Добавьте --sw, --stepwise в качестве альтернативы --lf -x для остановки при первом сбое, но запуска следующего вызова теста с этого теста. Дополнительную информацию см. в the documentation.

• issue #4188: Заставьте --color выдавать разноцветные точки, когда он не работает в режиме verbose. Ранее он окрашивал вывод по тестам, только если --verbose также был передан.

• issue #4225: Улучшение производительности при создании отчетов о сборах в бесшумном режиме с терминалами.

  Сообщение «сбор …» печатается/обновляется только каждые 0,5 с.