copybook-error

Error types and taxonomy for copybook-rs.

This crate provides a comprehensive error taxonomy with stable error codes for all failure modes in the copybook processing system.

61 error codes across 10 families covering parse, schema, data, encoding, record, character set, file, infrastructure, audit, and Arrow/writer errors.

Public API

• Error - Main error type with code, message, and optional context
• ErrorCode - Stable error codes for programmatic error handling
• ErrorContext - Detailed error context (record index, field path, byte offset, line number)
• Result<T> - Result type alias
• error! macro - Convenience macro for creating errors

Error Code Taxonomy

The error codes follow the pattern CBK[Category][Number]_[Description]:

• CBKP* - Parse errors during copybook analysis
• CBKS* - Schema validation and ODO processing
• CBKR* - Record format and RDW processing
• CBKC* - Character conversion and encoding
• CBKD* - Data decoding and field validation
• CBKE* - Encoding and JSON serialization
• CBKF* - File format and structure validation
• CBKI* - Iterator and infrastructure state validation
• CBKA* - Performance and compliance audit operations
• CBKW* - Arrow and Parquet conversion errors