mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-11-03 03:22:27 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

Issue #16695: Document how glob handles filenames starting with a dot

Browse source
This commit is contained in:
Petri Lehtinen 2013-02-23 19:53:03 +01:00
parent 9f74c6cf7d
commit ee4a20bad6
3 changed files with 24 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

15
Doc/library/glob.rst
View file

@ -16,8 +16,10 @@ according to the rules used by the Unix shell. No tilde expansion is done, but
``*``, ``?``, and character ranges expressed with ``[]`` will be correctly
matched. This is done by using the :func:`os.listdir` and
:func:`fnmatch.fnmatch` functions in concert, and not by actually invoking a
subshell. (For tilde and shell variable expansion, use
:func:`os.path.expanduser` and :func:`os.path.expandvars`.)
subshell. Note that unlike :func:`fnmatch.fnmatch`, :mod:`glob` treats
filenames beginning with a dot (``.``) as special cases. (For tilde and shell
variable expansion, use :func:`os.path.expanduser` and
:func:`os.path.expandvars`.)
For a literal match, wrap the meta-characters in brackets.
For example, ``'[?]'`` matches the character ``'?'``.
@ -51,6 +53,15 @@ preserved. ::
>>> glob.glob('?.gif')
['1.gif']
If the directory contains files starting with ``.`` they won't be matched by
default. For example, consider a directory containing :file:`card.gif` and
:file:`.card.gif`::
>>> import glob
>>> glob.glob('*.gif')
['card.gif']
>>> glob.glob('.c*')
['.card.gif']
.. seealso::