https://github.com/python/cpython/commit/50bb9c69e14f88965564b663d7088633691f5d6a
commit: 50bb9c69e14f88965564b663d7088633691f5d6a
branch: 3.12
author: Miss Islington (bot) <31488909+miss-isling...@users.noreply.github.com>
committer: erlend-aasland <erlend.aasl...@protonmail.com>
date: 2024-01-16T23:42:29+01:00
summary:
[3.12] gh-94220: Align fnmatch docs with the implementation and amend markup
(GH-114152) (#114155)
- Align the argument spec for fnmatch functions with the actual
implementation.
- Update Sphinx markup to recent recommandations.
- Add link to 'iterable' glossary entry.
(cherry picked from commit 6e84f3b56f445b56ab48723d636c0a17090298ab)
Co-authored-by: Erlend E. Aasland <erl...@python.org>
Co-authored-by: Adam Turner <9087854+aa-tur...@users.noreply.github.com>
files:
M Doc/library/fnmatch.rst
diff --git a/Doc/library/fnmatch.rst b/Doc/library/fnmatch.rst
index aed8991d44772f..7cddecd5e80887 100644
--- a/Doc/library/fnmatch.rst
+++ b/Doc/library/fnmatch.rst
@@ -50,10 +50,10 @@ Also note that :func:`functools.lru_cache` with the
*maxsize* of 32768 is used t
cache the compiled regex patterns in the following functions: :func:`fnmatch`,
:func:`fnmatchcase`, :func:`.filter`.
-.. function:: fnmatch(filename, pattern)
+.. function:: fnmatch(name, pat)
- Test whether the *filename* string matches the *pattern* string, returning
- :const:`True` or :const:`False`. Both parameters are case-normalized
+ Test whether the filename string *name* matches the pattern string *pat*,
+ returning ``True`` or ``False``. Both parameters are case-normalized
using :func:`os.path.normcase`. :func:`fnmatchcase` can be used to perform a
case-sensitive comparison, regardless of whether that's standard for the
operating system.
@@ -69,22 +69,24 @@ cache the compiled regex patterns in the following
functions: :func:`fnmatch`,
print(file)
-.. function:: fnmatchcase(filename, pattern)
+.. function:: fnmatchcase(name, pat)
- Test whether *filename* matches *pattern*, returning :const:`True` or
- :const:`False`; the comparison is case-sensitive and does not apply
- :func:`os.path.normcase`.
+ Test whether the filename string *name* matches the pattern string *pat*,
+ returning ``True`` or ``False``;
+ the comparison is case-sensitive and does not apply
:func:`os.path.normcase`.
-.. function:: filter(names, pattern)
+.. function:: filter(names, pat)
- Construct a list from those elements of the iterable *names* that match
*pattern*. It is the same as
- ``[n for n in names if fnmatch(n, pattern)]``, but implemented more
efficiently.
+ Construct a list from those elements of the :term:`iterable` *names*
+ that match pattern *pat*.
+ It is the same as ``[n for n in names if fnmatch(n, pat)]``,
+ but implemented more efficiently.
-.. function:: translate(pattern)
+.. function:: translate(pat)
- Return the shell-style *pattern* converted to a regular expression for
+ Return the shell-style pattern *pat* converted to a regular expression for
using with :func:`re.match`.
Example:
_______________________________________________
Python-checkins mailing list -- python-checkins@python.org
To unsubscribe send an email to python-checkins-le...@python.org
https://mail.python.org/mailman3/lists/python-checkins.python.org/
Member address: arch...@mail-archive.com
