comicbox.formats.base.online.warn_once

source module comicbox.formats.base.online.warn_once

Process-wide deduplication for repeated configuration warnings.

Functions

  • warn_once — Log message at WARNING the first time key is seen this process.

source warn_once(key: str, message: str) → None

Log message at WARNING the first time key is seen this process.

Online sources are rebuilt per file, so a warning emitted during client construction (e.g. “this config override is ignored”) would repeat for every file in a batch run. Deduplicating on a stable key keeps the signal at exactly one line per process regardless of which source’s build path emits it or how often.