p53209761
/
test_ok2
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Add docs for ALLOW_BYTES doctest option 

Fix #1287
This commit is contained in:
Bruno Oliveira 2015-12-29 21:05:11 -02:00
parent a0edbb75a4
commit 5a5b732fe1
1 changed files with 20 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
doc/en/doctest.rst
View File

@ -67,19 +67,32 @@ when executing text doctest files.
The standard ``doctest`` module provides some setting flags to configure the The standard ``doctest`` module provides some setting flags to configure the
strictness of doctest tests. In py.test You can enable those flags those flags strictness of doctest tests. In py.test You can enable those flags those flags
using the configuration file. To make pytest ignore trailing whitespaces and using the configuration file. To make pytest ignore trailing whitespaces and
ignore lengthy exception stack traces you can just write:: ignore lengthy exception stack traces you can just write:
.. code-block:: ini
# content of pytest.ini
[pytest] [pytest]
doctest_optionflags= NORMALIZE_WHITESPACE IGNORE_EXCEPTION_DETAIL doctest_optionflags= NORMALIZE_WHITESPACE IGNORE_EXCEPTION_DETAIL
py.test also introduces new options to allow doctests to run in Python 2 and
Python 3 unchanged:
py.test also introduces a new ``ALLOW_UNICODE`` option flag: when enabled, the * ``ALLOW_UNICODE``: when enabled, the ``u`` prefix is stripped from unicode
``u`` prefix is stripped from unicode strings in expected doctest output. This strings in expected doctest output.
allows doctests which use unicode to run in Python 2 and 3 unchanged.
As with any other option flag, this flag can be enabled in ``pytest.ini`` using * ``ALLOW_BYTES``: when enabled, the ``b`` prefix is stripped from byte strings
the ``doctest_optionflags`` ini option or by an inline comment in the doc test in expected doctest output.
As with any other option flag, these flags can be enabled in ``pytest.ini`` using
the ``doctest_optionflags`` ini option:
.. code-block:: ini
[pytest]
doctest_optionflags = ALLOW_UNICODE ALLOW_BYTES
Alternatively, it can be enabled by an inline comment in the doc test
itself:: itself::
# content of example.rst # content of example.rst