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