Files
kevinveenbirkenbachandClaude Opus 5.5 628e2587b8 fix(database_query): keep psql's command tags out of the returned rows
With `-tA` psql drops headers and the row-count footer but still prints
the command tag of every write statement. A guarded
`UPDATE … RETURNING` that matched nothing therefore came back as
`rows: [['UPDATE 0']]`, and web-app-peertube's oidc/enable.yml, which
judges its change by the row count, reported `changed` and restarted
PeerTube on every deploy after the first.

The PostgreSQL rows flags are now `-qtA`. Probed against a running
postgres container:

    -tA  -> CREATE TABLE / INSERT 0 1 / UPDATE 0 / 3 / UPDATE 1
    -qtA -> 3

SELECT output and the MariaDB path (`--batch --skip-column-names`, no
status line) are unchanged.

Fixes #1164

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-10-22 20:36:32 +02:00
..

Custom Modules (library/)

This directory contains project-specific Ansible modules used by Infinito.Nexus.

What Belongs Here

Use library/ for idempotent module logic that represents concrete automation actions.

Typical cases:

  • managing resources that have no suitable built-in/community module,
  • wrapping internal APIs or internal infrastructure semantics,
  • implementing reusable module interfaces for role/playbook consumption.

What Does Not Belong Here

  • Shared helper code used by multiple modules/plugins goes to utils/.
  • Jinja transformations belong to plugins/filter/.
  • Runtime value retrieval belongs to plugins/lookup/.
  • Task execution wrappers belong to plugins/action/.

Usage

Ansible searches library/ for custom modules. In playbooks, call them like built-in modules.

- name: Run a custom Infinito module
  infinito_custom_module:
    option_one: value
    option_two: value

Implementation Notes

  • Keep modules idempotent and predictable.
  • Validate input early and return structured failure messages.
  • Move duplicated helpers into utils/.

Shebang Requirement for Custom Modules

Files in library/ should use:

#!/usr/bin/python

Ansible rewrites this interpreter path to the configured host interpreter for module execution.

References