1
0
Fork 0
mirror of https://github.com/ansible-collections/community.general.git synced 2026-03-22 13:19:13 +00:00
community.general/plugins/modules/uv_python.py
2026-02-12 09:09:28 +01:00

101 lines
No EOL
2.3 KiB
Python

#!/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):
rc, out = self._find_python()
if rc == 0:
return False, out
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, out, _ = self.module.run_command(cmd)
return rc, out
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":
result["changed"], result["msg"] = uv.install_python()
module.exit_json(**result)
if __name__ == "__main__":
main()