summaryrefslogtreecommitdiffstats
path: root/Doc
Commit message (Collapse)AuthorAgeFilesLines
...
* gh-60712: Include the "object" type in the lists of documented types (GH-103036)Furkan Onder2024-10-302-18/+41
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * add test for the predefined object's attributes * Include the "object" type in the lists of documented types * remove 'or' from augment tuple * 📜🤖 Added by blurb_it. * Add cross-reference to news Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM> * Fix format for the function parameter Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM> * Add space Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM> * add reference for the 'object' Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM> * add reference for NotImplemented Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM> * Change ref:`string <textseq>` as class:`str` Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM> * remove hyphen from `newly-created` * Update Doc/reference/datamodel.rst 'dictionaries' to 'dict' Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM> * Update predefined attribute types in testPredefinedAttrs * Change `universal type` as `top type` * Don't mention about the top type * Update the description of richcmpfuncs * Update Doc/library/stdtypes.rst Co-authored-by: Éric <merwok@netwok.org> * Revert: Hierarchy Section in Data Model Documentation * Revert to original explanations of __new__ and __init__ methods in datamodel.rst for improved clarity. * Update Doc/reference/datamodel.rst Co-authored-by: Éric <merwok@netwok.org> * Remove blank line Co-authored-by: Éric <merwok@netwok.org> * Use ref:`str <textseq>` instead of :class:`str Co-authored-by: Éric <merwok@netwok.org> * Revert changes the description of Other Built-in Types in stdtypes.rst * Update Doc/reference/datamodel.rst Co-authored-by: Éric <merwok@netwok.org> --------- Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com> Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM> Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu> Co-authored-by: Éric <merwok@netwok.org> Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
* Fix incorrect indentation in importlib.metadata.rst (GH-126189)Rafael Fontenelle2024-10-301-3/+3
|
* gh-85583: Add f-string index in tutorial/inputoutput.rst (GH-21681)amaajemyfren2024-10-301-0/+7
| | | | | | | | | | | | * bpo-41411 fstring index in tutorial/inputoutput To assist in searching for fstrings I have added an index * Add newline --------- Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
* gh-125669: Do not run `-ugui` tests by default on `make test` (#125730)sobolevn2024-10-301-1/+9
| | | Adds `make ci` target for use in CI and keeping `make test` for the local development.
* gh-126072: do not add `None` to `co_consts` if there is no docstring (GH-126101)Xuanteng Huang2024-10-302-3/+11
|
* gh-126071: Improve formatting of the argparse documentation (GH-126073)Serhiy Storchaka2024-10-301-65/+72
| | | | | | | | | * Use appropriate roles for ArgumentParser, Action, etc. * Remove superfluous repeated links. * Explicitly document signatures and add index entries for some methods and classes. * Make it more clear that some parameters are keyword-only. * Fix some minor errors.
* gh-118633: Add warning regarding the unsafe usage of eval and exec (GH-118437)Daniel Ruf2024-10-301-0/+10
| | | | | | | | | | | | | | | | | | | | | | * Add warning regarding the unsafe usage of eval * Add warning regarding the unsafe usage of exec * Move warning under parameters table * Use suggested shorter text Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> * Use suggested shorter text Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com> * Improve wording as suggested --------- Co-authored-by: Kirill Podoprigora <kirill.bast9@mail.ru> Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* gh-58032: Docs: Sort argparse alphabetically (GH-125871)Hugo van Kemenade2024-10-302-21/+20
| | | Sort argparse alphabetically
* gh-124855: Don't allow the JIT and perf support to be active at the same ↵Pablo Galindo Salgado2024-10-301-0/+2
| | | | time (#124856)
* docs: restore an anchor to for/else (#126154)Ned Batchelder2024-10-301-0/+1
|
* Doc: Note that pydoc uses and prefers ``MANPAGER`` (#125362)Matthieu Ancellin2024-10-292-2/+4
| | | Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* bpo-41793: Fix an inaccuracy about reflected methods in datamodel docs ↵Wim Jeantine-Glenn2024-10-291-11/+14
| | | | | | | (GH-22257) * Qualifying that the right operand's type must be a *strict* subclass for the reflected method to take precedence avoids an edge case / counter-example when the types are actually equal. Co-authored-by: Ethan Furman <ethan@stoneleaf.us>
* gh-116938: Fix `dict.update` docstring and remove erraneous full stop from ↵Prometheus33752024-10-291-1/+1
| | | | | `dict` documentation (#125421) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* Add lightweight comments to conf.py and update docs readme (GH-126100)Carol Willing2024-10-292-14/+16
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * Update contributing contact info in readme * Add lightweight comments to improve docs workflow understanding * Apply code review suggestions from @hugovk Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> * Add code review suggestion from @AA-Turner Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> * Update Doc/conf.py Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> * Update Doc/conf.py Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> * Update Doc/conf.py Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> --------- Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* gh-122767: document "new style" formatting for complexes (GH-122848)Sergey B Kirpichev2024-10-291-5/+15
| | | Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
* GH-125837: Split `LOAD_CONST` into three. (GH-125972)Mark Shannon2024-10-292-8/+17
| | | | | | | | * Add LOAD_CONST_IMMORTAL opcode * Add LOAD_SMALL_INT opcode * Remove RETURN_CONST opcode
* gh-89762: Document strftime %G, %V, and %u format specifiers (#124572)RUANG (James Roy)2024-10-281-0/+13
|
* gh-126012: Add `__class_getitem__` to `memoryview` (#126013)Brian Schubert2024-10-272-0/+7
| | | | Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com> Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
* gh-125633: Add function `ispackage` to stdlib `inspect` (#125634)Zhikang Yan2024-10-272-0/+11
| | | | | --------- Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
* Fix a typo in ``Doc/tutorial/errors.rst`` exception output (#126001)Bogdana Vereha2024-10-261-1/+1
|
* gh-120313: amend documentation regarding `ctypes._CFuncPtr` (GH-120989)Bénédikt Tran2024-10-251-19/+29
| | | improve docs
* gh-121654: Add PyType_Freeze() function (#122457)Victor Stinner2024-10-253-0/+18
| | | Co-authored-by: Petr Viktorin <encukou@gmail.com>
* gh-84545: Clarify the 'extend' action documentation in argparse (GH-125870)Serhiy Storchaka2024-10-251-11/+15
|
* gh-125933: Add ARIA labels to select elements in the version switcher (#125934)Kerim Kabirov2024-10-241-2/+2
| | | Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
* gh-123930: Better error for "from imports" when script shadows module (#123929)Shantanu2024-10-241-2/+2
|
* gh-125909: Avoid a redirect when linking to the devguide (#125826)partev2024-10-241-1/+1
|
* gh-125665: Update turtledemo docstrings with correct file names (#125691)Wulian2024-10-231-3/+0
| | | | Co-authored-by: Wulian <xiguawulian@gmail.com> Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
* gh-125286: Share the Main Refchain With Legacy Interpreters (gh-125709)Eric Snow2024-10-233-1/+39
| | | | | They used to be shared, before 3.12. Returning to sharing them resolves a failure on Py_TRACE_REFS builds. Co-authored-by: Petr Viktorin <encukou@gmail.com>
* gh-58032: Deprecate the argparse.FileType type converter (GH-124664)Serhiy Storchaka2024-10-233-19/+33
|
* gh-80958: unittest: discovery support for namespace packages as start ↵Jacob Walls2024-10-232-21/+23
| | | | directory (#123820)
* Doc: Show object descriptions in the table of contents (#125757)Adam Turner2024-10-223-1/+9
|
* gh-124969: Make locale.nl_langinfo(locale.ALT_DIGITS) returning a string ↵Serhiy Storchaka2024-10-211-3/+4
| | | | | | | | again (GH-125774) This is a follow up of GH-124974. Only Glibc needed a fix. Now the returned value is a string consisting of semicolon-separated symbols on all Posix platforms.
* gh-125767: Fix pickling and copying of super objects (GH-125781)Serhiy Storchaka2024-10-212-0/+8
| | | | | | | | | Previously, copying a super object returned a copy of the instance invoking super(). Pickling a super object could pickle the instance invoking super() or fail, depending on its type and protocol. Now deep copying returns a new super object and pickling pickles the super object. Shallow copying returns the same super object.
* Doc: C API: Move `tp_dealloc` paragraph to `tp_dealloc` section (#125737)Richard Hansen2024-10-211-11/+13
| | | | | | | | | | | | It looks like commit 43cf44ddcce6b225f959ea2a53e4817244ca6054 (gh-31501) accidentally moved the paragraph to the `tp_finalize` section when the intent was to move it to the `tp_dealloc` section (according to the commit message). Also: * Convert the paragraph to a warning. * Apply the appropriate font style to `tp_dealloc`. * Unlinkify the first mention of `tp_dealloc` since the paragraph is already in the `tp_dealloc` section.
* gh-125766: Docs: minor rewording of installation on Linux section (GH-125743)partev2024-10-211-4/+4
|
* gh-125313: Prefer `sys.base_*` paths in `Py_Get(Exec)Prefix` deprecation ↵Y52024-10-212-6/+9
| | | | | | | notes (#125317) Prefer `sys.base_*` paths in `Py_Get(Exec)Prefix` deprecation notes. Signed-off-by: y5c4l3 <y5c4l3@proton.me>
* Doc: Fix typos (#125728)ember912024-10-216-7/+7
|
* gh-99030: Added documentation links for types and exceptions (GH-123857)RUANG (Roy James)2024-10-211-4/+8
| | | | | | | | | | | | | * Added documentation links for types and exceptions * Shortened description sentences * Change content * Change documentation * Move seealso * Add a spaces
* Doc: Fix pluralization in os.process_cpu_count() documentation (#125678)Tom Most2024-10-201-1/+1
|
* GH-99749: Add What's New entry for GH-124456 (GH-125671)Savannah Ostrowski2024-10-191-0/+5
|
* GH-125277: Increase minimum supported Sphinx to 7.2.6 (#125368)Adam Turner2024-10-192-16/+16
|
* gh-125541: Make Ctrl-C interrupt `threading.Lock.acquire()` on Windows (#125546)Sam Gross2024-10-172-6/+6
|
* gh-118986: expose `socket.IPV6_RECVERR` (#118987)chrysn2024-10-171-2/+2
|
* gh-95836: Add custom type converter examples to argparse tutorial (GH-125376)Savannah Ostrowski2024-10-171-0/+47
|
* gh-125542: Deprecate prefix_chars in ArgumentParser.add_argument_group() ↵Savannah Ostrowski2024-10-173-2/+17
| | | | (GH-125563)
* GH-99749: Add optional feature to suggest correct names (ArgumentParser) ↵Savannah Ostrowski2024-10-171-1/+27
| | | | (GH-124456)
* gh-124694: Add concurrent.futures.InterpreterPoolExecutor (gh-124548)Eric Snow2024-10-165-8/+152
| | | | | | | | | | | | This is an implementation of InterpreterPoolExecutor that builds on ThreadPoolExecutor. (Note that this is not tied to PEP 734, which is strictly about adding a new stdlib module.) Possible future improvements: * support passing a script for the initializer or to submit() * support passing (most) arbitrary functions without pickling * support passing closures * optionally exec functions against __main__ instead of the their original module
* gh-125615: Fix grammar nit in tutorial's interactive interpreter appendix ↵Cornelius Roemer2024-10-161-1/+1
| | | | | (GH-125617) Replace "without ... nor" with "with neither ... nor"
* gh-124872: Replace enter/exit events with "switched" (#125532)Kirill Podoprigora2024-10-161-10/+4
| | | | | | | | | | | | | | | | | | | | | | | | | Users want to know when the current context switches to a different context object. Right now this happens when and only when a context is entered or exited, so the enter and exit events are synonymous with "switched". However, if the changes proposed for gh-99633 are implemented, the current context will also switch for reasons other than context enter or exit. Since users actually care about context switches and not enter or exit, replace the enter and exit events with a single switched event. The former exit event was emitted just before exiting the context. The new switched event is emitted after the context is exited to match the semantics users expect of an event with a past-tense name. If users need the ability to clean up before the switch takes effect, another event type can be added in the future. It is not added here because YAGNI. I skipped 0 in the enum as a matter of practice. Skipping 0 makes it easier to troubleshoot when code forgets to set zeroed memory, and it aligns with best practices for other tools (e.g., https://protobuf.dev/programming-guides/dos-donts/#unspecified-enum). Co-authored-by: Richard Hansen <rhansen@rhansen.org> Co-authored-by: Victor Stinner <vstinner@python.org>
* Python 3.14.0a1v3.14.0a1Hugo van Kemenade2024-10-158-15/+15
|