Skip to main content

ActionSubError

Represents a structured action sub-error.

ActionSubError captures detailed information about errors that occur during build actions, including location information (file, line, column), error messages, and categorization. These objects are created in error handlers (error_handler in AnalysisActions.run) and are used to provide better error diagnostics.

ActionSubError objects are typically created using ActionErrorCtx.new_sub_error or parsed from error output using ActionErrorCtx.parse_with_errorformat.

ActionSubError.category​

ActionSubError.category: str

A more granular category for the action error.

ActionSubError.col​

ActionSubError.col: None | int

Column number for the error location.

ActionSubError.end_col​

ActionSubError.end_col: None | int

End column number for error ranges.

ActionSubError.end_lnum​

ActionSubError.end_lnum: None | int

End line number for multi-line error spans.

ActionSubError.error_number​

ActionSubError.error_number: None | int

Numeric error code (e.g., 404, 500).

ActionSubError.error_type​

ActionSubError.error_type: None | str

Type of error (e.g., error, warning, info).

ActionSubError.file​

ActionSubError.file: None | str

File path for the error location.

ActionSubError.lnum​

ActionSubError.lnum: None | int

Line number for the error location.

ActionSubError.message​

ActionSubError.message: None | str

An optional message to be displayed with the error, used to provide additional context

ActionSubError.remediation​

ActionSubError.remediation: None | str

Optional remediation steps for the error

ActionSubError.show_in_stderr​

ActionSubError.show_in_stderr: bool

Whether to show this error in stderr.

ActionSubError.subcategory​

ActionSubError.subcategory: None | str

Optional subcategory for finer-grained error categorization