This repository contains a Ruby gem computing liturgical calendar of the Czech Old Catholic Church (Starokatolická církev v ČR).
Since the calendar system is very similar to the post-Vatican II Roman Catholic one, functionality of the calendarium-romanum gem is reused as much as possible. (In fact, one of the main purposes of this project is to try out how un/suitable calendarium-romanum is for such projects.)
Based on comparison of computed results with official ordo published by the church (2015, 2016, 2017, 2020), the library seems to be feature-complete, or at least very close to it. Bug reports are welcome.
The instructions below won't work, the gem has not been released yet.
Add this line to your application's Gemfile:
gem 'czech_old_catholic_calendar'And then execute:
$ bundle install
Or install it yourself as:
$ gem install czech_old_catholic_calendar
Public API is almost exactly the same as that of calendarium-romanum, just with a different name of the top-level module. Please refer to calendarium-romanum's documentation.
Typical usage may look like this:
require 'czech_old_catholic_calendar'
# GENERAL can be replaced with PRAHA or SUMPERK in order to get proper celebrations
# of the parishes of Prague and Sumperk, respectively
# (the only two parishes with proper celebrations listed in the calendar of the 2007 missal)
sanctorale = CzechOldCatholicCalendar::Data::GENERAL.load_with_parents
calendar = CzechOldCatholicCalendar::PerpetualCalendar.new(sanctorale: sanctorale)
# retrieve liturgical details of today
day = calendar[Date.today]czech_old_catholic_calendar is free software under the terms of the MIT license
(see LICENSE).
After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install.