path.py

path.py implements a path objects as first-class entities, allowing common operations on files to be invoked on those path objects directly. For example:

from path import Path
d = Path('/home/guido/bin')
for f in d.files('*.py'):
    f.chmod(0755)

path.py is hosted at Github.

Documentation is hosted with PyPI.

Guides and Testimonials

Yasoob has written the Python 101 Writing a Cleanup Script based on path.py.

Installing

Path.py may be installed using setuptools, distribute, or pip:

pip install path.py

The latest release is always updated to the Python Package Index.

You may also always download the source distribution (zip/tarball), extract it, and run python setup.py to install it.

Development

To install an in-development version, use the Github links to clone or download a snapshot of the latest code. Alternatively, if you have git installed, you may be able to use pip or easy_install to install directly from the repository:

pip install git+https://github.com/jaraco/path.py.git

Testing

Tests are continuously run by Travis-CI:

To run the tests, refer to the .travis.yml file for the steps run on the Travis-CI hosts.