birdhousebuilder.recipe.conda

Introduction

birdhousebuilder.recipe.conda is a Buildout recipe to install Anaconda packages. This recipe is used by the Birdhouse project.

Usage

The recipe requires that Anaconda is already installed. You can use the buildout option anaconda-home to set the prefix for the anaconda installation. You can also use the recipe option prefix to set the conda prefix. Otherwise the environment variable CONDA_PREFIX (variable is set when activating a conda environment) is used as conda prefix.

Supported options

This recipe supports the following options:

anaconda-home

Buildout option pointing to the root folder of the Anaconda installation. Default: $HOME/anaconda.

conda-channels

Buildout option (optional) with channels of conda packages. Default: defaults

conda-offline

Buildout option (optional) to set conda offline mode. It has no effect when buildout is already in offline mode. Default: false

channel-priority

Buildout option (optional) to set channel priority in conda install. Default: true

prefix

Path to the conda prefix (optional). If not given then CONDA_PREFIX or anaconda-home will be used.

pkgs

A list of packages to install, separated by space.

channels

A list of space separated conda channels (optional). These channels are merged with conda-channels option. Default: defaults.

override-channels

If True then default channels from ~/.condarc are ignored (optional). Default. true.

no-pin

If True then conda pinned file is ignored (optional). Default: false.

env

Name of conda environment used for installation (optional). If environment is missing then packages are installed in the active environment.

default-pkgs

A list of packages to install when creating a conda environment separated by space (optional). Default: python

pip-pkgs

A list of packages which are installed by pip into the conda enviroment (optional).

Example usage

The following example buildout.cfg installs the packages in the active conda environment.

[buildout]
parts = conda

[conda]
recipe = birdhousebuilder.recipe.conda
pkgs = lxml owslib
channels = defaults birdhouse