object

# `linter_reporter`

Intercepts compiler linter warnings and caches them as machine-readable diagnostics.

Availability:
`logtalk_load(linter_reporter(loader))`
Author: Paulo Moura
Version: 1:0:0
Date: 2026-03-30
Compilation flags:
`static, context_switching_calls`
Imports:
`public` tool_diagnostics_common
`public` tutor_explanations
`public` options
Provides:
logtalk::message_hook/4
Uses:
list
logtalk
os
term_io
type
user
Remarks:

> - Usage: Load this tool before compiling code to be checked by the built-in linter. Call `enable/0-1` before compiling code, `disable/0` when finished collecting warnings, and then query the cached warnings using either the legacy warning predicates or the diagnostics protocol predicates. The standalone `sarif` tool can generate SARIF reports by querying these diagnostics.

> - Diagnostics targets: The diagnostics predicates accept the targets `all`, `entity(Entity)`, `file(File)`, `directory(Directory)`, `rdirectory(Directory)`, `library(Library)`, and `rlibrary(Library)`. These targets simply filter the cached diagnostics collected in the current warning collection session.

Inherited public predicates:
check_option/1 check_options/1 default_option/1 default_options/1 diagnostic/2 diagnostic/3 diagnostic_rule/5 diagnostic_rules/1 diagnostic_target/1 diagnostics/2 diagnostics/3 diagnostics_preflight/2 diagnostics_preflight/3 diagnostics_summary/2 diagnostics_summary/3 diagnostics_tool/5 explain//1 option/2 option/3 valid_option/1 valid_options/1

## Public predicates

### `enable/0`

Enables warning collection and starts a fresh warning collection session using the default options.

Compilation flags:
`static`
Mode and number of proofs:
`enable` - `one`

### `enable/1`

Enables warning collection and starts a fresh warning collection session using the given options.

Compilation flags:
`static`
Template:
`enable(Options)`
Mode and number of proofs:
`enable(+list(compound))` - `one_or_error`

### `disable/0`

Disables warning collection while preserving the cached warnings for later querying.

Compilation flags:
`static`
Mode and number of proofs:
`disable` - `one`

### `reset/0`

Clears all cached warnings collected in the current session.

Compilation flags:
`static`
Mode and number of proofs:
`reset` - `one`

### `warning/1`

Enumerates normalized linter warnings collected in the current session.

Compilation flags:
`static`
Template:
`warning(Warning)`
Mode and number of proofs:
`warning(-compound)` - `zero_or_more`

### `warnings/1`

Returns the collected normalized linter warnings.

Compilation flags:
`static`
Template:
`warnings(Warnings)`
Mode and number of proofs:
`warnings(-list(compound))` - `one`

### `summary/1`

Returns a machine-readable summary for the collected linter warnings.

Compilation flags:
`static`
Template:
`summary(Summary)`
Mode and number of proofs:
`summary(-compound)` - `one`

## Protected predicates

(no local declarations; see entity ancestors if any)

## Private predicates

### `enabled_/0`

True when warning collection is enabled.

Compilation flags:
`dynamic`
Mode and number of proofs:
`enabled_` - `zero_or_one`

### `warning_sequence_/1`

Stores the last assigned warning sequence number.

Compilation flags:
`dynamic`
Template:
`warning_sequence_(Sequence)`
Mode and number of proofs:
`warning_sequence_(-integer)` - `zero_or_one`

### `recorded_warning_/4`

Caches collected warnings together with their sequence number, flag, normalized message term, and printed message tokens.

Compilation flags:
`dynamic`
Template:
`recorded_warning_(Sequence,Flag,Message,Tokens)`
Mode and number of proofs:
`recorded_warning_(?integer,?atom,?compound,?list(compound))` - `zero_or_more`

### `collection_options_/1`

Stores the merged options for the current warning collection session.

Compilation flags:
`dynamic`
Template:
`collection_options_(Options)`
Mode and number of proofs:
`collection_options_(-list(compound))` - `zero_or_one`

## Operators

(none)