Skip to main content

Module error

Module error 

Source
Expand description

Error types for Materialize project operations.

This module provides structured error types using thiserror that capture rich contextual information about failures during project loading, parsing, and validation.

§Error Hierarchy

ProjectError
  ├── Load(LoadError)              - File I/O and directory traversal errors
  ├── Parse(ParseError)            - SQL parsing errors
  ├── Validation(ValidationError)  - Semantic validation errors with context
  └── Dependency(DependencyError)  - Dependency graph analysis errors

§Error Context

Validation errors are wrapped with ErrorContext that captures:

  • File path where the error occurred
  • SQL statement that caused the error (when available)

This design avoids duplicating context fields across all error variants.

Modules§

dependency 🔒
Dependency errors for dependency graph analysis.
load 🔒
Load errors for project file I/O operations.
parse 🔒
Parse errors for SQL parsing operations.
validation 🔒
Validation errors for semantic validation of project definitions.

Enums§

ProjectError
Top-level error type for all project operations.