calendarium-romanum 0.7.0 → 0.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 59b33d4daab8a2f9c7a7da74eec8ef43ce0d25a46ab4534dafa7f3c9d37b0d4c
-  data.tar.gz: 251aa299e6e32ff7eb839df52bc06538426162947b7292b867fbf2c4b0f80494
+  metadata.gz: cee5ab4345ad34eb849b0024a9d3489b29ebe55e8e960abd44ff858d911fdb32
+  data.tar.gz: e93e85c1e668d5d57a10e0846bdb0ae37e693ac125b3c9d3b09f3dac3d5d806f
 SHA512:
-  metadata.gz: e484244f48349457b63bd7ad473388a145ab4cf0b4282b1e8702f1ef2a120e8ef75364b2873e29685f91ed1aee2478fd136d0be1fc6427e7887096657f0a740b
-  data.tar.gz: e3bfd741231d609890f94d97882668eb42812c91413791c047e2f4f307c31f1187315d787d50367db011619297f5d4879186651a87b4ecd2652f85963cbdd254
+  metadata.gz: c6a4f20a4ccbb564ee51dcb24e7d354b5a9ed9495951b239ca653631fb08c48d2121989279cc3d9e93e0236721545fc62518c09b9ce8cdbd9e40ca89bff7786f
+  data.tar.gz: ab95329b242615cb3c81bcb31b171c2ba66ffa3e8e544dc1f33721d2e6e4d6e7e0cee68d429e4ff46ce34a550d6be9af969c5ee919da54f1890141f719900d4a

data/.gitignore

@@ -0,0 +1,4 @@
+*~
+.rvmrc
+*.gem
+coverage/

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/.rubocop.yml

@@ -0,0 +1,47 @@
+Metrics/LineLength:
+  Max: 100
+
+Style/EmptyLinesAroundClassBody:
+  Enabled: false
+
+Style/EmptyLinesAroundModuleBody:
+  Enabled: false
+
+Style/FrozenStringLiteralComment:
+  Enabled: false
+
+Style/IfUnlessModifier:
+  Enabled: false
+
+Style/Lambda:
+  Enabled: false
+
+Style/LambdaCall:
+  Enabled: false
+
+Style/NumericPredicate:
+  Enabled: false
+
+Style/PreferredHashMethods:
+  Enabled: false
+
+Style/RaiseArgs:
+  Enabled: false
+
+Style/RedundantException:
+  Enabled: false
+
+Style/SpaceInsideBlockBraces:
+  SpaceBeforeBlockParameters: false
+
+Style/SpaceInsideHashLiteralBraces:
+  EnforcedStyle: no_space
+
+Style/SpaceInsideRangeLiteral:
+  Enabled: false
+
+Style/TrailingCommaInLiteral:
+  Enabled: false
+
+Style/ZeroLengthPredicate:
+  Enabled: false

data/.travis.yml

@@ -0,0 +1,20 @@
+language: ruby
+
+dist: trusty
+
+rvm:
+  - 2.0.0 # oldest MRI we support
+  - 2.5.0 # oldest officially maintained MRI
+  - 2.6.5 # ~ latest MRI
+  #- jruby-9.1.12.0
+
+install: bundle install --jobs=3 --deployment --without development
+
+script: bundle exec rake spec_all_locales && bash spec/build/gem_build_test.sh
+
+git:
+  depth: 3
+
+#matrix:
+#  allow_failures:
+#    - rvm: jruby-9.1.12.0

data/.yardopts

@@ -0,0 +1,3 @@
+--main doc/yard_readme.rdoc
+--asset doc/images:images
+--file README.md,doc/data_readme.md,data/universal-en.txt

data/CHANGELOG.md

@@ -0,0 +1,340 @@
+# Changelog
+
+## [0.7.1] 2020-06-28
+
+### Fixed
+
+- `SanctoraleFactory.load_with_parents` crashing on files without
+  metadata
+- `Sanctorale#update` prohibiting application of a particular
+  calendar which moves s celebration contained in the calendar being
+  updated to an earlier date
+  (as exemplified by the bundled calendar of diocese of Litoměřice,
+  Czech Republic: on calendarium-romanum 0.7.0
+  `CalendariumRomanum::Data['czech-litomerice-cs'].load_with_parents`
+  raises `ArgumentError` complaining about non-unique celebration symbols)
+- broken links in YARD documentation (due to files missing in the
+  gem archive and basename clashes)
+
+### Changed
+
+- if `Sanctorale#update` raises `ArgumentError` complaining about
+  non-unique celebration symbols, the updated `Sanctorale` instance
+  is left in an inconsistent internal state (more than one occurrence
+  of at least one celebration symbol)
+- some additional non-code files (mostly for YARD documentation)
+  included in the gem archive
+
+## [0.7.0] 2020-06-21
+
+### Fixed
+
+- St. Sebastian was missing in the French version of General Roman Calendar
+- St. of Pietrelcina had incorrect rank in the Czech calendar
+- `Sanctorale#add`: invalid attempt (i.e. an attempt raising an exception)
+  to add a second (or n-th) celebration for a given date was causing
+  inconsistency in the instance's internal state
+- CLI: `calendariumrom query` wasn't printing celebrations of the highest
+  ranks (spotted and fixed by Mike Kasberg @mkasberg)
+- CLI: got rid of a deprecation warning of the `i18n` gem
+  concerning `I18n.enforce_available_locales` (by Mike Kasberg @mkasberg)
+
+### Added
+
+- data: General Roman Calendar in Spanish + Spanish locale (by Alejandro Ulate @CodingAleCR)
+- data: optional memorials of St. Paul VI, Our Lady of Loreto, St. Faustina Kowalska
+- data: diocese of Prague: optional memorial of Bl. Friedrich Bachstein and companions
+- `Day#weekday_name` (by Ronald Walker @RonWalker22)
+- `Day#to_s`, `Celebration#to_s` (by PJ Pollina @pjpollina)
+- all sanctorale data files are provided with celebration symbols (available as
+  `Celebration#symbol` when loaded)
+- `SanctoraleLoader` loads the YAML front matter (if provided),
+  to `Sanctorale#metadata` (new property added for this purpose)
+- `SanctoraleFactory` methods merge not only sanctorale contents,
+  but also metadata
+- `SanctoraleFactory.load_with_parents`, `Data#load_with_parents`
+  to conveniently load sanctorale file hierarchies based on their
+  metadata (using key `"extends"`)
+- `calendarium-romanum/cr` defining `::CR` shortcut constant
+- huge improvement of the API documentation
+
+### Changed
+
+- data files format: celebration symbols never more start with a colon
+- `Sanctorale#add` throws `ArgumentError` on attempt to add a `Celebration`
+  with `#symbol` which is already present in the given sanctorale
+- all `#each` and `#each_*` methods defined in the gem return `Enumerator`
+  if called without a block
+
+## [0.6.0] 2018-03-27
+
+### Fixed
+
+*Feature release - bugs were only introduced, not fixed :)*
+
+### Added
+
+- now handled: *Saturday Memorial of the Blessed Virgin Mary*
+- new memorial of *Mary, Mother of the Church*
+  (both handled by `Temporale`)
+- `Temporale#==`, `Sanctorale#==`
+- `Calendar#populates_vespers?` (access value of an option)
+- `Temporale#[]`, `Sanctorale#[]`, `PerpetualCalendar#[]`
+- `Celebration#date` - only set for fixed-date celebrations,
+  contains the celebration's *usual* date (as `AbstractDate` instance),
+  thus making it possible
+  to check if a solemnity was transferred and what would be
+  it's normal date if the transfer didn't occur
+- `Celebration#cycle` - returns either `:temporale` or `:sanctorale`
+- cycle predicates:
+  `Celebration#temporale?` and `#sanctorale?`
+- `Calendar#each` - yields each day of the liturgical year
+- missing rank predicates:
+  `Rank#ferial?`, `Rank#sunday?`,
+  `Celebration#ferial?`, `Celebration#sunday?`
+- `Celebration#symbol` can be specified also in sanctorale data files
+  (but data files with symbols are not yet available)
+- CLI: `calendariumrom version` prints gem version
+
+### Changed
+
+- `Calendar#==` used to compare only class and year, now it compares
+  complete internal data
+- `Colour#to_s` and `Season#to_s` now return meaningful values
+  like `"#<CalendariumRomanum::Colour red>"`
+  and `"#<CalendariumRomanum::Season lent>"`;
+  return value of `Rank#to_s` changed to match the common format
+- English temporale feast names edited to match the standard US
+  liturgical books (by Mike Kasberg @mkasberg)
+- `examples/` directory removed (README is now the main source
+  of copy-pastable examples)
+- file naming unified: `calendarium-romanum/sanctoraleloader.rb`
+  renamed to `.../sanctorale_loader.rb`
+
+## [0.5.0] 2017-11-01
+
+### Fixed
+
+- transfer of Epiphany to a Sunday was breaking numbering of weeks
+  of the Ordinary Time
+- `Day.new()` (call without any arguments) was crashing
+- shebang of `calendariumrom`
+- CLI: `calendariumrom query` was printing internal representation
+  of a `Season` object instead of human-readable season name
+  (spotted and fixed by Simon Szutkowski @simonszu)
+- MRI 2.x interpreter warnings
+
+### Added
+
+- first Vespers of Sundays and solemnities: optional feature
+  of the `Calendar` (constructor has new keyword argument
+  `vespers: true` to activate it), populates `Day#vespers`
+  with a `Celebration` if Vespers should be taken from the following
+  day
+- proper handling of collision between *Immaculate heart of Mary*
+  and another obligatory memorial ([CDW Prot. n. 2671/98/L](http://www.vatican.va/roman_curia/congregations/ccdds/documents/rc_con_ccdds_doc_20000630_memoria-immaculati-cordis-mariae-virginis_lt.html))
+- `Calendar#[]` - alias of `Calendar#day`, but with additional
+  support for a `Range` of `Date`s (returns an `Array` of `Dates`
+  when called this way;
+  by Brian Gates @bgates)
+- `Celebration#change(title: nil, rank: nil, colour: nil, color: nil, symbol: nil)` -
+  returns a copy of the celebration with values of selected
+  properties replaced by those passed as arguments
+- `Celebration#symbol` - machine-readable unique identifier
+  of a celebration, for now only for solemnities of the temporale
+- CLI: `calendariumrom query` supports printing a day, month or year
+  (by Simon Szutkowski @simonszu)
+- CLI: `calendariumrom query` supports apart of bundled calendars
+  also custom ones, specified on the command line
+  (by Simon Szutkowski @simonszu)
+- CLI: `calendariumrom cmp` correctly handles celebrations
+  present in only one of the compared sources
+- data: memorials of saint popes John XXIII and John Paul II added
+  to Universal Roman calendar in Latin and to the calendar
+  of Czech and Moravian dioceses where they were missing
+
+### Changed
+
+- ferials of the final week of Advent have proper titles
+- ordinals in French names of Sundays and ferials have proper
+  suffixes
+- `Day.new` signature changed from argument Hash
+  to Ruby 2 keyword arguments (no change in argument names
+  or count, but previously it wouldn't even notice unexpected
+  arguments, now it will crash when encountering them)
+- `SanctoraleLoader` raises always `InvalidDataError`
+  (it used to raise `RangeError` on invalid date and
+  `RuntimeError` on other kinds of invalid data)
+- `CelebrationFactory` creates also temporale solemnities
+  (useful mostly in specs)
+- CLI: `calendariumrom errors` fails gracefully, without backtrace
+
+## [0.4.0] 2017-09-02
+
+### Fixed
+
+- `Sanctorale#replace` saving the supplied array as part of
+  the internal data structures (and thus allowing their -
+  usually unintentional - modification by external code)
+- `Calendar` unintentionally modifying `Sanctorale` internal data
+  when handling optional memorials
+- errors in English ordinals greater than 10 ("21th" -> "21st" etc.)
+- `Ranks::FERIAL.memorial?` wrongly returning `true`
+- rank of *All Souls* fixed in all data files
+
+### Added
+
+- support for transfer of Epiphany, Ascension and Corpus Christi
+  to a Sunday (GNLYC 7)
+- General Roman Calendar in French and French localization
+  (by Azarias Boutin @AzariasB)
+- `PerpetualCalendar`
+- `Season#name`, `Colour#name` - localized human-readable names
+
+### Changed
+
+- interface for `Temporale` extensions changed completely:
+  extensions are self-contained, isolated; their sole responsibility
+  is to yield data
+- `Calendar` stripped of the ability to create new instances
+  with the same settings:
+  - `Calendar#pred` and `#succ` removed
+  - `Calendar.new` receives `Temporale` *instance*
+    (instead of a temporale factory)
+- `Calendar#day` raises `RangeError` if the day is earlier than
+  1st January 1970 (day of introduction of the implemented calendar
+  system)
+- `Temporale::Dates.easter_sunday` doesn't return Julian calendar
+  Easter date for years <= 1752 (this library isn't intended to be used
+  for years earlier than 1970)
+- `Day#==` and `Calendar#==` test object contents, not identity
+- `Temporale::Dates.body_blood` renamed to `.corpus_christi`
+- `Sanctorale#freeze` freezes also the internal data structures
+- `Calendar#freeze` freezes contained `Temporale` and `Sanctorale`
+- seasons and colours indexed by their symbols, not by index number -
+  e.g. `Seasons[:lent]`, `Colours[:violet]`
+- `Calendar#celebrations_for` made private
+
+## [0.3.0] 2017-08-07
+
+### Fixed
+
+*This is a feature release - bugs were only introduced, not fixed :)*
+
+### Added
+
+- `Celebration#title` is now being generated for all Sundays and
+  ferials (was empty)
+- ferials of the Holy Week and of the last week of Advent
+  have proper ranks
+- new rank `Ranks::COMMEMORATION` introduced;
+  during privileged seasons, suppressed memorials, which
+  can be commemorated in the Divine Office (see GILH 239),
+  appear in `Day#celebrations` with this rank
+- memorial of the *Immaculate Heart of Mary*
+  (although it really belongs to the sanctorale, as a movable feast
+  it is implemented in `Temporale`)
+- support for extending `Temporale` with additional feasts
+  (`Temporale.with_extensions`, `Temporale.add_celebration`,
+  additional optional argument accepted by `Calendar.new` and
+  `Calendar.for_date`)
+- `Temporale::Extensions::ChristEternalPriest` - `Temporale` extension
+  implementing the feast of *Christ the Eternal Priest*,
+  celebrated in some dioceses and religious institutes
+  on Thursday after Pentecost
+- `Temporale::Dates` - module containing all the
+  temporale-solemnity-date-computing algorithms used in `Temporale`
+- `Temporale#year`
+- sanctorale data files may have YAML front matter
+  (a YAML document with metadata placed before the main content)
+
+### Changed
+
+- seasons and colours are represented by `Season` and `Colour`
+  instances, not by `Symbol`s
+- `Temporale#advent_sunday` and most `#*_advent_sunday`
+  removed, only `Temporale#first_advent_sunday` remains
+- `Temporale#weekday_before`, `#weekday_after`, `#octave_of`,
+  `#monday_before` etc., `#monday_after` etc. removed
+  (all these general date helpers now reside in `Temporale::Dates`)
+- unused attribute `Day#vespers` removed
+- `Temporale#concretize_abstract_date` removed
+
+## [0.2.1] 2017-07-21
+
+### Fixed
+
+- `AbstractDate` validity checks refusing 29th February
+
+## [0.2.0] 2017-07-20
+
+### Fixed
+
+- numbering of Ordinary Time Sundays after Pentecost
+- `Calendar#day` when an instance of `DateTime` is supplied as argument
+- minor fixes in data files
+- `calendariumrom` executable (broken in recent releases)
+
+### Added
+
+- missing *temporale* feast days: Ash Wednesday, Palm Sunday, Ascension,
+- new bundled locales: Latin, Italian, Czech
+- contents of `Seasons`, `Ranks` and `Colours` can be explored via `each` and `all`
+- bundled data files easily accessible through `CalendariumRomanum::Data`
+
+### Changed
+
+- `Rank` never more inherits from `Struct`
+- `Seasons`, `Ranks` and `Colours` changed from modules to classes
+- `Sanctorale` raises `ArgumentError` on attempt to load two celebrations of rank other than optional memorial on a single day
+- data file format: rank letter is optional when the rank is specified by number
+- data file format: rank and colour letters are treated case-insensitively
+
+## [0.1.0] 2017-02-25
+
+### Fixed
+- computing date of Holy Family when there is no Sunday between December 25th and January 1st (by Eddy Mulyono @eddymul)
+- missing information for some celebrations added to the General Roman Calendar in English (by Andrea Ferrato @ferra-andre)
+
+### Added
+- General Roman Calendar in Italian (by Andrea Ferrato @ferra-andre)
+- `CalendariumRomanum::SanctoraleFactory` for loading of layered sanctorale calendars
+- `Rank#short_desc` value for unprivileged Sunday and privileged ferial
+- Temporale feast titles and some other strings can be translated (gem `i18n` used)
+
+### Changed
+- [breaking change] `SanctoraleLoader#load` argument order changed
+
+## [0.0.3] 2016-08-27
+
+### Fixed
+- fatal constant reference bug in `Temporale`
+- the specs that covered it
+
+## [0.0.2] 2016-08-27 YANKED
+
+release yanked, as it contained a fatal bug in `Temporale`,
+resulting in `NameError` being raised on each initialization
+
+### Fixed
+- all celebrations handled by `Temporale` purged from the sanctorale
+  data files. Note that having temporale *solemnities* in sanctorale
+  data results in these being duplicated due to the transfer of
+  impeded solemnities.
+- rank of Mary Magdalene updated in the sanctorale data files
+- rank of the feast of the Holy Family fixed
+
+### Changed
+- solemnity of Mary, Mother of God (January 1st) is handled by
+  `Temporale`
+
+## [0.0.1] 2016-08-20
+
+### Added
+- transfer of impeded solemnities
+
+### Changed
+- sanctorale data must be loaded before `Calendar` initialization
+- `Calendar#sanctorale` is read-only
+- dropped `Calendar.day`, `Sanctorale#validate_date`
+- `SanctoraleLoader` raises exceptions on errors (instead of writing invalid entries to a log and skipping them)

data/Gemfile

@@ -0,0 +1,25 @@
+source 'https://rubygems.org'
+
+gem 'thor'
+gem 'i18n'
+gem 'roman-numerals'
+
+group :development, :test do
+  gem 'rake'
+end
+
+group :development do
+  gem 'rubocop'
+  gem 'yard'
+end
+
+group :test do
+  gem 'rspec'
+  gem 'aruba'
+  # We don't use cucumber, but it is required by aruba
+  # and cucumber >= 3.0.0 requires ruby >= 2.1,
+  # but we want the tests to pass on ruby 2.0 as earliest target
+  gem 'cucumber', '~> 2.99'
+  gem 'simplecov'
+  gem 'backports', '~> 3.18'
+end