mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2026-11-09 12:17:13 +00:00
kevinveenbirkenbachandClaude Opus 5
972b4ce7aa
Four findings the quality gate raised against the offset and resume work, all of them mine. INFINITO_CI_OFFSET sat next to INFINITO_CI_CHUNK, where it reads well and sorts wrong, and no handler claimed it -- so `make dotenv` would never have materialised the default and every run outside CI would have resolved the offset from an unset variable. It is in ASC order now and passes through the static handler. runs.py crossed 500 lines. The three helpers that translate job titles back into selection tokens move to selections.py, which is a seam rather than a quota: reading a finished run and dispatching a new one is one subject, turning a job title into `role#variant@mode+tor` is another, and only the latter is what lets a retrigger replay exactly what failed. The sshd handler still told operators to look for a handler named 'sshd restart' after the topic became sshd-restart, and three lines from the offset commit were past the format width. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Shared Utilities (utils/)
This directory contains shared Python helpers used by custom modules and plugins.
Purpose
Use utils/ for reusable code that should not be duplicated across:
library/modules,plugins/action/,plugins/filter/,plugins/lookup/.
Typical shared utilities:
- API clients,
- validation/conversion helpers,
- path and configuration helpers,
- cross-plugin/module domain logic.
- Shared HTTP(S) connection handler for multiple modules.
- Common validation or transformation functions for user input.
- Utility functions for interacting with Docker, LDAP, etc.
- Grouped helper packages such as
utils/domains/for related domain logic.
Design Guidelines
- Keep helpers focused and composable.
- Avoid side effects during import.
- Prefer explicit function/class APIs over implicit globals.
- Keep dependencies minimal so modules/plugins stay lightweight.
Example Import
from utils.domains.primary_domain import get_primary_domain
What Does Not Belong Here
- Standalone executable modules (put in
library/). - Ansible plugin entrypoints (put in
plugins/*).
References
- Module utilities: https://docs.ansible.com/ansible/latest/dev_guide/developing_module_utilities.html
- Plugin development: https://docs.ansible.com/ansible/latest/dev_guide/developing_plugins.html