// SPDX-License-Identifier: MPL-2.0 // (c) Hare authors use bufio; use io; use strings; export type scanner = struct { scan: bufio::scanner, lineno: size, section: str, }; // Creates an INI file scanner. The supplied handle need not be buffered, since // the returned [[scanner]] manages its own internal [[bufio::scanner]]. Use // [[next]] to read entries. The caller must call [[finish]] once they're done // with the INI scanner. export fn scan(in: io::handle) scanner = { return scanner { scan = bufio::newscanner(in), lineno = 1, ... }; }; // Frees resources associated with a [[scanner]]. export fn finish(sc: *scanner) void = { bufio::finish(&sc.scan); free(sc.section); }; // An entry in an INI file: (section, key, value). export type entry = (const str, const str, const str); // Duplicates an [[entry]]. Use [[entry_finish]] to free it. export fn entry_dup(ent: entry) (entry | nomem) = { let dup: entry = ("", "", ""); let ok = false; defer if (!ok) entry_finish(dup); dup.0 = strings::dup(ent.0)?; dup.1 = strings::dup(ent.1)?; dup.2 = strings::dup(ent.2)?; ok = true; return dup; }; // Frees an [[entry]] previously duplicated with [[entry_dup]]. export fn entry_finish(ent: entry) void = { free(ent.0); free(ent.1); free(ent.2); }; // Returns the next entry from an INI file. The return value is borrowed from // the [[scanner]]. Use [[entry_dup]] to retain a copy. export fn next(sc: *scanner) (entry | io::EOF | error | nomem) = { for (const line => bufio::scan_line(&sc.scan)?) { defer sc.lineno += 1; const line = strings::trim(line); if (len(line) == 0 || strings::hasprefix(line, "#")) { continue; }; if (strings::hasprefix(line, "[")) { const end = match (strings::index(line, ']')) { case let idx: size => yield idx; case void => return sc.lineno: syntaxerr; }; match (strings::dup(strings::sub(line, 1, end))) { case let s: str => free(sc.section); sc.section = s; case nomem => // XXX maybe add a bufio::unread_line? bufio::unread(&sc.scan, ['\n': u8]); bufio::unread(&sc.scan, strings::toutf8(line)); sc.lineno -= 1; return nomem; }; continue; }; const eq = match (strings::index(line, '=')) { case let idx: size => yield idx; case void => return sc.lineno: syntaxerr; }; return ( sc.section, strings::sub(line, 0, eq), strings::sub(line, eq + 1, strings::end), ); }; return io::EOF; };