uv Facts¶

Present information provided by uv: + available and installed versions of Python + installed Python packages and their versions + where the installed versions of Python are stored + where tools are installed + version of uv available

See https://docs.astral.sh/uv/ for details of uv

See also: operations/uv.

uv.UvAvailablePythonsByImplementation¶

host.get_fact(UvAvailablePythonsByImplementation, is_managed=True)

Provides the implementation(s) of Python available for installation along with the versions(s) of the implementation(s).

+ **is_managed**: if set, only list Python implementations managed by `uv`. Default True

Example:

{
    "cpython-3.13.4-macos-aarch64-none": ["3.13.4"]
}

uv.UvAvailablePythonsByVersion¶

host.get_fact(UvAvailablePythonsByVersion, is_managed=True)

Provides the version(s) of Python available for installation along with the implementation(s) of the version(s).

+ **is_managed**: if set, only list Python implementations managed by `uv`. Default True

Example:

{
    "3.13.4": ["cpython-3.13.4-macos-aarch64-none"]
}

uv.UvInstalledPythonsByImplementation¶

host.get_fact(UvInstalledPythonsByImplementation, is_managed=True)

Provides the installed implementation(s) of Python along with the versions(s) of the implementation(s).

+ **is_managed**: if set, only list Python implementations managed by `uv`. Default True

Example:

{
    "cpython-3.13.4-macos-aarch64-none": ["3.13.4"]
}

uv.UvInstalledPythonsByVersion¶

host.get_fact(UvInstalledPythonsByVersion, is_managed=True)

Provides the installed versions of Python along with the implementation(s) of the version(s).

+ **is_managed**: if set, only list Python versions managed by `uv`. Default True

Example:

{
    "3.13.4": ["cpython-3.13.4-macos-aarch64-none"]
}

uv.UvPipPackages¶

host.get_fact(UvPipPackages)

Provides the installed Python packages and their version.

Example:

{
    "requests": ["2.32.5"],
}

uv.UvPythonDir¶

host.get_fact(UvPythonDir)

Provides the directory in which uv installs Python implementations.

Example:

/home/someone/.local/share/uv/python

uv.UvToolDir¶

host.get_fact(UvToolDir)

Provides the directory in which uv installs tools.

Example:

/home/someone/.local/share/uv/tools

uv.UvTools¶

host.get_fact(UvTools)

Provides the tool(s) currently installed along with their version(s).

Example:

{
    "pyinfra": "3.4.1"
}

uv.UvVersion¶

host.get_fact(UvVersion)

Provides the version of uv installed.

Example:

uv 0.8.5 (Homebrew 2025-08-05)