build

Package Builder

Functions

build(recipe[, pkg_paths, testonly, ...])

Build a single recipe for a single env

build_recipes(recipe_folder, config_path, ...)

Build one or many bioconda packages.

conda_build_purge()

Calls conda build purge and optionally conda clean

get_subdags(dag, n_workers, worker_offset)

remove_cycles(dag, name2recipes, failed, ...)

Classes

BuildResult(success, mulled_images)

Result tuple for builds comprising success status and list of docker images

Documentation

class bioconda_utils.build.BuildResult(success, mulled_images)

Result tuple for builds comprising success status and list of docker images

property mulled_images

Alias for field number 1

property success

Alias for field number 0

bioconda_utils.build.conda_build_purge()[source]

Calls conda build purge and optionally conda clean

conda clean --all is called if we haveless than 300 MB free space on the current disk.

Return type:

None

bioconda_utils.build.build(recipe, pkg_paths=None, testonly=False, mulled_test=True, channels=None, docker_builder=None, raise_error=False, linter=None)[source]

Build a single recipe for a single env

Parameters:

  • recipe (str) – Path to recipe

  • pkg_paths (Optional[List[str]]) – List of paths to expected packages

  • testonly (bool) – Only run the tests described in the meta.yaml

  • mulled_test (bool) – Run tests in minimal docker container

  • channels (Optional[List[str]]) – Channels to include via the --channel argument to conda-build. Higher priority channels should come first.

  • docker_builder (Optional[RecipeBuilder]) – docker_utils.RecipeBuilder object Use this docker builder to build the recipe, copying over the built recipe to the host’s conda-bld directory.

  • raise_error (bool) – Instead of returning a failed build result, raise the error instead. Used for testing.

  • linter – Linter to use for checking recipes

Return type:

BuildResult

bioconda_utils.build.build_recipes(recipe_folder, config_path, recipes, mulled_test=True, testonly=False, force=False, docker_builder=None, label=None, anaconda_upload=False, mulled_upload_target=None, check_channels=None, do_lint=None, lint_exclude=None, n_workers=1, worker_offset=0, keep_old_work=False)[source]

Build one or many bioconda packages.

Parameters:

  • recipe_folder (str) – Directory containing possibly many, and possibly nested, recipes.

  • config_path (str) – Path to config file

  • packages – Glob indicating which packages should be considered. Note that packages matching the glob will still be filtered out by any blacklists specified in the config.

  • mulled_test (bool) – If true, test the package in a minimal container.

  • testonly (bool) – If true, only run test.

  • force (bool) – If true, build the recipe even though it would otherwise be filtered out.

  • docker_builder (Optional[RecipeBuilder]) – If specified, use to build all recipes

  • label (Optional[str]) – If specified, use to label uploaded packages on anaconda. Default is “main” label.

  • anaconda_upload (bool) – If true, upload the package(s) to anaconda.org.

  • mulled_upload_target – If specified, upload the mulled docker image to the given target on quay.io.

  • check_channels (Optional[List[str]]) – Channels to check to see if packages already exist in them. Defaults to every channel in the config file except “defaults”.

  • do_lint (Optional[bool]) – Whether to run linter

  • lint_exclude (Optional[List[str]]) – List of linting functions to exclude.

  • n_workers (int) – The number of parallel instances of bioconda-utils being run. The sub-DAGs are then split into groups of n_workers size.

  • worker_offset (int) – If n_workers is >1, then every worker_offset within a given group of sub-DAGs will be processed.

  • keep_old_work (bool) – Do not remove anything from environment, even after successful build and test.