[Python-checkins] Update pattern matching docs for changes to the PEP (#25185)

gvanrossum webhook-mailer at python.org
Tue Apr 6 12:03:09 EDT 2021


https://github.com/python/cpython/commit/5143fd15b4fe5e122c79e3be4745031f17bb4d8e
commit: 5143fd15b4fe5e122c79e3be4745031f17bb4d8e
branch: master
author: Ken Jin <28750310+Fidget-Spinner at users.noreply.github.com>
committer: gvanrossum <gvanrossum at gmail.com>
date: 2021-04-06T09:03:00-07:00
summary:

Update pattern matching docs for changes to the PEP (#25185)

See:
- https://github.com/python/peps/pull/1909 (__match_args__ must be a tuple)
- https://github.com/python/peps/pull/1908 (allow keyword patterns for int(x) etc.)

files:
M Doc/reference/compound_stmts.rst
M Doc/reference/datamodel.rst

diff --git a/Doc/reference/compound_stmts.rst b/Doc/reference/compound_stmts.rst
index e13d6dd956209..aae7c7f68b6e0 100644
--- a/Doc/reference/compound_stmts.rst
+++ b/Doc/reference/compound_stmts.rst
@@ -1030,7 +1030,7 @@ subject value:
 
    For a number of built-in types (specified below), a single positional
    subpattern is accepted which will match the entire subject; for these types
-   no keyword patterns are accepted.
+   keyword patterns also work as for other types.
 
    If only keyword patterns are present, they are processed as follows,
    one by one:
@@ -1057,7 +1057,7 @@ subject value:
 
       * If this raises an exception, the exception bubbles up.
 
-      * If the returned value is not a list or tuple, the conversion fails and
+      * If the returned value is not a tuple, the conversion fails and
         :exc:`TypeError` is raised.
 
       * If there are more positional patterns than ``len(cls.__match_args__)``,
diff --git a/Doc/reference/datamodel.rst b/Doc/reference/datamodel.rst
index dfe5eb6857c0f..9c819b7ae6d28 100644
--- a/Doc/reference/datamodel.rst
+++ b/Doc/reference/datamodel.rst
@@ -2565,7 +2565,7 @@ define a *__match_args__* attribute.
 
 .. data:: object.__match_args__
 
-   This class variable can be assigned a tuple or list of strings. When this class is
+   This class variable can be assigned a tuple of strings. When this class is
    used in a class pattern with positional arguments, each positional argument will
    be converted into a keyword argument, using the corresponding value in
    *__match_args__* as the keyword. The absence of this attribute is equivalent to



More information about the Python-checkins mailing list