pyenv Chef Cookbook

Description

Manages pyenv and its installed Pythons.

Several custom resources are defined to facilitate this.

WARNING As of v1.0.0, this cookbook no longer provide any recipes. Custom resources are provided instead.

Requirements

Chef

This cookbook requires Chef 12.9+.

Platform

• Debian derivatives
• Fedora
• RHEL derivatives (RHEL, CentOS, Amazon Linux, Oracle, Scientific Linux)
• openSUSE and openSUSE leap

Usage

Please read

Examples installtions are provided in test/fixtures/cookbooks/test/recipes

A pyenv_system_install or pyenv_user_install is required to be set so that pyenv knows which version you want to use, and is installed on the system.

Pip

Used to install a Python package into the selected pyenv environment.
ruby
pyenv_pip 'requests' do
version # Optional: if passed, the version the python package to install
user # Optional: if passed, the user to install the python module for
end


Global

pyenv_global '3.6.1' do
  user # Optional: if passed sets the users global version. Do not set, to set the systems global version
end

If a user is passed in to this resource it sets the global version for the user, under the users root_path (usually ~/.pyenv/version), otherwise it sets the system global version.

Plugin

Installs a pyenv plugin.
ruby
pyenv_plugin 'virtualenv' do
git_url # Git URL of the plugin
git_ref # Git reference of the plugin
user # Optional: if passed installs to the users pyenv. Do not set, to set installs to the system pyenv.
end


Rehash

pyenv_rehash 'rehash' do
  user # Optional: if passed rehashes the user pyenv otherwise rehashes the system pyenv
end

Python

pyenv_python '3.6.1' do
  user         # Optional: if passed, the user pyenv to install to
  pyenv_action # Optional: the action to perform, install, remove etc
end

Shorter example pyenv_python '3.6.1'.

Script

Runs a pyenv aware script.
ruby
pyenv_script 'foo' do
code # Script code to run
pyenv_version # pyenv version to run the script against
environment # Optional: Environment to setup to run the script
user # Optional: User to run as
group # Optional: Group to run as
path # Optional: User to run as
returns # Optional: Expected return code
end


System install

Installs pyenv to the system location, by default /usr/local/pyenv
ruby
pyenv_system_install 'foo' do
git_url # URL of the plugin repo you want to checkout
git_ref # Optional: Git reference to checkout
update_pyenv # Optional: Keeps the git repo up to date
end


User install

Installs pyenv to the user path, making pyenv available to that user only.
ruby
pyenv_user_install 'vagrant' do
git_url # Optional: Git URL to checkout pyenv from.
git_ref # Optional: Git reference to checkout e.g. 'master'
user # Which user to install pyenv to (also specified in the resources name above)
end


System-Wide Mac Installation Note

This cookbook takes advantage of managing profile fragments in an
/etc/profile.d directory, common on most Unix-flavored platforms.
Unfortunately, Mac OS X does not support this idiom out of the box,
so you may need to modify your user profile.

Development

• Source hosted at GitHub
• Report issues/Questions/Feature requests on GitHub Issues

Pull requests are very welcome! Make sure your patches are well tested.

License and Author

• Shane da Silva
• Darwin D. Wu

Copyright 2014, Shane da Silva
Copyright 2017, Darwin D. Wu

http://www.apache.org/licenses/LICENSE-2.0


Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.