Compile report emission controls. More...

Data Structures
struct	loomc_compile_report_options_t
	Compile report emission options. More...

Macros
#define	LOOMC_ARTIFACT_FORMAT_COMPILE_REPORT_JSON "loom-compile-report-json"
	Loom compile report JSON artifact format.

Enumerations
enum	loomc_compile_report_mode_t { LOOMC_COMPILE_REPORT_MODE_NONE = 0 , LOOMC_COMPILE_REPORT_MODE_SUMMARY = 1 , LOOMC_COMPILE_REPORT_MODE_DETAILS = 2 }
	Compile report detail mode. More...

Functions
loomc_status_t	loomc_compile_report_mode_parse (loomc_string_view_t value, loomc_compile_report_mode_t *out_mode)
	Parses a stable compile report mode spelling.
loomc_string_view_t	loomc_compile_report_mode_name (loomc_compile_report_mode_t mode)
	Returns the stable JSON/CLI spelling for mode.

Detailed Description

Compile report emission controls.

Compile reports are optional machine-readable sidecars for target emission. They describe the selected backend, target, terminal status, artifact size, and target-provided compiler analysis facts available at the selected verbosity.

Report generation is opt-in. Omitting this descriptor, or setting mode to LOOMC_COMPILE_REPORT_MODE_NONE, keeps emission on the normal artifact path and avoids detail-only report collection.

Enumeration Type Documentation

◆ loomc_compile_report_mode_t

enum loomc_compile_report_mode_t

Compile report detail mode.

Enumerator
LOOMC_COMPILE_REPORT_MODE_NONE	Does not request a compile report.
LOOMC_COMPILE_REPORT_MODE_SUMMARY	Requests stable target, status, artifact, and summary compiler facts.
LOOMC_COMPILE_REPORT_MODE_DETAILS	Requests summary facts plus detail rows when producers support them.

Function Documentation

◆ loomc_compile_report_mode_name()

loomc_string_view_t loomc_compile_report_mode_name ( loomc_compile_report_mode_t mode )

Returns the stable JSON/CLI spelling for mode.

Parameters

mode	Mode to name. Unrecognized values use the "none" spelling.

Returns: Borrowed static string view containing the stable spelling.

◆ loomc_compile_report_mode_parse()

loomc_status_t loomc_compile_report_mode_parse	(	loomc_string_view_t	value,
		loomc_compile_report_mode_t *	out_mode )

Parses a stable compile report mode spelling.

Accepts "", "none", "summary", "details", "json", "json-summary", or "json-details".

Parameters

value	Mode spelling to parse. The view need not be NUL-terminated.
out_mode	Receives the parsed mode on success.

Returns: OK when value is recognized. Invalid argument is returned when out_mode is NULL or the spelling is unsupported.

Data Structures

Macros