python-fs
Port variant py39
Summary Python's filesystem abstraction layer (3.9)
Package version 2.4.14
Homepage https://github.com/PyFilesystem/pyfilesystem2
Keywords python
Maintainer Python Automaton
License Not yet specified
Other variants py310
Ravenports Buildsheet | History
Ravensource Port Directory | History
Last modified 20 NOV 2021, 04:14:38 UTC
Port created 03 JAN 2020, 01:03:23 UTC
Subpackage Descriptions
single # PyFilesystem2 Python's Filesystem abstraction layer. [PyPI version] [PyPI] [Downloads] [Build Status] [Windows Build Status] [Coverage Status] [Codacy Badge] [Docs] ## Documentation - [Wiki] - [API Documentation] - [GitHub Repository] - [Blog] ## Introduction 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. ```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: ```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: ```python projects_fs = open_fs('zip://projects.zip') ``` Or to count the Python lines on an FTP server: ```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: ```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()) return count ``` 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`. ## Credits The following developers have contributed code and their time to this projects: - [Will McGugan] - [Martin Larralde] - [Giampaolo Cimino] - [Geoff Jukes]
Configuration Switches (platform-specific settings discarded)
PY310 OFF Build using Python 3.10 PY39 ON Build using Python 3.9
Package Dependencies by Type
Build (only) python-pip:single:py39
autoselect-python:single:standard
Build and Runtime python39:single:standard
Runtime (only) python-appdirs:single:py39
python-pytz:single:py39
python-setuptools:single:py39
python-six:single:py39
Download groups
main mirror://PYPIWHL/94/09/868aad9dd6a6cb8c3b8f62e6b7c2393f246c799be6b9f93ee1e783143c80
Distribution File Information
b298013377f51125b3d7f0c86920de4e3e2d4a83731bd5caf1f1e5bddabe7798 133095 fs-2.4.14-py2.py3-none-any.whl
Ports that require python-fs:py39
fonts-cantarell:standard Cantarell, Humanist sans-serif font family