cpython/Doc/library
Emily Morehouse 8f59ee01be
bpo-35224: PEP 572 Implementation (#10497)
* Add tokenization of :=
- Add token to Include/token.h. Add token to documentation in Doc/library/token.rst.
- Run `./python Lib/token.py` to regenerate Lib/token.py.
- Update Parser/tokenizer.c: add case to handle `:=`.

* Add initial usage of := in grammar.

* Update Python.asdl to match the grammar updates. Regenerated Include/Python-ast.h and Python/Python-ast.c

* Update AST and compiler files in Python/ast.c and Python/compile.c. Basic functionality, this isn't scoped properly

* Regenerate Lib/symbol.py using `./python Lib/symbol.py`

* Tests - Fix failing tests in test_parser.py due to changes in token numbers for internal representation

* Tests - Add simple test for := token

* Tests - Add simple tests for named expressions using expr and suite

* Tests - Update number of levels for nested expressions to prevent stack overflow

* Update symbol table to handle NamedExpr

* Update Grammar to allow assignment expressions in if statements.
Regenerate Python/graminit.c accordingly using `make regen-grammar`

* Tests - Add additional tests for named expressions in RoundtripLegalSyntaxTestCase, based on examples and information directly from PEP 572

Note: failing tests are currently commented out (4 out of 24 tests currently fail)

* Tests - Add temporary syntax test failure tests in test_parser.py

Note: There is an outstanding TODO for this -- syntax tests need to be
moved to a different file (presumably test_syntax.py), but this is
covering what needs to be tested at the moment, and it's more convenient
to run a single test for the time being

* Add support for allowing assignment expressions as function argument annotations. Uncomment tests for these cases because they all pass now!

* Tests - Move existing syntax tests out of test_parser.py and into test_named_expressions.py. Refactor syntax tests to use unittest

* Add TargetScopeError exception to extend SyntaxError

Note: This simply creates the TargetScopeError exception, it is not yet
used anywhere

* Tests - Update tests per PEP 572

Continue refactoring test suite:
The named expression test suite now checks for any invalid cases that
throw exceptions (no longer limited to SyntaxErrors), assignment tests
to ensure that variables are properly assigned, and scope tests to
ensure that variable availability and values are correct

Note:
- There are still tests that are marked to skip, as they are not yet
implemented
- There are approximately 300 lines of the PEP that have not yet been
addressed, though these may be deferred

* Documentation - Small updates to XXX/todo comments

- Remove XXX from child description in ast.c
- Add comment with number of previously supported nested expressions for
3.7.X in test_parser.py

* Fix assert in seq_for_testlist()

* Cleanup - Denote "Not implemented -- No keyword args" on failing test case. Fix PEP8 error for blank lines at beginning of test classes in test_parser.py

* Tests - Wrap all file opens in `with...as` to ensure files are closed

* WIP: handle f(a := 1)

* Tests and Cleanup - No longer skips keyword arg test. Keyword arg test now uses a simpler test case and does not rely on an external file. Remove print statements from ast.c

* Tests - Refactor last remaining test case that relied on on external file to use a simpler test case without the dependency

* Tests - Add better description of remaning skipped tests. Add test checking scope when using assignment expression in a function argument

* Tests - Add test for nested comprehension, testing value and scope. Fix variable name in skipped comprehension scope test

* Handle restriction of LHS for named expressions - can only assign to LHS of type NAME. Specifically, restrict assignment to tuples

This adds an alternative set_context specifically for named expressions,
set_namedexpr_context. Thus, context is now set differently for standard
assignment versus assignment for named expressions in order to handle
restrictions.

* Tests - Update negative test case for assigning to lambda to match new error message. Add negative test case for assigning to tuple

* Tests - Reorder test cases to group invalid syntax cases and named assignment target errors

* Tests - Update test case for named expression in function argument - check that result and variable are set correctly

* Todo - Add todo for TargetScopeError based on Guido's comment (2b3acd37bd (r30472562))

* Tests - Add named expression tests for assignment operator in function arguments

Note: One of two tests are skipped, as function arguments are currently treating
an assignment expression inside of parenthesis as one child, which does
not properly catch the named expression, nor does it count arguments
properly

* Add NamedStore to expr_context. Regenerate related code with `make regen-ast`

* Add usage of NamedStore to ast_for_named_expr in ast.c. Update occurances of checking for Store to also handle NamedStore where appropriate

* Add ste_comprehension to _symtable_entry to track if the namespace is a comprehension. Initialize ste_comprehension to 0. Set set_comprehension to 1 in symtable_handle_comprehension

* s/symtable_add_def/symtable_add_def_helper. Add symtable_add_def to handle grabbing st->st_cur and passing it to symtable_add_def_helper. This now allows us to call the original code from symtable_add_def by instead calling symtable_add_def_helper with a different ste.

* Refactor symtable_record_directive to take lineno and col_offset as arguments instead of stmt_ty. This allows symtable_record_directive to be used for stmt_ty and expr_ty

* Handle elevating scope for named expressions in comprehensions.

* Handle error for usage of named expression inside a class block

* Tests - No longer skip scope tests. Add additional scope tests

* Cleanup - Update error message for named expression within a comprehension within a class. Update comments. Add assert for symtable_extend_namedexpr_scope to validate that we always find at least a ModuleScope if we don't find a Class or FunctionScope

* Cleanup - Add missing case for NamedStore in expr_context_name. Remove unused var in set_namedexpr_content

* Refactor - Consolidate set_context and set_namedexpr_context to reduce duplicated code. Special cases for named expressions are handled by checking if ctx is NamedStore

* Cleanup - Add additional use cases for ast_for_namedexpr in usage comment. Fix multiple blank lines in test_named_expressions

* Tests - Remove unnecessary test case. Renumber test case function names

* Remove TargetScopeError for now. Will add back if needed

* Cleanup - Small comment nit for consistency

* Handle positional argument check with named expression

* Add TargetScopeError exception definition. Add documentation for TargetScopeError in c-api docs. Throw TargetScopeError instead of SyntaxError when using a named expression in a comprehension within a class scope

* Increase stack size for parser by 200. This is a minimal change (approx. 5kb) and should not have an impact on any systems. Update parser test to allow 99 nested levels again

* Add TargetScopeError to exception_hierarchy.txt for test_baseexception.py_

* Tests - Major update for named expression tests, both in test_named_expressions and test_parser

- Add test for TargetScopeError
- Add tests for named expressions in comprehension scope and edge cases
- Add tests for named expressions in function arguments (declarations
and call sites)
- Reorganize tests to group them more logically

* Cleanup - Remove unnecessary comment

* Cleanup - Comment nitpicks

* Explicitly disallow assignment expressions to a name inside parentheses, e.g.: ((x) := 0)

- Add check for LHS types to detect a parenthesis then a name (see note)
- Add test for this scenario
- Update tests for changed error message for named assignment to a tuple
(also, see note)

Note: This caused issues with the previous error handling for named assignment
to a LHS that contained an expression, such as a tuple. Thus, the check
for the LHS of a named expression must be changed to be more specific if
we wish to maintain the previous error messages

* Cleanup - Wrap lines more strictly in test file

* Revert "Explicitly disallow assignment expressions to a name inside parentheses, e.g.: ((x) := 0)"

This reverts commit f1531400ca7d7a2d148830c8ac703f041740896d.

* Add NEWS.d entry

* Tests - Fix error in test_pickle.test_exceptions by adding TargetScopeError to list of exceptions

* Tests - Update error message tests to reflect improved messaging convention (s/can't/cannot)

* Remove cases that cannot be reached in compile.c. Small linting update.

* Update Grammar/Tokens to add COLONEQUAL. Regenerate all files

* Update TargetScopeError PRE_INIT and POST_INIT, as this was purposefully left out when fixing rebase conflicts

* Add NamedStore back and regenerate files

* Pass along line number and end col info for named expression

* Simplify News entry

* Fix compiler warning and explicity mark fallthrough
2019-01-24 16:49:56 -07:00
..
2to3.rst bpo-21446: Update reload fixer to use importlib (GH-8391) 2018-07-23 09:49:08 +03:00
__future__.rst String annotations [PEP 563] (#4390) 2018-01-26 08:20:18 -08:00
__main__.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
_dummy_thread.rst Restore dummy_threading and _dummy_thread, but deprecate them (bpo-31370) (#3648) 2017-09-18 22:04:20 +02:00
_thread.rst bpo-11233: Create availability directive for documentation (GH-9692) 2018-10-12 16:55:20 +02:00
abc.rst Grammar corrections in abc.rst (GH-10525) 2018-11-13 16:40:44 -08:00
aifc.rst bpo-35506: Remove redundant and incorrect links from keywords. (GH-11174) 2018-12-19 08:09:46 +02:00
allos.rst
archiving.rst
argparse.rst bpo-35054: Add yet more index entries for symbols. (GH-10121) 2018-10-28 13:41:26 +02:00
array.rst Issue #21818: Fixed references to classes that have names matching with module 2016-12-02 23:13:53 +02:00
ast.rst bpo-33416: Add end positions to Python AST (GH-11605) 2019-01-22 11:18:22 +00:00
asynchat.rst Issue 25002: Deprecate asyncore/asynchat. Patch by Mariatta. 2016-10-25 08:49:13 -07:00
asyncio-api-index.rst bpo-33649: Add low-level APIs index. (GH-9364) 2018-09-17 15:35:24 -04:00
asyncio-dev.rst Fix a typo in asyncio-dev.rst. (GH-10133) 2018-10-26 10:14:04 -07:00
asyncio-eventloop.rst bpo-35465: Document _UnixSelectorEventLoop.add_signal_handler. (GH-11145) 2018-12-18 16:31:29 -05:00
asyncio-exceptions.rst bpo-33649: A copy-editing pass on asyncio documentation (GH-9376) 2018-09-17 19:16:44 -04:00
asyncio-future.rst bpo-33649: Add a high-level section about Futures; few quick fixes (GH-9403) 2018-09-18 17:55:44 -04:00
asyncio-llapi-index.rst bpo-34746: Fix stop -> close (GH-9437) 2018-09-20 01:17:09 -04:00
asyncio-platforms.rst bpo-34687: Make asynico use ProactorEventLoop by default (GH-9538) 2018-09-25 11:27:08 -04:00
asyncio-policy.rst Fix typo in documentation of AbstractEventLoopPolicy.set_child_watcher() (GH-11369) 2018-12-30 14:01:28 -08:00
asyncio-protocol.rst bpo-23554: Change echo server example class name from EchoServerClientProtocol to EchoServerProtocol (GH-9859) 2018-10-15 17:39:16 -04:00
asyncio-queue.rst Fixes typo in asyncio.queue doc (GH-11581) 2019-01-17 03:52:17 -08:00
asyncio-stream.rst bpo-11233: Create availability directive for documentation (GH-9692) 2018-10-12 16:55:20 +02:00
asyncio-subprocess.rst bpo-34687: Update asyncio doc for ProactorEventLoop (GH-9623) 2018-09-28 08:40:08 -07:00
asyncio-sync.rst bpo-33649: A copy-editing pass on asyncio documentation (GH-9376) 2018-09-17 19:16:44 -04:00
asyncio-task.rst bpo-35579: Fix typo in in asyncio-task documentation (GH-11321) 2018-12-26 06:47:16 -08:00
asyncio.rst bpo-33649: Add a high-level section about Futures; few quick fixes (GH-9403) 2018-09-18 17:55:44 -04:00
asyncore.rst bpo-11233: Create availability directive for documentation (GH-9692) 2018-10-12 16:55:20 +02:00
atexit.rst bpo-31901: atexit callbacks should be run at subinterpreter shutdown (#4611) 2017-12-20 11:17:58 +01:00
audioop.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
base64.rst bpo-27846: Delete incorrect note in base64 docs (GH-5666) 2018-02-14 03:08:54 +03:00
bdb.rst Issue #19795: Mark up None as literal text. 2016-10-19 16:29:26 +03:00
binary.rst
binascii.rst Redo PR 785 -- Add cross reference links (GH-11319) 2018-12-25 17:53:36 -08:00
binhex.rst bpo-29557: Remove ambiguous line in binhex docs (#90) 2017-02-15 01:37:49 +03:00
bisect.rst
builtins.rst Issue #24314: Fix doc links for general attributes like __name__, __dict__ 2016-06-18 03:57:31 +00:00
bz2.rst bpo-33487: improve BZ2File Deprecation and documentation. (GH-6785) 2018-09-10 18:15:56 -07:00
calendar.rst Closes bpo-28281: Remove year (1-9999) limits on the weekday() function. (#4109) 2017-10-26 15:34:11 -04:00
cgi.rst bpo-33843: Remove deprecated stuff in cgi module (GH-7662) 2018-06-19 17:28:50 +09:00
cgitb.rst bpo-29920: Document cgitb.text() and cgitb.html() functions (GH-849) 2017-05-05 11:15:12 +03:00
chunk.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
cmath.rst bpo-29956: Improve the math.exp() related documentation. (#1073) 2017-05-04 12:25:09 +03:00
cmd.rst bpo-35054: Add yet more index entries for symbols. (GH-10121) 2018-10-28 13:41:26 +02:00
code.rst Issue #19795: Mark up None as literal text. 2016-10-19 16:37:13 +03:00
codecs.rst bpo-35110: Fix unintentional spaces around hyphens and dashes. (GH-10231) 2018-10-31 02:26:06 +02:00
codeop.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
collections.abc.rst bpo-32467: Let collections.abc.ValuesView inherit from Collection (#5152) 2018-01-11 21:53:49 -08:00
collections.rst dict insertion order is guaranteed since 3.7 (GH-10431) 2018-11-11 08:56:47 -08:00
colorsys.rst bpo-25910: Link redirections in docs (#1933) 2018-01-20 01:25:37 +01:00
compileall.rst bpo-34022: Stop forcing of hash-based invalidation with SOURCE_DATE_EPOCH (GH-9607) 2018-10-10 18:43:14 +02:00
concurrency.rst Restore dummy_threading and _dummy_thread, but deprecate them (bpo-31370) (#3648) 2017-09-18 22:04:20 +02:00
concurrent.futures.rst Fix typos in concurrent.Futures documentation (GH-10920) 2018-12-05 13:41:20 -08:00
concurrent.rst
configparser.rst bpo-35054: Add yet more index entries for symbols. (GH-10121) 2018-10-28 13:41:26 +02:00
constants.rst bpo-35054: Add more index entries for symbols. (GH-10064) 2018-10-26 09:00:49 +03:00
contextlib.rst bpo-35506: Remove redundant and incorrect links from keywords. (GH-11174) 2018-12-19 08:09:46 +02:00
contextvars.rst bpo-33985: Implement ContextVar.name attribute. (GH-7980) 2018-06-28 13:20:29 -04:00
copy.rst Include memo in the documented signature of copy.deepcopy() 2018-10-29 12:30:12 -06:00
copyreg.rst bpo-27200: fix configparser, copyreg and ctypes doctests (#240) 2017-03-02 14:02:43 +03:00
crypt.rst Correct a couple of unbalanced parenthesis. (GH-10779) 2018-12-05 21:45:30 +02:00
crypto.rst Issue #29062: Merge hashlib-blake2.rst into hashlib.rst 2017-01-13 19:29:58 +09:00
csv.rst bpo-33798: Update csv document about dict order (GH-7490) 2018-06-08 21:51:12 +09:00
ctypes.rst bpo-4260: Document that ctypes.xFUNCTYPE are decorators (GH-7924) 2018-07-13 15:50:20 +03:00
curses.ascii.rst bpo-35054: Add yet more index entries for symbols. (GH-10121) 2018-10-28 13:41:26 +02:00
curses.panel.rst bpo-30872: Update the curses docs to Python 3. (#2620) 2017-10-04 22:44:13 +03:00
curses.rst bpo-31680: Add curses.ncurses_version. (GH-4217) 2018-10-30 13:22:42 +02:00
custominterp.rst
dataclasses.rst bpo-35566: Add links to annotation glossary term (GH-11291) 2018-12-23 21:09:09 -08:00
datatypes.rst
datetime.rst bpo-34512: Document platform-specific strftime() behavior for non-ASCII format strings (GH-8948) 2019-01-12 19:21:54 +02:00
dbm.rst bpo-33106: change dbm key deletion error for readonly file from KeyError to dbm.error (#6295) 2018-12-12 20:46:55 +08:00
debug.rst
decimal.rst bpo-30055: add testcleanup to leave a fresh context (#1094) 2017-04-13 13:30:25 +02:00
development.rst bpo-32101: Add PYTHONDEVMODE environment variable (#4624) 2017-11-30 11:40:24 +01:00
difflib.rst bpo-35079: Revise difflib.SequenceManager.get_matching_blocks doc (GH-10144) 2018-10-26 23:03:08 -04:00
dis.rst bpo-34906: Doc: Fix typos (GH-9712) 2018-10-05 16:17:18 +02:00
distribution.rst bpo-33503: Fix the broken pypi link in the source and the documentation (GH-6814) 2018-05-15 14:58:35 -04:00
distutils.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
doctest.rst bpo-35054: Add yet more index entries for symbols. (GH-10121) 2018-10-28 13:41:26 +02:00
dummy_threading.rst Restore dummy_threading and _dummy_thread, but deprecate them (bpo-31370) (#3648) 2017-09-18 22:04:20 +02:00
email.charset.rst bpo-26441: Remove documentation for deleted to_splittable and from_splittable methods (#9865) 2018-10-18 20:13:23 -04:00
email.compat32-message.rst Correct a couple of unbalanced parenthesis. (GH-10779) 2018-12-05 21:45:30 +02:00
email.contentmanager.rst bpo-30820: Remove incorrect docs for email.contentmanager.raw_data_manager (#7631) 2018-06-11 10:47:47 -04:00
email.encoders.rst #24277: The new email API is no longer provisional. 2016-09-07 21:15:59 -04:00
email.errors.rst bpo-27397: Make email module properly handle invalid-length base64 strings (#7583) 2018-06-12 15:46:22 +03:00
email.examples.rst bpo-33641: Convert RFC references into links. (GH-7103) 2018-05-31 07:39:00 +03:00
email.generator.rst bpo-31887: Adds documentations for special multipart/signed handling (GH-4268) 2018-11-04 14:12:34 -08:00
email.header.rst #24277: The new email API is no longer provisional. 2016-09-07 21:15:59 -04:00
email.headerregistry.rst Fix typos in multiple .rst files (#1668) 2017-05-19 23:37:57 +03:00
email.iterators.rst Issue #27209: Fix doctests in Doc/library/email*.rst 2016-08-10 00:39:41 -05:00
email.message.rst bpo-35404: Clarify how to import _structure in email.message doc (GH-10886) 2019-01-09 15:52:10 -07:00
email.mime.rst Fix typos in multiple .rst files (#1668) 2017-05-19 23:37:57 +03:00
email.parser.rst Correct a couple of unbalanced parenthesis. (GH-10779) 2018-12-05 21:45:30 +02:00
email.policy.rst Fix typos in multiple .rst files (#1668) 2017-05-19 23:37:57 +03:00
email.rst bpo-35035: Rename email.utils documentation to email.utils.rst (GH-10023) 2018-11-21 13:41:07 +01:00
email.utils.rst bpo-35035: Rename email.utils documentation to email.utils.rst (GH-10023) 2018-11-21 13:41:07 +01:00
ensurepip.rst bpo-32996: The bulk of What's New in Python 3.7 (GH-6978) 2018-05-19 23:15:06 -04:00
enum.rst bpo-29577: Enum: mixin classes don't mix well with already mixed Enums (GH-9328) 2018-09-21 19:03:09 -07:00
errno.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
exceptions.rst Correct a couple of unbalanced parenthesis. (GH-10779) 2018-12-05 21:45:30 +02:00
faulthandler.rst Improve highlighting of some code blocks. (GH-6401) 2018-04-08 19:18:04 +03:00
fcntl.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
filecmp.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
fileformats.rst
fileinput.rst bpo-35506: Remove redundant and incorrect links from keywords. (GH-11174) 2018-12-19 08:09:46 +02:00
filesys.rst bpo-35471: Remove the macpath module (GH-11129) 2018-12-14 13:37:26 +01:00
fnmatch.rst glob uses fnmatch.filter instead of fnmatch since 2001. (GH-10102) 2018-11-07 20:09:11 +02:00
formatter.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
fractions.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
frameworks.rst
ftplib.rst bpo-33641: Convert RFC references into links. (GH-7103) 2018-05-31 07:39:00 +03:00
functional.rst
functions.rst bpo-34764: improve docs example of iter() with sentinel value (GH-11222) 2018-12-23 21:07:17 -08:00
functools.rst bpo-35300: Add usage note to the lru_cache() docs (GH-10707) 2018-11-25 16:24:52 -08:00
gc.rst bpo-34605: Avoid master/slave terms (GH-9101) 2018-09-07 17:30:33 +02:00
getopt.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
getpass.rst bpo-32651 Recommend getpass.getuser() (#5301) 2018-01-24 12:51:29 -05:00
gettext.rst bpo-2504: Add pgettext() and variants to gettext. (GH-7253) 2018-11-07 16:12:20 +02:00
glob.rst Explain that the orderness of the result of glob is system-dependant (GH-6587) 2018-11-04 15:50:55 +01:00
grp.rst Merge Issue #22558. 2016-06-11 15:06:08 -04:00
gzip.rst bpo-34898: Add mtime parameter to gzip.compress(). (GH-9704) 2018-11-07 11:50:23 +02:00
hashlib-blake2-tree.png bpo-30660: Doc: Optimize PNG files by optipng (GH-8032) 2018-07-01 16:02:52 +09:00
hashlib.rst bpo-11233: Create availability directive for documentation (GH-9692) 2018-10-12 16:55:20 +02:00
heapq.rst fix dangling keyfunc examples in documentation of heapq and sorted (#1432) 2018-10-15 13:06:53 -06:00
hmac.rst bpo-33604: Remove deprecated HMAC default value marked for removal in 3.8 (GH-7063) 2018-09-10 11:10:01 -07:00
html.entities.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
html.parser.rst Issue #26462: Doc: reduce literal_block warnings, fix syntax highlighting. 2016-07-26 11:18:21 +02:00
html.rst bpo-31865: Fix a couple of typos in the html.unescape() docs. (GH-9662) 2018-10-01 17:34:46 -07:00
http.client.rst bpo-21257: document http.client.parse_headers (GH-11443) 2019-01-18 08:49:16 -07:00
http.cookiejar.rst bpo-34911: Added support for secure websocket cookies (GH-9734) 2018-10-08 21:49:29 +03:00
http.cookies.rst bpo-29613: Added support for SameSite cookies (GH-6413) 2018-04-07 16:09:42 -04:00
http.rst bpo-30553: Add status code 421 to http.HTTPStatus (GH-2589) 2017-10-26 21:49:19 +03:00
http.server.rst Adds IPv6 support when invoking http.server directly. (GH-10595) 2018-11-26 10:43:38 -08:00
i18n.rst
idle.rst bpo-28097: IDLE - Add Previous/Next History to Shell menu (#11325) 2018-12-28 15:11:30 -05:00
imaplib.rst bpo-35506: Remove redundant and incorrect links from keywords. (GH-11174) 2018-12-19 08:09:46 +02:00
imghdr.rst Issue #28228: imghdr now supports pathlib 2016-10-01 05:01:54 +03:00
imp.rst bpo-35506: Remove redundant and incorrect links from keywords. (GH-11174) 2018-12-19 08:09:46 +02:00
importlib.rst bpo-35486: Note Py3.6 import system API requirement change (GH-11540) 2019-01-17 02:41:29 -08:00
index.rst bpo-34717: Stop numbering stdlib titles/sections in the docs (GH-9370) 2018-09-17 18:12:21 -04:00
inspect.rst bpo-34890: Make iscoroutinefunction, isgeneratorfunction and isasyncgenfunction work with functools.partial (GH-9903) 2018-10-26 12:19:14 +01:00
internet.rst
intro.rst bpo-11233: Create availability directive for documentation (GH-9692) 2018-10-12 16:55:20 +02:00
io.rst bpo-35506: Remove redundant and incorrect links from keywords. (GH-11174) 2018-12-19 08:09:46 +02:00
ipaddress.rst bpo-27683: Fix a regression for host() of ipaddress network objects (GH-6016) 2018-03-21 08:25:13 +08:00
ipc.rst bpo-33649: Fix asyncio-dev (GH-9324) 2018-09-14 16:57:11 -07:00
itertools.rst bpo-34659: Adds initial kwarg to itertools.accumulate() (GH-9345) 2018-09-23 17:34:59 -07:00
json.rst bpo-31553: add --json-lines option to json.tool (#10051) 2018-11-07 12:09:32 +02:00
keyword.rst
language.rst
linecache.rst bpo-32797: improve documentation of linecache.getline (GH-9540) 2018-10-24 14:44:41 +02:00
locale.rst bpo-28604: Fix localeconv() for different LC_MONETARY (GH-10606) 2018-11-20 16:20:16 +01:00
logging.config.rst bpo-35722: Updated the documentation for the 'disable_existing_loggers' parameter (GH-11525) 2019-01-23 07:12:39 +00:00
logging.handlers.rst bpo-34334: Don't log traceback twice in QueueHandler (GH-9537) 2018-09-26 00:00:08 +01:00
logging.rst bpo-35110: Fix unintentional spaces around hyphens and dashes. (GH-10231) 2018-10-31 02:26:06 +02:00
lzma.rst Tweak PEP 519 documentation in stdlib (#163) 2017-02-19 03:17:35 +03:00
mailbox.rst bpo-25910: Link redirections in docs (#1933) 2018-01-20 01:25:37 +01:00
mailcap.rst
markup.rst
marshal.rst bpo-29746: Update marshal docs to Python 3. (#547) 2017-03-12 08:53:22 +02:00
math.rst bpo-33089: Add math.dist() for computing the Euclidean distance between two points (GH-8561) 2018-07-31 00:45:49 -07:00
mimetypes.rst bpo-11233: Create availability directive for documentation (GH-9692) 2018-10-12 16:55:20 +02:00
misc.rst
mm.rst
mmap.rst bpo-32798: Add restriction on the offset parameter for mmap.flush in the docs (#5621) 2018-10-20 02:37:55 +02:00
modulefinder.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
modules.rst
msilib.rst Remove outdated .pyo reference from msilib docs (GH-4461) 2017-11-19 13:04:25 +03:00
msvcrt.rst Fixed double hyphens that are rendered to literal en-dashes in the documenation. 2016-12-04 10:20:55 +02:00
multiprocessing.rst bpo-32146: Add documentation about frozen executables on Unix (GH-5850) 2019-01-10 18:51:28 +01:00
netdata.rst
netrc.rst bpo-28334: netrc() now uses expanduser() to find .netrc file (GH-4537) 2017-11-25 13:37:22 +03:00
nis.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
nntplib.rst bpo-35525: Correct the argument name for NNTP.starttls() (GH-11310) 2019-01-02 23:05:19 +02:00
numbers.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
numeric.rst
operator.rst itemgetter add dict example (GH-1280) 2018-04-12 21:33:08 -04:00
optparse.rst Remove duplicate "Reference Guide" in optparse.rst. (GH-10372) 2018-11-07 07:47:11 +02:00
os.path.rst bpo-29707: Document that os.path.ismount() is not able to reliable detect bind mounts. (GH-11238) 2019-01-15 10:55:40 +02:00
os.rst bpo-35674: Add os.posix_spawnp() (GH-11554) 2019-01-16 14:29:26 +01:00
ossaudiodev.rst bpo-35110: Fix unintentional spaces around hyphens and dashes. (GH-10231) 2018-10-31 02:26:06 +02:00
othergui.rst bpo-25910: Fixes redirection from http to https (#4674) 2017-12-06 17:39:33 +01:00
parser.rst bpo-35506: Remove redundant and incorrect links from keywords. (GH-11174) 2018-12-19 08:09:46 +02:00
pathlib-inheritance.png bpo-30660: Doc: Optimize PNG files by optipng (GH-8032) 2018-07-01 16:02:52 +09:00
pathlib-inheritance.svg
pathlib.rst bpo-34825: Add more entries to os to pathlib reference table (GH-9608) 2018-10-05 08:24:11 -07:00
pdb.rst Doc: Remove superfluous markup. (GH-8112) 2018-07-06 11:15:13 +02:00
persistence.rst
pickle.rst bpo-35506: Remove redundant and incorrect links from keywords. (GH-11174) 2018-12-19 08:09:46 +02:00
pickletools.rst Fix indentation 2016-11-21 13:36:36 +00:00
pipes.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
pkgutil.rst bpo-35042: Use the :pep: role where a PEP is specified (#10036) 2018-10-26 15:58:26 -07:00
platform.rst bpo-35344: platform.platform() uses mac_ver() on macOS (GH-10780) 2018-12-05 22:41:52 +01:00
plistlib.rst bpo-33801: Remove non-ordered dict comment from plistlib doc (GH-7495) 2018-06-08 17:51:20 -04:00
poplib.rst Issue #28022: Deprecate ssl-related arguments in favor of SSLContext. 2016-09-10 23:23:33 +02:00
posix.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
pprint.rst bpo-9842: Add references for using "..." as a placeholder to the index. (GH-10330) 2018-11-20 19:26:09 +02:00
profile.rst bpo-35511: Trivial docs updates for profile and resource library modules. (GH-11124) 2018-12-16 21:34:08 +02:00
pty.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
pwd.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
py_compile.rst bpo-34022: Stop forcing of hash-based invalidation with SOURCE_DATE_EPOCH (GH-9607) 2018-10-10 18:43:14 +02:00
pyclbr.rst Fix "Python" casing in a few places (GH-9001) 2018-09-14 10:13:09 -07:00
pydoc.rst bpo-31128: Allow pydoc to bind to arbitrary hostnames (#3011) 2017-09-14 17:54:09 -04:00
pyexpat.rst bpo-30380: Fix Sphinx 1.6.1 warnings. (#1613) 2017-05-16 23:18:09 +03:00
python.rst bpo-32216: Add documentation for dataclasses (GH-6886) 2018-05-16 04:20:43 -04:00
queue.rst bpo-35118: Improve docs regarding indexing (GH-10265) 2018-11-04 14:34:22 -08:00
quopri.rst bpo-32701: Clarify the quotetabs flag in quopri documentation (GH-5401) 2018-01-29 19:36:06 -08:00
random.rst Neaten-up and extend the examples in the random module docs. 2016-12-04 11:00:34 -08:00
re.rst Add information about DeprecationWarning for invalid escaped characters in the re module (GH-5255) 2019-01-20 18:57:56 +00:00
readline.rst bpo-13631: Fix the order of initialization for readline libedit on macOS. (GH-6915) 2018-05-17 02:45:10 -04:00
reprlib.rst bpo-9842: Add references for using "..." as a placeholder to the index. (GH-10330) 2018-11-20 19:26:09 +02:00
resource.rst bpo-35511: Trivial docs updates for profile and resource library modules. (GH-11124) 2018-12-16 21:34:08 +02:00
rlcompleter.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
runpy.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
sched.rst versionadded -> versionchanged for all 'X parameter was added' for uniformity. (GH8114) 2018-07-05 17:01:16 -07:00
secrets.rst import secrets module in secrets recipes (#6705) 2018-05-20 01:01:49 +10:00
select.rst bpo-35497: add versionadded tag for EPOLLEXCLUSIVE (GH-11162) 2018-12-19 19:59:52 +08:00
selectors.rst Fix typo in selectors.rst (#1383) 2017-05-02 06:27:57 -07:00
shelve.rst Issue #19795: Mark up True and False as literal text instead of bold. 2016-10-19 16:43:42 +03:00
shlex.rst bpo-27200: Fix several doctests (GH-604) 2017-04-27 15:23:34 +03:00
shutil.rst bpo-20849: add dirs_exist_ok arg to shutil.copytree (patch by Josh Bronson) 2018-12-28 19:03:40 +01:00
signal.rst bpo-35568: add 'raise_signal' function (GH-11335) 2019-01-08 01:58:25 -08:00
site.rst bpo-35054: Add yet more index entries for symbols. (GH-10121) 2018-10-28 13:41:26 +02:00
smtpd.rst bpo-25008: Deprecate smtpd and point to aiosmtpd (#274) 2017-02-24 20:05:59 +01:00
smtplib.rst bpo-35506: Remove redundant and incorrect links from keywords. (GH-11174) 2018-12-19 08:09:46 +02:00
sndhdr.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
socket.rst bpo-11233: Create availability directive for documentation (GH-9692) 2018-10-12 16:55:20 +02:00
socketserver.rst bpo-35506: Remove redundant and incorrect links from keywords. (GH-11174) 2018-12-19 08:09:46 +02:00
spwd.rst Merge Issue #22558. 2016-06-11 15:06:08 -04:00
sqlite3.rst bpo-35054: Add yet more index entries for symbols. (GH-10121) 2018-10-28 13:41:26 +02:00
ssl.rst bpo-35044, doc: Use the :exc: role for the exceptions (GH-10037) 2018-10-26 12:52:11 +02:00
stat.rst bpo-35110: Fix unintentional spaces around hyphens and dashes. (GH-10231) 2018-10-31 02:26:06 +02:00
statistics.rst bpo-33573: docs to suggest median() alternatives for non-numeric data (GH-7587) 2018-06-25 14:04:01 +03:00
stdtypes.rst Fix minor grammatical mistakes in reversed(dict) doc (GH-10997) 2018-12-23 23:05:23 -08:00
string.rst Correct grammar mistakes in string.rst. (GH-9752) 2018-11-07 19:24:56 +02:00
stringprep.rst bpo-33641: Convert RFC references into links. (GH-7103) 2018-05-31 07:39:00 +03:00
struct.rst bpo-35054: Add yet more index entries for symbols. (GH-10121) 2018-10-28 13:41:26 +02:00
subprocess.rst bpo-31450: Remove documentation mentioning that subprocess's child_traceback is available with the parent process (GH-11422) 2019-01-03 11:53:56 -08:00
sunau.rst bpo-31985: Deprecate openfp in aifc, sunau, and wave (#4344) 2017-11-10 11:38:25 -05:00
superseded.rst
symbol.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
symtable.rst bpo-34983: Expose symtable.Symbol.is_nonlocal() in the symtable module (GH-9872) 2018-10-20 01:46:00 +01:00
sys.rst Fixed missing colun in library/sys.po (GH-11153) 2018-12-14 03:28:44 -08:00
sysconfig.rst Correct a couple of unbalanced parenthesis. (GH-10779) 2018-12-05 21:45:30 +02:00
syslog.rst Fix "Python" casing in a few places (GH-9001) 2018-09-14 10:13:09 -07:00
tabnanny.rst fix function name in tabnanny documentation (GH-759) 2017-03-22 14:53:57 +08:00
tarfile.rst bpo-30693: zip+tarfile: sort directory listing (#2263) 2018-01-31 11:17:10 +01:00
telnetlib.rst bpo-35506: Remove redundant and incorrect links from keywords. (GH-11174) 2018-12-19 08:09:46 +02:00
tempfile.rst bpo-35506: Remove redundant and incorrect links from keywords. (GH-11174) 2018-12-19 08:09:46 +02:00
termios.rst bpo-35110: Fix unintentional spaces around hyphens and dashes. (GH-10231) 2018-10-31 02:26:06 +02:00
test.rst bpo-35042: Use the :pep: role where a PEP is specified (#10036) 2018-10-26 15:58:26 -07:00
text.rst
textwrap.rst bpo-9842: Add references for using "..." as a placeholder to the index. (GH-10330) 2018-11-20 19:26:09 +02:00
threading.rst bpo-35506: Remove redundant and incorrect links from keywords. (GH-11174) 2018-12-19 08:09:46 +02:00
time.rst bpo-35716: Update time.CLOCK_MONOTONIC_RAW doc (GH-11517) 2019-01-11 14:19:57 +01:00
timeit.rst bpo-35738: Update the example for timer.Timer.repeat(). (GH-11559) 2019-01-15 12:29:21 +02:00
tk.rst
tkinter.rst bpo-35086: Fix tkinter example "A Simple Hello World Program". (GH-10160) 2018-10-30 16:56:07 +02:00
tkinter.scrolledtext.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
tkinter.tix.rst bpo-23156: Remove obsolete tix install directions (GH-11595) 2019-01-17 19:00:51 -05:00
tkinter.ttk.rst bpo-32585: Add tkinter.ttk.Spinbox. (#5221) 2018-02-09 02:03:55 +02:00
token-list.inc bpo-35224: PEP 572 Implementation (#10497) 2019-01-24 16:49:56 -07:00
token.rst bpo-30455: Generate all token related code and docs from Grammar/Tokens. (GH-10370) 2018-12-22 11:18:40 +02:00
tokenize.rst bpo-12486: Document tokenize.generate_tokens() as public API (#6957) 2018-06-05 10:26:39 -07:00
trace.rst bpo-29455: Mention coverage.py in trace module documentation (#261) 2017-03-03 12:42:04 -08:00
traceback.rst bpo-35054: Add yet more index entries for symbols. (GH-10121) 2018-10-28 13:41:26 +02:00
tracemalloc.rst bpo-32121: Add most_recent_first parameter to tracemalloc.Traceback.format (#4534) 2017-11-30 00:05:07 +01:00
tty.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
tulip_coro.dia
tulip_coro.png bpo-30660: Doc: Optimize PNG files by optipng (GH-8032) 2018-07-01 16:02:52 +09:00
turtle-star.pdf
turtle-star.png bpo-30660: Doc: Optimize PNG files by optipng (GH-8032) 2018-07-01 16:02:52 +09:00
turtle-star.ps
turtle.rst bpo-35250: Correct argument name "num" -> "btn" in turtle docs. (GH-10565) 2018-11-16 15:28:51 +02:00
types.rst Minor grammar improvement in types.rst (GH-11308) 2018-12-24 15:56:05 -08:00
typing.rst bpo-35631: Improve typing docs wrt abstract/concrete collection types (GH-11396) 2019-01-04 14:14:32 +00:00
undoc.rst Issue #27355: Removed support for Windows CE. It was never finished, 2016-09-05 15:11:23 -07:00
unicodedata.rst closes bpo-32285: Add unicodedata.is_normalized. (GH-4806) 2018-11-04 15:58:24 -08:00
unittest.mock-examples.rst bpo-35226: Fix equality for nested unittest.mock.call objects. (#10555) 2018-12-03 21:31:37 +00:00
unittest.mock.rst Add example to the documentation for calling unittest.mock.patch with create=True (GH-11056) 2019-01-09 21:43:24 +00:00
unittest.rst Clarify expectedFailure in the unittest docs. (#10953) 2018-12-06 12:56:24 -08:00
unix.rst
urllib.error.rst bpo-33641: Convert RFC references into links. (GH-7103) 2018-05-31 07:39:00 +03:00
urllib.parse.rst bpo-35116, urllib.parse: Document the new max_num_fields parameter (GH-10247) 2018-10-30 21:30:19 +01:00
urllib.request.rst bpo-35054: Add more index entries for symbols. (GH-10064) 2018-10-26 09:00:49 +03:00
urllib.robotparser.rst bpo-21475: Support the Sitemap extension in robotparser (GH-6883) 2018-05-16 10:52:07 -04:00
urllib.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
uu.rst bpo-30103: Allow Uuencode in Python using backtick as zero instead of space (#1326) 2017-05-03 11:16:21 +08:00
uuid.rst bpo-33640, uuid.UUID doc: document endian of bytes parameter (GH-7263) 2018-06-04 09:29:00 +02:00
venv.rst bpo-34977: Use venv redirector instead of original python.exe on Windows (GH-11029) 2018-12-10 08:11:21 -08:00
warnings.rst bpo-31975 (PEP 565): Show DeprecationWarning in __main__ (GH-4458) 2018-01-08 12:45:02 +10:00
wave.rst bpo-35506: Remove redundant and incorrect links from keywords. (GH-11174) 2018-12-19 08:09:46 +02:00
weakref.rst bpo-27200: Fix pathlib, ssl, turtle and weakref doctests (GH-616) 2017-04-13 17:17:59 +03:00
webbrowser.rst bpo-24241: Add versionchanged directive to the documentation (#342) 2017-02-27 19:13:41 +03:00
windows.rst
winreg.rst bpo-35054: Add yet more index entries for symbols. (GH-10121) 2018-10-28 13:41:26 +02:00
winsound.rst Issue #25387: Check return value of winsound.MessageBeep 2016-09-05 17:32:28 -05:00
wsgiref.rst bpo-35042: Use the :pep: role where a PEP is specified (#10036) 2018-10-26 15:58:26 -07:00
xdrlib.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
xml.dom.minidom.rst bpo-35506: Remove redundant and incorrect links from keywords. (GH-11174) 2018-12-19 08:09:46 +02:00
xml.dom.pulldom.rst Fix Python version since which external enities are not resolved by default. (GH-11237) 2018-12-19 15:29:04 +02:00
xml.dom.rst bpo-25910: Link redirections in docs (#1933) 2018-01-20 01:25:37 +01:00
xml.etree.elementtree.rst bpo-34160: Preserve user specified order of Element attributes (GH-10163) 2018-10-28 11:18:22 -07:00
xml.rst Fix Python version since which external enities are not resolved by default. (GH-11237) 2018-12-19 15:29:04 +02:00
xml.sax.handler.rst Issue #22558: Add remaining doc links to source code for Python-coded modules. 2016-06-11 15:02:54 -04:00
xml.sax.reader.rst Issue #19795: Mark up None as literal text. 2016-10-19 16:29:26 +03:00
xml.sax.rst Fix Python version since which external enities are not resolved by default. (GH-11237) 2018-12-19 15:29:04 +02:00
xml.sax.utils.rst Issue #19795: Mark up True and False as literal text instead of bold. 2016-10-19 16:43:42 +03:00
xmlrpc.client.rst bpo-33859: Fix spelling mistakes in docs. (GH-7691) 2018-06-16 08:08:31 +03:00
xmlrpc.rst
xmlrpc.server.rst bpo-7769: enable xmlrpc.server.SimpleXMLRPCDispatcher.register_function used as decorator (GH-231) 2017-02-28 17:12:52 +08:00
zipapp.rst bpo-34906: Doc: Fix typos (GH-9712) 2018-10-05 16:17:18 +02:00
zipfile.rst bpo-35506: Remove redundant and incorrect links from keywords. (GH-11174) 2018-12-19 08:09:46 +02:00
zipimport.rst bpo-35042: Use the :pep: role where a PEP is specified (#10036) 2018-10-26 15:58:26 -07:00
zlib.rst bpo-25007: Add copy protocol support to zlib compressors and decompressors (GH-7940) 2018-06-27 21:04:51 +03:00