Metadata-Version: 1.1
Name: fs
Version: 2.0.4
Summary: Python's filesystem abstraction layer
Home-page: https://github.com/PyFilesystem/pyfilesystem2
Author: Will McGugan
Author-email: will@willmcgugan.com
License: BSD
Description: PyFilesystem2
        =============
        
        Python's Filesystem abstraction layer.
        
        |PyPI version| |PyPI| |Build Status| |Coverage Status| |Codacy Badge|
        
        Documentation
        -------------
        
        -  `PyFilesytem
           Documentation <https://pyfilesystem2.readthedocs.io/en/latest/>`__
        -  `GitHub Repository <https://github.com/PyFilesystem/pyfilesystem2>`__
        -  `Blog <https://www.willmcgugan.com/tag/fs/>`__
        
        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.
        
        .. 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``.
        
        Credits
        -------
        
        -  `Will McGugan <https://github.com/willmcgugan>`__
        -  `Martin Larralde <https://github.com/althonos>`__ for TarFS
        -  `Giampaolo <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.
        
        -  Ryan Kelly
        -  Andrew Scheller
        -  Ben Timby
        
        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?utm_source=github.com&utm_medium=referral&utm_content=PyFilesystem/pyfilesystem2&utm_campaign=Badge_Grade
        
Platform: any
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: System :: Filesystems
