version bump -> 0.9.0

CHANGELOG.md

@@ -1,5 +1,62 @@
 # Changelog
 
+## [0.9.0] 2021-04-11
+
+### Fixed
+
+- `Transfers` + `Calendar`: on collision of two solemnities of
+  exactly the same rank (e.g. collision of the solemnities of
+  Sacred Heart of Jesus and Birth of St. John the Baptist in 2022)
+  the sanctorale one was scheduled both on the original date and
+  on the transferred date and the temporale solemnity was not
+  scheduled at all
+- liturgical colour of All Souls (has incorrectly been white
+  since the beginning of the project, changed to violet)
+
+### Added
+
+- data: General Roman Calendar in Portuguese + Portuguese locale (by Tomas Monteiro @tmonteiro2344)
+- data: all calendars: new memorial of St. Martha, Mary and Lazarus
+  (replacing memorial of St. Martha alone),
+  new optional memorials of St. Gregory of Narek, St. John De Avila
+  and St. Hildegard of Bingen
+- `SanctoraleWriter.new`: new optional keyword argument `front_matter`
+- `Calendar.new`: new optional keyword argument `transfers`
+  for supplying custom implementation of the solemnity transfer logic
+- `Temporale#provides_celebration?`
+- `Sanctorale#provides_celebration?`, `#by_symbol`, `#merge`
+- CLI: `calendariumrom id` to list celebration symbols included
+  in specified sanctorale data file
+- CLI: `calendariumrom merge` to merge two or more sanctorale data files
+- CLI: `calendariumrom cmp` supports new options `--no-rank`,
+  `--no-colour`, `--no-symbol` for ignoring differences in the specified
+  celebration properties and option `--title` to check for differences
+  in title (ignored by default)
+
+### Changed
+
+- `Temporale::Dates` methods are defined as instance methods and made
+  available as module methods through `extend self` (so far they were
+  defined and only available as module methods)
+- `Temporale::Dates`: helper methods `weekday_before`, `weekday_after`,
+  `octave_of` and their derivatives extracted to a new module
+  `Temporale::DateHelper` (but they are still available on `Temporale::Dates`, too)
+- data: repeated spaces removed from the Latin, Italian and Spanish
+  version of the General Roman Calendar (this does not affect behaviour
+  of calendarium-romanum itself, but may affect some other applications
+  possibly processing the data files directly)
+- `Transfers#call` return value: now it contains not only solemnities
+  transferred (and the destination dates), but also the ones winning
+  the original date, unless they are of the two highest ranks
+- `Transfer#call`: in case of collision of two solemnities of exactly
+  the same rank temporale always wins over sanctorale
+- `Sanctorale#dup` now properly creates for the clone it's own internal
+  data structures independent of the original's ones
+- CLI: `calendariumrom cmp` exits with status 1 if any differences are found
+- CLI: `calendariumrom cmp` prints celebration symbol if available
+- runtime dependencies loosenned: we support `thor` already from version 0.15
+  and `i18n` from version 0.7
+
 ## [0.8.0] 2020-11-25
 
 ### Fixed

README.md

@@ -4,6 +4,7 @@
 [![Gem Version](https://badge.fury.io/rb/calendarium-romanum.svg)](https://badge.fury.io/rb/calendarium-romanum)
 
 API documentation:
+[0.8.0](http://www.rubydoc.info/gems/calendarium-romanum/0.9.0)
 [0.8.0](http://www.rubydoc.info/gems/calendarium-romanum/0.8.0)
 [0.7.1](http://www.rubydoc.info/gems/calendarium-romanum/0.7.1)
 [0.6.0](http://www.rubydoc.info/gems/calendarium-romanum/0.6.0)
@@ -85,13 +86,13 @@ the dependency to a particular minor version.
 In your app's Gemfile
 
 ```
-gem 'calendarium-romanum', '~>0.8.0'
+gem 'calendarium-romanum', '~>0.9.0'
 ```
 
 or in gemspec of your gem
 
 ```
-spec.add_dependency 'calendarium-romanum', '~>0.8.0'
+spec.add_dependency 'calendarium-romanum', '~>0.9.0'
 ```
 
 ## Usage

lib/calendarium-romanum/sanctorale.rb

@@ -153,6 +153,7 @@ def update(other)
     #
     # @param other [Sanctorale]
     # @return [Sanctorale]
+    # @since 0.9.0
     def merge(other)
       dup.tap {|dupped| dupped.update other }
     end
@@ -232,6 +233,7 @@ def ==(b)
     #
     # @param symbol [Symbol]
     # @return [Boolean]
+    # @since 0.9.0
     def provides_celebration?(symbol)
       @symbols.include? symbol
     end
@@ -241,6 +243,7 @@ def provides_celebration?(symbol)
     #
     # @param symbol [Symbol]
     # @return [Array<AbstractDate, Celebration>, nil]
+    # @since 0.9.0
     def by_symbol(symbol)
       return nil unless provides_celebration? symbol
 

lib/calendarium-romanum/temporale.rb

@@ -357,6 +357,7 @@ def ==(b)
     #
     # @param symbol [Symbol]
     # @return [Boolean]
+    # @since 0.9.0
     def provides_celebration?(symbol)
       @all_celebration_symbols.include? symbol
     end

lib/calendarium-romanum/temporale/date_helper.rb

@@ -2,6 +2,8 @@ module CalendariumRomanum
   class Temporale
     # Provides utility methods for date arithmetics, available
     # both as mixin instance methods and module methods.
+    #
+    # @since 0.9.0
     module DateHelper
       extend self
 

lib/calendarium-romanum/version.rb

@@ -1,7 +1,7 @@
 require 'date'
 
 module CalendariumRomanum
-  VERSION = '0.8.0'.freeze
+  VERSION = '0.9.0'.freeze
 
-  RELEASE_DATE = Date.new(2020, 11, 25).freeze
+  RELEASE_DATE = Date.new(2021, 4, 11).freeze
 end