* [3.10] gh-129641: Switch Docs GHA build to actions/upload-artifact@v4
Add options for backwards compatibility, from the docs at:
https://github.com/actions/upload-artifact?tab=readme-ov-file#breaking-changes
* Python Tutorial typo fix (#128077)
Backported form commit: 5a584c8f54bbeceae7ffa501291e29b7ddc8a0b9
This is a trivial change meant to trigger a Docs build.
* Use Python 3.12 for the 3.10 docs build
The pinned version of Sphinx requires `imghdr`, removed in Python 3.13.
---------
Co-authored-by: shallow-beach <96891913+shallow-beach@users.noreply.github.com>
**Before**
This prevents directories with a common name, such as ``string``, unintentionally hiding ...
**After**
This prevents directories with a common name, such as ``string``, from unintentionally hiding ...
(cherry picked from commit 0a539b5db312d126ff45dd4aa6a53d40a292c512)
Co-authored-by: Robert Prater (B. Eng) <robcprater@gmail.com>
gh-102354: change python3 to python in docs examples (GH-102696)
(cherry picked from commit 80abd62647b2a36947a11a6a8e395061be6f0c61)
Co-authored-by: Paul Watson <paul.hermeneutic@gmail.com>
import dataclass not dataclasses from dataclasses
(cherry picked from commit 98308dbeb110198ebe28bdb7720d3671b3e7f57b)
Co-authored-by: Owain Davies <116417456+OTheDev@users.noreply.github.com>
Use unnumbered footnote in this file to avoid reseting the footnotes numbering.
Example: when building the tutorial into a PDF and using `latex_show_urls = "footnotes"`; this footnote become the number 8. However, without this change, the footnote shows the number 1.
(cherry picked from commit f042646595d1cdd2ecdc15222b1766f746d010f0)
Co-authored-by: Manuel Kaufmann <humitos@gmail.com>
Closes GH-91856.
On Windows double quotes are sometimes better, on Unix usually
single quotes. It's not our place to explain that, so just don't.
(cherry picked from commit 5f8ca1b7969f34ee09adb7b28337ebd920e6215a)
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Add auto exception chaining example to tutorial
(cherry picked from commit 395b66a0ae5237eec195ca97daaaf8563706ed34)
Co-authored-by: Shahriar Heidrich <smheidrich@weltenfunktion.de>
Use SyntaxError invalid range in tutorial introduction example (GH-93031)
Use output from a 3.10+ REPL, showing invalid range, for the
SyntaxError examples in the tutorial introduction page.
Co-authored-by: Eddie Hebert <eddie@eddiehebert.com>
(cherry picked from commit 4b81139aac3fa11779f6eedb6e621bde29e64b30)
Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
For the continuation lines, "..." should present as secondary prompt
(cherry picked from commit de28ee8f755760fda13b481a34b1f326984d293a)
Co-authored-by: Chenwei Xiao <chanvinxiao@163.com>
Co-authored-by: Chenwei Xiao <chanvinxiao@163.com>
The URL is now https://pyvideo.org, which uses HTTPS and avoids a redirect.
(cherry picked from commit 7c439dca13435085efb2fddf9ac75e5305db7ada)
Co-authored-by: partev <petrosyan@gmail.com>
This fixes an issue on tutorial/classes.rst section 9.4 where the example "class Warehouse"
was truncated when pressing the >>> button to hide the prompts and output.
(cherry picked from commit 88f0d0c1e8fdda036f3f64b0048911ba28ce7f06)
Co-authored-by: Nicolas Haller <nicolas@haller.im>
Add a link to the `match` statement from its section in the tutorial.
Automerge-Triggered-By: GH:Mariatta
(cherry picked from commit 35f55cc5c690a97853f1b544aac53574ab755b54)
Co-authored-by: William Andrea <william.j.andrea@gmail.com>
Remove the bit about subclassing exceptions.
Documentation PR can skip the NEWS label.
Automerge-Triggered-By: GH:iritkatriel
(cherry picked from commit 2db56130631255ca2eb504519430fb2f1fe789e9)
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
Updated the output for it=iter(s) from <iterator object at 0x00A1DB50> to <str_iterator object at 0x10c90e650>
(cherry picked from commit c5d18a5014f649368b5a4bca94e9ec7d2908b481)
Co-authored-by: Vivek Vashist <vivekvashist@gmail.com>
The "Color" example in the pattern-matching section of the "control flow" documentation is not immediately runnable, leading to confusion.
Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>
(cherry picked from commit 1cbb88736c32ac30fd530371adf53fe7554be0a5)
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Replace old names when they refer to actual versions of macOS.
Keep historical names in references to older versions.
Co-authored-by: Patrick Reader <_@pxeger.com>
(cherry picked from commit 36122e18148c5b6c78ebce1d36d514fd7cf250f5)
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Broadened scope of the document to explicitly discuss and differentiate between ``__main__.py`` in packages versus the ``__name__ == '__main__'`` expression (and the idioms that surround it), as well as ``import __main__``.
Co-authored-by: Géry Ogam <gery.ogam@gmail.com>
Co-authored-by: Éric Araujo <merwok@netwok.org>
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
(cherry picked from commit 7cba23164cf82f6619db002cd30021b5dfb1f809)
Co-authored-by: Jack DeVries <58614260+jdevries3133@users.noreply.github.com>
This is the last remaining instance, at least for this chapter, in 3.10 & 3.11.
(cherry picked from commit 2f47d8dcc735234bf9c7f92fbdacd8c5a6ee7761)
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
