summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorLukasz Kasprzak <lukas@labunix.xyz>2026-07-31 14:02:03 +0200
committerLukasz Kasprzak <lukas@labunix.xyz>2026-07-31 14:02:03 +0200
commite94eeaa19627a9a0f235baf110780c9fb564ca2b (patch)
tree2279ec29962017b08e0c5222192b0b6763fb9493 /README.md
parent8def55357436b0f6a7265af9e11663d95246e7eb (diff)
downloadcolitur-e94eeaa19627a9a0f235baf110780c9fb564ca2b.tar.gz
colitur-e94eeaa19627a9a0f235baf110780c9fb564ca2b.zip
chore: scaffold dune project (kernel lib + cli + tests)
OCaml 5.2.0 local switch; colitur_kernel library, a colitur executable stub, and an alcotest+qcheck test runner. AGPL LICENSE, README, generated colitur.opam.
Diffstat (limited to 'README.md')
-rw-r--r--README.md23
1 files changed, 23 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e5a6c5f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,23 @@
+# colitur
+
+*computus liturgicus* — a safe, highly-tested, deterministic engine that computes
+and validates liturgical calendars for multiple rites, with template-driven output.
+
+Starting with the Roman EF (1962) and OF forms; extensible to other traditions.
+Computes day-identity (season, celebration, rank, colour, cycle, precedence) and
+reading citations, correct to year 9999. See the design and rules research under
+`docs/` (local).
+
+## Build
+
+```sh
+opam switch create . 5.2.0 -y # first time: local OCaml switch
+opam install -y dune alcotest qcheck qcheck-alcotest
+dune build
+dune test
+dune exec colitur -- easter 2026
+```
+
+## License
+
+AGPL-3.0-or-later. See `LICENSE`.