# userpath

> Cross-platform tool for adding locations to the user PATH

- **URL**: https://www.freshcrate.ai/projects/userpath
- **Author**: pypi
- **Category**: Frameworks
- **Latest version**: `1.9.2` (2026-04-21)
- **License**: Unknown
- **Source**: https://github.com/sponsors/ofek
- **Homepage**: https://pypi.org/project/userpath/
- **Language**: Python
- **Registry**: pypi (`userpath`)
- **Tags**: `path`, `pypi`, `user`

## Description

# userpath

| | |
| --- | --- |
| CI/CD | [![CI - Test](https://github.com/ofek/userpath/actions/workflows/test.yml/badge.svg)](https://github.com/ofek/userpath/actions/workflows/test.yml) [![CD - Build](https://github.com/ofek/userpath/actions/workflows/build.yml/badge.svg)](https://github.com/ofek/userpath/actions/workflows/build.yml) |
| Package | [![PyPI - Version](https://img.shields.io/pypi/v/userpath.svg?logo=pypi&label=PyPI&logoColor=gold)](https://pypi.org/project/userpath/) [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/userpath.svg?logo=python&label=Python&logoColor=gold)](https://pypi.org/project/userpath/) |
| Meta | [![License - MIT](https://img.shields.io/badge/license-MIT-9400d3.svg)](https://spdx.org/licenses/) [![GitHub Sponsors](https://img.shields.io/github/sponsors/ofek?logo=GitHub%20Sponsors&style=social)](https://github.com/sponsors/ofek) |

-----

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

**Table of Contents**

- [Installation](#installation)
- [CLI](#cli)
- [API](#api)
- [License](#license)

## Installation

```console
pip install userpath
```

## CLI

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

Options:
  --version   Show the version and exit.
  -h, --help  Show this message and exit.

Commands:
  append   Appends to the user PATH
  prepend  Prepends to the user PATH
  verify   Checks if locations are in the user PATH
```

## API

```pycon
>>> import userpath
>>> location = r'C:\Users\Ofek\Desktop\test'
>>>
>>> userpath.in_current_path(location)
False
>>> userpath.in_new_path(location)
False
>>> userpath.append(location)
True
>>> userpath.in_new_path(location)
True
>>> userpath.need_shell_restart(location)
True
```

## License

`userpath` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `1.9.2` | 2026-04-21 | Low | Imported from PyPI (1.9.2) |

## Citation

- HTML: https://www.freshcrate.ai/projects/userpath
- Markdown: https://www.freshcrate.ai/projects/userpath.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/userpath/deps

_Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._