kevinveenbirkenbach/computer-playbook
1
0
Fork 0
mirror of https://github.com/kevinveenbirkenbach/computer-playbook.git synced 2025-08-26 21:45:20 +02:00
Code Issues Packages Projects Releases Wiki Activity
computer-playbook/module_utils
History
Kevin Veen-Birkenbach b867a52471
Refactor and extend role dependency resolution: 
- Introduced module_utils/role_dependency_resolver.py with full support for include_role, import_role, meta dependencies, and run_after.
- Refactored cli/build/tree.py to use RoleDependencyResolver (added toggles for include/import/dependencies/run_after).
- Extended filter_plugins/canonical_domains_map.py with optional 'recursive' mode (ignores run_after by design).
- Updated roles/web-app-nextcloud to properly include Collabora dependency.
- Added comprehensive unittests under tests/unit/module_utils for RoleDependencyResolver.

Ref: https://chatgpt.com/share/68a519c8-8e54-800f-83c0-be38546620d9
2025-08-20 02:42:07 +02:00
..
handler
Restructured libraries
2025-07-17 16:38:20 +02:00
manager
Restructured libraries
2025-07-17 16:38:20 +02:00
__init__.py
Optimized cert speed, testing etc.
2025-04-29 05:16:55 +02:00
cert_utils.py
Last SAN optimations
2025-04-29 06:37:12 +02:00
config_utils.py
Refactored get_app_conf
2025-07-22 10:08:47 +02:00
dict_renderer.py
Restructured libraries
2025-07-17 16:38:20 +02:00
domain_utils.py
General optimations and refactorings in preparation for simpleicon role implementation
2025-07-06 14:54:31 +02:00
entity_name_utils.py
Overall optimations for application id naming
2025-07-17 17:41:52 +02:00
get_url.py
Added auto setting for redirect urls for keycloak clients. Element and Synapse still need to be mapped
2025-08-11 00:17:18 +02:00
README.md
Renamed cymais to infinito and did some other optimations and logout implementations
2025-07-29 16:35:42 +02:00
role_dependency_resolver.py
Refactor and extend role dependency resolution:
2025-08-20 02:42:07 +02:00
sounds.py
Implemented functioning warning sound
2025-08-10 17:39:33 +02:00
valid_deploy_id.py
Restructured libraries
2025-07-17 16:38:20 +02:00

README.md

Shared Utility Code (module_utils/) for Infinito.Nexus

This directory contains shared Python utility code (also known as "library code") for use by custom Ansible modules, plugins, or roles in the Infinito.Nexus project.

When to Use module_utils

  • Shared logic: Use module_utils to define functions, classes, or helpers that are shared across multiple custom modules, plugins, or filter/lookups in your project.
  • Reduce duplication: Centralize code such as API clients, input validation, complex calculations, or protocol helpers.
  • Maintainability: If you find yourself repeating code in different custom modules/plugins, refactor it into module_utils/.

Examples

  • Shared HTTP(S) connection handler for multiple modules.
  • Common validation or transformation functions for user input.
  • Utility functions for interacting with Docker, LDAP, etc.

Usage Example

In a custom Ansible module or plugin:

from ansible.module_utils.infinito_utils import my_shared_function

When not to Use module_utils

  • Do not place standalone Ansible modules or plugins here—those go into library/, filter_plugins/, or lookup_plugins/ respectively.
  • Only use for code that will be imported by other plugins or modules.

Further Reading