Skip to content

sbitio/puppet-pipx

Repository files navigation

pipx

Table of Contents

  1. Description
  2. Setup - The basics of getting started with pipx
  3. Usage - Configuration options and additional functionality
  4. Limitations - OS compatibility, etc.
  5. Development - Guide for contributing to the module

Description

This module provides a puppet solution to overcome the implications of PEP 668 – Marking Python base environments as “externally managed” by leveraging pipx.

For such a thing, it provides a pipx package provider enabled to (optionally) install python dependencies system-wide. The provider code is based on Puppet's pip provider.

Due to pipx doesn't provide an option to install packages system-wide (ref), this module also provides the pipx-global wrapper script installed to /usr/local/bin. You can use this wrapper to directly manage pip packages system-wide.

Usage

The most basic thing to do is to just include the main class and use the package provider:

include pipx

package { certbot:
  provider: pipx
}

It will perform:

  • Install pipx package via OS default provider
  • Install /usr/local/bin/pipx-global script
  • Install certbot via pipx to /opt/pipx and binaries symlinked from /usr/local/bin

You can tweak this default behaviour with the main class parameters. See Code documentation for reference.

Limitations

This module requires Puppet 4.x or above, and is compatible with the following OSes/versions:

  • Debian 10, 11, 12
  • Ubuntu 18.04, 20.04, 22.04

It may work for other versions and OSes. Please report us if you are using it on another envinment.

Development

Development happens on GitHub.

Please log issues for any bug report, feature or support request.

Pull requests are welcome.

Disclaimer

A note on quality score

This module has a poor quality score. We're not fixing it because it comes from Puppet's pip package provider code it is based. It makes no sense to us to address lint warnings and diverge from the base code.

License

MIT License, see LICENSE file

Contact

Use contact form on http://sbit.io