LectServe α

Calendar Open Book Question Mark

Welcome to LectServe αlpha!

LectServe is an early version of a tool I'm providing to the Church to quickly find lectionary readings for a given day.

The backend supports both the Revised Common Lectionary and the ACNA lectionary for Sundays and Red-Letter days. I'm defaulting to the ACNA lectionary because I'm Anglican, but you can use the RCL if you would like.

The daily lectionary backend currently only supports the ACNA lectionary, but more are planned.

Nota bene: This software is shared in alpha quality. That's before beta! API endpoints and JSON payloads will change and things will shift around unexpectedly.

API Usage

All endpoints return JSON. Optionally, the argument ?lect=acna or ?lect=rcl can be given to each endpoint to specify the lectionary you wish to use for Sundays and Red-Letter days. The default lectionary is the ACNA.

/today
Returns the lectionary payload for today's date. "Today" is relative to the server LectServe is running on. Presently, the server is sitting in Virginia, but I'm not sure if it's running on EST or GMT.
/sunday
Returns the Sunday-only lectionary payload for the upcoming Sunday relative to "today".
/date/yyyy-mm-dd
Returns the lectionary payload for the given date. Date is given in four-digit year [yyyy], two-digit month [mm], and two digit day [dd] annotation with dashes between units. Christmas Day in 2016 would be given as /date/2016-12-25, for example.

Technical Information

LectServe is hosted on an Amazon EC2 instance and driven by Perl. The engine driving this site and the API is the wonderful Dancer2 framework and the Starman high-performance web server.

Behind the scenes all the hard work of finding our place in the lectionary is handled by the Date::Lectionary & Date::Lectionary::Daily modules and three helper modules Date::Advent, Date::Easter, and Date::Lectionary::Time.

Issues

This API and all the supporting infrastructure is supported and maintained by me in my free time. Please log issues for the lectionary content or day determination logic to the Date::Lectionary or Date::Lectionary::Daily projects on GitHub. Issues for this API and website can be logged to the LectServe project, also on GitHub.

Updates about issues, downtime, new features, etc. will be shared on our Twitter account.

/ect

More information about me, Michael Arnold, can be found on my website, Twitter, and on GitHub.

A huge thanks and much gratitude to my lovely wife, Jennifer, and my beautiful daughter, Rosemary, for letting me spend some of my free time working on this project!

Above all, Soli Deo Gloria!