{"categories":[{"label":"Utilities","url":"https://skillfed.io/packages/category/utilities/5"},{"label":"Testing","url":"https://skillfed.io/packages/category/software-development-testing/2"}],"enrichment":{"capability":"A pytest plugin that runs doctests in Python docstrings and documentation files (reStructuredText, Markdown, TeX) with advanced features like floating-point comparison and remote data handling.","skillfed_tags":["doctest","documentation-testing","pytest-plugin"],"use_cases":["Test code examples in Sphinx documentation to ensure they remain correct as the library evolves.","Validate Markdown README files and tutorials contain working Python code snippets.","Compare floating-point numerical results in doctests without brittle string matching on roundoff digits.","Skip doctests in specific classes or functions during CI without removing the documentation examples.","Test NumPy ufunc docstrings that contain example code requiring special handling."],"what_it_does":"pytest-doctestplus extends pytest's built-in doctest support to handle example code in Python docstrings and standalone documentation files (RST, Markdown, TeX). It solves the problem of testing documentation examples that may have floating-point precision variations, need to skip certain tests, or depend on remote data\u2014situations where standard doctests fail or require workarounds.\n\nThe plugin integrates directly into pytest's collection and execution pipeline. You enable it via command-line flags (--doctest-plus, --doctest-rst, --doctest-ufunc) or configuration, then write doctests using standard Python doctest syntax plus optional directives like +FLOAT_CMP for approximate numeric comparison, +IGNORE_WARNINGS to suppress warnings, or +SHOW_WARNINGS to display them. It respects pytest's standard doctest options and can work alongside pytest-remotedata for tests that fetch external resources.","worth_installing":"Yes. This is a mature, actively maintained plugin (Production/Stable) with low install friction and no known vulnerabilities. Install it if you write documentation with code examples and want to ensure those examples stay correct. The floating-point comparison and remote-data features address real pain points in scientific and technical documentation testing."},"id":"pytest-doctestplus","links":{"html":"https://skillfed.io/packages/pytest-doctestplus","md":"https://skillfed.io/packages/pytest-doctestplus.md","pypi":"https://pypi.org/project/pytest-doctestplus/"},"maintenance":{"status":"active"},"meta":{"latest_release":"2026-01-26","license_spdx":null,"license_treatment":"permissive","name":"pytest-doctestplus","python_support":"supports_current","summary":"Pytest plugin with advanced doctest features."},"popularity":{"monthly_downloads":678215,"position":5377,"tier":"top_15000"},"security":{"n_vulnerabilities":0},"version":"1.7.1"}
