def get_render_parser():
p = ArgumentParser(
description="""
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.""",
conflict_handler='resolve'
)
p.add_argument(
'-V', '--version',
action='version',
help='Show the conda-build version number and exit.',
version='conda-build %s' % __version__,
)
p.add_argument(
'-n', "--no-source",
action="store_true",
help="When templating can't be completed, do not obtain the \
source to try fill in related template variables.",
)
p.add_argument(
"--output",
action="store_true",
help="Output the conda package filename which would have been "
"created",
)
p.add_argument(
'--python',
action="append",
help="Set the Python version used by conda build.",
)
p.add_argument(
'--perl',
action="append",
help="Set the Perl version used by conda build.",
)
p.add_argument(
'--numpy',
action="append",
help="Set the NumPy version used by conda build.",
)
p.add_argument(
'--R',
action="append",
help="""Set the R version used by conda build.""",
dest="r_base"
)
p.add_argument(
'--lua',
action="append",
help="Set the Lua version used by conda build.",
)
p.add_argument(
'--bootstrap',
help="""Provide initial configuration in addition to recipe.
Can be a path to or name of an environment, which will be emulated
in the package.""",
)
p.add_argument(
'--append-file',
help="""Append data in meta.yaml with fields from this file. Jinja2 is not done
on appended fields""",
dest='append_sections_file',
)
p.add_argument(
'--clobber-file',
help="""Clobber data in meta.yaml with fields from this file. Jinja2 is not done
on clobbered fields.""",
dest='clobber_sections_file',
)
p.add_argument(
'-m', '--variant-config-files',
dest='variant_config_files',
action="append",
help="""Additional variant config files to add. These yaml files can contain
keys such as `c_compiler` and `target_platform` to form a build matrix."""
)
add_parser_channels(p)
return p
def parse_args(args):
p = get_render_parser()
p.description = """
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."""
p.add_argument(
"--check",
action="store_true",
help="Only check (validate) the recipe.",
)
p.add_argument(
"--no-anaconda-upload",
action="store_false",
help="Do not ask to upload the package to anaconda.org.",
dest='anaconda_upload',
default=binstar_upload,
)
p.add_argument(
"--no-binstar-upload",
action="store_false",
help=argparse.SUPPRESS,
dest='anaconda_upload',
default=binstar_upload,
)
p.add_argument(
"--no-include-recipe",
action="store_false",
help="Don't include the recipe inside the built package.",
dest='include_recipe',
default=cc_conda_build.get('include_recipe', 'true').lower() == 'true',
)
p.add_argument(
'-s',
"--source",
action="store_true",
help="Only obtain the source (but don't build).",
)
p.add_argument(
'-t',
"--test",
action="store_true",
help=
"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 necessary.",
)
p.add_argument(
'--no-test',
action='store_true',
dest='notest',
help="Do not test the package.",
)
p.add_argument(
'-b',
'--build-only',
action="store_true",
help="""Only run the build, without any post processing or
testing. Implies --no-test and --no-anaconda-upload.""",
)
p.add_argument(
'-p',
'--post',
action="store_true",
help=
"Run the post-build logic. Implies --no-test and --no-anaconda-upload.",
)
p.add_argument(
'recipe',
metavar='RECIPE_PATH',
nargs='+',
help="Path to recipe directory. Pass 'purge' here to clean the "
"work and test intermediates.",
)
p.add_argument(
'--skip-existing',
action='store_true',
help=("Skip recipes for which there already exists an existing build "
"(locally or in the channels)."),
default=cc_conda_build.get('skip_existing', 'false').lower() == 'true',
)
p.add_argument(
'--keep-old-work',
action='store_true',
dest='keep_old_work',
help="Do not remove anything from environment, even after successful "
"build and test.")
p.add_argument(
'--dirty',
action='store_true',
help='Do not remove work directory or _build environment, '
'to speed up debugging. Does not apply patches or download source.')
p.add_argument(
'-q',
"--quiet",
action="store_true",
help="do not display progress bar",
default=cc_conda_build.get('quiet', 'false').lower() == 'true',
)
p.add_argument(
'--debug',
action="store_true",
help="Show debug output from source checkouts and conda",
)
p.add_argument(
'--token',
help="Token to pass through to anaconda upload",
default=cc_conda_build.get('anaconda_token'),
)
p.add_argument(
'--user',
help="User/organization to upload packages to on anaconda.org or pypi",
default=cc_conda_build.get('user'),
)
p.add_argument(
'--label',
action='append',
dest='labels',
default=[],
help="Label argument to pass through to anaconda upload",
)
p.add_argument(
'--no-force-upload',
help=
"Disable force upload to anaconda.org, preventing overwriting any existing packages",
dest='force_upload',
default=True,
action='store_false',
)
pypi_grp = p.add_argument_group("PyPI upload parameters (twine)")
pypi_grp.add_argument(
'--password',
help="password to use when uploading packages to pypi",
)
pypi_grp.add_argument('--sign',
default=False,
help="sign files when uploading to pypi")
pypi_grp.add_argument(
'--sign-with',
default='gpg',
dest='sign_with',
help="program to use to sign files when uploading to pypi")
pypi_grp.add_argument(
'--identity',
help="GPG identity to use to sign files when uploading to pypi")
pypi_grp.add_argument(
'--config-file',
help="path to .pypirc file to use when uploading to pypi",
default=(abspath(expanduser(expandvars(cc_conda_build.get('pypirc'))))
if cc_conda_build.get('pypirc') else
cc_conda_build.get('pypirc')),
)
pypi_grp.add_argument(
'--repository',
'-r',
help="PyPI repository to upload to",
default=cc_conda_build.get('pypi_repository', 'pypitest'),
)
p.add_argument(
"--no-activate",
action="store_false",
help="do not activate the build and test envs; just prepend to PATH",
dest='activate',
default=cc_conda_build.get('activate', 'true').lower() == 'true',
)
p.add_argument(
"--no-build-id",
action="store_false",
help=
("do not generate unique build folder names. Use if having issues with "
"paths being too long."),
dest='set_build_id',
# note: inverted - dest stores positive logic
default=cc_conda_build.get('set_build_id', 'true').lower() == 'true',
)
p.add_argument(
"--croot",
help=
("Build root folder. Equivalent to CONDA_BLD_PATH, but applies only "
"to this call of conda-build."))
p.add_argument(
"--verify",
action="store_true",
help="run verification on recipes or packages when building",
default=cc_conda_build.get('verify', 'true').lower() == 'true',
)
p.add_argument(
"--no-verify",
action="store_false",
dest="verify",
help="do not run verification on recipes or packages when building",
default=cc_conda_build.get('verify', 'true').lower() == 'true',
)
p.add_argument(
"--strict-verify",
action="store_true",
dest="exit_on_verify_error",
help=
"Exit if any conda-verify check fail, instead of only printing them",
default=cc_conda_build.get('exit_on_verify_error',
'false').lower() == 'true',
)
p.add_argument(
"--output-folder",
help=
("folder to dump output package to. Package are moved here if build or test succeeds."
" Destination folder must exist prior to using this."),
default=cc_conda_build.get('output_folder'))
p.add_argument(
"--no-prefix-length-fallback",
dest='prefix_length_fallback',
action="store_false",
help=
("Disable fallback to older 80 character prefix length if environment creation"
" fails due to insufficient prefix length in dependency packages"),
default=True,
)
p.add_argument(
"--prefix-length-fallback",
dest='prefix_length_fallback',
action="store_true",
help=
("Disable fallback to older 80 character prefix length if environment creation"
" fails due to insufficient prefix length in dependency packages"),
# this default will change to false in the future, when we deem that the community has
# had enough time to build long-prefix length packages.
default=True,
)
p.add_argument(
"--prefix-length",
dest='_prefix_length',
help=
("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. Note"
"that 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."),
# this default will change to false in the future, when we deem that the community has
# had enough time to build long-prefix length packages.
default=255,
type=int,
)
p.add_argument(
"--no-locking",
dest='locking',
default=True,
action="store_false",
help=
("Disable locking, to avoid unresolved race condition issues. Unsafe to run multiple "
"builds at once on one system with this set."))
p.add_argument(
"--no-remove-work-dir",
dest='remove_work_dir',
default=True,
action="store_false",
help=
("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."))
p.add_argument(
"--error-overlinking",
dest='error_overlinking',
action="store_true",
help=
("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 conda-build 4.0."),
default=cc_conda_build.get('error_overlinking',
'false').lower() == 'true',
)
p.add_argument(
"--no-error-overlinking",
dest='error_overlinking',
action="store_false",
help=
("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."),
default=cc_conda_build.get('error_overlinking',
'false').lower() == 'true',
)
p.add_argument(
"--error-overdepending",
dest='error_overdepending',
action="store_true",
help=
("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."),
default=cc_conda_build.get('error_overdepending',
'false').lower() == 'true',
)
p.add_argument(
"--no-error-overdepending",
dest='error_overdepending',
action="store_false",
help=
("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."),
default=cc_conda_build.get('error_overdepending',
'false').lower() == 'true',
)
p.add_argument(
"--long-test-prefix",
action="store_true",
help=
("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 on by "
"default in conda-build 3.0+"),
default=cc_conda_build.get('long_test_prefix',
'true').lower() == 'true',
)
p.add_argument(
"--no-long-test-prefix",
dest="long_test_prefix",
action="store_false",
help=
("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. "
),
default=cc_conda_build.get('long_test_prefix',
'true').lower() == 'true',
)
p.add_argument(
'--keep-going',
'-k',
action='store_true',
help=
("When running tests, keep going after each failure. Default is to stop on the first "
"failure."))
p.add_argument(
'--cache-dir',
help=
('Path to store the source files (archives, git clones, etc.) during the build.'
),
default=(abspath(
expanduser(expandvars(cc_conda_build.get('cache_dir'))))
if cc_conda_build.get('cache_dir') else
cc_conda_build.get('cache_dir')),
)
p.add_argument(
"--no-copy-test-source-files",
dest="copy_test_source_files",
action="store_false",
default=cc_conda_build.get('copy_test_source_files',
'true').lower() == 'true',
help=
("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."))
p.add_argument(
'--merge-build-host',
action="store_true",
help=
('Merge the build and host directories, even when host section or compiler '
'jinja2 is present'),
default=cc_conda_build.get('merge_build_host',
'false').lower() == 'true',
)
p.add_argument(
'--stats-file',
help=('File path to save build statistics to. Stats are '
'in JSON format'),
)
p.add_argument(
'--extra-deps',
nargs='+',
help=
('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.'),
)
add_parser_channels(p)
args = p.parse_args(args)
return p, args
def parse_args(args):
p = ArgumentParser(description='''
Tool for building conda metapackages. A metapackage is a package with no
files, only metadata. They are typically used to collect several packages
together into a single package via dependencies.
NOTE: Metapackages can also be created by creating a recipe with the necessary
metadata in the meta.yaml, but a metapackage can be created entirely from the
command line with the conda metapackage command.
''', )
p.add_argument(
"--no-anaconda-upload",
action="store_false",
help="Do not ask to upload the package to anaconda.org.",
dest='anaconda_upload',
default=binstar_upload,
)
p.add_argument(
"--no-binstar-upload",
action="store_false",
help=argparse.SUPPRESS,
dest='anaconda_upload',
default=binstar_upload,
)
p.add_argument('--token', help="Token to pass through to anaconda upload")
p.add_argument(
'--user',
help="User/organization to upload packages to on anaconda.org")
p.add_argument(
'--label',
action='append',
dest='labels',
default=[],
help="Label argument to pass through to anaconda upload",
)
p.add_argument(
"name",
help="Name of the created package.",
)
p.add_argument(
"version",
help="Version of the created package.",
)
p.add_argument(
"--build-number",
type=int,
default=0,
help="Build number for the package (default is 0).",
)
p.add_argument(
"--build-string",
default=None,
help=
"Build string for the package (default is automatically generated).",
)
p.add_argument(
"--dependencies",
"-d",
nargs='*',
default=(),
help=
"""The dependencies of the package. To specify a version restriction for a
dependency, wrap the dependency in quotes, like 'package >=2.0'.""",
)
p.add_argument(
"--home",
help="The homepage for the metapackage.",
)
p.add_argument("--license",
help="The license of the metapackage.",
dest='license_name')
p.add_argument(
"--summary",
help="""Summary of the package. Pass this in as a string on the command
line, like --summary 'A metapackage for X'. It is recommended to use
single quotes if you are not doing variable substitution to avoid
interpretation of special characters.""",
)
p.add_argument(
"--entry-points",
nargs='*',
default=(),
help=
"""Python entry points to create automatically. They should use the same
syntax as in the meta.yaml of a recipe, e.g., --entry-points
bsdiff4=bsdiff4.cli:main_bsdiff4 will create an entry point called
bsdiff4 that calls bsdiff4.cli.main_bsdiff4(). """,
)
add_parser_channels(p)
args = p.parse_args(args)
return p, args
def parse_args(args):
p = get_render_parser()
p.description = """
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."""
p.add_argument(
"--check",
action="store_true",
help="Only check (validate) the recipe.",
)
p.add_argument(
"--no-anaconda-upload",
action="store_false",
help="Do not ask to upload the package to anaconda.org.",
dest='anaconda_upload',
default=binstar_upload,
)
p.add_argument(
"--no-binstar-upload",
action="store_false",
help=argparse.SUPPRESS,
dest='anaconda_upload',
default=binstar_upload,
)
p.add_argument(
"--no-include-recipe",
action="store_false",
help="Don't include the recipe inside the built package.",
dest='include_recipe',
default=True,
)
p.add_argument(
'-s',
"--source",
action="store_true",
help="Only obtain the source (but don't build).",
)
p.add_argument(
'-t',
"--test",
action="store_true",
help=
"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 necessary.",
)
p.add_argument(
'--no-test',
action='store_true',
dest='notest',
help="Do not test the package.",
)
p.add_argument(
'-b',
'--build-only',
action="store_true",
help="""Only run the build, without any post processing or
testing. Implies --no-test and --no-anaconda-upload.""",
)
p.add_argument(
'-p',
'--post',
action="store_true",
help=
"Run the post-build logic. Implies --no-test and --no-anaconda-upload.",
)
p.add_argument(
'recipe',
metavar='RECIPE_PATH',
nargs='+',
choices=RecipeCompleter(),
help="Path to recipe directory. Pass 'purge' here to clean the "
"work and test intermediates.",
)
p.add_argument(
'--skip-existing',
action='store_true',
help="""Skip recipes for which there already exists an existing build
(locally or in the channels). """)
p.add_argument('--keep-old-work',
action='store_true',
dest='dirty',
help="Deprecated. Same as --dirty.")
p.add_argument(
'--dirty',
action='store_true',
help='Do not remove work directory or _build environment, '
'to speed up debugging. Does not apply patches or download source.')
p.add_argument(
'-q',
"--quiet",
action="store_true",
help="do not display progress bar",
)
p.add_argument(
'--debug',
action="store_true",
help="Show debug output from source checkouts and conda",
)
p.add_argument('--token', help="Token to pass through to anaconda upload")
p.add_argument(
'--user',
help="User/organization to upload packages to on anaconda.org or pypi")
pypi_grp = p.add_argument_group("PyPI upload parameters (twine)")
pypi_grp.add_argument(
'--password', help="password to use when uploading packages to pypi")
pypi_grp.add_argument('--sign',
default=False,
help="sign files when uploading to pypi")
pypi_grp.add_argument(
'--sign-with',
default='gpg',
dest='sign_with',
help="program to use to sign files when uploading to pypi")
pypi_grp.add_argument(
'--identity',
help="GPG identity to use to sign files when uploading to pypi")
pypi_grp.add_argument(
'--config-file',
help="path to .pypirc file to use when uploading to pypi")
pypi_grp.add_argument('--repository',
'-r',
default='pypitest',
help="PyPI repository to upload to")
p.add_argument(
"--no-activate",
action="store_false",
help="do not activate the build and test envs; just prepend to PATH",
dest='activate',
)
p.add_argument(
"--no-build-id",
action="store_false",
help=
("do not generate unique build folder names. Use if having issues with "
"paths being too long."),
dest='set_build_id',
)
p.add_argument(
"--croot",
help=
("Build root folder. Equivalent to CONDA_BLD_PATH, but applies only "
"to this call of conda-build."))
p.add_argument(
"--no-verify",
action="store_true",
help=("do not run verification on recipes or packages when building"))
p.add_argument(
"--output-folder",
help=
("folder to dump output package to. Package are moved here if build or test succeeds."
" Destination folder must exist prior to using this."))
p.add_argument(
"--no-prefix-length-fallback",
dest='prefix_length_fallback',
action="store_false",
help=
("Disable fallback to older 80 character prefix length if environment creation"
" fails due to insufficient prefix length in dependency packages"),
default=True,
)
p.add_argument(
"--prefix-length-fallback",
dest='prefix_length_fallback',
action="store_true",
help=
("Disable fallback to older 80 character prefix length if environment creation"
" fails due to insufficient prefix length in dependency packages"),
# this default will change to false in the future, when we deem that the community has
# had enough time to build long-prefix length packages.
default=True,
)
p.add_argument(
"--prefix-length",
dest='_prefix_length',
help=
("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. Note"
"that 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."),
# this default will change to false in the future, when we deem that the community has
# had enough time to build long-prefix length packages.
default=255,
type=int,
)
p.add_argument(
"--no-locking",
dest='locking',
default=True,
action="store_false",
help=
("Disable locking, to avoid unresolved race condition issues. Unsafe to run multiple"
"builds at once on one system with this set."))
p.add_argument(
"--no-remove-work-dir",
dest='remove_work_dir',
default=True,
action="store_false",
help=
("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."))
p.add_argument(
"--long-test-prefix",
default=True,
action="store_false",
help=
("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 on by "
"default in conda-build 3.0+"))
p.add_argument(
"--no-long-test-prefix",
dest="long_test_prefix",
action="store_false",
help=
("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. "
))
add_parser_channels(p)
args = p.parse_args(args)
return p, args
def get_render_parser():
p = ArgumentParser(description="""
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.""",
conflict_handler='resolve')
p.add_argument(
'-V',
'--version',
action='version',
help='Show the conda-build version number and exit.',
version='conda-build %s' % __version__,
)
p.add_argument(
'-n',
"--no-source",
action="store_true",
help="When templating can't be completed, do not obtain the \
source to try fill in related template variables.",
)
p.add_argument(
"--output",
action="store_true",
help="Output the conda package filename which would have been "
"created",
)
p.add_argument(
'--python',
action="append",
help="Set the Python version used by conda build.",
)
p.add_argument(
'--perl',
action="append",
help="Set the Perl version used by conda build.",
)
p.add_argument(
'--numpy',
action="append",
help="Set the NumPy version used by conda build.",
)
p.add_argument('--R',
action="append",
help="""Set the R version used by conda build.""",
dest="r_base")
p.add_argument(
'--lua',
action="append",
help="Set the Lua version used by conda build.",
)
p.add_argument(
'--bootstrap',
help="""Provide initial configuration in addition to recipe.
Can be a path to or name of an environment, which will be emulated
in the package.""",
)
p.add_argument(
'--append-file',
help=
"""Append data in meta.yaml with fields from this file. Jinja2 is not done
on appended fields""",
dest='append_sections_file',
)
p.add_argument(
'--clobber-file',
help=
"""Clobber data in meta.yaml with fields from this file. Jinja2 is not done
on clobbered fields.""",
dest='clobber_sections_file',
)
p.add_argument(
'-m',
'--variant-config-files',
action="append",
help=
"""Additional variant config files to add. These yaml files can contain
keys such as `c_compiler` and `target_platform` to form a build matrix."""
)
p.add_argument(
'-e',
'--exclusive-config-files',
'--exclusive-config-file',
action="append",
help=
"""Exclusive variant config files to add. Providing files here disables
searching in your home directory and in cwd. The files specified here come 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 --variant-config-files will
override values from these files.""")
p.add_argument(
"--old-build-string",
dest="filename_hashing",
action="store_false",
default=cc_conda_build.get('filename_hashing',
'true').lower() == 'true',
help=("Disable hash additions to filenames to distinguish package "
"variants from one another. NOTE: any filename collisions are "
"yours to handle. Any variants with overlapping names within a "
"build will clobber each other."))
p.add_argument(
'--use-channeldata',
action='store_true',
dest='use_channeldata',
help=
("Use channeldata, if available, to determine run_exports. Otherwise packages "
"are downloaded to determine this information"))
p.add_argument(
'--variants',
nargs=1,
action=ParseYAMLArgument,
help=
('Variants to extend the build matrix. Must be a valid YAML instance, '
'such as "{python: [3.6, 3.7]}"'))
add_parser_channels(p)
return p
def parse_args(args):
p = get_render_parser()
p.description = """
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."""
p.add_argument(
"--check",
action="store_true",
help="Only check (validate) the recipe.",
)
p.add_argument(
"--no-anaconda-upload",
action="store_false",
help="Do not ask to upload the package to anaconda.org.",
dest='anaconda_upload',
default=cc.binstar_upload,
)
p.add_argument(
"--no-binstar-upload",
action="store_false",
help=argparse.SUPPRESS,
dest='anaconda_upload',
default=cc.binstar_upload,
)
p.add_argument(
"--no-include-recipe",
action="store_false",
help="Don't include the recipe inside the built package.",
dest='include_recipe',
default=True,
)
p.add_argument(
'-s',
"--source",
action="store_true",
help="Only obtain the source (but don't build).",
)
p.add_argument(
'-t',
"--test",
action="store_true",
help=
"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 necessary.",
)
p.add_argument(
'--no-test',
action='store_true',
dest='notest',
help="Do not test the package.",
)
p.add_argument(
'-b',
'--build-only',
action="store_true",
help="""Only run the build, without any post processing or
testing. Implies --no-test and --no-anaconda-upload.""",
)
p.add_argument(
'-p',
'--post',
action="store_true",
help=
"Run the post-build logic. Implies --no-test and --no-anaconda-upload.",
)
p.add_argument(
'recipe',
metavar='RECIPE_PATH',
nargs='+',
choices=RecipeCompleter(),
help="Path to recipe directory. Pass 'purge' here to clean the "
"work and test intermediates.",
)
p.add_argument(
'--skip-existing',
action='store_true',
help="""Skip recipes for which there already exists an existing build
(locally or in the channels). """)
p.add_argument(
'--keep-old-work',
action='store_true',
help="""Keep any existing, old work directory. Useful if debugging across
callstacks involving multiple packages/recipes. """)
p.add_argument(
'--dirty',
action='store_true',
help='Do not remove work directory or _build environment, '
'to speed up debugging. Does not apply patches or download source.')
p.add_argument(
'-q',
"--quiet",
action="store_true",
help="do not display progress bar",
)
p.add_argument(
'--debug',
action="store_true",
help="Show debug output from source checkouts and conda",
)
p.add_argument('--token', help="Token to pass through to anaconda upload")
p.add_argument(
'--user',
help="User/organization to upload packages to on anaconda.org")
p.add_argument(
"--no-activate",
action="store_false",
help="do not activate the build and test envs; just prepend to PATH",
dest='activate',
)
p.add_argument(
"--no-build-id",
action="store_false",
help=
("do not generate unique build folder names. Use if having issues with "
"paths being too long."),
dest='set_build_id',
)
p.add_argument(
"--croot",
help=
("Build root folder. Equivalent to CONDA_BLD_PATH, but applies only "
"to this call of conda-build."))
p.add_argument(
"--no-verify",
action="store_true",
help=("do not run verification on recipes or packages when building"))
add_parser_channels(p)
args = p.parse_args(args)
return p, args
def get_render_parser():
p = ArgumentParser(
description="""
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.""",
conflict_handler='resolve'
)
p.add_argument(
'-V', '--version',
action='version',
help='Show the conda-build version number and exit.',
version='conda-build %s' % __version__,
)
p.add_argument(
'-n', "--no-source",
action="store_true",
help="When templating can't be completed, do not obtain the \
source to try fill in related template variables.",
)
p.add_argument(
"--output",
action="store_true",
help="Output the conda package filename which would have been "
"created",
)
p.add_argument(
'--python',
action="append",
help="Set the Python version used by conda build.",
)
p.add_argument(
'--perl',
action="append",
help="Set the Perl version used by conda build.",
)
p.add_argument(
'--numpy',
action="append",
help="Set the NumPy version used by conda build.",
)
p.add_argument(
'--R',
action="append",
help="""Set the R version used by conda build.""",
dest="r_base"
)
p.add_argument(
'--lua',
action="append",
help="Set the Lua version used by conda build.",
)
p.add_argument(
'--bootstrap',
help="""Provide initial configuration in addition to recipe.
Can be a path to or name of an environment, which will be emulated
in the package.""",
)
p.add_argument(
'--append-file',
help="""Append data in meta.yaml with fields from this file. Jinja2 is not done
on appended fields""",
dest='append_sections_file',
)
p.add_argument(
'--clobber-file',
help="""Clobber data in meta.yaml with fields from this file. Jinja2 is not done
on clobbered fields.""",
dest='clobber_sections_file',
)
p.add_argument(
'-m', '--variant-config-files',
dest='variant_config_files',
action="append",
help="""Additional variant config files to add. These yaml files can contain
keys such as `c_compiler` and `target_platform` to form a build matrix."""
)
p.add_argument(
"--old-build-string", dest="filename_hashing", action="store_false",
default=cc_conda_build.get('filename_hashing', 'true').lower() == 'true',
help=("Disable hash additions to filenames to distinguish package "
"variants from one another. NOTE: any filename collisions are "
"yours to handle. Any variants with overlapping names within a "
"build will clobber each other.")
)
add_parser_channels(p)
return p
def get_render_parser():
p = ArgumentParser(description="""
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.""",
conflict_handler='resolve')
p.add_argument(
'-V',
'--version',
action='version',
help='Show the conda-build version number and exit.',
version='conda-build %s' % __version__,
)
p.add_argument(
'-n',
"--no-source",
action="store_true",
help="When templating can't be completed, do not obtain the \
source to try fill in related template variables.",
)
p.add_argument(
"--output",
action="store_true",
help="Output the conda package filename which would have been "
"created",
)
p.add_argument(
'--python',
action="append",
help="""Set the Python version used by conda build. Can be passed
multiple times to build against multiple versions. Can be 'all' to
build against all known versions (%r)""" %
[i for i in PythonVersionCompleter() if '.' in i],
metavar="PYTHON_VER",
choices=PythonVersionCompleter(),
)
p.add_argument(
'--perl',
action="append",
help="""Set the Perl version used by conda build. Can be passed
multiple times to build against multiple versions.""",
metavar="PERL_VER",
)
p.add_argument(
'--numpy',
action="append",
help="""Set the NumPy version used by conda build. Can be passed
multiple times to build against multiple versions. Can be 'all' to
build against all known versions (%r)""" %
[i for i in NumPyVersionCompleter() if '.' in i],
metavar="NUMPY_VER",
choices=NumPyVersionCompleter(),
)
p.add_argument(
'--R',
action="append",
help="""Set the R version used by conda build. Can be passed
multiple times to build against multiple versions.""",
metavar="R_VER",
choices=RVersionsCompleter(),
)
p.add_argument(
'--lua',
action="append",
help="Set the Lua version used by conda build. Can be passed"
"multiple times to build against multiple versions (%r)." %
[i for i in LuaVersionsCompleter()],
metavar="LUA_VER",
choices=LuaVersionsCompleter(),
)
add_parser_channels(p)
return p
def parse_args(args):
p = get_render_parser()
p.description = """
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."""
p.add_argument(
"--check",
action="store_true",
help="Only check (validate) the recipe.",
)
p.add_argument(
"--no-anaconda-upload",
action="store_false",
help="Do not ask to upload the package to anaconda.org.",
dest='anaconda_upload',
default=cc.binstar_upload,
)
p.add_argument(
"--no-binstar-upload",
action="store_false",
help=argparse.SUPPRESS,
dest='anaconda_upload',
default=cc.binstar_upload,
)
p.add_argument(
"--no-include-recipe",
action="store_false",
help="Don't include the recipe inside the built package.",
dest='include_recipe',
default=True,
)
p.add_argument(
'-s', "--source",
action="store_true",
help="Only obtain the source (but don't build).",
)
p.add_argument(
'-t', "--test",
action="store_true",
help="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 necessary.",
)
p.add_argument(
'--no-test',
action='store_true',
dest='notest',
help="Do not test the package.",
)
p.add_argument(
'-b', '--build-only',
action="store_true",
help="""Only run the build, without any post processing or
testing. Implies --no-test and --no-anaconda-upload.""",
)
p.add_argument(
'-p', '--post',
action="store_true",
help="Run the post-build logic. Implies --no-test and --no-anaconda-upload.",
)
p.add_argument(
'recipe',
metavar='RECIPE_PATH',
nargs='+',
choices=RecipeCompleter(),
help="Path to recipe directory. Pass 'purge' here to clean the "
"work and test intermediates.",
)
p.add_argument(
'--skip-existing',
action='store_true',
help="""Skip recipes for which there already exists an existing build
(locally or in the channels). """
)
p.add_argument(
'--keep-old-work',
action='store_true',
dest='dirty',
help="Deprecated. Same as --dirty."
)
p.add_argument(
'--dirty',
action='store_true',
help='Do not remove work directory or _build environment, '
'to speed up debugging. Does not apply patches or download source.'
)
p.add_argument(
'-q', "--quiet",
action="store_true",
help="do not display progress bar",
)
p.add_argument(
'--debug',
action="store_true",
help="Show debug output from source checkouts and conda",
)
p.add_argument(
'--token',
help="Token to pass through to anaconda upload"
)
p.add_argument(
'--user',
help="User/organization to upload packages to on anaconda.org or pypi"
)
pypi_grp = p.add_argument_group("PyPI upload parameters (twine)")
pypi_grp.add_argument(
'--password',
help="password to use when uploading packages to pypi"
)
pypi_grp.add_argument(
'--sign', default=False,
help="sign files when uploading to pypi"
)
pypi_grp.add_argument(
'--sign-with', default='gpg', dest='sign_with',
help="program to use to sign files when uploading to pypi"
)
pypi_grp.add_argument(
'--identity',
help="GPG identity to use to sign files when uploading to pypi"
)
pypi_grp.add_argument(
'--config-file',
help="path to .pypirc file to use when uploading to pypi"
)
pypi_grp.add_argument(
'--repository', default='pypi',
help="PyPI repository to upload to"
)
p.add_argument(
"--no-activate",
action="store_false",
help="do not activate the build and test envs; just prepend to PATH",
dest='activate',
)
p.add_argument(
"--no-build-id",
action="store_false",
help=("do not generate unique build folder names. Use if having issues with "
"paths being too long."),
dest='set_build_id',
)
p.add_argument(
"--croot",
help=("Build root folder. Equivalent to CONDA_BLD_PATH, but applies only "
"to this call of conda-build.")
)
p.add_argument(
"--no-verify",
action="store_true",
help=("do not run verification on recipes or packages when building")
)
p.add_argument(
"--output-folder",
help=("folder to dump output package to. Package are moved here if build or test succeeds."
" Destination folder must exist prior to using this.")
)
p.add_argument(
"--no-prefix-length-fallback", dest='prefix_length_fallback',
action="store_false",
help=("Disable fallback to older 80 character prefix length if environment creation"
" fails due to insufficient prefix length in dependency packages"),
default=True,
)
p.add_argument(
"--prefix-length-fallback", dest='prefix_length_fallback',
action="store_true",
help=("Disable fallback to older 80 character prefix length if environment creation"
" fails due to insufficient prefix length in dependency packages"),
# this default will change to false in the future, when we deem that the community has
# had enough time to build long-prefix length packages.
default=True,
)
p.add_argument(
"--prefix-length", dest='_prefix_length',
help=("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. Note"
"that 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."),
# this default will change to false in the future, when we deem that the community has
# had enough time to build long-prefix length packages.
default=255, type=int,
)
p.add_argument(
"--no-locking", dest='locking', default=True, action="store_false",
help=("Disable locking, to avoid unresolved race condition issues. Unsafe to run multiple"
"builds at once on one system with this set.")
)
p.add_argument(
"--no-remove-work-dir", dest='remove_work_dir', default=True, action="store_false",
help=("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.")
)
add_parser_channels(p)
args = p.parse_args(args)
return p, args
def parse_args(args):
p = get_render_parser()
p.description = """
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."""
p.add_argument(
"--check",
action="store_true",
help="Only check (validate) the recipe.",
)
p.add_argument(
"--no-anaconda-upload",
action="store_false",
help="Do not ask to upload the package to anaconda.org.",
dest='anaconda_upload',
default=binstar_upload,
)
p.add_argument(
"--no-binstar-upload",
action="store_false",
help=argparse.SUPPRESS,
dest='anaconda_upload',
default=binstar_upload,
)
p.add_argument(
"--no-include-recipe",
action="store_false",
help="Don't include the recipe inside the built package.",
dest='include_recipe',
default=cc_conda_build.get('include_recipe', 'true').lower() == 'true',
)
p.add_argument(
'-s', "--source",
action="store_true",
help="Only obtain the source (but don't build).",
)
p.add_argument(
'-t', "--test",
action="store_true",
help="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 necessary.",
)
p.add_argument(
'--no-test',
action='store_true',
dest='notest',
help="Do not test the package.",
)
p.add_argument(
'-b', '--build-only',
action="store_true",
help="""Only run the build, without any post processing or
testing. Implies --no-test and --no-anaconda-upload.""",
)
p.add_argument(
'-p', '--post',
action="store_true",
help="Run the post-build logic. Implies --no-test and --no-anaconda-upload.",
)
p.add_argument(
'recipe',
metavar='RECIPE_PATH',
nargs='+',
help="Path to recipe directory. Pass 'purge' here to clean the "
"work and test intermediates.",
)
p.add_argument(
'--skip-existing',
action='store_true',
help=("Skip recipes for which there already exists an existing build "
"(locally or in the channels)."),
default=cc_conda_build.get('skip_existing', 'false').lower() == 'true',
)
p.add_argument(
'--keep-old-work',
action='store_true',
dest='keep_old_work',
help="Do not remove anything from environment, even after successful "
"build and test."
)
p.add_argument(
'--dirty',
action='store_true',
help='Do not remove work directory or _build environment, '
'to speed up debugging. Does not apply patches or download source.'
)
p.add_argument(
'-q', "--quiet",
action="store_true",
help="do not display progress bar",
default=cc_conda_build.get('quiet', 'false').lower() == 'true',
)
p.add_argument(
'--debug',
action="store_true",
help="Show debug output from source checkouts and conda",
)
p.add_argument(
'--token',
help="Token to pass through to anaconda upload",
default=cc_conda_build.get('anaconda_token'),
)
p.add_argument(
'--user',
help="User/organization to upload packages to on anaconda.org or pypi",
default=cc_conda_build.get('user'),
)
p.add_argument(
'--label', action='append', dest='labels', default=[],
help="Label argument to pass through to anaconda upload",
)
p.add_argument(
'--no-force-upload',
help="Disable force upload to anaconda.org, preventing overwriting any existing packages",
dest='force_upload',
default=True,
action='store_false',
)
pypi_grp = p.add_argument_group("PyPI upload parameters (twine)")
pypi_grp.add_argument(
'--password',
help="password to use when uploading packages to pypi",
)
pypi_grp.add_argument(
'--sign', default=False,
help="sign files when uploading to pypi"
)
pypi_grp.add_argument(
'--sign-with', default='gpg', dest='sign_with',
help="program to use to sign files when uploading to pypi"
)
pypi_grp.add_argument(
'--identity',
help="GPG identity to use to sign files when uploading to pypi"
)
pypi_grp.add_argument(
'--config-file',
help="path to .pypirc file to use when uploading to pypi",
default=(abspath(expanduser(expandvars(cc_conda_build.get('pypirc'))))
if cc_conda_build.get('pypirc')
else cc_conda_build.get('pypirc')),
)
pypi_grp.add_argument(
'--repository', '-r', help="PyPI repository to upload to",
default=cc_conda_build.get('pypi_repository', 'pypitest'),
)
p.add_argument(
"--no-activate",
action="store_false",
help="do not activate the build and test envs; just prepend to PATH",
dest='activate',
default=cc_conda_build.get('activate', 'true').lower() == 'true',
)
p.add_argument(
"--no-build-id",
action="store_false",
help=("do not generate unique build folder names. Use if having issues with "
"paths being too long."),
dest='set_build_id',
# note: inverted - dest stores positive logic
default=cc_conda_build.get('set_build_id', 'true').lower() == 'true',
)
p.add_argument(
"--croot",
help=("Build root folder. Equivalent to CONDA_BLD_PATH, but applies only "
"to this call of conda-build.")
)
p.add_argument(
"--verify",
action="store_true",
help="run verification on recipes or packages when building",
default=cc_conda_build.get('verify', 'true').lower() == 'true',
)
p.add_argument(
"--no-verify",
action="store_false",
dest="verify",
help="do not run verification on recipes or packages when building",
default=cc_conda_build.get('verify', 'true').lower() == 'true',
)
p.add_argument(
"--strict-verify",
action="store_true",
dest="exit_on_verify_error",
help="Exit if any conda-verify check fail, instead of only printing them",
default=cc_conda_build.get('exit_on_verify_error', 'false').lower() == 'true',
)
p.add_argument(
"--output-folder",
help=("folder to dump output package to. Package are moved here if build or test succeeds."
" Destination folder must exist prior to using this.")
)
p.add_argument(
"--no-prefix-length-fallback", dest='prefix_length_fallback',
action="store_false",
help=("Disable fallback to older 80 character prefix length if environment creation"
" fails due to insufficient prefix length in dependency packages"),
default=True,
)
p.add_argument(
"--prefix-length-fallback", dest='prefix_length_fallback',
action="store_true",
help=("Disable fallback to older 80 character prefix length if environment creation"
" fails due to insufficient prefix length in dependency packages"),
# this default will change to false in the future, when we deem that the community has
# had enough time to build long-prefix length packages.
default=True,
)
p.add_argument(
"--prefix-length", dest='_prefix_length',
help=("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. Note"
"that 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."),
# this default will change to false in the future, when we deem that the community has
# had enough time to build long-prefix length packages.
default=255, type=int,
)
p.add_argument(
"--no-locking", dest='locking', default=True, action="store_false",
help=("Disable locking, to avoid unresolved race condition issues. Unsafe to run multiple "
"builds at once on one system with this set.")
)
p.add_argument(
"--no-remove-work-dir", dest='remove_work_dir', default=True, action="store_false",
help=("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.")
)
p.add_argument(
"--error-overlinking", dest='error_overlinking', action="store_true",
help=("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 conda-build 4.0."),
default=cc_conda_build.get('error_overlinking', 'false').lower() == 'true',
)
p.add_argument(
"--no-error-overlinking", dest='error_overlinking', action="store_false",
help=("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."),
default=cc_conda_build.get('error_overlinking', 'false').lower() == 'true',
)
p.add_argument(
"--long-test-prefix", default=True, action="store_false",
help=("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 on by "
"default in conda-build 3.0+")
)
p.add_argument(
"--no-long-test-prefix", dest="long_test_prefix", action="store_false",
help=("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. ")
)
p.add_argument(
'--keep-going', '-k', action='store_true',
help=("When running tests, keep going after each failure. Default is to stop on the first "
"failure.")
)
p.add_argument(
'--cache-dir',
help=('Path to store the source files (archives, git clones, etc.) during the build.'),
default=(abspath(expanduser(expandvars(cc_conda_build.get('cache_dir'))))
if cc_conda_build.get('cache_dir')
else cc_conda_build.get('cache_dir')),
)
p.add_argument(
"--no-copy-test-source-files", dest="copy_test_source_files", action="store_false",
default=cc_conda_build.get('copy_test_source_files', 'true').lower() == 'true',
help=("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.")
)
p.add_argument(
'--merge-build-host', action="store_true",
help=('Merge the build and host directories, even when host section or compiler '
'jinja2 is present'),
default=cc_conda_build.get('merge_build_host', 'false').lower() == 'true',
)
p.add_argument('--stats-file', help=('File path to save build statistics to. Stats are '
'in JSON format'), )
p.add_argument('--extra-deps',
nargs='+',
help=('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.'), )
add_parser_channels(p)
args = p.parse_args(args)
return p, args
def get_render_parser():
p = ArgumentParser(
description="""
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.""",
conflict_handler='resolve'
)
p.add_argument(
'-V', '--version',
action='version',
help='Show the conda-build version number and exit.',
version='conda-build %s' % __version__,
)
p.add_argument(
'-n', "--no-source",
action="store_true",
help="When templating can't be completed, do not obtain the \
source to try fill in related template variables.",
)
p.add_argument(
"--output",
action="store_true",
help="Output the conda package filename which would have been "
"created",
)
p.add_argument(
'--python',
action="append",
help="""Set the Python version used by conda build. Can be passed
multiple times to build against multiple versions. Can be 'all' to
build against all known versions (%r)""" % [i for i in
PythonVersionCompleter() if '.' in i],
metavar="PYTHON_VER",
choices=PythonVersionCompleter(),
)
p.add_argument(
'--perl',
action="append",
help="""Set the Perl version used by conda build. Can be passed
multiple times to build against multiple versions.""",
metavar="PERL_VER",
)
p.add_argument(
'--numpy',
action="append",
help="""Set the NumPy version used by conda build. Can be passed
multiple times to build against multiple versions. Can be 'all' to
build against all known versions (%r)""" % [i for i in
NumPyVersionCompleter() if '.' in i],
metavar="NUMPY_VER",
choices=NumPyVersionCompleter(),
)
p.add_argument(
'--R',
action="append",
help="""Set the R version used by conda build. Can be passed
multiple times to build against multiple versions.""",
metavar="R_VER",
choices=RVersionsCompleter(),
)
p.add_argument(
'--lua',
action="append",
help="Set the Lua version used by conda build. Can be passed"
"multiple times to build against multiple versions (%r)." %
[i for i in LuaVersionsCompleter()],
metavar="LUA_VER",
choices=LuaVersionsCompleter(),
)
add_parser_channels(p)
return p
def parse_args(args):
p = get_render_parser()
p.description = """
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."""
p.add_argument(
"--check",
action="store_true",
help="Only check (validate) the recipe.",
)
p.add_argument(
"--no-anaconda-upload",
action="store_false",
help="Do not ask to upload the package to anaconda.org.",
dest='anaconda_upload',
default=cc.binstar_upload,
)
p.add_argument(
"--no-binstar-upload",
action="store_false",
help=argparse.SUPPRESS,
dest='anaconda_upload',
default=cc.binstar_upload,
)
p.add_argument(
"--no-include-recipe",
action="store_false",
help="Don't include the recipe inside the built package.",
dest='include_recipe',
default=True,
)
p.add_argument(
'-s', "--source",
action="store_true",
help="Only obtain the source (but don't build).",
)
p.add_argument(
'-t', "--test",
action="store_true",
help="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 necessary.",
)
p.add_argument(
'--no-test',
action='store_true',
dest='notest',
help="Do not test the package.",
)
p.add_argument(
'-b', '--build-only',
action="store_true",
help="""Only run the build, without any post processing or
testing. Implies --no-test and --no-anaconda-upload.""",
)
p.add_argument(
'-p', '--post',
action="store_true",
help="Run the post-build logic. Implies --no-test and --no-anaconda-upload.",
)
p.add_argument(
'recipe',
metavar='RECIPE_PATH',
nargs='+',
choices=RecipeCompleter(),
help="Path to recipe directory. Pass 'purge' here to clean the "
"work and test intermediates.",
)
p.add_argument(
'--skip-existing',
action='store_true',
help="""Skip recipes for which there already exists an existing build
(locally or in the channels). """
)
p.add_argument(
'--keep-old-work',
action='store_true',
help="""Keep any existing, old work directory. Useful if debugging across
callstacks involving multiple packages/recipes. """
)
p.add_argument(
'--dirty',
action='store_true',
help='Do not remove work directory or _build environment, '
'to speed up debugging. Does not apply patches or download source.'
)
p.add_argument(
'-q', "--quiet",
action="store_true",
help="do not display progress bar",
)
p.add_argument(
'--debug',
action="store_true",
help="Show debug output from source checkouts and conda",
)
p.add_argument(
'--token',
help="Token to pass through to anaconda upload"
)
p.add_argument(
'--user',
help="User/organization to upload packages to on anaconda.org"
)
p.add_argument(
"--no-activate",
action="store_false",
help="do not activate the build and test envs; just prepend to PATH",
dest='activate',
)
p.add_argument(
"--no-build-id",
action="store_false",
help=("do not generate unique build folder names. Use if having issues with "
"paths being too long."),
dest='set_build_id',
)
p.add_argument(
"--croot",
help=("Build root folder. Equivalent to CONDA_BLD_PATH, but applies only "
"to this call of conda-build.")
)
p.add_argument(
"--no-verify",
action="store_true",
help=("do not run verification on recipes or packages when building")
)
p.add_argument(
"--output-folder",
help=("folder to dump output package to. Package are moved here if build or test succeeds."
" Destination folder must exist prior to using this.")
)
add_parser_channels(p)
args = p.parse_args(args)
return p, args
def parse_args(args):
p = ArgumentParser(
description='''
Tool for building conda metapackages. A metapackage is a package with no
files, only metadata. They are typically used to collect several packages
together into a single package via dependencies.
NOTE: Metapackages can also be created by creating a recipe with the necessary
metadata in the meta.yaml, but a metapackage can be created entirely from the
command line with the conda metapackage command.
''',
)
p.add_argument(
"--no-anaconda-upload",
action="store_false",
help="Do not ask to upload the package to anaconda.org.",
dest='anaconda_upload',
default=binstar_upload,
)
p.add_argument(
"--no-binstar-upload",
action="store_false",
help=argparse.SUPPRESS,
dest='anaconda_upload',
default=binstar_upload,
)
p.add_argument(
'--token',
help="Token to pass through to anaconda upload"
)
p.add_argument(
'--user',
help="User/organization to upload packages to on anaconda.org"
)
p.add_argument(
"name",
help="Name of the created package.",
)
p.add_argument(
"version",
help="Version of the created package.",
)
p.add_argument(
"--build-number",
type=int,
default=0,
help="Build number for the package (default is 0).",
)
p.add_argument(
"--build-string",
default=None,
help="Build string for the package (default is automatically generated).",
)
p.add_argument(
"--dependencies", "-d",
nargs='*',
default=(),
help="""The dependencies of the package. To specify a version restriction for a
dependency, wrap the dependency in quotes, like 'package >=2.0'.""",
)
p.add_argument(
"--home",
help="The homepage for the metapackage.",
)
p.add_argument(
"--license",
help="The license of the metapackage.",
dest='license_name'
)
p.add_argument(
"--summary",
help="""Summary of the package. Pass this in as a string on the command
line, like --summary 'A metapackage for X'. It is recommended to use
single quotes if you are not doing variable substitution to avoid
interpretation of special characters.""",
)
p.add_argument(
"--entry-points",
nargs='*',
default=(),
help="""Python entry points to create automatically. They should use the same
syntax as in the meta.yaml of a recipe, e.g., --entry-points
bsdiff4=bsdiff4.cli:main_bsdiff4 will create an entry point called
bsdiff4 that calls bsdiff4.cli.main_bsdiff4(). """,
)
add_parser_channels(p)
args = p.parse_args(args)
return p, args
