Add minimal uv_python module

plugins/modules/uv_python.py

@@ -0,0 +1,101 @@
+#!/usr/bin/python
+# Copyright (c) 2026 Mariam Ahhttouche <mariam.ahhttouche@gmail.com>
+# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
+
+
+DOCUMENTATION = r'''
+---
+module: uv_python
+short_description: Manage Python installations using uv
+description:
+  - Install or remove Python versions managed by uv.
+# requirements:
+#   - uv must be installed and available on PATH
+options:
+  version:
+    description: Python version to manage
+    type: str
+    required: true
+  state:
+    description: Desired state
+    type: str
+    choices: [present, absent]
+    default: present
+  force:
+    description: Force reinstall
+    type: bool
+    default: false
+  uv_path:
+    description: Path to uv binary
+    type: str
+    default: uv
+author:
+  - Your Name
+'''
+
+EXAMPLES = r'''
+- name: Install Python 3.12
+  uv_python:
+    version: "3.12"
+
+- name: Remove Python 3.11
+  uv_python:
+    version: "3.11"
+    state: absent
+'''
+
+RETURN = r'''
+python:
+  description: Installed Python info
+  returned: when state=present
+  type: dict
+'''
+
+from ansible.module_utils.basic import AnsibleModule
+
+
+class UV:
+    def __init__(self, module, **kwargs):
+        self.module = module
+
+    def install_python(self):
+        if self.find_python() == 0:
+            return False, ""
+        if self.module.check_mode:
+            return True, ""
+        
+        cmd = [self.module.get_bin_path("uv", required=True), "python", "install", self.module.params["version"]]
+        _, out, _ = self.module.run_command(cmd, check_rc=True)
+        return True, out
+    
+    def find_python(self):
+      cmd = [self.module.get_bin_path("uv", required=True), "python", "find", self.module.params["version"]]
+      rc, _, _ = self.module.run_command(cmd)
+      return rc
+
+
+def main():
+    module = AnsibleModule(
+        argument_spec=dict(
+            version=dict(type='str', required=True),
+            state=dict(type='str', default='present', choices=['present', 'absent']),
+        ),
+        supports_check_mode=True
+    )
+
+    result = dict(
+        changed=False,
+        msg="",
+    )
+    state = module.params["state"]
+    uv = UV(module)
+
+    if state == "present":
+      if uv.find_python() != 0:
+        result["changed"], result["msg"] = uv.install_python()
+
+    module.exit_json(**result)
+
+
+if __name__ == "__main__":
+    main()