Enum SofError 

pub enum SofError {
    InvalidViewDefinition(String),
    FhirPathError(String),
    SerializationError(Error),
    CsvError(Error),
    IoError(Error),
    UnsupportedContentType(String),
    CsvWriterError(String),
    InvalidSource(String),
    SourceNotFound(String),
    SourceFetchError(String),
    SourceReadError(String),
    InvalidSourceContent(String),
    UnsupportedSourceProtocol(String),
    ParquetConversionError(String),
}

Comprehensive error type for SQL-on-FHIR operations.

This enum covers all possible error conditions that can occur during ViewDefinition processing, from validation failures to output formatting issues. Each variant provides specific context about the error to aid in debugging.

Error Categories

• Validation: ViewDefinition structure and logic validation
• Evaluation: FHIRPath expression evaluation failures
• I/O: File and serialization operations
• Format: Output format conversion issues

Examples

use helios_sof::{SofError, SofViewDefinition, SofBundle, ContentType, run_view_definition};

match run_view_definition(view, bundle, content_type) {
    Ok(output) => {
        println!("Transformation successful");
    },
    Err(SofError::InvalidViewDefinition(msg)) => {
        eprintln!("ViewDefinition validation failed: {}", msg);
    },
    Err(SofError::FhirPathError(msg)) => {
        eprintln!("FHIRPath evaluation error: {}", msg);
    },
    Err(SofError::UnsupportedContentType(format)) => {
        eprintln!("Unsupported output format: {}", format);
    },
    Err(e) => {
        eprintln!("Other error: {}", e);
    }
}

Variants

InvalidViewDefinition(String)

ViewDefinition structure or logic validation failed.

This error occurs when a ViewDefinition contains invalid or inconsistent configuration, such as missing required fields, invalid FHIRPath expressions, or incompatible select/unionAll structures.

FhirPathError(String)

FHIRPath expression evaluation failed.

This error occurs when a FHIRPath expression in a ViewDefinition cannot be evaluated, either due to syntax errors or runtime evaluation issues.

SerializationError(Error)

JSON serialization/deserialization failed.

This error occurs when parsing input JSON or serializing output data fails, typically due to malformed JSON or incompatible data structures.

CsvError(Error)

CSV processing failed.

This error occurs during CSV output generation, such as when writing headers or data rows to the CSV format.

IoError(Error)

File I/O operation failed.

This error occurs when reading input files or writing output files fails, typically due to permission issues or missing files.

UnsupportedContentType(String)

Unsupported output content type requested.

This error occurs when an invalid or unimplemented content type is specified for output formatting.

CsvWriterError(String)

CSV writer internal error.

This error occurs when the CSV writer encounters an internal issue that prevents successful output generation.

InvalidSource(String)

Invalid source parameter value.

This error occurs when the source parameter contains an invalid URL or path.

SourceNotFound(String)

Source not found.

This error occurs when the specified source file or URL cannot be found.

SourceFetchError(String)

Failed to fetch data from source.

This error occurs when fetching data from a remote source fails.

SourceReadError(String)

Failed to read source data.

This error occurs when reading data from the source fails.

InvalidSourceContent(String)

Invalid content in source.

This error occurs when the source content is not valid FHIR data.

UnsupportedSourceProtocol(String)

Unsupported source protocol.

This error occurs when the source URL uses an unsupported protocol.

ParquetConversionError(String)

Parquet conversion error.

This error occurs when converting data to Parquet format fails.

Trait Implementations

impl Debug for SofError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for SofError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for SofError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for SofError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SofError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SofError

fn from(source: Error) -> Self

Converts to this type from the input type.