Python's filesystem abstraction layer
Python's Filesystem abstraction layer.
|PyPI version| |PyPI| |Build Status| |Coverage Status| |Codacy Badge| |Code Health|
Wiki <https://www.pyfilesystem.org>__API
Documentation <https://pyfilesystem2.readthedocs.io/en/latest/>__GitHub Repository <https://github.com/PyFilesystem/pyfilesystem2>__Blog <https://www.willmcgugan.com/tag/fs/>__Think of PyFilesystem's FS objects as the next logical step to
Python's file objects. In the same way that file objects abstract a
single file, FS objects abstract an entire filesystem.
Let's look at a simple piece of code as an example. The following
function uses the PyFilesystem API to count the number of non-blank
lines of Python code in a directory. It works recursively, so it will
find .py files in all sub-directories.
.. code:: python
def count_python_loc(fs):
"""Count non-blank lines of Python code."""
count = 0
for path in fs.walk.files(filter=['*.py']):
with fs.open(path) as python_file:
count += sum(1 for line in python_file if line.strip())
return count
We can call count_python_loc as follows:
.. code:: python
from fs import open_fs
projects_fs = open_fs('~/projects')
print(count_python_loc(projects_fs))
The line project_fs = open_fs('~/projects') opens an FS object that
maps to the projects directory in your home folder. That object is
used by count_python_loc when counting lines of code.
To count the lines of Python code in a zip file, we can make the following change:
.. code:: python
projects_fs = open_fs('zip://projects.zip')
Or to count the Python lines on an FTP server:
.. code:: python
projects_fs = open_fs('ftp://ftp.example.org/projects')
No changes to count_python_loc are necessary, because PyFileystem
provides a simple consistent interface to anything that resembles a
collection of files and directories. Essentially, it allows you to write
code that is independent of where and how the files are physically
stored.
Contrast that with a version that purely uses the standard library:
.. code:: python
def count_py_loc(path):
count = 0
for root, dirs, files in os.walk(path):
for name in files:
if name.endswith('.py'):
with open(os.path.join(root, name), 'rt') as python_file:
count += sum(1 for line in python_file if line.strip())
This version is similar to the PyFilesystem code above, but would only
work with the OS filesystem. Any other filesystem would require an
entirely different API, and you would likely have to re-implement the
directory walking functionality of os.walk.
Will McGugan <https://github.com/willmcgugan>__Martin Larralde <https://github.com/althonos>__ for TarFSGiampaolo <https://github.com/gpcimino>__ for copy_if_newer and
ftp fixes.PyFilesystem2 owes a massive debt of gratitude to the following developers who contributed code and ideas to the original version.
Apologies if I missed anyone, feel free to prompt me if your name is missing here.
.. |PyPI version| image:: https://badge.fury.io/py/fs.svg :target: https://badge.fury.io/py/fs .. |PyPI| image:: https://img.shields.io/pypi/pyversions/fs.svg :target: https://pypi.python.org/pypi/fs/ .. |Build Status| image:: https://travis-ci.org/PyFilesystem/pyfilesystem2.svg?branch=master :target: https://travis-ci.org/PyFilesystem/pyfilesystem2 .. |Coverage Status| image:: https://coveralls.io/repos/github/PyFilesystem/pyfilesystem2/badge.svg :target: https://coveralls.io/github/PyFilesystem/pyfilesystem2 .. |Codacy Badge| image:: https://api.codacy.com/project/badge/Grade/30ad6445427349218425d93886ade9ee :target: https://www.codacy.com/app/will-mcgugan/pyfilesystem2?utmsource=github.com&utmmedium=referral&utmcontent=PyFilesystem/pyfilesystem2&utmcampaign=Badge_Grade .. |Code Health| image:: https://landscape.io/github/PyFilesystem/pyfilesystem2/master/landscape.svg?style=flat :target: https://landscape.io/github/PyFilesystem/pyfilesystem2/master