calendarium-romanum 0.8.0 → 0.9.0

data/data/universal-pt.txt

@@ -0,0 +1,248 @@
+---
+title: Calendário Romano Geral
+locale: pt
+# source: https://pt.wikipedia.org/wiki/Calendário_Romano_Geral,
+#         Roman Missal (Portuguese edition),
+#         and https://www.liturgia.pt/
+---
+
+= 1
+2 m basil_gregory : Ss. Basílio Magno e Gregório de Nazianzo, bispos e doutores da Igreja
+3 name_jesus : Santíssimo Nome de Jesus
+7 raymond : S. Raimundo de Peñafort. presbítero
+13 hilary : S. Hilário, bispo e doutor da Igreja
+17 m anthony_of_egypt : S. Antão, abade
+20 R fabian : S. Fabião, papa e mártir
+20 R sebastian : S. Sebastião, mártir
+21 m R agnes : S. Inês, virgem e mártir
+22 R vincent_deacon : S. Vicente, diácono e mártir
+24 m francis_de_sales : S. Francisco de Sales, bispo e doutor da Igreja
+25 f paul_conversion : Conversão de S. Paulo, apóstolo
+26 m timothy_titus : Ss. Timóteo e Tito, bispos
+27 merici : S. Angela Merici, virgem
+28 m aquinas : S. Tomás de Aquino, presbítero e doutor da Igreja 
+31 m bosco : S. João Bosco, presbítero
+
+= 2
+2 f2.5 presentation_of_lord : Apresentação do Senhor
+3 R blase : S. Brás, bispo e mártir
+3 ansgar : S. Ansgário, bispo
+5 m R agatha : S. Águeda (ou Ágata), virgem e mártir
+6 m R paul_miki : Ss. Paulo Miki e companheiros, mártires 
+8 jerome_emiliani : S. Jerónimo Emiliano, presbítero
+8 josephine_bakhita : S. Josefina Bakhita, virgem
+10 m scholastica : S. Escolástica, virgem
+11 bvm_lourdes : Nossa Senhora de Lourdes
+14 m cyril_methodius : Ss. Cirilo, monge, e Metódio, bispo
+17 servite_founders : Ss. Sete Fundadores da Ordem dos Servitas
+21 peter_damian : S. Pedro Damião, bispo e doutor da Igreja
+22 f chair_of_peter : Cátedra de S. Pedro, apóstolo
+23 m R polycarp : S. Policarpo, bispo e mártir
+27 gregory_of_narek : S. Gregório de Narek, abade e doutor da Igreja
+
+= 3
+4 casimir : S. Casimiro
+7 m R perpetua_felicity : Santas Perpétua e Felicidade, mártires
+8 john_of_god : S. João de Deus, religiosos
+9 frances_of_rome : S. Francisca Romana, religiosa
+17 patrick : S. Patrício, bispo
+18 cyril_of_jerusalem : S. Cirilo de Jerusalém, bispo e doutor da Igreja
+19 s joseph : S. José, esposo da Virgem S. Maria
+23 turibius :  S. Turíbio de Mongrovejo, bispo
+25 s annunciation : Anunciação do Senhor
+
+= 4
+2 francis_of_paola :  S. Francisco de Paula, eremita
+4 isidore : S. Isidoro, bispo e doutor da Igreja
+5 vincent_ferrer : S. Vicente Ferrer, presbítero
+7 m de_la_salle : S. João Batista de La Salle, presbítero
+11 m R stanislaus : S. Estanislau, bispo e mártir
+13 R martin_i : S. Martinho I, papa e mártir
+21 anselm : S. Anselmo, bispo e doutor da Igreja
+23 R george : S. Jorge, mártir
+23 R adalbert : S. Adalberto de Praga, bispo e mártir
+24 R fidelis : S. Fiel de Sigmaringa, presbítero e mártir
+25 f R mark : S. Marcos, evangelista
+28 R peter_chanel : S. Pedro Chanel, presbítero e mártir
+28 de_montfort : S. Luís Maria Grignion de Montfort, presbítero
+29 m catherine_of_siena : S. Catarina de Siena, virgem e doutora da Igreja
+30 pius_v : S. Pio V, papa
+
+= 5
+1 joseph_worker : S. José operário
+2 m athanasius : S. Atanásio, bispo e doutor da Igreja
+3 f R philip_james : Ss. Filipe e Tiago, apóstolos
+10 john_de_avila : S. João de Ávila, presbítero e doutor da Igreja
+12 R nereus_achilleus : Ss. Nereu e Aquileu, mártires
+12 R pancras : S. Pancrácio, mártir
+13 bvm_fatima : Nossa Senhora de Fátima
+14 f R matthias : S. Matias, apóstolo
+18 R john_i : S. João I, papa e mártir
+20 bernardine : S. Bernardino de Sena, presbítero
+21 R magallanes : Ss. Cristóvão de Magalhães e companheiros, mártires
+22 rita : S. Rita de Cássia, religiosa
+25 bede_venerable : S. Beda Venerável, presbítero e doutor da Igreja
+25 gregory_vii : S. Gregório VII, papa
+25 de_pazzi : S. Maria Madalena de Pazzi, virgem
+26 m neri : S. Filipe Néri, presbítero
+27 augustine_of_canterbury : S. Agostinho de Cantuária, bispo
+29 paul_vi : Sãp Paulo VI, papa
+31 f visitation :  Visitação da Virgem S. Maria
+
+= 6
+1 m R justin : S. Justino, mártir
+2 R marcellinus_peter : Ss. Marcelino e Pedro, mártires
+3 m R ugandan_martyrs : Ss. Carlos Lwanga e companheiros, mártires
+5 m R boniface : S. Bonifácio, bispo e mártir
+6 norbert : S. Norberto, bispo
+9 ephrem : S. Efrém, diácono e doutor da Igreja
+11 m R barnabas : S. Barnabé, apóstolo
+13 m anthony_of_padua : S. António de Lisboa, presbítero e doutor da Igreja
+19 romuald : S. Romualdo, abade
+21 m aloysius : S. Luís de Gonzaga, religioso
+22 paulinus : S. Paulino de Nola, bispo
+22 R fisher_more : Ss. João Fisher, bispo e mártir, e Tomás Moro, mártir
+24 s baptist_birth : Nascimento de João Batista
+27 cyril_of_alexandria : S. Cirilo de Alexandria, bispo e doutor da Igreja
+28 m R irenaeus : S. Ireneu, bispo e mártir
+29 s R peter_paul : Ss. Pedro e Paulo, apóstolos
+30 R first_martyrs_of_rome : Primeiros Ss. Mártires da Igreja de Roma
+
+= 7
+3 f R thomas_apostle : S. Tomé, apóstolo
+4 elizabeth_of_portugal : S. Isabel de Portugal
+5 anthony_zaccaria : S. António Maria Zacarias, presbítero
+6 R goretti : S. Maria Goretti, virgem e mártir
+9 R chinese_martyrs : Ss. Agostinho Zhao Rong e companheiros, mártires
+11 m benedict : S. Bento, abade
+13 henry : S. Henrique
+14 camillus_de_lellis : S. Camilo de Lelis, presbítero
+15 m bonaventure : S. Boaventura, bispo e doutor da Igreja
+16 bvm_mount_carmel : Virgem S. Maria do Monte Carmelo
+20 R apollinaris : S. Apolinário, bispo e mártir
+21 lawrence_of_brindisi : S. Lourenço de Brindes, presbítero e doutor da Igreja
+22 f mary_magdalene : S. Maria Madalena
+23 birgitta : S. Brígida, religiosa
+24 sharbel : S. Sarbélio Makhluf, presbítero
+25 f R james : S. Tiago, Apóstolo 
+26 m joachim_anne : S. Joaquim e S. Ana, pais da Virgem S. Maria 
+29 m martha_mary_lazarus : SS. Marta, Maria e Lázaro
+30 peter_chrysologus : S. Pedro Crisólogo, bispo e doutor da Igreja
+31 m ignatius_of_loyola : S. Inácio de Loiola, presbítero
+
+= 8
+1 m alphonsus : S. Afonso Maria de Ligório, bispo e doutor da Igreja
+2 eusebius : S. Eusébio de Vercelas, bispo
+2 eymard : S. Pedro Juliano Eymard, presbítero
+4 m vianney : S. João Maria Vianney, presbítero
+5 mary_major : Dedicação da Basílica de Santa Maria Maior
+6 f2.5 transfiguration : Transfiguração do Senhor
+7 R sixtus_ii : SS. Sisto II, papa, e Companheiros, mártires
+7 cajetan : S. Caetano, presbítero
+8 m dominic : S. Domingos, presbítero, Fundador da Ordem dos Pregadores
+9 R stein : S. Teresa Benedita da Cruz, virgem e mártir
+10 f R lawrence : S. Lourenço, diácono e mártir
+11 m clare : S. Clara, virgem
+12 de_chantal : S. Joana Francisca de Chantal, religiosa
+13 R pontian_hippolytus : S. Ponciano, papa, e S. Hipólito, presbítero, mártires
+14 m R kolbe : S. Maximiliano Maria Kolbe, presbítero e mártir
+15 s assumption : ASSUNÇÃO DA VIRGEM SANTA MARIA
+16 stephen_hungary : S. Estêvão da Hungria
+19 eudes : S. João Eudes, presbítero
+20 m bernard : S. Bernardo, abade e doutor da Igreja
+21 m pius_x : S. Pi0 X, papa
+22 m bvm_queenship : Virgem Santa Maria, Rainha
+23 rose_lima : S. Rosa de Lima, virgem
+24 f R bartholomew : S. Bartolomeu, Apóstolo
+25 louis : S. Luís de França
+25 joseph_calasanz : S. José de Calasanz, presbítero
+27 m monica : S. Mónica
+28 m augustine : S. Agostinho, bispo e doutor da Igreja
+29 m R baptist_beheading : Martírio de S. João Baptista
+
+= 9
+3 m gregory_great : S. Gregório Magno, papa e doutor da Igreja
+8 f bvm_birth : Natividade da Virgem Santa Maria
+9 claver : S. Pedro Claver, presbítero
+12 bvm_name : Santíssimo Nome de Maria
+13 m john_chrysostom : S. João Crisóstomo, bispo e doutor da Igreja
+14 f2.5 R cross : Exaltação da Santa Cruz
+15 m bvm_sorrows : Virgem Santa Maria das Dores
+16 m R cornelius_cyprian : S. Cornélio, papa, e S. Cipriano, bispo, mártires
+17 bellarmine : S. Roberto Belarmino, bispo e doutor da Igreja
+17 hildegard : S. Hildegarda de Bingen, virgem e doutora da Igreja
+19 R januarius : S. Januário, bispo e mártir
+20 m R korean_martyrs : SS. André Kim Taegon, presbítero, Paulo Chang Hasang, e Companheiros, mártires
+21 f R matthew : S. Mateus, Apóstolo e Evangelista
+23 m padre_pio : S. Pio de Pietrelcina, presbítero
+26 R cosmas_damian : S. Cosme e S. Damião, mártires
+27 m vincent_de_paul : S. Vicente de Paulo, presbítero
+28 R wenceslaus : S. Venceslau, mártir
+28 R ruiz : SS. Lourenço Ruiz e Companheiros, mártires
+29 f archangels : S. Miguel, S. Gabriel e S. Rafael, Arcanjos
+30 m jerome : S. Jerónimo, presbítero e doutor da Igreja
+
+= 10
+1 m therese_lisieux : S. Teresa do Menino Jesus, virgem e doutora da Igreja
+2 m guardian_angels : Santos Anjos da Guarda
+4 m francis_assisi : S. Francisco de Assis
+5 faustina_kowalska : Santa Faustina Kowalska
+6 bruno : S. Bruno, presbítero
+7 m bvm_rosary : Virgem Santa Maria do Rosário
+9 R denis : SS. Dionísio, bispo, e Companheiros, mártires
+9 leonardi : S. João Leonardo, presbítero
+11 john_xxiii : S. João XXIII, papa
+14 R callistus_i : S. Calisto I, papa e mártir
+15 m teresa_avila : S. Teresa de Jesus, virgem e doutora da Igreja
+16 hedwig : S. Hedwiges, religiosa
+16 alacoque : S. Margarida Maria Alacoque, virgem
+17 m R ignatius_of_antioch : S. Inácio de Antioquia, bispo e mártir
+18 f R luke : S. Lucas, Evangelista
+19 R brebeuf_jogues : SS. João de Brébeuf e Isaac Jogues, presbíteros, e Companheiros, mártires
+19 paul_of_cross : S. Paulo da Cruz, presbítero
+22 john_paul_ii : S. João Paulo II, papa
+23 john_capistrano : S. João de Capistrano, presbítero
+24 claret : S. António Maria Claret, bispo
+28 f R simon_jude : S. Simão e S. Judas, Apóstolos
+
+= 11
+1 s all_saints : TODOS OS SANTOS
+2 s V all_souls : Comemoração de Todos os Fiéis Defuntos 
+3 de_porres : S. Martinho de Porres, religioso
+4 m borromeo : S. Carlos Borromeu, bispo
+9 f2.5 lateran_basilica : Dedicação da Basílica de Latrão
+10 m leo_great : S. Leão Magno, papa e doutor da Igreja
+11 m martin : S. Martinho de Tours, bispo
+12 m R josaphat : S. Josafat, bispo e mártir
+15 albert : S. Alberto Magno, bispo e doutor da Igreja
+16 margaret_of_scotland : S. Margarida da Escócia
+16 gertrude : S. Gertrudes, virgem
+17 m elizabeth_of_hungary : S. Isabel da Hungria, religiosa 
+18 peter_paul_basilicas : Dedicação das Basílicas de S. Pedro e de S. Paulo, Apóstolos
+21 m bvm_presentation : Apresentação de Nossa Senhora
+22 m R cecilia : S. Cecília, virgem e mártir
+23 R clement_i : S. Clemente I, papa e mártir
+23 columban : S. Columbano, abade
+24 m R vietnamese_martyrs : SS. André Dung-Lac, presbítero, e Companheiros, mártires
+25 R catherine_of_alexandria : S. Catarina Alexandrina, virgem e mártir 
+30 f R andrew : S. André, Apóstolo
+
+= 12
+3 m francis_xavier : S. Francisco Xavier, presbítero, Padroeiro das Missões
+4 john_damascene : S. João Damasceno, presbítero e doutor da Igreja
+6 nicholas : S. Nicolau, bispo
+7 m ambrose : S. Ambrósio, bispo e doutor da Igreja
+8 s bvm_immaculate : IMACULADA CONCEIÇÃO DA VIRGEM SANTA MARIA
+9 juan_diego : S. João Diogo
+10 bvm_loreto : Virgem Santa Maria de Loreto
+11 damasus_i : S. Dâmaso I, papa
+12 bvm_guadalupe : Nossa Senhora de Guadalupe
+13 m R lucy : S. Luzia, virgem e mártir
+14 m john_of_cross : S. João da Cruz, presbítero e doutor da Igreja
+21 canisius : S. Pedro Canísio, presbítero e doutor da Igreja
+23 john_of_kanty : S. João de Quenty (Câncio), presbítero
+26 f R stephen : S. Estêvão, Primeiro Mártir
+27 f john_evangelist : S. João, Apóstolo e Evangelista
+28 f R innocents : Santos Inocentes, mártires
+29 R becket : S. Tomás Becket (de Cantuária), bispo e mártir
+31 sylvester_i : S. Silvestre I, papa

data/lib/calendarium-romanum.rb

@@ -4,6 +4,8 @@
 module CalendariumRomanum
 end
 
+require 'date'
+
 %w(
   version
   i18n_setup
@@ -17,6 +19,7 @@ end
   day
   calendar
   perpetual_calendar
+  temporale/date_helper
   temporale/dates
   temporale/celebration_factory
   temporale/easter_table

data/lib/calendarium-romanum/calendar.rb

@@ -1,4 +1,3 @@
-require 'date'
 require 'forwardable'
 
 module CalendariumRomanum
@@ -17,7 +16,7 @@ module CalendariumRomanum
     # Returns a calendar for the liturgical year beginning with
     # Advent of the specified civil year.
     #
-    # @overload initialize(year, sanctorale = nil, temporale = nil, vespers: false)
+    # @overload initialize(year, sanctorale = nil, temporale = nil, vespers: false, transfers: nil)
     #   @param year [Integer]
     #     Civil year when the liturgical year begins.
     #   @param sanctorale [Sanctorale, nil]
@@ -27,19 +26,22 @@ module CalendariumRomanum
     #     If not provided, +Temporale+ for the given year with default
     #     configuration will built.
     #   @param vespers [Boolean] Set to true if you want the +Calendar+ to populate {Day#vespers}
+    #   @param transfers [#call, nil]
+    #     Object with the same public interface as the +Transfers+ class (really class,
+    #     not instance!), responsible for handling transfers of conflicting solemnities.
+    #     Only useful for overriding the default solemnity transfer logic with a custom one.
     #
-    # @overload initialize(temporale, sanctorale=nil, vespers: false)
+    # @overload initialize(temporale, sanctorale=nil, vespers: false, transfers: nil)
     #   @param temporale [Temporale]
     #   @param sanctorale [Sanctorale, nil]
-    #     If not provided, the +Calendar+ will only know celebrations
-    #     of the temporale cycle, no feasts of the saints!
-    #   @param vespers [Boolean] Set to true if you want the +Calendar+ to populate {Day#vespers}
+    #   @param vespers [Boolean]
+    #   @param transfers [#call, nil]
     #   @since 0.8.0
     #
     # @raise [RangeError]
     #   if +year+ is specified for which the implemented calendar
     #   system wasn't in force
-    def initialize(year, sanctorale = nil, temporale = nil, vespers: false)
+    def initialize(year, sanctorale = nil, temporale = nil, vespers: false, transfers: nil)
       unless year.is_a? Integer
         temporale = year
         year = temporale.year
@@ -58,7 +60,7 @@ module CalendariumRomanum
       @temporale = temporale || Temporale.new(year)
       @populate_vespers = vespers
 
-      @transferred = Transfers.call(@temporale, @sanctorale).freeze
+      @transferred = (transfers || Transfers).call(@temporale, @sanctorale).freeze
     end
 
     class << self
@@ -262,13 +264,13 @@ module CalendariumRomanum
          @temporale.season(date) == Seasons::ORDINARY &&
          (st.empty? || st.first.rank == Ranks::MEMORIAL_OPTIONAL) &&
          t.rank <= Ranks::MEMORIAL_OPTIONAL
-        st = st.dup << Temporale::CelebrationFactory.saturday_memorial_bvm
+        st += [Temporale::CelebrationFactory.saturday_memorial_bvm]
       end
 
       unless st.empty?
         if st.first.rank > t.rank
           if st.first.rank == Ranks::MEMORIAL_OPTIONAL
-            return st.dup.unshift t
+            return [t] + st
           else
             return st
           end
@@ -276,7 +278,7 @@ module CalendariumRomanum
           commemorations = st.collect do |c|
             c.change(rank: Ranks::COMMEMORATION, colour: t.colour)
           end
-          return commemorations.unshift t
+          return [t] + commemorations
         elsif t.symbol == :immaculate_heart &&
               [Ranks::MEMORIAL_GENERAL, Ranks::MEMORIAL_PROPER].include?(st.first.rank)
           optional_memorials = ([t] + st).collect do |celebration|

data/lib/calendarium-romanum/cli.rb

@@ -42,7 +42,7 @@ EOS
       Data.each {|c| puts c.siglum }
     end
 
-    desc 'errors FILE1, ...', 'find errors in sanctorale data files'
+    desc 'errors FILE1 ...', 'find errors in sanctorale data files'
     def errors(*files)
       files.each do |path|
         begin
@@ -53,9 +53,38 @@ EOS
       end
     end
 
-    desc 'cmp FILE1, FILE2', 'detect differences between two sanctorale data files'
+    desc 'cmp FILE1 FILE2', 'detect differences between two sanctorale data files'
+    option :no_rank, type: :boolean, desc: 'ignore differences of rank'
+    option :no_colour, type: :boolean, desc: 'ignore differences of colour'
+    option :no_symbol, type: :boolean, desc: 'ignore differences of symbol'
+    option :title, type: :boolean, desc: 'report differences of title'
     def cmp(a, b)
-      Comparator.new.call(a, b)
+      properties = Comparator::DEFAULT_PROPERTIES
+      options.each_key do |k|
+        if k.start_with? 'no_'
+          properties.delete k.sub('no_', '').to_sym
+        else
+          properties << k.to_sym
+        end
+      end
+      Comparator.new(properties).call(a, b) || exit(1)
+    end
+
+    desc 'merge FILE1 ...', 'loads sanctorale data files on top of each other, prints the resulting sanctorale'
+    option :front_matter, type: :boolean, desc: 'output YAML front matter'
+    def merge(*files)
+      sanctoralia = files.collect {|path| sanctorale_from_path path }
+      merged = SanctoraleFactory.create_layered *sanctoralia
+      SanctoraleWriter.new(front_matter: options[:front_matter]).write merged, STDOUT
+    end
+
+    desc 'id FILE', 'print celebration identifiers found in a sanctorale data file'
+    def id(file)
+      sanctorale_from_path(file).each_day do |_, celebrations|
+        celebrations.each do |c|
+          puts c.symbol if c.symbol
+        end
+      end
     end
 
     desc 'dump YEAR', 'print calendar of the specified year for use in regression tests'

data/lib/calendarium-romanum/cli/comparator.rb

@@ -1,3 +1,5 @@
+require 'set'
+
 module CalendariumRomanum
   class CLI
     # Compares two sanctorale data files, reports differences.
@@ -6,11 +8,23 @@ module CalendariumRomanum
     class Comparator
       include Helper
 
+      SUPPORTED_PROPERTIES = %i(rank colour symbol title)
+      DEFAULT_PROPERTIES = SUPPORTED_PROPERTIES - %i(title)
+
+      def initialize(properties = DEFAULT_PROPERTIES)
+        unless Set.new(properties) <= Set.new(SUPPORTED_PROPERTIES)
+          raise ArgumentError.new("Unsupported properties specified: #{properties} Only #{SUPPORTED_PROPERTIES} are supported")
+        end
+
+        @properties = properties
+      end
+
       def call(path_a, path_b)
         paths = [path_a, path_b]
         sanctoralia = paths.collect {|source| sanctorale_from_path source }
         names = paths.collect {|source| File.basename source }
 
+        differences_found = false
         all_possible_dates.each do |d|
           a, b = sanctoralia.collect {|sanctorale| sanctorale[d] }
 
@@ -20,6 +34,7 @@ module CalendariumRomanum
             compared = [ca, cb]
 
             if compared.index(&:nil?)
+              differences_found = true
               notnili = compared.index {|c| !c.nil? }
 
               print date(d)
@@ -29,11 +44,12 @@ module CalendariumRomanum
               next
             end
 
-            differences = %i(rank colour symbol).select do |property|
+            differences = @properties.select do |property|
               ca.public_send(property) != cb.public_send(property)
             end
 
             next if differences.empty?
+            differences_found = true
             print date(d)
             puts " differs in #{differences.join(', ')}"
             puts celebration(ca)
@@ -41,6 +57,8 @@ module CalendariumRomanum
             puts
           end
         end
+
+        !differences_found
       end
 
       private
@@ -56,7 +74,9 @@ module CalendariumRomanum
       end
 
       def celebration(c)
-        "#{c.rank.priority} #{c.colour.symbol} | #{c.title}"
+        symbol_chunk = c.symbol && "#{c.symbol} | "
+
+        "#{c.rank.priority} #{c.colour.symbol} | #{symbol_chunk}#{c.title}"
       end
     end
   end