Something went wrong. Try again.
A CSV parsing library in Zig.
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869//! CSV dialect configuration — controls delimiter, quote character, and//! optional UTF-8 BOM stripping.//!//! The default `Dialect` produces standard RFC 4180 behaviour: comma//! delimiter, double-quote quoting, with BOM stripping enabled (matches//! Excel-exported CSVs).
/// Parsing configuration. The default value is RFC 4180-compatible.pub const Dialect = struct { /// The single byte that separates fields. Common values: ',', '\t', /// ';', '|'. Must differ from `quote_char`, `\n`, and `\r`. delimiter: u8 = ',',
/// The single byte used to quote fields containing the delimiter, /// the quote character itself, or line endings. Must differ from /// `delimiter`, `\n`, and `\r`. quote_char: u8 = '"',
/// If true, strip a leading UTF-8 BOM (`EF BB BF`) from the input /// before parsing any fields. Default: on. Matches Excel-exported /// CSVs that prepend a BOM. strip_bom: bool = true,
/// Verify that the dialect's structural bytes do not collide with /// each other or with `\n`/`\r`. Returns `error.InvalidDialect` if /// any collision is present. Called by every parser `init` that /// accepts a `Dialect`. pub fn validate(self: Dialect) error{InvalidDialect}!void { if (self.delimiter == self.quote_char) return error.InvalidDialect; if (self.delimiter == '\n' or self.delimiter == '\r') return error.InvalidDialect; if (self.quote_char == '\n' or self.quote_char == '\r') return error.InvalidDialect; }};
const std = @import("std");const testing = std.testing;
test "Dialect: default is valid" { try (Dialect{}).validate();}
test "Dialect: delimiter == quote_char rejected" { try testing.expectError(error.InvalidDialect, (Dialect{ .delimiter = '"', .quote_char = '"' }).validate());}
test "Dialect: delimiter == LF rejected" { try testing.expectError(error.InvalidDialect, (Dialect{ .delimiter = '\n' }).validate());}
test "Dialect: delimiter == CR rejected" { try testing.expectError(error.InvalidDialect, (Dialect{ .delimiter = '\r' }).validate());}
test "Dialect: quote_char == LF rejected" { try testing.expectError(error.InvalidDialect, (Dialect{ .quote_char = '\n' }).validate());}
test "Dialect: quote_char == CR rejected" { try testing.expectError(error.InvalidDialect, (Dialect{ .quote_char = '\r' }).validate());}
test "Dialect: tab delimiter is valid" { try (Dialect{ .delimiter = '\t' }).validate();}
test "Dialect: semicolon delimiter is valid" { try (Dialect{ .delimiter = ';' }).validate();}