calendarium-romanum 0.5.0 → 0.9.0

data/liturgical_law/2006_notification.md

@@ -0,0 +1,37 @@
+---
+source: Notitiae 475-476/2006, p. 96 http://www.cultodivino.va/content/dam/cultodivino/notitiae/2006/475-476%20DEF.pdf#page=34
+note: |
+  Not an act of liturgical legislation in a proper sense, but an authoritative example
+  of correct application of the law in force.
+---
+
+CONGREGATIO DE CULTU DIVINO ET DISCIPLINA SACRAMENTORUM
+
+NOTIFICAZIONE
+
+La Congregazione per il Culto Divino e la Disciplina dei Sacramenti si fa premura
+di attirare l’attenzione sulla occorrenza di alcune celebrazioni che ricorreranno
+nell’anno 2008. In particolare, si fa presente che la solennità di San Giuseppe (19 marzo)
+ricorre il mercoledì della Settimana Santa e la solennità dell’Annunciazione del Signore
+(25 marzo) il martedì fra l’Ottava di Pasqua.
+
+Secondo la normativa vigente contenuta nelle Normae Universales de Anno Liturgico
+et de Calendario, le summenzionate solennità devono essere trasferite in tal modo:
+« Sollemnitas S. Ioseph, ubi est de praecepto servanda, si cum Dominica
+in Palmis de Passione Domini occurrit, anticipatur sabbato praecedenti, die 18 martii.
+Ubi vero non est de praecepto servanda, a Conferentia Episcoporum ad alium diem
+extra Quadragesimam transferri potest » (n. 56 f);
+« Sollemnitas vero Annuntiationis Domini, quotiescumque occurrit aliquo die Hebdomadae
+Sanctae, semper ad feriam II post dominicam II Paschae erit transferenda » (n. 60).
+
+Pertanto, è stabilito che nell’anno 2008 la solennità di San Giuseppe sarà celebrata
+il 15 marzo, ovvero il sabato precedente la Domenica delle Palme, mentre la solennità
+dell’Annunciazione del Signore sarà celebrata il 31 marzo, ovvero il lunedì dopo
+la II Domenica di Pasqua.
+
+```ruby
+calendar = CR::PerpetualCalendar.new(sanctorale: CR::Data::GENERAL_ROMAN_LATIN.load)
+
+expect(calendar[Date.new(2008, 3, 15)].celebrations[0].symbol).to be :joseph
+expect(calendar[Date.new(2008, 3, 31)].celebrations[0].symbol).to be :annunciation
+```

data/liturgical_law/2012_declarationes.md

@@ -0,0 +1,38 @@
+---
+source: Notitiae 549-550/2012, p. 269; http://www.cultodivino.va/content/dam/cultodivino/notitiae/2012/549-550 DEF.pdf#page=80
+note: |
+  Not an act of liturgical legislation in a proper sense, but an authoritative example
+  of correct application of the law in force.
+---
+
+# Declaratio circa Sollemnitatem Annuntiationis Domini anno 2013 celebrandam
+
+Cum anno 2013, die 25 martii incidat feria II Hebdomadae
+Sanctae, iuxta Tabulam dierum liturgicorum secundum ordinem
+praecedentiae dispositam et secundum n. 60 Normarum de Anno
+liturgico et de Calendario, sollemnitas Annuntiationis Domini
+celebrabitur die 8 aprilis, scilicet feria II post Dominicam II Paschae, sicut
+ex editione typica tertia Missalis Romani patet.
+
+```ruby
+calendar = CR::Calendar.new(2012, CR::Data::GENERAL_ROMAN_LATIN.load)
+
+day = calendar[Date.new(2013, 4, 8)]
+expect(day.celebrations.first.symbol).to be :annunciation
+```
+
+# Declaratio circa sollemnitatem Immaculatae Conceptionis Beatae Mariae Virginis a. 2013 in Dominica II Adventus incidentem
+
+Cum anno 2013, die 8 decembris incidat Dominica II Adventus,
+iuxta Tabulam dierum liturgicorum secundum ordinem praecedentiae
+dispositam et secundum nn. 5 et 60 Normarum de Anno liturgico
+et de Calendario, sollemnitas Immaculatae Conceptionis Beatae
+Mariae Virginis celebrabitur die 9 decembris, feria II post Dominica
+II Adventus.
+
+```ruby
+calendar = CR::Calendar.new(2013, CR::Data::GENERAL_ROMAN_LATIN.load)
+
+day = calendar[Date.new(2013, 12, 9)]
+expect(day.celebrations.first.symbol).to be :bvm_immaculate
+```

data/liturgical_law/2020_dubia_de_calendario_2022.md

@@ -0,0 +1,100 @@
+---
+title: Responsum ad dubia de calendario liturgico exarando pro anno 2022
+source: http://www.cultodivino.va/content/cultodivino/it/documenti/responsa-ad-dubia/2020/de-calendario-liturgico-2022.html
+---
+
+# RESPONSUM AD DUBIA DE CALENDARIO LITURGICO EXARANDO PRO ANNO 2022
+
+Redactores nonnulli "Ordinis Missae celebrandae et Officii Divini persolvendi" dubia proposuerunt
+de Calendario liturgico pro venturo anno 2022 exarando, cum sollemnitas quaedam die sabbati aut feria
+secunda occurrit.
+
+Attento numero 60 ["Normarum universalium de anno liturgico et de Calendario"](./2002_normae_universales.md),
+infrascriptarum celebrationum ordo sequenti modo erit disponendus:
+
+a) Sollemnitas Sanctae Dei Genetricis Mariae, die 1 ianuarii, sabbato.
+   Dominica II Post Nativitatem, die 2 ianuarii.
+
+   - Die 1 ianuarii II Vesperae et Missa vespertina sollemnitatis Sanctae Dei Genetricis Mariae celebrentur.
+
+```ruby
+calendar = CR::Calendar.new 2021, CR::Data::GENERAL_ROMAN_LATIN.load, vespers: true
+
+date = Date.new(2022, 1, 1)
+expect(date).to be_saturday
+
+day = calendar[date]
+expect(day.celebrations[0].symbol).to be :mother_of_god
+expect(day.vespers).to be nil
+
+expect(calendar[Date.new(2022, 1, 2)].celebrations[0].rank)
+  .to be CR::Ranks::SUNDAY_UNPRIVILEGED
+```
+
+b) Sollemnitas S. Ioseph Sponsi Beatae Mariae Virginis, die 19 martii, sabbato.
+   Dominica III in Quadragesima, die 20 martii.
+
+   - Die 19 martii I Vesperae et Missa vespertina Dominicae III in Quadragesima celebrentur.
+
+```ruby
+calendar = CR::Calendar.new 2021, CR::Data::GENERAL_ROMAN_LATIN.load, vespers: true
+
+date = Date.new(2022, 3, 19)
+expect(date).to be_saturday
+
+I18n.with_locale(:la) do
+  day = calendar[date]
+  expect(day.celebrations[0].symbol).to be :joseph
+  expect(day.vespers.title).to eq 'Dominica III Quadragesimae'
+end
+```
+
+c) Sollemnitas Nativitatis S. Ioanni Baptistae et sollemnitas Sacratissimi Cordis Iesu, eadem die 24 iunii
+   coincidentes.
+
+   - Die 24 iunii, feria VI: sollemnitas Sacratissimi Cordis Iesu celebretur.
+     Sollemnitas Nativitatis S. Ioannis Baptistae ad diem 23 iunii, feriam V, transferatur,
+	 II Vesperae omittantur. I Vesperae sollemnitatis Sacratissimi Cordis Iesu celebrentur.
+
+```ruby
+pending 'ad hoc solution beyond the regular calendar rules, not supported in this version of calendarium-romanum'
+
+calendar = CR::Calendar.new 2021, CR::Data::GENERAL_ROMAN_LATIN.load, vespers: true
+
+i23 = Date.new(2022, 6, 23)
+i24 = i23 + 1
+
+expect(i24).to be_friday
+
+expect(calendar[i24].celebrations[0].symbol).to be :sacred_heart
+
+day = calendar[i23]
+expect(day.celebrations[0].symbol).to be :baptist_birth
+expect(day.vespers.symbol).to be :sacred_heart
+```
+
+Ubi vero S. Ioannes Baptista patronus sit nationis vel dioecesis vel civitatis aut
+communitatis religiosae, sollemnitas Nativitatis S. Ioannis Baptistae die 24 iunii,
+feria VI, celebretur; sollemnitas autem Sacratissimi Cordis Iesu ad diem 23 iunii,
+feriam V transferatur, usque ad horam Nonam inclusive.
+
+```ruby
+skip 'there is currently no pretty way how to model this scenario using calendarium-romanum -
+  significant customizations of core functionalities would be required'
+```
+
+d) Dominica XX Temporis "per annum", die 14 augusti.
+   Sollemnitas Assumptionis Beatae Mariae Virginis, die 15 augusti, feria II.
+
+   - Die 14 augusti I Vesperae et Missa in Vigilia sollemnitatis Assumptionis Beatae Mariae Virginis
+     celebrentur.
+
+```ruby
+calendar = CR::Calendar.new 2021, CR::Data::GENERAL_ROMAN_LATIN.load, vespers: true
+
+date = Date.new(2022, 8, 14)
+expect(date).to be_sunday
+expect(calendar[date].vespers.symbol).to be :assumption
+```
+
+Ex aedibus Congregationis de Cultu Divino et Disciplina Sacramentorum, die 11 mensis maii 2020.

data/liturgical_law/README.md

@@ -0,0 +1,74 @@
+# Liturgical Law
+
+This directory contains documents of liturgical legislation
+implemented by the library. Each document is reproduced in Latin,
+in a form of a Markdown file.
+
+## Main documents, development overview
+
+Fundamental outline of the calendar system is contained in the document
+*Normae universales de anno liturgico et de calendario*, first published in 1969.
+Most of the 1969 text is in force without a substantial change up to this day,
+but during the years some important parts were changed, a particularly hot matter
+being the rules concerning transfer of impeded solemnities.
+Apart of updates of the *Normae* themselves, a few additional rules were added
+to the calendar system by separate documents (the more formal ones being CDW decrees,
+the less formal ones notifications).
+
+* **1969 Normae universales de anno liturgico et de calendario**
+  initial outline of the calendar system
+* **1970 Missale Romanum, editio typica**
+  [updated](http://www.cultodivino.va/content/dam/cultodivino/notitiae/1970/54 1.pdf#page=49)
+  paragraphs 13, 56, 59 and 60 of the *Normae*
+* **1975 Missale Romanum, editio typica altera**
+  [updated](http://www.cultodivino.va/content/dam/cultodivino/notitiae/1975/111-112.pdf#page=27)
+  paragraphs 14, 47 and 59 of the *Normae* (mostly mere terminological changes;
+  the change of paragraph 59 dropped a few categories from the *Table of Liturgical Days*)
+* **1977 Decree about the feast of Baptism of the Lord**
+  with an improved rule of computing it's date for places where Epiphany is celebrated
+  on a Sunday
+* **1990 Decree updating Normae, n. 5**
+  (transfer rule for a solemnity impeded by a privileged Sunday)
+* **1998 Notification concerning occurrence of the memorial of the Immaculate Heart of Mary**
+
+## Code examples
+
+The Markdown files, in addition to the text of documents of liturgical
+legislation, contain also blocks of Ruby code, each proving
+that the immediately preceding part of the document is implemented
+by the library. The documents illustrated with code blocks thus constitute
+sort of a test suite in the [literate programming](https://en.wikipedia.org/wiki/Literate_programming)
+style. This test suite is integrated in the project's main test suite
+(see `spec/liturgical_law_spec.rb`)
+
+Utilities commonly used in the code blocks:
+
+```ruby
+# RSpec expectations are available in the code blocks
+expect(1).to be_truthy
+
+# method `year` returns a random year (which is a valid liturgical years
+# for calendarium-romanum) and should be used in all examples which need
+# a single year and don't require a particular one
+expect(year).to be_a Integer
+expect(year).to be >= 1970
+# year is the same for the whole example, even if called multiple times
+a = year; b = year
+expect(a).to be b
+
+# method `years` returns a representative Enumerable of (valid liturgical)
+# years and should be used in all examples which test across several years
+# and don't require particular ones
+expect(years).to be_a Enumerable
+yrs = years.to_a
+expect(yrs[0]).to be_a Integer
+
+# method `years_with` returns an array of years (which are valid liturgical years
+# for calendarium-romanum) matching the specified condition
+yrs = years_with {|y| true }
+expect(yrs).to be_an Array
+expect(yrs[0]).to be_an Integer
+# if no matching year is found an exception is raised
+expect { years_with {|y| false } }
+  .to raise_exception(RuntimeError, /no matching year/)
+```

metadata

@@ -1,43 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: calendarium-romanum
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Jakub Pavlík
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-11-01 00:00:00.000000000 Z
+date: 2021-04-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.18'
+        version: '0.15'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.18'
+        version: '0.15'
 - !ruby/object:Gem::Dependency
   name: i18n
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0.7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0.7'
 - !ruby/object:Gem::Dependency
   name: roman-numerals
   requirement: !ruby/object:Gem::Requirement
@@ -81,19 +81,35 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '3.5'
 description: calendar computations according to the Roman Catholic liturgical calendar
-  as instituted by MP Mysterii Paschalis of Paul VI (1969).
+  as instituted by MP Mysterii Paschalis of Paul VI (1969) and defined in General
+  Norms for the Liturgical Year and the Calendar and other documents of liturgical
+  legislation.
 email: jkb.pavlik@gmail.com
 executables:
 - calendariumrom
 extensions: []
 extra_rdoc_files: []
 files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
+- ".yardopts"
+- Appraisals
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
 - bin/calendariumrom
+- calendarium-romanum.gemspec
 - config/locales/cs.yml
 - config/locales/en.yml
+- config/locales/es.yml
 - config/locales/fr.yml
 - config/locales/it.yml
 - config/locales/la.yml
+- config/locales/pt.yml
 - data/README.md
 - data/czech-brno-cs.txt
 - data/czech-budejovice-cs.txt
@@ -106,14 +122,28 @@ files:
 - data/czech-ostrava-cs.txt
 - data/czech-plzen-cs.txt
 - data/czech-praha-cs.txt
+- data/easter_dates.txt
+- data/universal-1969-la.txt
 - data/universal-en.txt
+- data/universal-es.txt
 - data/universal-fr.txt
 - data/universal-it.txt
 - data/universal-la.txt
+- data/universal-pt.txt
+- doc/data_readme.md
+- doc/images/class_diagram.png
+- doc/images/class_diagram.puml
+- doc/yard_readme.rdoc
 - lib/calendarium-romanum.rb
 - lib/calendarium-romanum/abstract_date.rb
 - lib/calendarium-romanum/calendar.rb
 - lib/calendarium-romanum/cli.rb
+- lib/calendarium-romanum/cli/comparator.rb
+- lib/calendarium-romanum/cli/date_parser.rb
+- lib/calendarium-romanum/cli/dumper.rb
+- lib/calendarium-romanum/cli/helper.rb
+- lib/calendarium-romanum/cli/querier.rb
+- lib/calendarium-romanum/cr.rb
 - lib/calendarium-romanum/data.rb
 - lib/calendarium-romanum/day.rb
 - lib/calendarium-romanum/enum.rb
@@ -123,44 +153,37 @@ files:
 - lib/calendarium-romanum/ordinalizer.rb
 - lib/calendarium-romanum/perpetual_calendar.rb
 - lib/calendarium-romanum/rank.rb
+- lib/calendarium-romanum/rank_predicates.rb
 - lib/calendarium-romanum/sanctorale.rb
 - lib/calendarium-romanum/sanctorale_factory.rb
-- lib/calendarium-romanum/sanctoraleloader.rb
+- lib/calendarium-romanum/sanctorale_loader.rb
+- lib/calendarium-romanum/sanctorale_writer.rb
 - lib/calendarium-romanum/temporale.rb
 - lib/calendarium-romanum/temporale/celebration_factory.rb
+- lib/calendarium-romanum/temporale/date_helper.rb
 - lib/calendarium-romanum/temporale/dates.rb
+- lib/calendarium-romanum/temporale/easter_table.rb
+- lib/calendarium-romanum/temporale/extensions.rb
 - lib/calendarium-romanum/temporale/extensions/christ_eternal_priest.rb
+- lib/calendarium-romanum/temporale/extensions/dedication_before_all_saints.rb
 - lib/calendarium-romanum/transfers.rb
 - lib/calendarium-romanum/util.rb
 - lib/calendarium-romanum/version.rb
-- spec/abstract_date_spec.rb
-- spec/calendar_spec.rb
-- spec/celebration_factory_spec.rb
-- spec/celebration_spec.rb
-- spec/cli_spec.rb
-- spec/colour_spec.rb
-- spec/data_spec.rb
-- spec/date_parser_spec.rb
-- spec/date_spec.rb
-- spec/dates_spec.rb
-- spec/day_spec.rb
-- spec/enum_spec.rb
-- spec/i18n_spec.rb
-- spec/ordinalizer_spec.rb
-- spec/perpetual_calendar_spec.rb
-- spec/rank_spec.rb
-- spec/readme_spec.rb
-- spec/sanctorale_factory_spec.rb
-- spec/sanctorale_spec.rb
-- spec/sanctoraleloader_spec.rb
-- spec/season_spec.rb
-- spec/spec_helper.rb
-- spec/temporale_spec.rb
+- liturgical_law/1969_normae_universales.md
+- liturgical_law/1977_decretum_de_celebratione_baptismatis_domini.md
+- liturgical_law/1990_decretum_de_variatione_inducenda.md
+- liturgical_law/1998_notificatio_de_occurrentia.md
+- liturgical_law/2002_normae_universales.md
+- liturgical_law/2006_notification.md
+- liturgical_law/2012_declarationes.md
+- liturgical_law/2020_dubia_de_calendario_2022.md
+- liturgical_law/README.md
 homepage: http://github.com/igneus/calendarium-romanum
 licenses:
 - LGPL-3.0
 - MIT
-metadata: {}
+metadata:
+  documentation_uri: https://www.rubydoc.info/gems/calendarium-romanum/
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -169,7 +192,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -177,7 +200,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.1
+rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
 summary: Roman Catholic liturgical calendar computations