bcb435ee8f
docs: module page titles should not start with a link to themselves ( #117099 )
2024-05-08 20:34:40 +01:00
1446024124
Docs: replace Harry Potter reference with Monty Python ( #118130 )
2024-04-21 19:03:46 +01:00
29829b58a8
gh-117294: Report DocTestCase as skipped if all examples in the doctest are skipped (GH-117297)
2024-03-28 21:59:12 +02:00
ce00de4c8c
gh-117225: doctest: only print "and X failed" when non-zero, don't pluralise "1 items" ( #117228 )
2024-03-27 16:46:35 +02:00
f6cdc6b4a1
Revert "gh-96844: Improve error message of list.remove (gh-106455)" ( #116956 )
...
This reverts commit 217f47d6e5
2024-03-18 13:54:45 +00:00
9c93350f58
gh-108303: Move all doctest related files and tests to `Lib/test/test_doctest/` ( #112109 )
...
Co-authored-by: Brett Cannon <brett@python.org>
2024-01-18 16:58:11 +01:00
d99d871225
gh-113360: Fix the documentation of module's attribute __test__ (GH-113393)
...
It can only be a dict since Python 2.4.
2024-01-06 00:23:16 +02:00
b3c21265fa
Fixing typo in DocTestRunner docs (GH-112326)
2023-12-14 12:07:37 +02:00
0303a9fa79
gh-101100 : Fix Sphinx warnings in `library/doctest.rst` ( #112399 )
...
* Fix Sphinx warnings in library/doctest.rst
* Don't link to self, and wrap a line
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* Link to load_tests protocol
* Link to option flags
* Wrap line
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
---------
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2023-11-25 20:08:32 +02:00
bcc941bd4a
gh-109510: Clearly explain "Which Docstrings Are Examined" ( #109696 )
...
Co-authored-by: Mariatta <Mariatta@users.noreply.github.com>
Co-authored-by: Jacob Coffee <jacob@z7x.org>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2023-10-19 18:10:06 +03:00
4f9b706c6f
gh-108794: doctest counts skipped tests ( #108795 )
...
* Add 'skipped' attribute to TestResults.
* Add 'skips' attribute to DocTestRunner.
* Rename private DocTestRunner._name2ft attribute
to DocTestRunner._stats.
* Use f-string for string formatting.
* Add some tests.
* Document DocTestRunner attributes and its API for statistics.
* Document TestResults class.
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2023-09-02 16:42:07 +02:00
217f47d6e5
gh-96844: Improve error message of list.remove (gh-106455)
2023-07-06 07:19:49 +09:00
e477348f36
gh-99970 Adding missing `optionflags` parameter in the documentation of `doctest` ( #99971 )
2022-12-10 15:42:40 +05:30
286e3c76a9
gh-99087: Add missing newline for prompts in docs (GH-98993)
...
Add newline for prompts so copying to REPL does not cause errors.
2022-12-08 19:31:19 -08:00
22860dbbc8
doc: Remove backslashes in doctest grammar docs ( #29346 )
2022-11-27 12:08:39 +05:30
3440d197a5
Docs: remove redundant "adverb-adjective" hyphens from compound modifiers (GH-94551)
...
Discussion: https://discuss.python.org/t/slight-grammar-fix-throughout-adverbs-dont-need-hyphen/17021
2022-07-05 11:16:10 +02:00
97b9c1096f
gh-92417: Update docs and examples of doctest.IGNORE_EXCEPTION_DETAIL for Py>=3 (GH-92502)
2022-05-19 16:59:07 +02:00
7b024e3a3f
gh-80856: doc: reveal doctest directives ( #92318 )
...
* Doc: Reveal doctest directives.
* Fix whitespace.
Co-authored-by: Julien Palard <julien@palard.fr>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
2022-05-08 18:14:55 +02:00
5639ea1ef9
gh-92417: `doctest` docs: remove references to Python <3.6 (GH-92420)
2022-05-08 16:17:23 +03:00
f76889a887
Fix doctest doc examples for syntax errors (GH-28486)
...
* fix doctest doc examples for syntax errors
* updated examples to use TypeErrors
* fixed first sentence
* unneeded comma
2021-09-29 12:44:43 +01:00
5c1f15b4b1
bpo-42843: Keep Sphinx 1.8 and Sphinx 2 compatibility (GH-24282)
2021-01-25 15:46:06 +01:00
c8a10d2fab
bpo-36675: Doc: Reveal doctest directives (GH-23620)
2020-12-15 17:23:03 +01:00
138ccbb022
bpo-38738: Fix formatting of True and False. (GH-17083)
...
* "Return true/false" is replaced with "Return ``True``/``False``"
if the function actually returns a bool.
* Fixed formatting of some True and False literals (now in monospace).
* Replaced "True/False" with "true/false" if it can be not only bool.
* Replaced some 1/0 with True/False if it corresponds the code.
* "Returns <bool>" is replaced with "Return <bool>".
2019-11-12 16:57:03 +02:00
2c910c1e73
bpo-36675: Remove obsolete code. (GH-16024)
...
Does no longer work since Sphinx moved the trim_doctest_flag option in
the configuration.
2019-09-12 12:23:53 +01:00
913876d824
bpo-35054: Add yet more index entries for symbols. (GH-10121)
2018-10-28 13:41:26 +02:00
ddb961d2ab
bpo-35054: Add more index entries for symbols. (GH-10064)
2018-10-26 09:00:49 +03:00
0522fd81dc
bpo-34839: Add a 'before 3.6' in the section 'warnings' of doctest (GH-9736)
2018-10-20 10:43:32 +02:00
8856940cf2
bpo-28315: Improve code examples in docs (GH-1372)
...
Replace
File "<stdin>", line 1, in ?
with
File "<stdin>", line 1, in <module>
2017-05-03 09:46:45 -07:00
81b8977349
Issue #29371 : Clarify bitwise OR operation in doctest option flags.
2017-02-06 20:15:01 -08:00
ecf41da83e
Issue #19795 : Mark up None as literal text.
2016-10-19 16:29:26 +03:00
1050d2d0c7
Issue #26462 : Doc: reduce literal_block warnings, fix syntax highlighting.
...
Patch by Julien Palard.
2016-07-26 11:18:21 +02:00
fa089b9b0b
Issue #22558 : Add remaining doc links to source code for Python-coded modules.
...
Reformat header above separator line (added if missing) to a common format.
Patch by Yoni Lavi.
2016-06-11 15:02:54 -04:00
7b51a55ecd
Issue24756: clarify usage of run_docstring_examples()
2015-09-17 22:21:36 -07:00
2a5f9da56c
Issue24756: clarify usage of run_docstring_examples()
2015-09-17 22:20:41 -07:00
1f6afef2ea
merge with 3.4
2014-10-06 16:57:02 +02:00
7fa4a8f15a
Closes #12148 : clarify "or's together option flags" in doctest docs.
2014-10-06 16:56:43 +02:00
1976d9bf6d
#15916 : if there are no docstrings, make empty suite, not an error.
...
This makes doctest work like unittest: if the test case is empty, that
just means there are zero tests run, it's not an error. The existing
behavior was broken, since it only gave an error if there were *no*
docstrings, and zero tests run if there were docstrings but none of them
contained tests. So this makes it self-consistent as well.
Patch by Glenn Jones.
2014-04-14 20:28:36 -04:00
df48b97855
Fix a few scoping issues with versionadded/versionchanged directives.
2014-03-24 09:06:18 +01:00
a4b7a7548c
Issue #3158 : doctest can now find doctests in functions and methods
...
written in C.
As a part of this, a few doctests have been added to the builtins module
(on hex(), oct(), and bin()), a doctest has been fixed (hopefully on all
platforms) on float, and test_builtins now runs doctests in builtins.
2013-11-24 01:19:09 -06:00
5707d508e1
#11390 : convert doctest CLI to argparse and add -o and -f options.
...
This provides a way to specify arbitrary doctest options when using
the CLI interface to process test files, just as one can when calling
testmod or testfile programmatically.
2013-06-23 14:24:13 -04:00
60dd6e538f
#16522 : s/always 1/at most 1/.
...
Correction thanks to Joey Geralnik.
2012-11-22 06:22:41 -05:00
5a9d706123
#16522 : Add FAIL_FAST flag to doctest.
...
Patch by me, most of the work (doc and tests) by Daniel Urban.
2012-11-21 15:09:21 -05:00
3fa8c59024
Issue #12947 : Remove doctest directives from the doctest examples in the "Option Flag" section.
...
The doctest examples that illustrate the use of doctest option flags
independent of doctest directives should not display doctest directives.
2012-10-10 08:34:38 -07:00
23a87de96f
Missed one instance of code-block:: text highlighting to revert.
2012-10-10 16:56:15 +02:00
83e51f48a8
Issue #12947 : revert earlier workaround and use a monkey-patch to enable showing doctest directives only in the doctest docs.
2012-10-10 16:45:11 +02:00
3650ea2a9f
Issue #12947 : Divide doctest "Option Flags and Directives" section into two.
...
This changeset also applies the rendering workaround to the last remaining
example in the file that has a doctest directive that should be displayed.
2012-10-10 06:52:08 -07:00
0b26ccfaa6
Issue #12947 : Better workaround for the problem with doctest directives being stripped from code examples that are intended to illustrate those directives
2012-10-03 13:52:48 +05:30
8f80e0a651
Issue #12947 : Add a note to doctest until the example rendering is fixed
2012-10-03 12:21:44 +05:30
694f2331c6
Fix a few quotes/backslashes.
2012-09-20 09:47:03 +03:00
5abd76a75d
#14649 : clarify DocTestSuite error when there are no docstrings.
...
Also adds tests to verify the documented behavior (which is probably a bug, as
indicated in the added comments).
Patch by Chris Jerdonek.
2012-09-10 10:15:58 -04:00
Ned Batchelder
Clément Robert
Malcolm Smith
Hugo van Kemenade
Victor Stinner
Nikita Sobolev
Serhiy Storchaka
Daniel Wysocki
Hugo van Kemenade
Unique-Usman
Dong-hee Na
busywhitespace
Stanley
George Zhang
CAM Gerlach
Davide Rizzo
Alex Waygood
andrei kulakov
Julien Palard
Stéphane Wirtel
UltimateCoder
Mariatta Wijaya
Martin Panter
Terry Jan Reedy
Ethan Furman
Georg Brandl
R David Murray
Zachary Ware
Chris Jerdonek
Nick Coghlan
Ezio Melotti