summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLukasz Kasprzak <lukas@labunix.xyz>2026-07-27 21:44:17 +0200
committerLukasz Kasprzak <lukas@labunix.xyz>2026-07-27 21:44:17 +0200
commite661227e10d2b6de4ab659fd9586d0a1479650dc (patch)
treefcf842a548dfe940746f4c85a8d796207d6fb2ec
parentb423759bf017d8fa1e45e5d1ce978f1b8d0a6a9f (diff)
downloadlectio-e661227e10d2b6de4ab659fd9586d0a1479650dc.tar.gz
lectio-e661227e10d2b6de4ab659fd9586d0a1479650dc.zip
chore: bump to 0.35.0 + README for calendar API (JSON/iCal)
-rw-r--r--README.md21
-rw-r--r--internal/config/config.go2
2 files changed, 22 insertions, 1 deletions
diff --git a/README.md b/README.md
index 82228f4..8ed8f81 100644
--- a/README.md
+++ b/README.md
@@ -100,6 +100,27 @@ not respect `--lectionary`/`--offline`, it always harvests the modern
lectio update --days 30
```
+### Calendar API — JSON & iCal
+
+Emit the computed liturgical calendar (day identity + reading citations) as
+JSON or iCal, offline. Honours the config's form (OF/EF) and custom calendar
+layers.
+
+```sh
+lectio 2026-01-06 --format json # one day, JSON
+lectio --format ical --year 2026 > lectio-2026.ics # a year, iCal feed
+lectio --format json --from 2026-01-01 --to 2026-01-31 # a range
+lectio --format ical --year 2026 --form new # override the form
+```
+
+`lectio-web` also serves the same data for `webcal://` subscription:
+
+- `GET /api/calendar.json?date=…` or `?from=&to=` or `?year=` (+ optional `&form=old|new`)
+- `GET /calendar.ics?year=…` or `?from=&to=` — served as `text/calendar`
+
+The web endpoints validate every input and cap a request's span at ~5 years
+(1830 days); JSON carries a stable `"schema": "lectio.calendar/1"`.
+
## `lectio-ui` — the terminal reader
```sh
diff --git a/internal/config/config.go b/internal/config/config.go
index 5dff005..ec50e0c 100644
--- a/internal/config/config.go
+++ b/internal/config/config.go
@@ -63,7 +63,7 @@ const configHeader = `# lectio configuration (INI). Full-line comments only (# o
// Version is lectio's release version, shared by every binary's
// -v/--version output (lectio, lectio-ui, lectio-web).
-const Version = "0.34.0"
+const Version = "0.35.0"
// validVersions are the five scripture versions lectio understands.
var validVersions = map[string]bool{