updated for 2025, tests, uv, woah

Author: otakup0pe

.ansible-lint

@@ -0,0 +1,30 @@
+---
+profile: production
+
+exclude_paths:
+  - .cache/
+  - .github/
+  - molecule/*/tests/
+
+skip_list:
+  - yaml[line-length]
+  - fqcn[action-core]  # todo this one is probably worth fixing
+  - package-latest
+
+offline: false
+
+supported_ansible_also:
+  - ">=2.12"
+
+mock_modules:
+  - community.general.ini_file
+  - community.general.alternatives
+
+mock_roles:
+  - external.role.dependency
+
+verbosity: 1
+
+warn_list:
+  - experimental
+  - yaml[truthy]

.github/workflows/github-workflow-molecule.yml

@@ -0,0 +1,66 @@
+---
+name: Molecule CI
+
+# Run tests on pull requests and main branch pushes
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+  workflow_dispatch:  # Allow manual triggering
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements-dev.txt
+
+      - name: Run yamllint
+        run: yamllint .
+
+      - name: Run ansible-lint
+        run: ansible-lint
+
+  test:
+    name: Molecule Test
+    runs-on: ubuntu-latest
+    needs: lint
+    strategy:
+      fail-fast: false
+      matrix:
+        config:
+          - 2204-no-uv
+          - 2404-no-uv
+          - 2404-uv
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.x'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements-dev.txt
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Run molecule test
+        run: make molecule-${{ matrix.config }}

.gitignore

@@ -6,3 +6,6 @@ Icon
 .Spotlight-V100
 .Trashes
 .ci-env
+.ansible
+__pycache__
+molecule*.log

.travis.yml

@@ -0,0 +1,51 @@
+---    # -*-YAML-*-
+extends: default
+
+ignore: |
+  .cache/
+  .git/
+  .github/
+  molecule/*/tests/
+  vagrant-inventory
+  tasks/.#*
+
+rules:
+  line-length:
+    max: 120
+    level: warning
+
+  indentation:
+    spaces: 2
+    indent-sequences: true
+    check-multi-line-strings: false
+
+  comments:
+    min-spaces-from-content: 1
+
+  document-start:
+    present: true
+
+  trailing-spaces: enable
+
+  empty-lines:
+    max: 2
+    max-start: 0
+    max-end: 1
+
+  brackets:
+    min-spaces-inside: 0
+    max-spaces-inside: 1
+
+  braces:
+    min-spaces-inside: 0
+    max-spaces-inside: 1
+
+  key-duplicates: enable
+
+  octal-values:
+    forbid-implicit-octal: true
+    forbid-explicit-octal: false
+
+  truthy:
+    allowed-values: ['true', 'false', 'yes', 'no']
+    check-keys: true

.yamllint

@@ -1,6 +1,7 @@
 The MIT License
 
 Copyright (c) 2014 Pieterjan Vandaele
+Copyright (c) 2015-2025 Jonathan E Freedman
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

LICENSE

@@ -1,9 +1,59 @@
-.PHONY: clean dist_clean molecule testenv
+.PHONY: help clean lint test molecule molecule-test format \
+	molecule-test molecule-2204-no-uv molecule-2404-no-uv molecule-2404-uv
 
-BUILD_IMAGE="anxsscaffolding/build"
+molecule ?= molecule
+
+help: ## Display this help message
+	@echo "Available targets:"
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "  %-20s %s\n", $$1, $$2}'
+
+lint: yamllint ansible-lint
+	@echo "All linting completed!"
+
+yamllint: ## Run YAML linting
+	@echo "Running yamllint..."
+	yamllint .
+
+ansible-lint: ## Run Ansible linting
+	@echo "Running ansible-lint..."
+	ansible-lint
+
+format: ## Format code with black and other formatters
+	@echo "Formatting Python code..."
+	black tests/ --line-length 88 --target-version py39
+	@echo "Code formatting completed!"
+
+test: lint molecule ## Run default test suite (lint + default molecule scenario)
+	@echo "Default testing completed!"
+
+molecule-2204-no-uv:
+	@echo "==> molecule: ubuntu-22.04 (no uv)"; \
+	LOG=molecule-2204-no-uv.log; \
+	( MOLECULE_UBUNTU_VERSION=2204 PYTHON_UV_INSTALL=false $(molecule) test -s default 2>&1 | tee $$LOG ) || ( echo "FAILED: see $$LOG"; cat $$LOG; false )
+
+molecule-2404-no-uv:
+	@echo "==> molecule: ubuntu-24.04 (no uv)"; \
+	LOG=molecule-2404-no-uv.log; \
+	( MOLECULE_UBUNTU_VERSION=2404 PYTHON_UV_INSTALL=false $(molecule) test -s default 2>&1 | tee $$LOG ) || ( echo "FAILED: see $$LOG"; cat $$LOG; false )
+
+molecule-2404-uv:
+	@echo "==> molecule: ubuntu-24.04 (with uv)"; \
+	LOG=molecule-2404-uv.log; \
+	( MOLECULE_UBUNTU_VERSION=2404 PYTHON_UV_INSTALL=true PYTHON_UV_SUFFIX="-alt" $(molecule) test -s default 2>&1 | tee $$LOG ) || ( echo "FAILED: see $$LOG"; cat $$LOG; false )
 
 molecule:
-	docker run \
-		-v $(shell pwd):/mnt \
-		-v /var/run/docker.sock:/var/run/docker.sock \
-		$(BUILD_IMAGE)
+	@echo "Running all molecule scenarios..."
+	make -j molecule-test
+
+molecule-test: molecule-2404-uv molecule-2404-no-uv molecule-2204-no-uv
+
+molecule-destroy:
+	@echo "Removing molecule instances"
+	molecule destroy
+
+clean: molecule-destroy ## Clean up molecule instances and temporary files
+	@echo "Cleaning up..."
+	find . -name "*.pyc" -delete
+	find . -name "__pycache__" -type d -exec rm -rf {} + 2>/dev/null || true
+	find . -name ".pytest_cache" -type d -exec rm -rf {} + 2>/dev/null || true
+	@echo "Cleanup completed!"

Makefile

@@ -1,11 +1,11 @@
-## ANXS - python [![Build Status](https://travis-ci.com/ANXS/python.png)](https://travis-ci.com/ANXS/python)
+## ANXS - python
 
-Ansible role which installs python, pip, setuptools and virtualenv
+[![test workflow status](https://github.com/ANXS/python/actions/workflows/test.yml/badge.svg)](https://github.com/ANXS/python/actions/workflows/test.yml) ![Maintenance](https://img.shields.io/maintenance/yes/2025.svg)
 
+Ansible role which installs python, pip, and virtualenv
 
 #### Requirements & Dependencies
-- Tested on Ansible 2.3 or higher.
-
+- Tested on Ansible 2.12 or higher.
 
 #### Variables
 
@@ -14,18 +14,14 @@ python_setuptools_version:    # default to latest
 python_virtualenv_version:    # default to latestlenv
 ```
 
+## Testing
 
-#### Testing
-This project comes with a VagrantFile, this is a fast and easy way to test changes to the role, fire it up with `vagrant up`
-
-See [vagrant docs](https://docs.vagrantup.com/v2/) for getting setup with vagrant
-
-
-#### License
+This project uses molecule to test a few scenarios. You can kick off the tests (and linting) with `make test`.
 
-Licensed under the MIT License. See the LICENSE file for details.
+## License
 
+Licensed under the MIT License. See the [LICENSE](https://github.com/ANXS/python/blob/master/LICENSE) file for details.
 
-#### Feedback, bug-reports, requests, ...
+## Feedback, bug-reports, requests, ...
 
 Are [welcome](https://github.com/ANXS/python/issues)!

README.md

@@ -1,9 +1,11 @@
 ---
 python_prefix_dir: "/usr/local"
-python_pip_location: "{{python_prefix_dir}}/bin/pip"
-python_virtualenv_location: "{{python_prefix_dir}}/bin/virtualenv"
-# python_setuptools_version:    # default to latest
-
-get_pip_url: "https://bootstrap.pypa.io/get-pip.py"
 
+# List of optional deadsnakes versions to install
 python_versions: []
+
+# UV installation settings
+python_uv_install: false
+python_uv_version: "0.9.3"
+python_uv_install_path: "{{ python_prefix_dir }}/bin"
+python_uv_temp_dir: "/tmp"