userpath

Cross-platform tool for adding locations to the user PATH

userpath Permissive license DORMANT v1.9.2 released 2024-02-29

Install

userpath on PyPI

pip

pip install userpath

uv

uv add userpath

poetry

poetry add userpath

Package facts

License	not declared (permissive)
Python support	supports the current Python release (>=3.7)
Install friction	low — pure-Python wheel
Runtime dependencies	1 — click
Maintenance	dormant — 896 days since the last release
First released	2018-05-15
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: userpath-1.9.2-py3-none-any.whl

Keywords: path, user path

Development Status :: 4 - BetaIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Programming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPy

About userpath

from the package's own PyPI description — quoted content, verbatim

userpath


CI/CD	CI - Test (image) CD - Build (image)
Package	PyPI - Version (image) PyPI - Python Version (image)
Meta	License - MIT (image) GitHub Sponsors (image)

This is a tool for modifying a user's PATH.

Table of Contents

Installation
CLI
API
License

Installation

pip install userpath

CLI

```console $ userpath -h Usage: userpath [OPTIONS] COMMAND [ARGS]...

Options:...

Read as markdown · JSON record · Source repository

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

userpath modifies a user's PATH environment variable across platforms, providing both CLI and Python API methods to append, prepend, or verify locations in the user's PATH.

Low friction install with a single runtime dependency (click). Package is dormant—last release was 896 days ago—but supports Python 3.7–3.11 and PyPy, suggesting stable maintenance rather than active development.

MIT license permits unrestricted use, modification, and distribution with minimal obligations, making this suitable for both open-source and proprietary projects.

Usage

pip install userpath

import userpath
location = '/usr/local/myapp'
userpath.append(location)
if userpath.in_new_path(location):
    print('Location added to PATH')

Modifying PATH requires appropriate file system permissions; shell restart may be needed for changes to take effect in the current session.

Verdict: userpath is a lightweight, permissively licensed tool for cross-platform PATH manipulation with no known vulnerabilities. Its dormant status and lack of recent activity are offset by broad Python version support and a simple, stable API. Suitable for scripting and tooling that needs to modify user PATH without external complications.

Needs verification

Whether dormant status reflects intentional stability or abandonment risk over the next 12–24 months
Compatibility with Python 3.12+ despite classifiers only listing through 3.11
Whether shell restart requirement is automatic or manual on all supported platforms

modify user PATH environment variableadd directory to PATHcross-platform PATH managementappend prepend PATH locationsverify PATH contains directoryuser PATH manipulation tool