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: Uv Operations.

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)