onepm 24.3

Picks the right package manager for you

onepm

Picks the right package manager for you.

Don't make me think about which package manager to use when I clone a project from other people. OnePM will pick the right package manager by searching for the lock files and/or the project settings in pyproject.toml.

This project is created in the same spirit as @antfu/ni.

Supported package managers: pip, pipenv, poetry, pdm, uv

Install onepm

Install with pipx:

pipx install onepm

Or use pdm global install:

pdm add -g onepm

Provided Shortcuts

pi - install

pi

# (venv) pip install . or pip install -r requirements.txt
# pipenv install
# poetry install
# pdm install

pi requests

# (venv) pip install requests
# pipenv install requests
# poetry add requests
# pdm add requests

pu - update

pu

# not available for pip
# pipenv update
# poetry update
# pdm update

pr - run

pr ...args

# (venv) ...args
# pipenv run ...args
# poetry run ...args
# pdm run ...args

pun - uninstall

pun requests

# pip uninstall requests
# pipenv uninstall requests
# poetry remove requests
# pdm remove requests

pa - Alias for the package manager

pa

# pip
# pipenv
# poetry
# pdm

If the package manager agent is pip, OnePM will enforce an activated virtualenv, or a .venv under the current directory.

Shims for Package Managers

OnePM also provides shim for the package managers like corepack, so you don't need to install package managers yourself. To enable it, install OnePM with shims extra:

pipx install --include-deps onepm[shims]

OnePM reads the package-manager field under [tool.onepm] table in pyproject.toml, and install the required package manager with the correct version in an isolated environment.

[tool.onepm]
package-manager = "poetry"

Or you can restrict the version range:

[tool.onepm]
package-manager = "poetry>=1.1.0"

For Python package management, OnePM is all you need.

OnePM Management Commands

• onepm install: Install the package manager configured in project file
• onepm use $SPEC: Use the package manager given by the requirement spec
• onepm update|up: Update the package manager used in the project
• onepm cleanup [$NAME]: Clean up installations of specified package manager or all
• onepm list|ls $NAME: List all installed versions of the given package manager