Forge Home


Custom python pip package provider that's less broken


8,222 latest version

5.0 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 0.2.0 (latest)
  • 0.1.5
  • 0.1.4
  • 0.1.3
released Feb 25th 2016
This version is compatible with:
  • , , ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'yuav-pip', '0.2.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add yuav-pip
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install yuav-pip --version 0.2.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.



yuav/pip — version 0.2.0 Feb 25th 2016

Puppet Pip module

Build Status

Table of Contents

  1. Overview
  2. Module Description - What the module does and why it is useful
  3. Setup - The basics of getting started with pip
  4. Usage - Configuration options and additional functionality


Less broken Puppet package provider for pip. Can also install and configure pip

Module Description

The pip provider in Puppet is currently broken due to the fact that it's polling PyPI directly instead of relying on Pip from CLI

Installing this modules gives you a pip provider that works with;

  • Custom global PyPI repositories (since Pip 6.0)
  • Ensure latest
  • Proxies
  • Treat pip as a pip installable package


What pip affects

  • A list of files, packages, services, or operations that the module will alter, impact, or execute on the system it's installed on.
  • This is a great place to stick any warnings.
  • Can be in list or paragraph form.

Setup Requirements

If you don't use this module to manage python pip, it assumes pip is already installed and available in $PATH

Beginning with pip

Just install the module:

puppet module install yuav-pip

and use it as a custom provider

package { 'Django':
  ensure   => 'latest',
  provider => 'yuavpip',

*Note that pip needs to be installed prior to using this provider.


To have pip installed using this module

class { 'pip': }

Ensure pip is installed with the latest version

class { 'pip':
  package_ensure => 'latest',

Installing a global extra index

class { 'pip':
  package_ensure => 'latest',
  extra_index_url => '',

package { 'puppet-pip-test-project':
  ensure   => 'latest',
  provider => 'yuavpip',
  require  => Class['pip'], # Ensure custom repo is installed prior to my_package

Installing a custom global PyPI repo

class { 'pip':
  package_ensure => 'latest',
  index_url => 'http://devpi.fqdn:3141/repo/base/+simple/',

package { 'my_package':
  ensure   => 'latest',
  provider => 'yuavpip',
  require  => Class['pip'], # Ensure custom repo is installed prior to my_package

*Note: By default this module use the vendor version of pip (E.G 1.0 for Ubuntu 12.04), however global PyPI repo requires pip 6.0 or later. Since Puppet doesn't support ensure '>6.0', use 'latest' to ensure a recent enough version