conda build
CONDA(1) User Commands CONDA(1)
NAME
conda - conda build
DESCRIPTION
usage: conda-build [-h] [-V] [-n] [--output] [--python PYTHON_VER]
[--perl PERL_VER] [--numpy NUMPY_VER] [--R R_VER] [--lua
LUA_VER] [--check] [--no-anaconda-upload] [--no-include-recipe]
[-s] [-t] [--no-test] [-b] [-p] [--skip-existing]
[--keep-old-work] [--dirty] [-q] [--debug] [--token TOKEN]
[--user USER] [--password PASSWORD] [--sign SIGN] [--sign-with
SIGN_WITH] [--identity IDENTITY] [--config-file CONFIG_FILE]
[--repository REPOSITORY] [--no-activate] [--no-build-id]
[--croot CROOT] [--no-verify] [--output-folder OUTPUT_FOLDER]
[--no-prefix-length-fallback] [--prefix-length-fallback] [--pre-
fix-length _PREFIX_LENGTH] [--no-locking] [--no-remove-work-dir]
[--long-test-prefix] [--no-long-test-prefix] [-c CHANNEL]
[--override-channels] RECIPE_PATH [RECIPE_PATH ...]
Tool for building conda packages. A conda package is a binary tarball
containing system-level libraries, Python modules, executable programs,
or other components. conda keeps track of dependencies between packages
and platform specifics, making it simple to create working environments
from different sets of packages.
positional arguments:
RECIPE_PATH
Path to recipe directory. Pass 'purge' here to clean the work
and test intermediates.
optional arguments:
-h, --help
Show this help message and exit.
-V, --version
Show the conda-build version number and exit.
-n, --no-source
When templating can't be completed, do not obtain the source to
try fill in related template variables.
--output
Output the conda package filename which would have been created
--python PYTHON_VER
Set the Python version used by conda build.
--perl PERL_VER
Set the Perl version used by conda build.
--numpy NUMPY_VER
Set the NumPy version used by conda build.
--R R_VER
Set the R version used by conda build.
--lua LUA_VER
Set the Lua version used by conda build.
--check
Only check (validate) the recipe.
--no-anaconda-upload
Do not ask to upload the package to anaconda.org.
--no-include-recipe
Don't include the recipe inside the built package.
-s, --source
Only obtain the source (but don't build).
-t, --test
Test package (assumes package is already built). RECIPE_DIR
argument can be either recipe directory, in which case source
download may be necessary to resolve packageversion, or path to
built package .tar.bz2 file, in which case no source is neces-
sary.
--no-test
Do not test the package.
-b, --build-only
Only run the build, without any post processing or testing.
Implies --no-test and --no-anaconda-upload.
-p, --post
Run the post-build logic. Implies --no-test and --noana-
conda-upload.
--skip-existing
Skip recipes for which there already exists an existing build
(locally or in the channels).
--keep-old-work
Deprecated. Same as --dirty.
--dirty
Do not remove work directory or _build environment, to speed up
debugging. Does not apply patches or download source.
-q, --quiet
do not display progress bar
--debug
Show debug output from source checkouts and conda
--token TOKEN
Token to pass through to anaconda upload
--user USER
User/organization to upload packages to on anaconda.org or pypi
--no-activate
do not activate the build and test envs; just prepend to PATH
--no-build-id
do not generate unique build folder names. Use if having issues
with paths being too long.
--croot CROOT
Build root folder. Equivalent to CONDA_BLD_PATH, but applies
only to this call of conda-build.
--no-verify
do not run verification on recipes or packages when building
--output-folder OUTPUT_FOLDER
folder to dump output package to. Package are moved here if
build or test succeeds. Destination folder must exist prior to
using this.
--no-prefix-length-fallback
Disable fallback to older 80 character prefix length if environ-
ment creation fails due to insufficient prefix length in depen-
dency packages
--prefix-length-fallback
Disable fallback to older 80 character prefix length if environ-
ment creation fails due to insufficient prefix length in depen-
dency packages
--prefix-length _PREFIX_LENGTH
length of build prefix. For packages with binaries that embed
the path, this is critical to ensuring that your package can run
as many places as possible. Notethat this value can be altered
by the OS below conda-build (e.g. encrypted filesystems on
Linux), and you should prefer to set --croot to a non-encrypted
location instead, so that you maintain a known prefix length.
--no-locking
Disable locking, to avoid unresolved race condition issues.
Unsafe to run multiplebuilds at once on one system with this
set.
--no-remove-work-dir
Disable removal of the work dir before testing. Be careful using
this option, as you package may depend on files that are not
included in the package, and may passtests, but ultimately fail
on installed systems.
--long-test-prefix
Use a long prefix for the test prefix, as well as the build pre-
fix. Affects only Linux and Mac. Prefix length matches the
--prefix-length flag. This is off by default in conda-build 2.x,
but will be enabled by default in conda-build 3.0.
--no-long-test-prefix
Do not use a long prefix for the test prefix, as well as the
build prefix. Affects only Linux and Mac. Prefix length matches
the --prefix-length flag. This is currently the default behav-
ior, and does not need to be set. This will change in
conda-build 3.0 (longtest-prefix enabled by default)
-c CHANNEL, --channel CHANNEL
Additional channel to search for packages. These are URLs
searched in the order they are given (including file:// for
local directories). Then, the defaults or channels from .condarc
are searched (unless --override-channels is given). You can use
'defaults' to get the default packages for conda, and 'system'
to get the system packages, which also takes .condarc into
account. You can also use any name and the .condarc chan-
nel_alias value will be prepended. The default channel_alias is
http://conda.anaconda.org/.
--override-channels
Do not search default or .condarc channels. Requires --channel.
PyPI upload parameters (twine):
--password PASSWORD
password to use when uploading packages to pypi
--sign SIGN
sign files when uploading to pypi
--sign-with SIGN_WITH
program to use to sign files when uploading to pypi
--identity IDENTITY
GPG identity to use to sign files when uploading to pypi
--config-file CONFIG_FILE
path to .pypirc file to use when uploading to pypi
--repository REPOSITORY, -r REPOSITORY
PyPI repository to upload to
Continuum Analytics June 2017 CONDA(1)