conda-build


CONDA(1)                         User Commands                        CONDA(1)




NAME

       conda - conda build


DESCRIPTION

       usage:  conda-build [-h] [-V] [-n] [--output] [--python PYTHON] [--perl
       PERL]

              [--numpy NUMPY] [--R R_BASE] [--lua LUA] [--bootstrap BOOTSTRAP]
              [--append-file   APPEND_SECTIONS_FILE]   [--clobber-file   CLOB-
              BER_SECTIONS_FILE] [-m VARIANT_CONFIG_FILES] [-e  EXCLUSIVE_CON-
              FIG_FILE]  [--old-build-string] [--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]  [--no-force-upload]  [--password
              PASSWORD]  [--sign  SIGN]  [--sign-with  SIGN_WITH]  [--identity
              IDENTITY] [--config-file CONFIG_FILE] [--repository  REPOSITORY]
              [--no-activate]   [--no-build-id]   [--croot  CROOT]  [--verify]
              [--output-folder  OUTPUT_FOLDER]   [--no-prefix-length-fallback]
              [--prefix-length-fallback]    [--prefix-length   _PREFIX_LENGTH]
              [--no-locking]   [--no-remove-work-dir]    [--error-overlinking]
              [--no-error-overlinking]                    [--long-test-prefix]
              [--no-long-test-prefix] [--keep-going]  [--cache-dir  CACHE_DIR]
              [--no-copy-test-source-files] [--merge-build-host] [--stats-file
              STATS_FILE] [--extra-deps EXTRA_DEPS [EXTRA_DEPS ...]] [-c CHAN-
              NEL] [--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
              Set the Python version used by conda build.

       --perl PERL
              Set the Perl version used by conda build.

       --numpy NUMPY
              Set the NumPy version used by conda build.

       --R R_BASE
              Set the R version used by conda build.

       --lua LUA
              Set the Lua version used by conda build.

       --bootstrap BOOTSTRAP
              Provide  initial  configuration in addition to recipe.  Can be a
              path to or name of an environment, which will be emulated in the
              package.

       --append-file APPEND_SECTIONS_FILE
              Append  data in meta.yaml with fields from this file.  Jinja2 is
              not done on appended fields

       --clobber-file CLOBBER_SECTIONS_FILE
              Clobber data in meta.yaml with fields from this file.  Jinja2 is
              not done on clobbered fields.

       -m VARIANT_CONFIG_FILES, --variant-config-files VARIANT_CONFIG_FILES
              Additional  variant  config  files  to add. These yaml files can
              contain keys such as `c_compiler` and `target_platform` to  form
              a build matrix.

       -e EXCLUSIVE_CONFIG_FILE, --exclusive-config-file EXCLUSIVE_CONFIG_FILE
              Exclusive  variant  config  file  to  add. Compared with --vari-
              ant-config-files, you're allowed only one file here. Providing a
              file  here disables searching in your home directory and in cwd.
              The file specified here comes at the  start  of  the  order,  as
              opposed to the end with --variant-config-files. Any config files
              in recipes and any config  files  specified  with  --variantcon-
              fig-files will override values from this file.

       --old-build-string
              Disable hash additions to filenames to distinguish package vari-
              ants from one another. NOTE: any filename collisions  are  yours
              to  handle.  Any  variants with overlapping names within a build
              will clobber each other.

       --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 package version, 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.

       -p, --test-run-post
              Run the post-build logic during testing.

       --skip-existing
              Skip recipes for which there already exists  an  existing  build
              (locally or in the channels).

       --keep-old-work
              Do  not  remove anything from environment, even after successful
              build and test.

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

       --label LABELS
              Label argument to pass through to anaconda upload

       --no-force-upload
              Disable force upload to anaconda.org, preventing overwriting any
              existing packages

       --zstd-compression-level {1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22}
              When building v2 packages, set the compression level used by
              conda-package-handling. Defaults to 19. Note that using levels
              above 19 is not advised due to high memory consumption.

       --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. Deprecated, please use --build-id-pat
              instead

       --build-id-pat BUILD_ID_PAT
              specify a templated pattern to use as 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.

       --verify
              run verification on recipes or packages when building

       --no-verify
              do not run verification on recipes or packages when building

       --strict-verify
              Exit if any conda-verify check fail, instead of only printing them

       --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 multiple builds 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 pass tests, but ultimately fail
              on installed systems.

       --error-overlinking
              Enable error when shared libraries from transitive  dependencies
              are  directly  linked  to any executables or shared libraries in
              built packages. This is disabled by default, but will be enabled
              by default in condabuild 4.0.

       --no-error-overlinking
              Disable error when shared libraries from transitive dependencies
              are directly linked to any executables or  shared  libraries  in
              built packages. This is currently the default behavior, but will
              change in conda-build 4.0.

       --error-overdepending
              Enable error when packages with names beginning lib or which have
              run_exports are not auto-loaded by the OSes DSO loading mechanism
              by any of the files in this package.

       --no-error-overdepending
              Disable error when packages with names beginning lib or which have
              run_exports are not auto-loaded by the OSes DSO loading mechanism
              by any of the files in this package.

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

       --keep-going, -k
              When running tests, keep going after each failure.   Default  is
              to stop on the first failure.

       --cache-dir CACHE_DIR
              Path to store the source files (archives, git clones, etc.) dur-
              ing the build.

       --no-copy-test-source-files
              Disables copying the files necessary  for  testing  the  package
              into  the  info/test  folder. Passing this argument means it may
              not be possible to test the  package  without  internet  access.
              There is also a danger that the source archive(s) containing the
              files could become unavailable sometime in the future.

       --merge-build-host
              Merge the build and host directories, even when host section  or
              compiler jinja2 is present

       --stats-file STATS_FILE
              File path to save build statistics to. Stats are in JSON format

       --extra-deps EXTRA_DEPS [EXTRA_DEPS ...]
              Extra  dependencies  to  add  to all environment creation steps.
              This is only enabled for testing with the  -t  or  --test  flag.
              Change meta.yaml or use templates otherwise.

       -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

   conda commands available from other packages:
              build build-all convert develop env  index  inspect  metapackage
              render server sign skeleton smithy tracker verify



Anaconda, Inc.                     June 2018                          CONDA(1)