path

library17.1.1pypypi✓ verified 35d ago

The `path` library (formerly known as `path.py`) provides an object-oriented way to interact with file system paths, acting as a convenient wrapper around `os.path`. It implements path objects as first-class entities, allowing common file operations to be invoked directly on these objects. It aims to offer a superior experience to similar offerings, including Python's built-in `pathlib`, by providing more robust cross-platform abstractions and ease of subclassing. The current version is 17.1.1, with a regular release cadence as seen from its active GitHub development.

serialization database

github ↗package ↗

Install & Compatibility

Where this runs

tested against v17.1.1 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.925 runs

installs and imports cleanly · install 0.0s · import 0.052s · 18MB

glibc

py 3.10–3.925 runs

installs and imports cleanly · install 1.6s · import 0.043s · 18MB

16MB installed

● package 16MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

The PyPI package name changed from `path.py` to `path`, so the import path also changed. While `from path.py import Path` might work for older versions (<=12.x), the current stable version imports from `path`.

from path import Path

This quickstart demonstrates how to create Path objects, join paths, create directories, write to files, read from files, and clean up the created files and directories using the `path` library's object-oriented interface. It ensures cross-platform compatibility by abstracting OS-specific path separators.

import os from path import Path # Create a Path object for the current directory p = Path(os.getcwd()) print(f"Current directory: {p}") # Join paths new_dir = p / 'my_test_dir' print(f"Proposed new directory: {new_dir}") # Ensure the directory exists (create if not) new_dir.mkdir_p() print(f"Directory exists: {new_dir.isdir()}") # Create a file inside the new directory file_path = new_dir / 'my_file.txt' file_path.write_text('Hello from path.py (now path)!') print(f"File created: {file_path.exists()}") print(f"File content: {file_path.read_text()}") # Delete the file and directory file_path.remove() new_dir.rmdir() print(f"Directory removed: {new_dir.exists()}")

Debug

Known footguns

breakingThe package name on PyPI and the primary import changed from `path.py` to `path`. Code using `import path.py` or `from path.py import Path` will fail for versions 13.0.0 and above.

gotchaThe `path` library provides similar functionality to Python's built-in `pathlib` module. Be aware of which library you intend to use to avoid mixing `path.Path` objects with `pathlib.Path` objects, which are not directly interchangeable and can lead to unexpected behavior.

gotchaThere are other packages on PyPI with similar names (e.g., `pathpy`, `pathy`), which are unrelated and serve different purposes. Installing the wrong package can lead to `ModuleNotFoundError` or unexpected behavior.

gotchaWhen handling paths manually with strings, especially across different operating systems, developers often encounter issues with path separators (e.g., `\` on Windows vs. `/` on Linux) or incorrect relative paths in production environments. While `path` abstracts this, direct string manipulation can still introduce errors.

Upgrade

Version history

Breaking-change detection hasn't run for this library yet.

Audit

Security & dependencies

CVE tracking and dependency tree are planned for a later release.

Agent activity

9 hits · last 30 days

gptbot

ahrefsbot

script

Resources

githubhttps://github.com/jaraco/path ↗

packagehttps://pypi.org/project/path/ ↗