From 063d4058346f7dc03eb0aa5ba394b9a872d3f1e3 Mon Sep 17 00:00:00 2001 From: Lukasz Kasprzak Date: Wed, 19 Aug 2026 08:41:23 +0200 Subject: feat(render): CSV and JSON emitters, and the published contract Both consume the VIEW, not the kernel, so every emitter and every template describe exactly the same fields -- there is one vocabulary, not five. CSV is RFC 4180: a field with a comma is quoted. That is live on real data, not hypothetical -- 'St. Joseph, Spouse of the Bl. Virgin Mary' would otherwise split into two columns. JSON is hand-rolled because the dependency list is frozen and escaping is the only subtlety. Control characters below 0x20 are \u-escaped per RFC 8259 section 7. There are no numbers in the view, deliberately: a consumer never has to guess whether week is 2 or "2". schema/day-v1.json pins the shape. Once a phone subscribes or a site fetches this, it is a promise to strangers -- adding a field is minor, renaming one means /v2/. --- lib/render/emit_csv.ml | 44 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) create mode 100644 lib/render/emit_csv.ml (limited to 'lib/render/emit_csv.ml') diff --git a/lib/render/emit_csv.ml b/lib/render/emit_csv.ml new file mode 100644 index 0000000..b478265 --- /dev/null +++ b/lib/render/emit_csv.ml @@ -0,0 +1,44 @@ +(* emit_csv.ml *) +module T = Template + +let escape_field s = + let needs = + String.exists (fun c -> c = ',' || c = '"' || c = '\n' || c = '\r') s + in + if not needs then s + else begin + let b = Buffer.create (String.length s + 8) in + Buffer.add_char b '"'; + String.iter (fun c -> if c = '"' then Buffer.add_string b "\"\"" else Buffer.add_char b c) s; + Buffer.add_char b '"'; + Buffer.contents b + end + +let get v k = match v with T.Obj kvs -> List.assoc_opt k kvs | _ -> None +let s v k = match get v k with Some (T.Str x) -> x | _ -> "" +let nested v a b = match get v a with Some inner -> s inner b | None -> "" + +let columns = + [ "date"; "rite"; "season"; "week"; "slug"; "rank"; "colour"; "subject"; + "name_la"; "name_en"; "first"; "gospel"; "comms" ] + +let row ~rite d = + let comms = + match get d "comms" with + | Some (T.List l) -> String.concat " " (List.map (fun c -> s c "slug") l) + | _ -> "" + in + String.concat "," + (List.map escape_field + [ s d "iso"; rite; s d "season"; s d "week"; s d "slug"; s d "rank"; + s d "colour"; s d "subject"; nested d "name" "la"; nested d "name" "en"; + s d "first"; s d "gospel"; comms ]) + +let year v = + let rite = s v "rite" in + let days = match get v "days" with Some (T.List l) -> l | _ -> [] in + let b = Buffer.create (64 * 400) in + Buffer.add_string b (String.concat "," columns); + Buffer.add_char b '\n'; + List.iter (fun d -> Buffer.add_string b (row ~rite d); Buffer.add_char b '\n') days; + Buffer.contents b -- cgit v1.3