7e8044f9b8
Revamp the mark section in the docs
...
Add an introductory section about how to register marks,
including doing so programatically (#5255 ).
2019-05-15 20:45:22 -03:00
dc75b6af47
Use fix-encoding-pragma pre-commit hook
2019-05-14 15:56:31 -07:00
e668aaf885
Fix indentation and use code-block directives
...
The code-block directives are required by our blacken-docs hook
2019-05-14 18:59:27 -03:00
ecd072ea94
add env example to monkeypatch docs
2019-05-12 09:52:22 -04:00
63fe547d9f
Preparing release version 4.5.0
2019-05-11 16:35:32 +00:00
465b2d998a
Further "unknown marks warning" improvements ( #5178 )
...
Further "unknown marks warning" improvements
2019-05-11 13:28:10 -03:00
73bbff2b74
Introduce record_testsuite_property fixture
...
This exposes the functionality introduced in fa6acdcFix #5202
2019-05-10 19:44:27 -03:00
0594dba5ce
Remove unused markers and enable --strict-markers
2019-05-09 19:36:39 -03:00
685ca96c71
Change ``--strict`` to ``--strict-markers``, preserving the old one
...
Fix #5023
2019-05-09 19:36:38 -03:00
ccf6c3cb46
Merge remote-tracking branch 'upstream/master' into merge-master-into-features
2019-05-09 19:22:40 -03:00
5d7686951c
Run regendoc
2019-05-08 21:50:08 +00:00
80c5f6e609
Ignore PytestUnknownMark warnings when regen docs
...
A lot of our examples use custom markers to make a point and showcase
features, which generates a lot of warnings
2019-05-08 21:46:26 +00:00
3ac43314ee
Preparing release version 4.4.2
2019-05-08 12:46:14 -03:00
d1a48ad68f
Use exec directly
2019-05-06 23:07:39 -07:00
784e1e3b7e
Add links to pytest.raises `message` workaround
...
Related to #3974
2019-05-06 12:35:27 -03:00
9f66102869
Merge remote-tracking branch 'upstream/master' into merge-master-into-features
2019-05-04 10:47:57 -03:00
254b195f50
Fix a typo
2019-05-03 22:30:20 -07:00
af40473c9a
Add quick note about accessing config through session or item objects
...
Fix #5030
2019-05-01 11:46:35 -03:00
204004c8b8
Review doctest docs ( #5183 )
...
Review doctest docs
2019-04-29 08:02:59 -03:00
772a4a5cf3
Remove all version references to obsolete pytest versions ( #5184 )
...
Remove all version references to obsolete pytest versions
2019-04-29 08:02:32 -03:00
e943aff995
Update blurb about Sybil
2019-04-28 20:01:22 -03:00
9c5da9c0d1
Remove all version references to obsolete pytest versions
...
Remove version references to pytest 2 and 3.
Just like Python 3 no longer has references to Python 2, I think
we should follow the same approach in pytest.
2019-04-28 12:37:58 -03:00
f6ab6d71ad
Run regendoc
2019-04-28 12:17:15 -03:00
67755d67fb
Review doctest docs
...
* Add pytest.skip() example
* Add blurb about Sybil
* Create a subsection for doctest-options
* Create a subsection for pytest-specific features
2019-04-28 12:17:15 -03:00
53cd7fd2ea
Introduce new warning subclasses
...
Fix #5177
2019-04-28 10:38:25 -03:00
8532e991a5
Publish UnknownMarkWarning as part of the public API and docs
2019-04-28 10:16:07 -03:00
50937fe622
Add note about pytest_load_initial_conftests working only from plugins
...
Fix #5175
2019-04-27 10:12:27 -03:00
7f519f8ab7
Merge master into features
2019-04-27 00:43:00 +02:00
0e651d7297
[Docs] Fix typo in skipping.rst
...
One of the `pytest.mark.skipif` blocks does not use the `reason` kwarg.
2019-04-16 09:30:13 -07:00
8d3a5dcd1b
Merge remote-tracking branch 'upstream/master' into merge-master-into-features
2019-04-15 14:47:45 -03:00
006dc30476
Preparing release version 4.4.1
2019-04-15 14:24:17 +00:00
6f0a5789fb
Merge master into features
2019-04-14 23:22:21 +02:00
8449294e5d
blacken-docs more code samples in docs
2019-04-12 04:50:26 -07:00
42e60d935a
doc/changelog
2019-04-11 11:44:04 +02:00
1f66e3b0d0
docs: tbreportdemo: remove obsolete comment
2019-04-11 11:39:23 +02:00
eb5b2e0db5
Support glob argument with ``--cache-show``
2019-04-04 18:10:39 +02:00
8907fedc79
Merge master into features (with regen branch)
2019-04-03 22:11:00 +02:00
befc8a3f10
Update via https://github.com/pytest-dev/regendoc/pull/8
2019-04-03 22:08:44 +02:00
5935fbaa7a
doc/en/Makefile: stabilize output between regendoc versions
2019-04-03 22:07:33 +02:00
cec2dd6a7c
doc/en/Makefile: allow passing in REGENDOC_FILES
...
This allows for:
> make -C doc/en regen REGENDOC_FILES=example/parametrize.rst
2019-04-03 19:53:00 +02:00
266bf2c007
doc: make regen: replace trailing spaces already
2019-04-03 17:34:26 +02:00
db34bf01b6
doc: minor whitespace, punctuation
2019-04-03 11:45:45 +02:00
9121138a1b
Emit warning for unknown marks
2019-04-01 10:40:18 +11:00
deade370b9
Update doc/en/mark.rst
...
Co-Authored-By: Zac-HD <Zac-HD@users.noreply.github.com>
2019-04-01 07:13:45 +11:00
bcc08ffe4d
More docs on registering marks
2019-03-31 14:22:30 +11:00
8881b201aa
Preparing release version 4.4.0
2019-03-29 20:49:18 +00:00
3d9e68ecfd
Update doc/en/parametrize.rst
2019-03-28 00:07:28 +09:00
cf6e2ceafd
add ini option to disable string escape for parametrization
2019-03-28 00:07:28 +09:00
69a55d334a
Merge pull request #5004 from blueyed/doc-pdb
...
doc: fix note about output capturing with pdb
2019-03-26 20:20:05 -03:00
057c97812b
Merge pull request #4975 from blueyed/verbose-fixes
...
Fix usages of "verbose" option
2019-03-26 18:38:39 -03:00
52730f6330
doc: fix note about output capturing with pdb
...
[skip travis]
2019-03-26 18:33:00 +01:00
e1ae469504
Merge master into features
2019-03-26 10:23:21 +01:00
23146e7527
Fix usages of "verbose" option
...
With `-qq` `bool(config.getoption("verbose"))` is True; it needs to be
checked for `> 0`.
2019-03-26 10:11:25 +01:00
8e125c9759
doc/en/reference.rst: whitespace/alignment
2019-03-22 13:23:44 +01:00
dcbdcc729b
Fix pytestmark syntax in reference.rst
...
pytest 4.3.1 throws an error if `pytestmark` is set to a tuple of marks; it appears to insist on a list.
With `pytestmark = [pytest.mark.api, pytest.mark.good]`:
```
============================== test session starts ==============================
platform win32 -- Python 3.6.3, pytest-4.3.1, py-1.8.0, pluggy-0.9.0
rootdir: C:\Temp\git\sphobjinv, inifile: tox.ini
plugins: timeout-1.3.3
collected 48 items / 41 deselected / 7 selected
tests\test_api_good.py ....... [100%]
==================== 7 passed, 41 deselected in 0.15 seconds ====================
```
With `pytestmark = (pytest.mark.api, pytest.mark.good)`:
```
==================================== ERRORS =====================================
____________________ ERROR collecting tests/test_api_good.py ____________________
env\lib\site-packages\_pytest\runner.py:226: in from_call
result = func()
env\lib\site-packages\_pytest\runner.py:289: in <lambda>
call = CallInfo.from_call(lambda: list(collector.collect()), "collect")
env\lib\site-packages\_pytest\python.py:435: in collect
self._inject_setup_module_fixture()
env\lib\site-packages\_pytest\python.py:447: in _inject_setup_module_fixture
setup_module = _get_non_fixture_func(self.obj, "setUpModule")
env\lib\site-packages\_pytest\python.py:255: in obj
self.own_markers.extend(get_unpacked_marks(self.obj))
env\lib\site-packages\_pytest\mark\structures.py:244: in get_unpacked_marks
return normalize_mark_list(mark_list)
env\lib\site-packages\_pytest\mark\structures.py:259: in normalize_mark_list
raise TypeError("got {!r} instead of Mark".format(mark))
E TypeError: got (MarkDecorator(mark=Mark(name='api', args=(), kwargs={})), MarkDecorator(mark=Mark(name='good', args=(), kwargs={}))) instead of Mark
!!!!!!!!!!!!!!!!!!!! Interrupted: 1 errors during collection !!!!!!!!!!!!!!!!!!!!
==================== 19 deselected, 1 error in 0.27 seconds =====================
```
2019-03-21 15:14:28 -04:00
751c061d9a
Merge master into features
2019-03-19 01:07:10 +01:00
519157cfcf
Minor grammar fixes in pytest.mark.xfail docs
2019-03-17 10:14:40 +01:00
2af0a023c9
Pin sphinx-removed-in to >= 0.2.0 to support Sphinx 2.0
...
Fixes https://github.com/pytest-dev/pytest/issues/4912
2019-03-15 10:56:13 +01:00
7afe17740f
Merge master into features
2019-03-15 00:52:12 +01:00
134b957bf4
Remove deprecated Sphinx directive add_description_unit()
...
Partial solution for https://github.com/pytest-dev/pytest/issues/4912
2019-03-14 12:16:59 +01:00
f4bcb44025
docs: pin Sphinx to <2.0
...
Ref: https://github.com/pytest-dev/pytest/issues/4912
2019-03-13 02:36:15 +01:00
492cc4219c
Prepare release 4.3.1
2019-03-11 12:59:54 -03:00
2d43f42769
Add missing plugin hooks to docs
...
pytest-dev/pytest#4896
2019-03-08 09:24:01 -05:00
76687030f0
Merge branch 'master' into merge-master-into-features
...
Conflicts:
appveyor.yml
setup.py
2019-03-05 19:07:36 +01:00
dac164cc99
Add missing ref docs to tmp_path and tmp_path_factory
2019-03-01 17:09:07 -03:00
fec656b3b1
Apply suggestions from code review
...
Co-Authored-By: nicoddemus <nicoddemus@gmail.com>
2019-02-27 07:46:03 -03:00
16cbb3196c
Document how to disable caching rewritten .pyc files to disk
...
Also changed how the section is presented: instead of "Note" blocks, use proper
sections as those contain enough information to exist on their own.
Fix #1680
2019-02-26 20:42:59 -03:00
29112d7e0b
Merge master into features
2019-02-26 11:48:10 +01:00
d9bdf5cfca
Clarify docs on --strict marks
2019-02-25 22:30:49 +11:00
a0207274f4
-p option now can be used to early-load plugins by entry-point name
...
Fixes #4718
2019-02-24 13:20:17 -03:00
2e210acd00
Merge pull request #4819 from Handsome2734/doc-fix
...
add notice to use [tool:pytest] in setup.cfg
2019-02-24 12:16:30 -03:00
3e11bd0d6e
Update wording about [tool:pytest] in setup.cfg files
2019-02-23 15:32:42 -03:00
6a4c7063fd
Fix docs about pytest conventions for test functions
...
Fix #4818
2019-02-23 15:22:27 -03:00
15fe60aa25
add notice to use [tool:pytest] in setup.cfg
2019-02-24 00:24:56 +08:00
e1aeb6915e
Fix linting
2019-02-21 13:27:12 -03:00
e75915bb73
Revert recommending virtualenv for Python 3.4
...
`venv` is already available in Python 3.4, my mistake
2019-02-21 13:03:19 -03:00
ba2a43266a
Mention that virtualenv should be used for Python 3.4 as well
2019-02-21 12:52:09 -03:00
cfaa8bbee8
recommend venv or virtualenv, depending on python version
...
venv has been installed with Python since 3.3. https://docs.python.org/3/library/venv.html
2019-02-21 10:50:49 -05:00
6b661795cf
update links.inc to include both venv and virtualenv
2019-02-21 10:41:59 -05:00
fa65b71c98
Merge pull request #1 from discdiver/discdiver-patch-1
...
update links for virtualenv -> venv
2019-02-20 15:41:39 -05:00
da5dec83f6
update links for virtualenv -> venv
2019-02-20 15:36:34 -05:00
2ef3cb2510
Recommend use venv instead of virtualenv
...
From the Python docs:
"Changed in version 3.5: The use of venv is now recommended for creating virtual environments."
-https://docs.python.org/3/library/venv.html
2019-02-20 15:33:48 -05:00
c8a87e48ab
Merge pull request #4783 from gyermolenko/fix_syntax_highlighting_for_two_rst_docs
...
Fix sphinx code-block types (syntax highlighting) in two docs
2019-02-20 06:31:10 +11:00
ff015f6308
Fix docs (tox -e regen, plus pre-commit)
2019-02-18 18:46:03 +01:00
31c869b4c4
Preparing release version 4.3.0
2019-02-16 14:11:58 +00:00
0395996756
Merge remote-tracking branch 'upstream/master' into release-4.3.0
2019-02-16 14:06:51 +00:00
986dd84375
LoggingPlugin: Support to customize log_file from hook ( #4752 )
...
LoggingPlugin: Support to customize log_file from hook
2019-02-16 12:01:21 -02:00
e3824d23bc
LoggingPlugin: Expose setting log_file_handler
...
- This patch allows to set log_file (path) from hook
Signed-off-by: Thomas Hisch
Signed-off-by: Andras Mitzki <andras.mitzki@balabit.com>
2019-02-15 16:05:10 +01:00
59f69dd9e7
Add good talk by Andrew Svetlov
2019-02-15 15:37:18 +02:00
6e1ee0802f
Fix sphinx code-block types for remaining rst docs
2019-02-15 15:10:37 +02:00
5cf58a9ae9
Revert '$' changes to not trigger regendoc
2019-02-15 14:09:37 +02:00
4bc2f96c93
Remove 'message' parameter docs from assert.rst
...
As per:
https://github.com/pytest-dev/pytest/issues/3974#issuecomment-463462732
Also made the 'match' parameter more prominent
2019-02-14 08:32:49 -02:00
7b91952645
Merge master into features
...
Conflicts:
tox.ini
2019-02-13 17:58:16 +01:00
799bcccd1b
Fix sphinx code-block types (syntax highlighting) in two docs
2019-02-13 17:08:49 +02:00
82cc3d8cc2
Preparing release version 4.2.1
2019-02-12 20:17:06 +00:00
aee67bb1a7
Clarify pytest_assertrepr_compare docs per #4759
2019-02-10 08:34:35 -05:00
7f6108beb1
Add ref docs for junit_family option
2019-02-08 21:44:52 -02:00
fc8800c71f
Merge pull request #4722 from fetzerch/ignore_wildcards
...
Add ability to use globs when using --ignore
2019-02-09 00:11:04 +01:00
526f4a95cc
Merge pull request #4735 from kohr-h/pytest_plugins_module_name
...
Mention that `pytest_plugins` should not be used as module name
2019-02-07 07:07:58 +01:00
2f083504ee
Merge pull request #4709 from namurphy/warns-docs
...
Document how to customize test failure message for missing warnings
2019-02-06 20:51:14 -02:00
7445b5345f
Mention that `pytest_plugins` should not be used as module name
2019-02-06 21:57:42 +01:00
1876a928d3
Document collect_ignore and collect_ignore_glob in reference
2019-02-06 17:15:30 +01:00
2dc2a19db5
Add ability to exclude files matching glob patterns in conftest.py
...
This adds the `collect_ignore_glob` option for `conftest.py` to allow
Unix-style wildcards for excluding files.
2019-02-06 16:49:43 +01:00
fc5d4654e5
Add ability to exclude files matching glob patterns with --ignore-glob
...
This adds the `--ignore-glob` option to allow Unix-style wildcards so
that `--ignore-glob=integration*` excludes all tests that reside in
files starting with `integration`.
Fixes : #3711
2019-02-06 11:29:30 +01:00
584c052da4
Fix linting and change False to True as requested in review
2019-02-05 19:04:26 -02:00
2264db7f4a
Merge pull request #4682 from arel/parameterize-conditional-raises-document-only
...
Document parametrizing conditional raises
2019-02-02 13:15:26 -08:00
f0ecb25acd
Document custom failure messages for missing warnings
2019-02-01 21:48:29 -05:00
7ec1a1407a
Incorporating feedback from asottile
2019-02-02 01:57:17 +00:00
fa979a4290
Preparing release version 4.2.0
2019-01-30 14:25:38 -02:00
ade5f2c8c5
Merge remote-tracking branch 'upstream/master' into merge-master-into-features
2019-01-29 19:36:56 -02:00
8a1afe4213
Including note on using nullcontext in Python 3.7+
2019-01-28 13:31:08 +00:00
fd4289dae0
Adding `does_not_raise` to documentation only
2019-01-27 16:42:10 +00:00
977adf1354
Improving sphinx docs based on feedback
2019-01-27 16:41:23 +00:00
c166b80a8c
Documenting raises/does_not_raise + parametrize
2019-01-27 16:40:49 +00:00
067f2c6148
Improve pytest.raises 'message' deprecation docs
...
Based on recent discussions in #3974
2019-01-24 20:41:18 -02:00
daf39112e7
Merge pull request #4091 from nicoddemus/setup-methods-as-fixtures-3094
...
Use fixtures to invoke xunit-style fixtures
2019-01-23 19:23:31 -02:00
92a2c1a9c4
remove and ban py.io.BytesIO, py.process, py.path.local.sysfind
2019-01-21 19:51:16 -08:00
e2a9aaf24b
Add docs page about plans for dropping py27 and py34
...
Fix #4635
2019-01-14 22:10:15 -02:00
e48f68953d
Merge pull request #4638 from nicoddemus/release-4.1.1
...
Preparing release version 4.1.1
2019-01-12 12:51:32 -02:00
25081d8e30
Merge pull request #4570 from nicoddemus/sphinx-removed-in
...
Use sphinx removed in extension in the documentation
2019-01-12 08:34:29 -02:00
34eeda1c09
Preparing release version 4.1.1
2019-01-12 00:55:12 +00:00
0f918b1a9d
xunit-style functions and methods are invoked by autouse fixtures
...
Fix #3094 , Fix #517
2019-01-10 12:10:04 -02:00
9f6d9efc1d
Mention PYTHONPATH semantics in goodpractices.rst
...
Fix #4625
2019-01-09 22:45:09 -02:00
2467831913
rephrase warning section to explain better the issue.
2019-01-09 23:52:08 +02:00
6ee5d431a0
add warning for using non canonical configuration files.
2019-01-06 23:11:24 +02:00
38adb23bd2
Merge pull request #4600 from nicoddemus/release-4.1.0
...
Release 4.1.0
2019-01-06 13:09:11 -02:00
e24031fb36
Regendocs again, without hypothesis
2019-01-05 20:42:44 +00:00
99ef8c6d16
Fix typo in Makefile: PYTEST_ADDOPT -> PYTEST_ADDOPTS
2019-01-05 20:31:01 +00:00
d7465895d0
Regendoc again
2019-01-05 19:19:40 +00:00
01151ff566
Add example for -ra usage to the docs
2019-01-05 16:53:12 -02:00
d0e9b4812f
Regendocs
2019-01-05 16:38:59 -02:00
9d297c06e8
Preparing release version 4.1.0
2019-01-05 16:38:59 -02:00
e24fdb138d
Merge pull request #4598 from nicoddemus/license-year
...
Update copyright year
2019-01-05 09:09:55 -08:00
7f671586b0
Update copyright year
2019-01-04 10:37:07 -02:00
9e62f9d64e
Fix PEP 565 typo in warnings.rst
2019-01-04 11:50:36 +11:00
81c2780d2b
Move Node.get_marker and markname deprecations next to the other 4.0 ones
2019-01-02 19:37:17 -02:00
b39b69a730
Use sphinx-removed-in extension in the documentation
...
Fix #4568
2019-01-02 19:34:46 -02:00
30c7a7bd69
Merge remote-tracking branch 'upstream/master' into features
2019-01-02 19:16:18 -02:00
388aff16c8
Improve detailed summary report docs
...
The existing examples had 0 tests collected so didn't show the actual summary report. Also I added a section explaining the difference between `p` and `P`.
2018-12-29 11:47:39 +00:00
2dc8cc1e48
Remove out of date dependencies list in docs
...
Was scrolling through the docs and noticed this, I figure it's easier to remove this than try and keep it in sync with setup.py
2018-12-25 20:46:48 -05:00
b2c4ed9a2b
Remove an extraneous comma from the docs.
...
Signed-off-by: Randy Barlow <randy@electronsweatshop.com>
2018-12-21 17:53:28 -05:00
8f8d3114dd
apply suggested enhancements in deprecations.rst
2018-12-21 14:02:38 +01:00
64a353f2b6
update deprecation docs
2018-12-21 14:02:38 +01:00
b258764ffe
fix docs
2018-12-21 14:02:38 +01:00
ece01b0f56
Update cache documentation example to correctly show cache hit and miss
2018-12-21 04:43:26 +00:00
c378cb4793
Remove support for applying marks to values in parametrize
...
Fix #3082
2018-12-20 16:16:13 -02:00
a93f41233a
Raise an error if pytest_plugins is defined in a non-top-level conftest.py file
...
Fix #4548
2018-12-19 18:09:47 -02:00
9138419379
Remove support for '[pytest]' section in setup.cfg file
...
Fix #3086
2018-12-19 17:43:17 -02:00
0115766df3
Calling fixtures directly is now an error instead of a warning
...
Fix #4545
2018-12-19 09:26:29 -02:00
b7e8171cf8
Merge branch 'features' into remove-legacy-warn
2018-12-17 10:37:31 -02:00
Bruno Oliveira
Anthony Sottile
Evan Kepner
Bruno Oliveira
Don Kirkby
Daniel Hahler
Douglas Thor
Zac Hatfield-Dodds
Daniel Hahler
Zac-HD
ApaDoctor
Brian Skinn
smheidrich
Miro Hrončok
Kyle Altendorf
songbowen
Jeff Hale
Andras Mitzki
Grygorii Iermolenko
Kevin J. Foley
Ronny Pfannschmidt
Holger Kohr
Christian Fetzer
Nick Murphy
Arel Cordero
Yoav Caspi
David Vo
Adam Johnson
Randy Barlow
Ronny Pfannschmidt
Hyunchel Kim