def parse_args(args):
p = ArgumentParser(
description="""
Generates a boilerplate/skeleton recipe, which you can then edit to create a
full recipe. Some simple skeleton recipes may not even need edits.
""",
epilog="""
Run --help on the subcommands like 'conda skeleton pypi --help' to see the
options available.
""",
)
repos = p.add_subparsers(
dest="repo"
)
skeletons = [name for _, name, _ in
pkgutil.iter_modules([os.path.join(thisdir, '../skeletons')])]
for skeleton in skeletons:
if skeleton.startswith("_"):
continue
module = importlib.import_module("conda_build.skeletons." + skeleton)
module.add_parser(repos)
args = p.parse_args(args)
return p, args
def parse_args(args):
p = ArgumentParser(
description="""
Generates a boilerplate/skeleton recipe, which you can then edit to create a
full recipe. Some simple skeleton recipes may not even need edits.
""",
epilog="""
Run --help on the subcommands like 'conda skeleton pypi --help' to see the
options available.
""",
)
repos = p.add_subparsers(dest="repo")
skeletons = [
name for _, name, _ in pkgutil.iter_modules(
[os.path.join(thisdir, '../skeletons')])
]
for skeleton in skeletons:
if skeleton.startswith("_"):
continue
module = importlib.import_module("conda_build.skeletons." + skeleton)
module.add_parser(repos)
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 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 = ArgumentParser(
description='Tools for inspecting conda packages.',
epilog="""
Run --help on the subcommands like 'conda inspect linkages --help' to see the
options available.
""",
)
subcommand = p.add_subparsers(dest='subcommand', )
linkages_help = """
Investigates linkages of binary libraries in a package (works in Linux and
OS X). This is an advanced command to aid building packages that link against
C libraries. Aggregates the output of ldd (on Linux) and otool -L (on OS X) by
dependent packages. Useful for finding broken links, or links against system
libraries that ought to be dependent conda packages. """
linkages = subcommand.add_parser(
"linkages",
# help controls conda inspect -h and description controls conda
# inspect linkages -h
help=linkages_help,
description=linkages_help,
)
linkages.add_argument(
'packages',
action='store',
nargs='*',
help='Conda packages to inspect.',
)
linkages.add_argument(
'--untracked',
action='store_true',
help=
"""Inspect the untracked files in the environment. This is useful when used in
conjunction with conda build --build-only.""",
)
linkages.add_argument(
'--show-files',
action="store_true",
help="Show the files in the package that link to each library",
)
linkages.add_argument(
'--groupby',
action='store',
default='package',
choices=('package', 'dependency'),
help="""Attribute to group by (default: %(default)s). Useful when used
in conjunction with --all.""",
)
linkages.add_argument(
'--sysroot',
action='store',
help='System root in which to look for system libraries.',
default='',
)
linkages.add_argument(
'--all',
action='store_true',
help="Generate a report for all packages in the environment.",
)
add_parser_prefix(linkages)
objects_help = """
Investigate binary object files in a package (only works on OS X). This is an
advanced command to aid building packages that have compiled
libraries. Aggregates the output of otool on all the binary object files in a
package.
"""
objects = subcommand.add_parser(
"objects",
help=objects_help,
description=objects_help,
)
objects.add_argument(
'packages',
action='store',
nargs='*',
help='Conda packages to inspect.',
)
objects.add_argument(
'--untracked',
action='store_true',
help=
"""Inspect the untracked files in the environment. This is useful when used
in conjunction with conda build --build-only.""",
)
# TODO: Allow groupby to include the package (like for --all)
objects.add_argument(
'--groupby',
action='store',
default='filename',
choices=('filename', 'filetype', 'rpath'),
help='Attribute to group by (default: %(default)s).',
)
objects.add_argument(
'--all',
action='store_true',
help="Generate a report for all packages in the environment.",
)
add_parser_prefix(objects)
channels_help = """
Tools for investigating conda channels.
"""
channels = subcommand.add_parser(
"channels",
help=channels_help,
description=channels_help,
)
channels.add_argument(
'--verbose',
action='store_true',
help="""Show verbose output. Note that error output to stderr will
always be shown regardless of this flag. """,
)
channels.add_argument(
'--test-installable',
'-t',
action='store_true',
help="""Test every package in the channel to see if it is installable
by conda.""",
)
channels.add_argument(
"channel",
nargs='?',
default="defaults",
help="The channel to test. The default is %(default)s.")
prefix_lengths = subcommand.add_parser(
"prefix-lengths",
help="""Inspect packages in given path, finding those with binary
prefixes shorter than specified""",
description=linkages_help,
)
prefix_lengths.add_argument(
'packages',
action='store',
nargs='+',
help='Conda packages to inspect.',
)
prefix_lengths.add_argument(
'--min-prefix-length',
'-m',
help=
'Minimum length. Only packages with prefixes below this are shown.',
default=api.Config().prefix_length,
type=int,
)
hash_inputs = subcommand.add_parser(
"hash-inputs",
help="Show data used to compute hash identifier (h????) for package",
description=
"Show data used to compute hash identifier (h????) for package",
)
hash_inputs.add_argument(
'packages',
action='store',
nargs='*',
help='Conda packages to inspect.',
)
args = p.parse_args(args)
return p, args
def parse_args(args):
p = ArgumentParser(
description="""
Various tools to convert conda packages. Takes a pure Python package build for
one platform and converts it to work on one or more other platforms, or
all.""",
epilog=epilog,
)
# TODO: Factor this into a subcommand, since it's python package specific
p.add_argument(
'files',
nargs='+',
help="Package files to convert."
)
p.add_argument(
'-p', "--platform",
dest='platforms',
action="append",
choices=['osx-64', 'linux-32', 'linux-64',
'linux-ppc64le', 'linux-armv6l', 'linux-armv7l', 'linux-aarch64',
'win-32', 'win-64', 'all'],
help="Platform to convert the packages to.",
default=None
)
p.add_argument(
"--dependencies", "-d",
nargs='*',
help="""Additional (besides python) dependencies of the converted
package. To specify a version restriction for a dependency, wrap
the dependency in quotes, like 'package >=2.0'.""",
)
p.add_argument(
'--show-imports',
action='store_true',
default=False,
help="Show Python imports for compiled parts of the package.",
)
p.add_argument(
'-f', "--force",
action="store_true",
help="Force convert, even when a package has compiled C extensions.",
)
p.add_argument(
'-o', '--output-dir',
default='.',
help="""Directory to write the output files. The packages will be
organized in platform/ subdirectories, e.g.,
win-32/package-1.0-py27_0.tar.bz2."""
)
p.add_argument(
'-v', '--verbose',
default=False,
action='store_true',
help="Print verbose output."
)
p.add_argument(
"--dry-run",
action="store_true",
help="Only display what would have been done.",
)
p.add_argument(
"-q", "--quiet",
action="store_true",
help="Don't print as much output."
)
args = p.parse_args(args)
return p, args
def parse_args(args):
p = ArgumentParser(
description="""
Various tools to convert conda packages. Takes a pure Python package build for
one platform and converts it to work on one or more other platforms, or
all.""",
epilog=epilog,
)
# TODO: Factor this into a subcommand, since it's python package specific
p.add_argument('files', nargs='+', help="Package files to convert.")
p.add_argument(
'-p',
"--platform",
dest='platforms',
action="append",
choices=['osx-64', 'linux-32', 'linux-64', 'win-32', 'win-64', 'all'],
help="Platform to convert the packages to.",
default=None)
p.add_argument(
"--dependencies",
"-d",
nargs='*',
help="""Additional (besides python) dependencies of the converted
package. To specify a version restriction for a dependency, wrap
the dependency in quotes, like 'package >=2.0'.""",
)
p.add_argument(
'--show-imports',
action='store_true',
default=False,
help="Show Python imports for compiled parts of the package.",
)
p.add_argument(
'-f',
"--force",
action="store_true",
help="Force convert, even when a package has compiled C extensions.",
)
p.add_argument(
'-o',
'--output-dir',
default='.',
help="""Directory to write the output files. The packages will be
organized in platform/ subdirectories, e.g.,
win-32/package-1.0-py27_0.tar.bz2.""")
p.add_argument('-v',
'--verbose',
default=False,
action='store_true',
help="Print verbose output.")
p.add_argument(
"--dry-run",
action="store_true",
help="Only display what would have been done.",
)
p.add_argument("-q",
"--quiet",
action="store_true",
help="Don't print as much output.")
args = p.parse_args(args)
return p, args
def parse_args(args):
p = ArgumentParser(
description='Tools for inspecting conda packages.',
epilog="""
Run --help on the subcommands like 'conda inspect linkages --help' to see the
options available.
""",
)
subcommand = p.add_subparsers(
dest='subcommand',
)
linkages_help = """
Investigates linkages of binary libraries in a package (works in Linux and
OS X). This is an advanced command to aid building packages that link against
C libraries. Aggregates the output of ldd (on Linux) and otool -L (on OS X) by
dependent packages. Useful for finding broken links, or links against system
libraries that ought to be dependent conda packages. """
linkages = subcommand.add_parser(
"linkages",
# help controls conda inspect -h and description controls conda
# inspect linkages -h
help=linkages_help,
description=linkages_help,
)
linkages.add_argument(
'packages',
action='store',
nargs='*',
help='Conda packages to inspect.',
)
linkages.add_argument(
'--untracked',
action='store_true',
help="""Inspect the untracked files in the environment. This is useful when used in
conjunction with conda build --build-only.""",
)
linkages.add_argument(
'--show-files',
action="store_true",
help="Show the files in the package that link to each library",
)
linkages.add_argument(
'--groupby',
action='store',
default='package',
choices=('package', 'dependency'),
help="""Attribute to group by (default: %(default)s). Useful when used
in conjunction with --all.""",
)
linkages.add_argument(
'--all',
action='store_true',
help="Generate a report for all packages in the environment.",
)
add_parser_prefix(linkages)
objects_help = """
Investigate binary object files in a package (only works on OS X). This is an
advanced command to aid building packages that have compiled
libraries. Aggregates the output of otool on all the binary object files in a
package.
"""
objects = subcommand.add_parser(
"objects",
help=objects_help,
description=objects_help,
)
objects.add_argument(
'packages',
action='store',
nargs='*',
help='Conda packages to inspect.',
)
objects.add_argument(
'--untracked',
action='store_true',
help="""Inspect the untracked files in the environment. This is useful when used
in conjunction with conda build --build-only.""",
)
# TODO: Allow groupby to include the package (like for --all)
objects.add_argument(
'--groupby',
action='store',
default='filename',
choices=('filename', 'filetype', 'rpath'),
help='Attribute to group by (default: %(default)s).',
)
objects.add_argument(
'--all',
action='store_true',
help="Generate a report for all packages in the environment.",
)
add_parser_prefix(objects)
channels_help = """
Tools for investigating conda channels.
"""
channels = subcommand.add_parser(
"channels",
help=channels_help,
description=channels_help,
)
channels.add_argument(
'--verbose',
action='store_true',
help="""Show verbose output. Note that error output to stderr will
always be shown regardless of this flag. """,
)
channels.add_argument(
'--test-installable', '-t',
action='store_true',
help="""Test every package in the channel to see if it is installable
by conda.""",
)
channels.add_argument(
"channel",
nargs='?',
default="defaults",
help="The channel to test. The default is %(default)s."
)
prefix_lengths = subcommand.add_parser(
"prefix-lengths",
help="""Inspect packages in given path, finding those with binary
prefixes shorter than specified""",
description=linkages_help,
)
prefix_lengths.add_argument(
'packages',
action='store',
nargs='+',
help='Conda packages to inspect.',
)
prefix_lengths.add_argument(
'--min-prefix-length', '-m',
help='Minimum length. Only packages with prefixes below this are shown.',
default=api.Config().prefix_length,
type=int,
)
hash_inputs = subcommand.add_parser(
"hash-inputs",
help="Show data used to compute hash identifier (h????) for package",
description="Show data used to compute hash identifier (h????) for package",
)
hash_inputs.add_argument(
'packages',
action='store',
nargs='*',
help='Conda packages to inspect.',
)
args = p.parse_args(args)
return p, args
def parse_args(args):
p = ArgumentParser(
description="Update package index metadata files in given directories."
)
p.add_argument(
'dir',
help='Directory that contains an index to be updated.',
nargs='*',
default=[os.getcwd()],
)
p.add_argument(
'-c',
"--check-md5",
action="store_true",
help=
"""Use MD5 values instead of file modification times for determining if a
package's metadata needs to be updated.""",
)
p.add_argument(
'-f',
"--force",
action="store_true",
help="Force reading all files.",
)
p.add_argument(
'-q',
"--quiet",
action="store_true",
help="Don't show any output.",
)
p.add_argument(
'--no-remove',
action="store_false",
dest="remove",
default=True,
help="Don't remove entries for files that don't exist.",
)
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 = ArgumentParser(
description="Update package index metadata files in given directories."
)
p.add_argument(
'dir',
help='Directory that contains an index to be updated.',
nargs='*',
default=[os.getcwd()],
)
p.add_argument(
'-c',
"--check-md5",
action="store_true",
help=
"""Use hash values instead of file modification times for determining if a
package's metadata needs to be updated.""",
)
p.add_argument(
"-n",
"--channel-name",
help="Customize the channel name listed in each channel's index.html.",
)
p.add_argument(
'-s',
'--subdir',
action='append',
help=
'Optional. The subdir to index. Can be given multiple times. If not provided, will '
'default to all of %s. If provided, will not create channeldata.json for the channel.'
'' % ', '.join(DEFAULT_SUBDIRS),
)
p.add_argument(
'-t',
'--threads',
default=MAX_THREADS_DEFAULT,
type=int,
)
p.add_argument(
"-p",
"--patch-generator",
help="Path to Python file that outputs metadata patch instructions")
p.add_argument(
"--hotfix-source-repo",
help="URL of git repo that hosts your metadata patch instructions")
p.add_argument("--verbose",
help="show extra debugging info",
action="store_true")
p.add_argument("--no-progress",
help="Hide progress bars",
action="store_false",
dest="progress")
p.add_argument(
"--no-shared-format-cache",
action="store_false",
dest="shared_format_cache",
help=
("Do not share a cache between .tar.bz2 and .conda files. By default, "
"we assume that two files that differ only by extension can be treated "
"as similar for the purposes of caching metadata. This flag disables that assumption."
))
p.add_argument("--current-index-versions-file",
"-m",
help="""
YAML file containing name of package as key, and list of versions as values. The current_index.json
will contain the newest from this series of versions. For example:
python:
- 2.7
- 3.6
will keep python 2.7.X and 3.6.Y in the current_index.json, instead of only the very latest python version.
""")
args = p.parse_args(args)
return p, args
def parse_args(args):
p = ArgumentParser(
description="Update package index metadata files in given directories.")
p.add_argument(
'dir',
help='Directory that contains an index to be updated.',
nargs='*',
default=[os.getcwd()],
)
p.add_argument(
'-c', "--check-md5",
action="store_true",
help="""Use hash values instead of file modification times for determining if a
package's metadata needs to be updated.""",
)
p.add_argument(
"-n", "--channel-name",
help="Customize the channel name listed in each channel's index.html.",
)
p.add_argument(
'-s', '--subdir',
action='append',
help='Optional. The subdir to index. Can be given multiple times. If not provided, will '
'default to all of %s. If provided, will not create channeldata.json for the channel.'
'' % ', '.join(DEFAULT_SUBDIRS),
)
p.add_argument(
'-t', '--threads',
default=MAX_THREADS_DEFAULT,
type=int,
)
p.add_argument(
"-p", "--patch-generator",
help="Path to Python file that outputs metadata patch instructions"
)
p.add_argument(
"--hotfix-source-repo",
help="URL of git repo that hosts your metadata patch instructions"
)
p.add_argument(
"--verbose", help="show extra debugging info", action="store_true"
)
p.add_argument(
"--no-progress", help="Hide progress bars", action="store_false", dest="progress"
)
args = p.parse_args(args)
return p, args
def parse_args(args):
p = ArgumentParser(
description="Update package index metadata files in given directories."
)
p.add_argument(
'dir',
help='Directory that contains an index to be updated.',
nargs='*',
default=[os.getcwd()],
)
p.add_argument(
'-c',
"--check-md5",
action="store_true",
help=
"""Use hash values instead of file modification times for determining if a
package's metadata needs to be updated.""",
)
p.add_argument(
"-n",
"--channel-name",
help="Customize the channel name listed in each channel's index.html.",
)
p.add_argument(
'-s',
'--subdir',
action='append',
help=
'Optional. The subdir to index. Can be given multiple times. If not provided, will '
'default to all of %s. If provided, will not create channeldata.json for the channel.'
'' % ', '.join(DEFAULT_SUBDIRS),
)
p.add_argument(
'-t',
'--threads',
default=MAX_THREADS_DEFAULT,
type=int,
)
p.add_argument(
"-p",
"--patch-generator",
help="Path to Python file that outputs metadata patch instructions")
p.add_argument(
"--hotfix-source-repo",
help="URL of git repo that hosts your metadata patch instructions")
p.add_argument("--verbose",
help="show extra debugging info",
action="store_true")
p.add_argument("--no-progress",
help="Hide progress bars",
action="store_false",
dest="progress")
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(). """,
)
args = p.parse_args(args)
return p, args
def parse_args(args):
p = ArgumentParser(
description="Update package index metadata files in given directories.")
p.add_argument(
'dir',
help='Directory that contains an index to be updated.',
nargs='*',
default=[os.getcwd()],
)
p.add_argument(
'-c', "--check-md5",
action="store_true",
help="""Use MD5 values instead of file modification times for determining if a
package's metadata needs to be updated.""",
)
p.add_argument(
'-f', "--force",
action="store_true",
help="Force reading all files.",
)
p.add_argument(
'-q', "--quiet",
action="store_true",
help="Don't show any output.",
)
p.add_argument(
'--no-remove',
action="store_false",
dest="remove",
default=True,
help="Don't remove entries for files that don't exist.",
)
args = p.parse_args(args)
return p, args
def parse_args(args):
p = ArgumentParser(
description="""
Install a Python package in 'development mode'.
This works by creating a conda.pth file in site-packages."""
# TODO: Use setup.py to determine any entry-points to install.
)
p.add_argument('source',
metavar='PATH',
nargs='+',
help="Path to the source directory.")
p.add_argument('-npf',
'--no-pth-file',
action='store_true',
help=("Relink compiled extension dependencies against "
"libraries found in current conda env. "
"Do not add source to conda.pth."))
p.add_argument('-b',
'--build_ext',
action='store_true',
help=("Build extensions inplace, invoking: "
"python setup.py build_ext --inplace; "
"add to conda.pth; relink runtime libraries to "
"environment's lib/."))
p.add_argument('-c',
'--clean',
action='store_true',
help=("Invoke clean on setup.py: "
"python setup.py clean "
"use with build_ext to clean before building."))
p.add_argument('-u',
'--uninstall',
action='store_true',
help=("Removes package if installed in 'development mode' "
"by deleting path from conda.pth file. Ignore other "
"options - just uninstall and exit"))
add_parser_prefix(p)
p.set_defaults(func=execute)
args = p.parse_args(args)
return p, args
def parse_args(args):
p = ArgumentParser(
description="""
Install a Python package in 'development mode'.
This works by creating a conda.pth file in site-packages."""
# TODO: Use setup.py to determine any entry-points to install.
)
p.add_argument(
'source',
metavar='PATH',
nargs='+',
help="Path to the source directory."
)
p.add_argument('-npf', '--no-pth-file',
action='store_true',
help=("Relink compiled extension dependencies against "
"libraries found in current conda env. "
"Do not add source to conda.pth."))
p.add_argument('-b', '--build_ext',
action='store_true',
help=("Build extensions inplace, invoking: "
"python setup.py build_ext --inplace; "
"add to conda.pth; relink runtime libraries to "
"environment's lib/."))
p.add_argument('-c', '--clean',
action='store_true',
help=("Invoke clean on setup.py: "
"python setup.py clean "
"use with build_ext to clean before building."))
p.add_argument('-u', '--uninstall',
action='store_true',
help=("Removes package if installed in 'development mode' "
"by deleting path from conda.pth file. Ignore other "
"options - just uninstall and exit"))
add_parser_prefix(p)
p.set_defaults(func=execute)
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 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 parse_args(args):
p = ArgumentParser(description="""\
Tool for signing conda packages. Signatures will be written alongside the
files as FILE.sig.""")
p.add_argument(
'files',
help="Files to sign.",
nargs='*',
metavar="FILE",
)
p.add_argument('-k',
'--keygen',
help="Generate a public-private "
"key pair ~/.conda/keys/<NAME>(.pub).",
metavar="NAME")
p.add_argument(
'--size',
help="Size of generated RSA public-private key pair in bits "
"(defaults to 2048).",
metavar="BITS")
p.add_argument('-v',
'--verify',
action="store_true",
help="Verify FILE(s).")
p.add_argument('-i',
'--input-key',
default="",
help="Name of or path to private key to use for signing")
return p, p.parse_args(args)
def parse_args(args):
p = ArgumentParser(
description="Update package index metadata files in given directories.")
p.add_argument(
'dir',
help='Directory that contains an index to be updated.',
nargs='*',
default=[os.getcwd()],
)
p.add_argument(
'-c', "--check-md5",
action="store_true",
help="""Use hash values instead of file modification times for determining if a
package's metadata needs to be updated.""",
)
p.add_argument(
"-n", "--channel-name",
help="Customize the channel name listed in each channel's index.html.",
)
p.add_argument(
'-s', '--subdir',
action='append',
help='Optional. The subdir to index. Can be given multiple times. If not provided, will '
'default to all of %s. If provided, will not create channeldata.json for the channel.'
'' % ', '.join(DEFAULT_SUBDIRS),
)
p.add_argument(
'-t', '--threads',
default=MAX_THREADS_DEFAULT,
type=int,
)
p.add_argument(
"-p", "--patch-generator",
help='Path to Python file that outputs metadata patch instructions from its '
'_patch_repodata function or a .tar.bz2/.conda file which contains a '
'patch_instructions.json file for each subdir'
)
p.add_argument(
"--hotfix-source-repo",
help="Deprecated, will be removed in a future version of conda build"
)
p.add_argument(
"--verbose", help="show extra debugging info", action="store_true"
)
p.add_argument(
"--no-progress", help="Hide progress bars", action="store_false", dest="progress"
)
p.add_argument(
"--current-index-versions-file", "-m",
help="""
YAML file containing name of package as key, and list of versions as values. The current_index.json
will contain the newest from this series of versions. For example:
python:
- 2.7
- 3.6
will keep python 2.7.X and 3.6.Y in the current_index.json, instead of only the very latest python version.
"""
)
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."""
)
add_parser_channels(p)
return p
def parse_args(args):
p = ArgumentParser(
description="""\
Tool for signing conda packages. Signatures will be written alongside the
files as FILE.sig."""
)
p.add_argument("files", help="Files to sign.", nargs="*", metavar="FILE")
p.add_argument(
"-k", "--keygen", help="Generate a public-private " "key pair ~/.conda/keys/<NAME>(.pub).", metavar="NAME"
)
p.add_argument(
"--size", help="Size of generated RSA public-private key pair in bits " "(defaults to 2048).", metavar="BITS"
)
p.add_argument("-v", "--verify", action="store_true", help="Verify FILE(s).")
p.add_argument("-i", "--input-key", default="", help="Name of or path to private key to use for signing")
return p, p.parse_args(args)
