0 Fork 0

mirror of https://github.com/kevinveenbirkenbach/computer-playbook.git synced 2026-11-09 04:06:42 +00:00

Files

T

kevinveenbirkenbachandClaude Opus 5 351d1f4553 fix(env): take the services.yml path from the role-mapping SPOT

3f0bca4d83 replaced the YAML walk with a line scan and glob-ed the role file
by hand. test_file_spot refuses a hard-coded role-file path: the name belongs
to utils.roles.mapping, which every other reader imports it from.

The import is safe for the bootstrap layer this handler lives on, which is the
whole point of the preceding commit: utils/roles/mapping.py declares nothing
but a future-import, so its closure stays stdlib-only. That is the shape the
handler README allows and the one 77292f9041 established.

The derived registry set is unchanged, asserted against the previous value.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-10-01 05:50:21 +02:00

annotations

fix(i18n): keep a nocheck alive when an annotation lands above it

2026-09-26 12:14:33 +02:00

cache

fix(users): reserve one username per domain label instead of the first two

2026-09-30 21:52:54 +02:00

claude

…

cleanup

…

diagnostics

fix(diagnostics): let the in-zone probes read the drop-in that holds the zone

2026-09-03 12:50:58 +02:00

docker

fix(docs): let docutils read these docstrings and two markdown files

2026-09-25 19:24:19 +02:00

domains

…

env

fix(env): take the services.yml path from the role-mapping SPOT

2026-10-01 05:50:21 +02:00

github

fix(ci): narrow a row's architectures by what its variant deploys

2026-09-22 16:01:09 +02:00

handler

fix(vault): keep ansible off the CI runner host's import path

2026-09-08 22:28:47 +02:00

i18n

fix(i18n): refuse a translation for what it destroyed, not for what it added

2026-09-30 17:35:51 +02:00

install

feat(docs): report a code span that names a linkable directory

2026-09-25 20:09:41 +02:00

inventory

perf(tools): bring the lane up only when it does not already serve

2026-09-29 11:48:07 +02:00

manager

fix(inventory): stop holding a default's template text to the value's pattern

2026-09-14 22:29:59 +02:00

README.md

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