pip_runner documentation¶

pip_runner¶

pip_runner is a small, extendable Python wrapper around the pip command-line interface.

It provides a thin, high-level API that executes python -m pip and parses commonly used outputs (freeze / list).

Overview¶

Key features¶

Thin wrapper using subprocess to run pip commands via Python executable.
High-level Pip class with convenient methods: install, uninstall, list_installed, freeze, show, search, download, wheel, help.
Easy to extend, test and integrate with virtual environments (pass custom python_executable).

PyPI record.

Documentation.

Usage¶

Basic usage:

from pip_runner import Pip
pip = Pip()
pip.install("requests")
print(pip.list().get("requests"))

Installation¶

Prerequisites:

Python 3.10 or higher
- https://www.python.org/
pip
- https://pypi.org/project/pip/

To install run:

python -m pip install --upgrade pip_runner

Development¶

Prerequisites:

Development is strictly based on nox. To install it run:
```
python -m pip install --upgrade nox
```

Visit Development page.

Installation from sources:

clone the sources:

git clone https://github.com/karpierz/pip_runner pip_runner

and run:

python -m pip install ./pip_runner

or on development mode:

python -m pip install --editable ./pip_runner

License¶

Copyright (c) 2026-2026 Adam Karpierz

Licensed under the zlib/libpng License

https://opensource.org/license/zlib

Please refer to the accompanying LICENSE file.

Authors¶

Adam Karpierz <adam@karpierz.net>

Sponsoring¶

If you would like to sponsor the development of this project, your contribution is greatly appreciated.

As I am now retired, any support helps me dedicate more time to maintaining and improving this work.

Donate

Contents¶

Changelog