LinuxCommandLibrary

uv-tree

Visualize process relationships as a tree

TLDR

Show dependency tree for current environment

$ uv tree
copy

Show dependency tree for all environments
$ uv tree --universal
copy

Show dependency tree up to a certain depth
$ uv tree [[-d|--depth]] [n]
copy

Show the latest available version for all outdated packages
$ uv tree --outdated
copy

Exclude dependencies from the dev group
$ uv tree --no-dev
copy

Show the inverted tree, so children are dependents instead of dependencies
$ uv tree --invert
copy

SYNOPSIS

uv-tree [OPTIONS]

PARAMETERS

--depth <N>
    Limit the depth of the dependency tree display to N levels.

--venv <PATH>
    Specify the path to the virtual environment for which to display the tree. Defaults to the current active environment.

--package <PACKAGE_NAME>
    Display the dependency tree for a specific package, showing what it depends on.

--reverse
    Show reverse dependencies (i.e., which packages depend on the specified package).

--format <FORMAT>
    Specify the output format (e.g., text for console-friendly output, json for machine-readable).

--installed-only
    Only show dependencies for packages that are currently installed in the environment.

--help
    Display help message and exit.

DESCRIPTION

uv-tree is not a standard Linux command or a subcommand of the uv Python package management tool.

This entry describes a hypothetical command that, if it existed, would combine the functionality of the standard tree(1) utility with uv's capabilities. Its purpose would be to visualize the hierarchical dependency structure of Python packages within a uv-managed virtual environment or project. It would display which packages depend on others, offering insights into the installed software's interconnections, similar to how tools like pipdeptree work for pip environments. Such a command would be highly useful for debugging dependency conflicts or understanding the composition of a Python application's environment.

CAVEATS

Important: uv-tree is not a real or standard Linux command. This description is based on a hypothetical command that would combine features of the uv package manager and the tree(1) utility for displaying directory structures. Users looking for dependency visualization in uv should typically use commands like uv pip list or explore external tools like pipdeptree.

HISTORY

As a hypothetical command, uv-tree has no actual development history. However, the need for dependency visualization arose with the complexity of software projects, leading to tools like pipdeptree. The uv project itself is a modern, fast Python package installer and resolver, which has recently gained significant traction as an alternative to pip and pip-tools. If a dependency tree command were to be integrated, it would likely be a future enhancement to the uv toolset.

SEE ALSO

tree(1), uv(1), pipdeptree

Copied to clipboard