Skip to content


Subversion checkout URL

You can clone with
Download ZIP
"Path" object conveniently wrapping assorted file/path-related functionality

README.rst 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) is hosted at Github.

Documentation is hosted with PyPI.

Guides and Testimonials

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

Installing may be installed using setuptools, distribute, or pip:

pip install

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 to install it.


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+


Tests are continuously run by Travis-CI: BuildStatus

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

Something went wrong with that request. Please try again.