Installation

Requirements

1. pip

pip is a Python package manager that makes it much easier to download and install Python packages, as a part of such wbuild and snakemake. If you don’t have pip installed, this Python installation guide can guide you through the process.

Advanced users who want to get the Python packages elsehow can skip this step.

2. snakemake

Snakemake is essential to wBuild workflow (learn why in the Overview of functionality). You can get Snakemake either using pip or building from sources. By installing wBuild from pip you automatically install the Snakemake, should it be absent.

3. R and packages

The original purpose of wBuild’s work is to let you put additional build/dependencies info in your R scripts, so we suppose you have already installed R. Now, the very important step for installation is to install various R packages:

  • knitr
  • rmarkdown
  • pandoc

as Snakemake inevitably uses them while working with wBuild.

You can install packages for R with install.packages(packagename) directive. Find out more for instance here.

Additionally for Windows users

You need to add R_HOME and pandoc home variables to your Path for Snakemake CLI to run correctly. See p.2 in this instruction.

Now, you are all ready and set up to install the wBuild itself.

Stable release

Please make sure you’ve read Requirements first.

To install wBuild, run this command in your terminal:

$ pip install wbuild

From sources

The sources for wBuild can be downloaded from the Github repo.

You can either clone the public repository:

$ git clone git://github.com/wachutka/wbuild

Or download the tarball:

$ curl  -OL https://github.com/wachutka/wbuild/tarball/master

Once you have a copy of the source, you can install it with:

$ python setup.py install