Skip to content

gh-133510: Add links to more info for the match statement #133511

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 7 commits into
base: main
Choose a base branch
from
Open

gh-133510: Add links to more info for the match statement #133511

Changes from 4 commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
d377b8c
Add example for the match statement
xzkdeng May 6, 2025
08674f4
Update Doc/faq/design.rst,by suggestion of sobolevn -1
xzkdeng May 6, 2025
0fe1843
Update Doc/faq/design.rst,by suggestion of sobolevn -2
xzkdeng May 6, 2025
eb54817
Update Doc/faq/design.rst,by suggestion of sobolevn -3
xzkdeng May 6, 2025
804c8a3
Update Doc/faq/design.rst
AA-Turner May 7, 2025
05a62ee
Update Doc/faq/design.rst,by suggestions -1
xzkdeng May 9, 2025
184c150
Update design.rst according to suggestions -2
xzkdeng May 9, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions Doc/faq/design.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -261,8 +261,11 @@ Why isn't there a switch or case statement in Python?

In general, structured switch statements execute one block of code
when an expression has a particular value or set of values.

Since Python 3.10 one can easily match literal values, or constants
within a namespace, with a ``match ... case`` statement.
See :pep:`634` (specification) and :pep:`636` (tutorial) for details about the ``match`` statement.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For the "(tutorial)" it is probably best to replace the link with a link to the actual tutorial page that covers this.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agreed. The PEPs are historical documents that typically become stale over time. I think that there shouldn't be a link to a PEP for either the specification or tutorial.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So we should add an 'outdated' note in PEP 636, like the one in PEP 634.


An older alternative is a sequence of ``if... elif... elif... else``.

For cases where you need to choose from a very large number of possibilities,
Expand Down
Loading