pdstools.utils.report_utils

Helpers for generating Quarto-based pdstools reports.

This package preserves the public surface of the previous report_utils module while splitting the implementation across several focused private submodules:

• _common — shared module-level state (logger).

• _filenames — output filename composition and report-resource copying.

• _quarto — Quarto execution: rendering, command-line wrappers, Quarto/Pandoc version detection, callouts, and the show_credits block.

• _html — HTML post-processing: CSS inlining, zip bundling of Quarto resource folders, and report error scanning.

• _tables — RAG-coloured metric tables (itables and great_tables).

• _polars_helpers — small Polars helpers and aggregations used by Quarto report templates (gains table, hierarchy summarisations, etc.).

• _query — serialise/deserialise pdstools QUERY objects so they can travel through Quarto YAML parameters.

Submodule names are underscore-prefixed; only this __init__ is the supported import surface. Imports such as from pdstools.utils.report_utils import quarto_render_to_html continue to resolve unchanged.