summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMichał Górny <mgorny@gentoo.org>2022-01-29 22:51:27 +0100
committerMichał Górny <mgorny@gentoo.org>2022-01-29 22:51:57 +0100
commit417d3ec5de11c6af8ad6b48b89bd5f338d988e9c (patch)
treebe9b5408406d5378f5bad0a0da0283ff24c0fa36 /guide/pytest.html
parentImport the current version of python-guide (diff)
downloadpython-417d3ec5de11c6af8ad6b48b89bd5f338d988e9c.tar.gz
python-417d3ec5de11c6af8ad6b48b89bd5f338d988e9c.tar.bz2
python-417d3ec5de11c6af8ad6b48b89bd5f338d988e9c.zip
Update guide to 57b8ed1
Signed-off-by: Michał Górny <mgorny@gentoo.org>
Diffstat (limited to 'guide/pytest.html')
-rw-r--r--guide/pytest.html9
1 files changed, 9 insertions, 0 deletions
diff --git a/guide/pytest.html b/guide/pytest.html
index af29942..8293761 100644
--- a/guide/pytest.html
+++ b/guide/pytest.html
@@ -134,6 +134,15 @@ please avoid the dependency and strip it if necessary.</p>
users. They include plugins for test coverage
(<code class="docutils literal notranslate"><span class="pre">dev-python/pytest-cov</span></code>), coding style (<code class="docutils literal notranslate"><span class="pre">dev-python/pytest-flake8</span></code>)
and more. Generally, packages should avoid using those plugins.</p>
+<div class="admonition warning">
+<p class="admonition-title">Warning</p>
+<p>As of 2022-01-24, <code class="docutils literal notranslate"><span class="pre">epytest</span></code> disables a few undesirable plugins
+by default. As a result, developers have a good chance
+of experiencing failures due to hardcoded pytest options first,
+even if they have the relevant plugins installed.</p>
+<p>If your package <em>really</em> needs to use the specific plugin, you need
+to pass <code class="docutils literal notranslate"><span class="pre">-p</span> <span class="pre">&lt;plugin&gt;</span></code> explicitly to reenable it.</p>
+</div>
<p>In some cases, upstream packages only list them as dependencies
but do not use them automatically. In other cases, you will need
to strip options enabling them from <code class="docutils literal notranslate"><span class="pre">pytest.ini</span></code> or <code class="docutils literal notranslate"><span class="pre">setup.cfg</span></code>.</p>