Add module to manage Python versions using uv

[mriamah]

SUMMARY

Introduces a new module uv_python to manage Python versions using the uv python subcommand from the Astral uv package manager. The module allows users to install, remove, and upgrade patch version of Python interpreters managed by uv.

Design Decisions

• Valid version numbers consist of two or three dot-separated numeric components, with an optional 'pre-release' tag on the end such as 3.12, 3.12.3, 3.15.0a5.
• Does not support advanced uv selector formats in the initial release (e.g. >=3.12,<3.13, cpython@3.12).
• Implements full check_mode support.
• Does not implement diff_mode.

---

ISSUE TYPE

• New Module/Plugin Pull Request

---

COMPONENT NAME

uv_python

---

ADDITIONAL INFORMATION

Example Usage

- name: Ensure Python 3.12 latest patch is installed
  community.general.uv_python:
    version: "3.12"
    state: latest

- name: Install exact Python version
  community.general.uv_python:
    version: 3.12.3
    state: present

- name: Remove all 3.11 patch versions
  community.general.uv_python:
    version: 3.11
    state: absent

This was recently published as a collection mriamah.uv.python in Ansible galaxy.

[russoz]

Hi @mriamah thank you for your contribution!

Please see some initial comments. The markup comments apply to other parts as well, please review the entire docs, not just the place pointed to.

[russoz]

This will not have effect you are likely imagining: the content will be rendered as a single paragraph block, the newlines will be reduced to single spaces. If you want to make multiple paragraphs, make each one of them a list item under description.

[mriamah]

Thanks for the review. I actually did that to avoid a linting error since the paragraphs are over 160 charaters.

[russoz]

It would be nice to add a note in the description of version to remind users that when version is major or major.minor, the number must be enclosed in quotes so it is parsed as string (and not as an int or a float).

[mriamah]

Actually, whether the user puts quotes or not, the value given will always be converted to a string. I just made some examples with versions in quotes or without to show that it can be written in both forms, but I didn't see that my examples could also be interpreted this way, I will add more examples to clarify this. Thanks for pointing this out.