Metadata-Version: 2.4
Name: pip_runner
Version: 0.2.0a1
Summary: A small high-level wrapper around pip CLI (python -m pip).
Author-email: Adam Karpierz <adam@karpierz.net>
Maintainer-email: Adam Karpierz <adam@karpierz.net>
License-Expression: Zlib
Project-URL: Homepage, https://pypi.org/project/pip-runner/
Project-URL: Documentation, https://karpierz.github.io/pip_runner/
Project-URL: History, https://karpierz.github.io/pip_runner/CHANGES.html
Project-URL: Download, https://pypi.org/project/pip-runner/
Project-URL: Repository, https://github.com/karpierz/pip_runner
Project-URL: Tracker, https://github.com/karpierz/pip_runner/issues
Project-URL: Sponsoring, https://www.paypal.com/donate/?hosted_button_id=FX8L7CJUGLW7S
Keywords: pip,pip_runner,pip-runner,pipwrapper,pip_api,pip-api
Platform: any
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: Polish
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3.15
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Programming Language :: Python :: Implementation :: GraalPy
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: <4.0.0,>=3.10.0
Description-Content-Type: text/x-rst; charset=UTF-8
License-File: LICENSE
Requires-Dist: pip>=23.3.2
Requires-Dist: typing-extensions>=4.16.0
Requires-Dist: packaging>=26.3.0
Requires-Dist: pkg-about>=2.4.0; python_version >= "3.11"
Requires-Dist: pkg-about>=2.3.0; python_version < "3.11"
Requires-Dist: py-utlx>=2.5.0; python_version >= "3.11"
Requires-Dist: py-utlx>=2.3.0; python_version < "3.11"
Requires-Dist: nocasedict>=2.2.1
Requires-Dist: regex>=2026.9.3
Dynamic: license-file

pip_runner
==========

| |package_bold| 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:

.. code:: python

  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:

  .. parsed-literal::

    python -m pip install --upgrade |package|

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:

  .. parsed-literal::

    git clone |respository| |package|

and run:

  .. parsed-literal::

    python -m pip install ./|package|

or on development mode:

  .. parsed-literal::

    python -m pip install --editable ./|package|

License
=======

  | |copyright|
  | 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`_

.. |package| replace:: pip_runner
.. |package_bold| replace:: **pip_runner**
.. |copyright| replace:: Copyright (c) 2026-2026 Adam Karpierz
.. |respository| replace:: https://github.com/karpierz/pip_runner
.. _Development page: https://github.com/karpierz/pip_runner
.. _PyPI record: https://pypi.org/project/pip-runner/
.. _Documentation: https://karpierz.github.io/pip_runner/
.. _Donate: https://www.paypal.com/donate/?hosted_button_id=FX8L7CJUGLW7S
