summaryrefslogtreecommitdiffstats
path: root/Doc/library
Commit message (Collapse)AuthorAgeFilesLines
* Update logging.config.rst (GH-24630)takahashi2021-02-261-1/+1
| | | | | # a typo fix Automerge-Triggered-By: GH:vsajip
* bpo-43293: Doc: move note about GIL to top of threading module (GH-24622)Guanzhong Chen2021-02-241-13/+13
| | | | | | | | The note about the GIL was buried pretty deep in the threading documentation, and this made it hard for first time users to discover why their attempts at using threading to parallelizing their application did not work. In this commit, the note is moved to the top of the module documention for visibility.
* bpo-43283: Add IDLE doc paragraph about print speed (GH-24615)Terry Jan Reedy2021-02-241-0/+9
| | | | | | Printing to IDLE's Shell is often slower than printing to a system terminal, but it can be made faster by pre-formatting a single string before printing.
* bpo-23882: Doc: Clarify unittest discovery document (GH-21560)Inada Naoki2021-02-221-6/+12
| | | | | | | | Unittest discovery support namespace package as start directory. But it doesn't find namespace package in the start directory automatically. Otherwise, unittest discovery search into unexpected directories like `vendor/` or `node_modules/`.
* bpo-43283: Rearrange some IDLE doc paragraphs. (GH-24604)Terry Jan Reedy2021-02-211-14/+15
| | | | | In the Running User Code section, gather together paragraphs about two processes and the sys.stdstream replacements, preparing to add another.
* Fix typo in dis module doc (GH-24509)Irit Katriel2021-02-201-1/+1
|
* bpo-42960: Add resource.RLIMIT_KQUEUES constant from FreeBSD (GH-24251)David CARLIER2021-02-181-0/+8
|
* bpo-42990: Add __builtins__ attribute to functions (GH-24559)Victor Stinner2021-02-181-0/+6
| | | | | | Expose the new PyFunctionObject.func_builtins member in Python as a new __builtins__ attribute on functions. Document also the behavior change in What's New in Python 3.10.
* Add a warning block around the get_referrers() documentation (GH-24511)Pablo Galindo2021-02-151-4/+5
|
* bpo-42967: Fix urllib.parse docs and make logic clearer (GH-24536)Ken Jin2021-02-151-6/+12
|
* bpo-42967: only use '&' as a query string separator (#24297)Adam Goldschmidt2021-02-142-5/+20
| | | | | | | | | | | bpo-42967: [security] Address a web cache-poisoning issue reported in urllib.parse.parse_qsl(). urllib.parse will only us "&" as query string separator by default instead of both ";" and "&" as allowed in earlier versions. An optional argument seperator with default value "&" is added to specify the separator. Co-authored-by: Éric Araujo <merwok@netwok.org> Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com> Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com> Co-authored-by: Éric Araujo <merwok@netwok.org>
* bpo-43200: Fix link to shutil.copy() in the shutil doc (GH-24505)Zackery Spytz2021-02-131-2/+3
| | | Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
* bpo-43172: readline now passes its tests when built against libedit (GH-24499)Gregory P. Smith2021-02-121-1/+3
| | | | | | | bpo-43172: readline now passes its tests when built against libedit. Existing irreconcilable API differences remain in readline.get_begidx and readline.get_endidx behavior based on libreadline vs libedit use. A note about that has been documented.
* bpo-41824: Add versionadded for typing.ForwardRef docs (#24224)Ken Jin2021-02-091-0/+2
|
* Improve docs of PEP 604 Union (#24301)Ken Jin2021-02-092-18/+13
|
* bpo-43147: Remove archaic terminology. (GH-24462)Raymond Hettinger2021-02-081-6/+5
|
* bpo-16781: In 'exec' doc, add 'nonlocal' to 'yield' and 'return' (GH-2446)Terry Jan Reedy2021-02-071-1/+2
| | | These 3 statements cannot be used at module scope -- nor in exec with one namespace.
* bpo-43106: Add os.O_EVTONLY/O_FSYNC/O_SYMLINK/O_NOFOLLOW_ANY (GH-24428)Dong-hee Na2021-02-031-0/+10
|
* bpo-8264: Document hasattr and getattr behavior for private attributes ↵Ken Jin2021-02-021-0/+14
| | | | | | | | (GH-23513) Clarify ``getattr`` and ``setattr`` requirements for accessing name-mangled attributes Co-Authored-By: Catalin Iacob <iacobcatalin@gmail.com>
* bpo-43059: Remove reference to legacy external sqlite3 repository (GH-24364)L2021-01-311-4/+0
|
* bpo-43047: logging.config formatters documentation update (GH-24358)Ian Wienand2021-01-301-19/+23
| | | | | | | | | | | | | | | | | | | | | | | | The documentation for some parts of the logging.config formatters has fallen behind the code. For example, the dictionary-schema section does not list the "class" attribute, however it is discussed in the file/ini discussion; and neither references the style argument which has been added. This modifies the dictionary-schema formatters documentation to list the keys available and overall makes it clearer these are passed to create a logging.Formatter object. The logging.Formatter documentation describes the default values of format/datefmt and the various formatting options. Since we have now more clearly described how the configuration is created via this type of object, we remove the discussion in this document to avoid duplication and rely on users reading the referenced logging.Formatter documenation directly for such details. Instead of duplicating the discussion for the two config types, the file/ini section is modified to link back to the dictionary-schema discussion, making it clear the same arguments are accepted. Automerge-Triggered-By: GH:vsajip
* bpo-41282: Add deprecation warning and docs for distutils (PEP 632) (GH-24355)Steve Dower2021-01-291-0/+5
|
* Fixing typos in turtle.rst (GH-24376)Jules Lasne2021-01-291-6/+6
| | | Automerge-Triggered-By: GH:JulienPalard
* Fixed typo in turtle.rst (GH-24371)Jules Lasne2021-01-291-1/+1
| | | | | Found it while translating it to french 🤷 Automerge-Triggered-By: GH:JulienPalard
* bpo-42955: Remove sub-packages from sys.stdlib_module_names (GH-24353)Victor Stinner2021-01-271-3/+4
|
* bpo-43008: Make IDLE respect sys.excepthook (GH-24302)Ken2021-01-261-1/+1
| | | Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
* bpo-33387: update documentation for exception handling opcode changes (GH-24334)Irit Katriel2021-01-261-1/+1
| | | | | * bpo-33387: remove obsolete comment * bpo-33387: update SETUP_WITH opcode documentation
* Fix minor typo in the rest format in the enum docs (GH-24335)Pablo Galindo2021-01-251-1/+1
|
* bpo-38250: [Enum] single-bit flags are canonical (GH-24215)Ethan Furman2021-01-251-27/+135
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Flag members are now divided by one-bit verses multi-bit, with multi-bit being treated as aliases. Iterating over a flag only returns the contained single-bit flags. Iterating, repr(), and str() show members in definition order. When constructing combined-member flags, any extra integer values are either discarded (CONFORM), turned into ints (EJECT) or treated as errors (STRICT). Flag classes can specify which of those three behaviors is desired: >>> class Test(Flag, boundary=CONFORM): ... ONE = 1 ... TWO = 2 ... >>> Test(5) <Test.ONE: 1> Besides the three above behaviors, there is also KEEP, which should not be used unless necessary -- for example, _convert_ specifies KEEP as there are flag sets in the stdlib that are incomplete and/or inconsistent (e.g. ssl.Options). KEEP will, as the name suggests, keep all bits; however, iterating over a flag with extra bits will only return the canonical flags contained, not the extra bits. Iteration is now in member definition order. If member definition order matches increasing value order, then a more efficient method of flag decomposition is used; otherwise, sort() is called on the results of that method to get definition order. ``re`` module: repr() has been modified to support as closely as possible its previous output; the big difference is that inverted flags cannot be output as before because the inversion operation now always returns the comparable positive result; i.e. re.A|re.I|re.M|re.S is ~(re.L|re.U|re.S|re.T|re.DEBUG) in both of the above terms, the ``value`` is 282. re's tests have been updated to reflect the modifications to repr().
* bpo-42955: Rename module_names to sys.stdlib_module_names (GH-24332)Victor Stinner2021-01-251-19/+19
| | | | * Rename _Py_module_names to _Py_stdlib_module_names. * Rename Python/module_names.h to Python/stdlib_module_names.h.
* bpo-37319: Improve documentation, code and tests of randrange. (GH-19112)Serhiy Storchaka2021-01-251-2/+3
|
* bpo-42843: Keep Sphinx 1.8 and Sphinx 2 compatibility (GH-24282)Julien Palard2021-01-259-47/+27
|
* bpo-42955: Fix sys.module_names doc (GH-24329)Victor Stinner2021-01-251-1/+1
| | | Replace versionchanged markup with versionadded.
* bpo-42955: Add sys.modules_names (GH-24238)Victor Stinner2021-01-251-1/+21
| | | | Add sys.module_names, containing the list of the standard library module names.
* bpo-27772: Make preceding width with 0 valid in string format. (GH-11270)Serhiy Storchaka2021-01-251-2/+6
| | | | Previously it was an error with confusing error message.
* bpo-42996: Update a reference to PKCS #5 in hashlib docs to version 2.1 ↵Illia Volochii2021-01-221-2/+2
| | | | | | | (GH-24289) RFC 8018 superseded RFC 8018. Automerge-Triggered-By: GH:tiran
* bpo-40304: Correct type(name, bases, dict) doc (GH-19553)Борис Верховский2021-01-221-8/+9
| | | | | Co-authored-by: Éric Araujo <merwok@netwok.org> Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu> Co-authored-by: Tal Einat <532281+taleinat@users.noreply.github.com>
* bpo-42856: Add --with-wheel-pkg-dir=PATH configure option (GH-24210)Victor Stinner2021-01-201-3/+3
| | | | | | | | | | | | | Add --with-wheel-pkg-dir=PATH option to the ./configure script. If specified, the ensurepip module looks for setuptools and pip wheel packages in this directory: if both are present, these wheel packages are used instead of ensurepip bundled wheel packages. Some Linux distribution packaging policies recommend against bundling dependencies. For example, Fedora installs wheel packages in the /usr/share/python-wheels/ directory and don't install the ensurepip._bundled package. ensurepip: Remove unused runpy import.
* Fix typos in unittest documentation (GH-24194)Conchylicultor2021-01-201-3/+3
| | | | * addCleanupClass -> addClassCleanup * doCleanupsClass -> doClassCleanups
* Doc: os.path.abspath and Path.resolve are also different (GH-23276)Hong Xu2021-01-201-5/+12
|
* bpo-42877: add the 'compact' param to TracebackException's __init__ (#24179)Irit Katriel2021-01-151-1/+9
| | | Use it to reduce the time and memory taken up by several of traceback's module-level functions.
* bpo-39273: Expose BUTTON5_* constants in the curses module if available ↵Zackery Spytz2021-01-141-1/+5
| | | | (GH-17996)
* bpo-37324: Remove ABC aliases from collections (GH-23754)Hugo van Kemenade2021-01-121-5/+0
| | | | Remove deprecated aliases to Abstract Base Classes from the collections module.
* Fix various ParamSpec errors in typing (GH-24176)Ken Jin2021-01-111-2/+2
| | | | | 1. ParamSpec -> TypeVar for ``typing.Concatenate`` 2. ParamSpec's call signature should align with its documentation. Noticed in GH-24169
* Fix a typo in docs for typing.Concatenate (#24169)Johan Dahlin2021-01-081-1/+1
| | | Return param spec should be R, not T
* bpo-42783: Documentation for asyncio.sleep(0) (#24002)Simon Willison2021-01-071-0/+4
| | | Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>
* bpo-42811: Update importlib.utils.resolve_name() docs to use __spec__.parent ↵Yair Frid2021-01-061-1/+1
| | | | | (GH-24100) Automerge-Triggered-By: GH:brettcannon
* bpo-14014: Clarify StreamWriter.reset() documentation (GH-13716)Berker Peksag2021-01-061-2/+2
|
* bpo-38413: Remove outdated section about multithreading in sqlite3 (GH-23159)Vladimir2021-01-061-13/+0
|
* bpo-40810: Require SQLite 3.7.15 (GH-24106)Erlend Egeberg Aasland2021-01-061-1/+1
|