# `fnmatch` — Filtrage par motif des noms de fichiers Unix

Code source : Lib/fnmatch.py

Ce module fournit la gestion des caractères de remplacement de style shell Unix, qui ne sont pas identiques à ceux utilisés dans les expressions régulières (documentés dans le module `re`). Les caractères spéciaux utilisés comme caractères de remplacement de style shell sont :

Motif | Signification
--- | ---
`*` | reconnaît n'importe quoi
`?` | reconnaît n'importe quel caractère unique
`[seq]` | reconnaît n'importe quel caractère dans seq
`[!seq]` | reconnaît n'importe quel caractère qui n'est pas dans seq

Pour une correspondance littérale, il faut entourer le métacaractère par des crochets. Par exemple, `'[?]'` reconnaît le caractère `'?'`.

Notons que le séparateur de nom de fichiers (`'/'` sous Unix) n'est pas traité de manière spéciale par ce module. Voir le module `glob` pour la recherche de chemins (`glob` utilise `filter()` pour reconnaître les composants d'un chemin). De la même manière, les noms de fichiers commençant par un point ne sont pas traités de manière spéciale par ce module, et sont reconnus par les motifs `*` et `?`.

Also note that `functools.lru_cache()` with the maxsize of 32768 is used to cache the compiled regex patterns in the following functions: `fnmatch()`, `fnmatchcase()`, `filter()`.

fnmatch.fnmatch(name, pat)

  Test whether the filename string name matches the pattern string pat, returning `True` or `False`. Both parameters are case-normalized using `os.path.normcase()`. `fnmatchcase()` can be used to perform a case-sensitive comparison, regardless of whether that's standard for the operating system.

  Cet exemple affiche tous les noms de fichiers du répertoire courant ayant pour extension `.txt` :

      import fnmatch
      import os

      for file in os.listdir('.'):
          if fnmatch.fnmatch(file, '*.txt'):
              print(file)

fnmatch.fnmatchcase(name, pat)

  Test whether the filename string name matches the pattern string pat, returning `True` or `False`; the comparison is case-sensitive and does not apply `os.path.normcase()`.

fnmatch.filter(names, pat)

  Construct a list from those elements of the iterable names that match pattern pat. It is the same as `[n for n in names if fnmatch(n, pat)]`, but implemented more efficiently.

fnmatch.translate(pat)

  Return the shell-style pattern pat converted to a regular expression for using with `re.match()`.

  Exemple :

      >>> import fnmatch, re
      >>>
      >>> regex = fnmatch.translate('*.txt')
      >>> regex
      '(?s:.*\\.txt)\\Z'
      >>> reobj = re.compile(regex)
      >>> reobj.match('foobar.txt')
      <re.Match object; span=(0, 10), match='foobar.txt'>

Voir aussi

Module `glob`

  Recherche de chemins de style shell Unix.