Skip to content
This repository has been archived by the owner on Sep 22, 2020. It is now read-only.

bird-house/birdhousebuilder.recipe.conda

Repository files navigation

birdhousebuilder.recipe.conda

Travis Build GitHub license Join the chat at https://gitter.im/bird-house/birdhouse

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).

Note

If buildout is run in offline mode no network connection will be establish and conda packages will not be installed.

Note

If buildout is run in newest=false mode then conda dependencies are not updated.

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