Skip to main content

A module wrapper for os.path

Project description

https://img.shields.io/pypi/v/path.svg https://img.shields.io/pypi/pyversions/path.svg tests Ruff https://readthedocs.org/projects/path/badge/?version=latest https://img.shields.io/badge/skeleton-2025-informational https://tidelift.com/badges/package/pypi/path

path (aka path pie, formerly path.py) implements 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(0o755)

# Globbing
for f in d.files("*.py"):
    f.chmod("u+rwx")

# Changing the working directory:
with Path("somewhere"):
    # cwd in now `somewhere`
    ...

# Concatenate paths with /
foo_txt = Path("bar") / "foo.txt"

Path pie is hosted at Github.

Find the documentation here.

Guides and Testimonials

Yasoob wrote the Python 101 Writing a Cleanup Script based on path.

Advantages

Path pie provides a superior experience to similar offerings.

Python 3.4 introduced pathlib, which shares many characteristics with path. In particular, it provides an object encapsulation for representing filesystem paths. One may have imagined pathlib would supersede path.

But the implementation and the usage quickly diverge, and path has several advantages over pathlib:

  • path implements Path objects as a subclass of str, and as a result these Path objects may be passed directly to other APIs that expect simple text representations of paths, whereas with pathlib, one must first cast values to strings before passing them to APIs that do not honor PEP 519 PathLike interface.

  • path give quality of life features beyond exposing basic functionality of a path. path provides methods like rmtree (from shlib) and remove_p (remove a file if it exists), properties like .permissions, and sophisticated walk, TempDir, and chmod behaviors.

  • As a PyPI-hosted package, path is free to iterate faster than a stdlib package. Contributions are welcome and encouraged.

  • path provides superior portability using a uniform abstraction over its single Path object, freeing the implementer to subclass it readily. One cannot subclass a pathlib.Path to add functionality, but must subclass Path, PosixPath, and WindowsPath, even to do something as simple as to add a __dict__ to the subclass instances. path instead allows the Path.module object to be overridden by subclasses, defaulting to the os.path. Even advanced uses of path.Path that subclass the model do not need to be concerned with OS-specific nuances. path.Path objects are inherently “pure”, not requiring the author to distinguish between pure and non-pure variants.

This path project has the explicit aim to provide compatibility with pathlib objects where possible, such that a path.Path object is a drop-in replacement for pathlib.Path* objects. This project welcomes contributions to improve that compatibility where it’s lacking.

Origins

The path.py project was initially released in 2003 by Jason Orendorff and has been continuously developed and supported by several maintainers over the years.

For Enterprise

Available as part of the Tidelift Subscription.

This project and the maintainers of thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use.

Learn more.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

path-17.1.1.tar.gz (50.5 kB view details)

Uploaded Source

Built Distribution

path-17.1.1-py3-none-any.whl (23.9 kB view details)

Uploaded Python 3

File details

Details for the file path-17.1.1.tar.gz.

File metadata

  • Download URL: path-17.1.1.tar.gz
  • Upload date:
  • Size: 50.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.5

File hashes

Hashes for path-17.1.1.tar.gz
Algorithm Hash digest
SHA256 2dfcbfec8b4d960f3469c52acf133113c2a8bf12ac7b98d629fa91af87248d42
MD5 c7ab103cb96b36758daeccd1ed52b587
BLAKE2b-256 dd52a7bdd5ef8488977d354b7915d1e75009bebbd04f73eff14e52372d5e9435

See more details on using hashes here.

File details

Details for the file path-17.1.1-py3-none-any.whl.

File metadata

  • Download URL: path-17.1.1-py3-none-any.whl
  • Upload date:
  • Size: 23.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.5

File hashes

Hashes for path-17.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ec7e136df29172e5030dd07e037d55f676bdb29d15bfa09b80da29d07d3b9303
MD5 092276d9204b81740a9dfc2e8f7fca86
BLAKE2b-256 7c5011c9ee1ede64b45d687fd36eb8768dafc57afc78b4d83396920cfd69ed30

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page