1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
|
.. _globbing:
Globbing
========
Globbing is the process of matching paths according to the rules used
by the Unix shell.
Generally speaking, you can think of a glob pattern as a path containing
one or more wildcard patterns, separated by forward slashes.
Matching Files and Directories
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
In a glob pattern, A ``*`` means match anything text in a filename. A ``?``
matches any single character. A ``**`` matches any number of subdirectories,
making the glob *recursive*. If the glob pattern ends in a ``/``, it will
only match directory paths, otherwise it will match files and directories.
.. note::
A recursive glob requires that PyFilesystem scan a lot of files,
and can potentially be slow for large (or network based) filesystems.
Here's a summary of glob patterns:
``*``
Matches all files in the current directory.
``*.py``
Matches all .py file in the current directory.
``*.py?``
Matches all .py files and .pyi, .pyc etc in the currenct directory.
``project/*.py``
Matches all .py files in a directory called ``project``.
``*/*.py``
Matches all .py files in any sub directory.
``**/*.py``
Recursively matches all .py files.
``**/.git/``
Recursively matches all the git directories.
Interface
~~~~~~~~~
PyFilesystem supports globbing via the ``glob`` attribute on every FS
instance, which is an instance of :class:`~fs.glob.BoundGlobber`. Here's
how you might use it to find all the Python files in your filesystem::
for match in my_fs.glob("**/*.py"):
print(f"{match.path} is {match.info.size} bytes long")
Calling ``.glob`` with a pattern will return an iterator of
:class:`~fs.glob.GlobMatch` named tuples for each matching file or
directory. A glob match contains two attributes; ``path`` which is the
full path in the filesystem, and ``info`` which is an
:class:`fs.info.Info` info object for the matched resource.
Batch Methods
~~~~~~~~~~~~~
In addition to iterating over the results, you can also call methods on
the :class:`~fs.glob.Globber` which apply to every matched path.
For instance, here is how you can use glob to remove all ``.pyc`` files
from a project directory::
>>> import fs
>>> fs.open_fs('~/projects/my_project').glob('**/*.pyc').remove()
29
|
