summaryrefslogtreecommitdiffstats
path: root/Doc/library
Commit message (Collapse)AuthorAgeFilesLines
* bpo-36270: Doc: add link to traceback object reference (GH-13119)Björn Meier2019-09-111-1/+1
|
* Doc: recursive glob ** follows symlinks to directories (GH-12918)Marc2019-09-111-2/+3
|
* bpo-28724: Add methods send_fds and recv_fds to the socket module (GH-12889)Joannah Nanjekye2019-09-111-0/+23
| | | | | | | The socket module now has the socket.send_fds() and socket.recv.fds() functions. Contributed by Joannah Nanjekye, Shinya Okano (original patch) and Victor Stinner. Co-Authored-By: Victor Stinner <vstinner@redhat.com>
* Doc: Fix missing negation. (GH-14640)Julien Palard2019-09-111-2/+2
| | | | | | | Reported by Hug Capella on docs@. Automerge-Triggered-By: @matrixise
* bpo-36182: Update pathlib.Path.write_text() docs (GH-12161)Lysandros Nikolaou2019-09-111-0/+3
| | | with the case of an existing file
* bpo-36260: Add pitfalls to zipfile module documentation (#13378)JunWei Song2019-09-111-0/+40
| | | | | | | | | | | | | | | | * bpo-36260: Add pitfalls to zipfile module documentation We saw vulnerability warning description (including zip bomb) in Doc/library/xml.rst file. This gave us the idea of documentation improvement. So, we moved a little bit forward :P And the doc patch can be found (pr). * fix trailing whitespace * 📜🤖 Added by blurb_it. * Reformat text for consistency.
* Improve the io module documentation (GH-15099)Géry Ogam2019-09-111-55/+61
| | | | | | | | | | * Update io.rst * Apply suggestions from code review Co-Authored-By: Ashwin Ramaswami <aramaswamis@gmail.com> Co-Authored-By: Carol Willing <carolcode@willingconsulting.com>
* Update ftplib.all_errors documentation to match code (#15026)Andrew Scheller2019-09-111-1/+1
| | | The documentation doesn't mention the `EOFError` that https://github.com/python/cpython/blob/master/Lib/ftplib.py#L66 includes
* bpo-38096: Clean up the "struct sequence" / "named tuple" docs (GH-15895)Raymond Hettinger2019-09-111-6/+6
| | | | | | | | * bpo-38096: Clean up the "struct sequence" / "named tuple" docs * Fix remaining occurrences of "struct sequence" * Repair a user visible docstring
* bpo-37651: Document CancelledError is now a subclass of BaseException (GH-15950)Xtreak2019-09-111-19/+2
| | | | | | | https://bugs.python.org/issue37651 Automerge-Triggered-By: @1st1
* bpo-33187: Document ElementInclude (XInclude) support in ElementTree (GH-8861)Anjali Bansal2019-09-111-0/+89
|
* bpo-23460: Fix documentation for decimal string :g formatting (GH-11850)Brennan D Baraban2019-09-111-3/+4
|
* bpo-37488 : Document a warning for datetime.utcnow() and utcfromtimestamp() ↵Joannah Nanjekye2019-09-111-16/+34
| | | | | | | | | (GH-15773) https://bugs.python.org/issue37488 Automerge-Triggered-By: @pganssle
* bpo-31163: Added return values to pathlib.Path instance's rename and replace ↵hui shang2019-09-111-5/+14
| | | | | methods. (GH-13582) * bpo-31163: Added return values to pathlib.Path instance's rename and replace methods.
* bpo-33944: note about the intended use of code in .pth files (GH-10131)native-api2019-09-111-0/+13
| | | https://bugs.python.org/issue33944
* bpo-35640: Allow passing PathLike arguments to SimpleHTTPRequestHandler ↵Géry Ogam2019-09-111-0/+3
| | | | (GH-11398)
* Doc: Use walrus operator in example. (GH-15934)Julien Palard2019-09-111-4/+1
|
* bpo-35649: update http client example (GH-11441)Ashwin Ramaswami2019-09-111-2/+5
|
* Minor ReST formatting fixes in subprocess docs (#14876)Tim Hoffmann2019-09-111-4/+4
|
* bpo-35603: Add a note on difflib table header interpreted as HTML (GH-11439)Xtreak2019-09-111-0/+4
|
* bpo-35168: Make shlex.punctuation_chars read-only (#11631)Alex2019-09-111-3/+5
| | | | | | | | * bpo-35168: Documentation about shlex.punctuation_chars now states that it should be set in __init__.py * bpo-35168: Convert shlex.punctuation_chars to read-only property * Add NEWS.d entry
* bpo-32972: Document IsolatedAsyncioTestCase of unittest module (GH-15878)Xtreak2019-09-111-0/+76
| | | | | | | | | | | * Document `unittest.IsolatedAsyncioTestCase` API * Add a simple example with respect to order of evaluation of setup and teardown calls. https://bugs.python.org/issue32972 Automerge-Triggered-By: @asvetlov
* bpo-25810: Clarify eval() docs, it does not keywords (GH-15173)smokephil2019-09-111-1/+1
|
* bpo-37585: Add clarification regarding comparing dict.values() (GH-14954)Kyle Stanley2019-09-111-0/+8
|
* bpo-16438: Doc: confusing text regarding numeric precedence corrected (GH-10521)Anjali2019-09-111-3/+2
|
* Overhaul datetime documentation (GH-13410)Brad2019-09-111-476/+729
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This is a restructuring of the datetime documentation to hopefully make them more user-friendly and approachable to new users without losing any of the detail. Changes include: - Creating dedicated subsections for some concepts such as: - "Constants" - "Naive vs Aware" - "Determining if an Object is Aware" - Give 'naive vs aware' its own subsection - Give 'constants' their own subsection - Overhauling the strftime-strptime section by: - Breaking it into logical, linkable, and digestable parts - Adding a high-level comparison table - Moving the technical detail to bottom: readers come to this section primarily to remind themselves to things: - How do I write the format code for X? - strptime/strftime: which one is which again? - Touching up fromisoformat + isoformat sections by: - Revising fromisoformat + isoformat for date, time, and datetime - Adding basic examples - Enforcing consistency about putting formats (i.e. ``HH:MM``) in double backticks. This was previously done in some places but not all - Putting long 'supported formats', on their own line to improve readability - Moving the 'seealso' section to the top and add a link to dateutil Rationale: This doesn't really belong nested under the 'constants' section. Let readers know right away that datetime is one of several related tools. - Moving common features of several types into one place: Previously, each type went out of its way to note separately that it was hashable and picklable. These can be brought into one single place that is more prominent. - Reducing some verbose explanations to improve readability - Breaking up long paragraphs into digestable chunks - Displaying longer "equivalent to" examples, as short code blocks - Using the dot notation for datetime/time classes: Use :class:`.time` and :class:`.datetime` rather than :class:`time` and :class:`datetime`; otherwise, the generated links will route to the respective modules, not classes. - Rewording the tzinfo class description The top paragraph should get straight to the point of telling the reader what subclasses of tzinfo _do_. Previously, that was hidden in a later paragraph. - Adding a note on .today() versus .now() - Rearranging and expanding example blocks, including: - Moved long, multiline inline examples to standalone examples - Simplified the example block for timedelta arithmetic: - Broke the example into two logical sections: 1. normalization/parameter 'merging' 2. timedelta arithmetic - Reduced the complexity of the some of the examples. Show reasonable, real-world uses cases that are easy to follow along with and progres in difficult slightly. - Broke up the example sections for date and datetime sections by putting the easy examples first, progressing to more esoteric situations and breaking it up into logical sections based on what the methods are doing at a high level. - Simplified the KabulTz example: - Put the class definition itself into a non-REPL block since there is no interactive output involved there - Briefly explained what's happening before launching into the code - Broke the example section into visually separate chunks - Various whitespace, formatting, style and grammar fixes including: - Consistently using backctics for 'date_string' formats - Consistently using one space after periods. - Consistently using bold for vocab terms - Consistently using italics when referring to params: See https://devguide.python.org/documenting/#id4 - Using '::' to lead into code blocks Per https://devguide.python.org/documenting/#source-code, this will let the reader use the 'expand/collapse' top-right button for REPL blocks to hide or show the prompt. - Using consistent captialization schemes - Removing use of the default role - Put 'example' blocks in Markdown subsections This is a combination of 66 commits. See bpo-36960: https://bugs.python.org/issue36960
* bpo-38034: Fix typo in logging.handlers.rst (GH-15708)wwuck2019-09-111-1/+1
|
* bpo-37574: Mention helper functions for find_spec documentation (GH-14739)jdkandersson2019-09-101-1/+4
|
* bpo-33602: Doc: Remove set and queue references from Data Types (GH-7055)Andre Delfino2019-09-101-3/+4
|
* Correct minor grammatical mistake in open docs (GH-15865)Andre Delfino2019-09-101-2/+2
|
* bpo-38086: Sync importlib.metadata with importlib_metadata 0.21. (GH-15840)Jason R. Coombs2019-09-101-14/+16
| | | https://gitlab.com/python-devs/importlib_metadata/-/tags/0.21
* Fix typo in ssl.RAND_bytes documentation (GH-14791)Zach Thompson2019-09-101-1/+1
| | | | | It looks like "cryptographically strong" is the preferred phrase from the surrounding documentation. Automerge-Triggered-By: @tiran
* Note regarding + mode truncation applies to both text and binary mode (#11314)Andre Delfino2019-09-101-3/+3
| | | | | | | | * Improve doc on open's mode + * Improve wording * Address comment from Rémi
* bpo-21018: added missing documentation about escaping characters for ↵Arun Persaud2019-09-101-0/+5
| | | | | configparser (GH-6137) Document how $ and % can be escaped in configparser.
* bpo-36373: Deprecate explicit loop parameter in all public asyncio APIs ↵Emmanuel Arias2019-09-101-0/+4
| | | | | | | | | | | | | | | [queue] (GH-13950) This PR deprecate explicit loop parameters in all public asyncio APIs This issues is split to be easier to review. fourth step: queue.py https://bugs.python.org/issue36373
* bpo-36373: Deprecate explicit loop parameter in all public asyncio APIs ↵Emmanuel Arias2019-09-101-0/+18
| | | | | | | | | | | | | | | [locks] (GH-13920) This PR deprecate explicit loop parameters in all public asyncio APIs This issues is split to be easier to review. Third step: locks.py https://bugs.python.org/issue36373
* bpo-37052: Add examples for mocking async iterators and context managers ↵Xtreak2019-09-101-0/+39
| | | | | | | | (GH-14660) Add examples for mocking asynchronous iterators and asynchronous context managers. https://bugs.python.org/issue37052
* bpo-25237: Documentation for tkinter modules (GH-1870)Nikhil2019-09-109-15/+478
|
* bpo-38049: Add command-line interface for the ast module. (GH-15724)Serhiy Storchaka2019-09-091-0/+36
|
* bpo-37383: Updates docs to reflect AsyncMock call_count after await. (#15761)Lisa Roach2019-09-091-0/+14
| | | | | | | | | | * bpo-351428: Updates documentation to reflect AsyncMock call_count after await. * Adds skip and fixes warning. * Removes extra >>>. * Adds ... in front of await mock().
* bpo-36502: Update link to UAX #44, the Unicode doc on the UCD. (GH-15301)Greg Price2019-09-091-1/+1
| | | | | | | The link we have points to the version from Unicode 6.0.0, dated 2010. There have been numerous updates to it since then: https://www.unicode.org/reports/tr44/#Modifications Change the link to one that points to the current version. Also, use HTTPS.
* bpo-37995: Add an option to ast.dump() to produce a multiline output. (GH-15631)Serhiy Storchaka2019-09-091-1/+12
|
* bpo-35803: Document and test dir=PathLike for tempfile (GH-11644)Anthony Sottile2019-09-091-0/+6
| | | Co-Authored-By: Ammar Askar <ammar_askar@hotmail.com>
* Clarify that shutil's copy functions can accept path-like values (GH-15141)Boris Verhovsky2019-09-091-3/+5
|
* Fix docs bz.open default mode (GH-15100)Richard Sanger2019-09-091-1/+1
| | | bz2.open()'s default mode is rb, not r
* docs: Add references to AsyncMock in unittest.mock.patch (#13681)Mario Corchero2019-09-091-4/+16
| | | | Update the docs as patch can now return an AsyncMock if the patched object is an async function.
* bpo-38053 Update documentation for plistlib (GH-15727)Jon Janzen2019-09-091-4/+18
| | | | | | * Update documentation for plistlib - Update "Mac OS X" to "Apple" since plists are used more widely than just macOS - Re-add the UID class documentation (oops, removed in GH-15615)
* bpo-37662: Documented venv.EnvBuilder.upgrade_dependencies(). (GH-15768)Vinay Sajip2019-09-091-0/+8
|
* logging.Formatter docs: Add missing `validate` parameter, clarify `style` ↵David Röthlisberger2019-09-091-3/+6
| | | | parameter (GH-15222)
* bpo-34410: Fix a crash in the tee iterator when re-enter it. (GH-15625)Serhiy Storchaka2019-09-091-0/+4
| | | | RuntimeError is now raised in this case.
generated by cgit v0.12 at 2025-03-04 21:51:52 (GMT)