Pyppyn

Pyppyn helps you dynamically read setup configurations and load dependencies.

Since pip is excellent at reading setup configurations and loading dependencies, why Pyppyn? If you need programmatic access to dependency information, for example, in dynamically creating standalone applications using GravityBee and PyInstaller, Pyppyn can help you out.

Pyppyn can be used in scripts or using the CLI. Either way, it can be installed easily.

$ pip install pyppyn

CLI

Pyppyn will display help in typical fashion.

$ pyppyn --help

Example

To parse the included test mini Python package (tests/minipippy), with a setup.cfg and setup.py file, and install the required dependencies, you can use this command. This allows you to install dependencies without installing the package.

$ pyppyn --setup-path tests/minipippy --platform linux -v -a
Pyppyn CLI, 0.3.5
[Pyppyn] Platform: linux
[Pyppyn] Setup path: tests/minipippy
[Pyppyn] Reading configuration of tests/minipippy
[Pyppyn] Building wheel from tests/minipippy
[...]
[Pyppyn] Extracting wheel (unzipping)
[Pyppyn] Wheel archive found: ./minipippy-4.8.2-py2.py3-none-any.whl
[Pyppyn] Unzipping: ./minipippy-4.8.2-py2.py3-none-any.whl
[Pyppyn] Going through wheel directories
[Pyppyn] Looking at wheel top level
[Pyppyn] Reading names of console scripts
[Pyppyn] Reading wheel metadata
[Pyppyn] Cleaning up wheel
[Pyppyn] This Python: 3.6
[Pyppyn] Version from tests/minipippy : 4.8.2
[Pyppyn] Unsupported marker [ six ]: platform_system == "linux" and python_version > "3.3"
[Pyppyn] Install Requires:
[Pyppyn]    Generally required: ['backoff', 'click', 'pyyaml']
[Pyppyn]    For this OS: []
[Pyppyn]    For this Python version: []
[Pyppyn]    Unparsed markers: ['six']
[Pyppyn]    Others listed by not required (e.g., wrong platform): ['defusedxml', 'pypiwin32']
[Pyppyn] Installing package: backoff
[Pyppyn] Imported module: backoff
[Pyppyn] Installing package: click
[Pyppyn] Imported module: click
[Pyppyn] Installing package: pyyaml
[Pyppyn] Imported module: yaml

From Python

This is a sample usage of Pyppyn from a Python script.

import pyppyn

# Create an instance
p = pyppyn.ConfigRep(setup_path="tests/minipippy")

# Load config, install dependencies and import a module from the package
p.process_config()

print("Package requires:", p.get_required(include_extras_require=False))

Contribute

Pyppyn is hosted on GitHub and is an open source project that welcomes contributions of all kinds from the community.

For more information about contributing, see the contributor guidelines.

Namesake

This module is named in honor of Pippin, a companion, friend, Bichon Frise-Shih Tzu mix. He passed away on March 30, 2018 at the age of 12 after a battle with diabetes, blindness, deafness, and loss of smell. Pleasant to the end, he was a great, great dog.