https://github.com/onpuppet/puppet-pip

Custom pip provider for Puppet package resource
https://github.com/onpuppet/puppet-pip

Last synced: about 2 months ago
JSON representation

Custom pip provider for Puppet package resource

• Host: GitHub
• URL: https://github.com/onpuppet/puppet-pip
• Owner: onpuppet
• License: apache-2.0
• Created: 2016-02-03T11:02:42.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2017-02-02T13:28:44.000Z (about 9 years ago)
• Last Synced: 2026-02-19T04:41:12.538Z (about 2 months ago)
• Language: Ruby
• Size: 68.4 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.markdown
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

          
Puppet Pip module

=================

[![Build Status](https://travis-ci.org/onpuppet/puppet-pip.svg)](https://travis-ci.org/onpuppet/puppet-pip)

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

**NOTICE:** Features of this provider has been ported to Puppet core, and is available in Puppet 4.5.0

## 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

## Setup

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 onpuppet-pip

and use it as a custom provider

    package { 'Django':

      ensure   => 'latest',

      provider => 'yuavpip',

    }

*Note that pip needs to be installed prior to using the provider as in this example.

## Usage

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 => 'https://repo.fury.io/yuav/',

    }

    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

### Limitations

# Acceptance testing with Beaker

Due to bug: https://tickets.puppetlabs.com/browse/BKR-699 (Beaker adding /usr/bin in front of $PATH)

there's an issue using this module in an acceptance test with ensure => 'latest'.

The workaround is to override the Beaker set path in the test like so:

    apply_manifest(pp, :catch_changes => true, :environment => {

        'PATH' => '/opt/puppet-git-repos/hiera/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games'

    })