version bump -> 0.7.0

CHANGELOG.md

@@ -1,5 +1,46 @@
 # Changelog
 
+## [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

README.md

@@ -5,6 +5,7 @@
 
 API documentation:
 [master](http://www.rubydoc.info/github/igneus/calendarium-romanum/master)
+[0.7.0](http://www.rubydoc.info/gems/calendarium-romanum/0.7.0)
 [0.6.0](http://www.rubydoc.info/gems/calendarium-romanum/0.6.0)
 [0.5.0](http://www.rubydoc.info/gems/calendarium-romanum/0.5.0)
 [0.4.0](http://www.rubydoc.info/gems/calendarium-romanum/0.4.0)

lib/calendarium-romanum/cr.rb

@@ -12,4 +12,5 @@
 #   require 'calendarium-romanum/cr'
 #
 #   calendar = CR::Calendar.new 2000
+# @since 0.7.0
 CR = CalendariumRomanum

lib/calendarium-romanum/data.rb

@@ -28,6 +28,7 @@ def load
       # Load the data file and all it's parents
       #
       # @return [Sanctorale]
+      # @since 0.7.0
       def load_with_parents
         SanctoraleFactory.load_with_parents(path)
       end

lib/calendarium-romanum/day.rb

@@ -34,6 +34,7 @@ def weekday
     # Weekday as internationalized string
     #
     # @return [String]
+    # @since 0.7.0
     def weekday_name
       I18n.t(date.wday, scope: 'weekday')
     end
@@ -87,6 +88,7 @@ def vespers_from_following?
     # Intended mostly for debugging purposes.
     #
     # @return [String]
+    # @since 0.7.0
     def to_s
       celebrations_string = '['
       celebrations.each do |c|
@@ -234,6 +236,7 @@ def change(title: nil, rank: nil, colour: nil, color: nil, symbol: nil, date: ni
     # (not very pretty, intended mostly for development inspections).
     #
     # @return [String]
+    # @since 0.7.0
     def to_s
       "#<#{self.class.name} @title=\"#{title}\" @rank=#{rank} @colour=#{colour} symbol=#{symbol.inspect} date=#{date.inspect} cycle=#{cycle.inspect}>"
     end

lib/calendarium-romanum/sanctorale.rb

@@ -40,6 +40,7 @@ def initialize
     # front matters.
     #
     # @return [Hash, nil]
+    # @since 0.7.0
     attr_accessor :metadata
 
     # Adds a new {Celebration}

lib/calendarium-romanum/sanctorale_factory.rb

@@ -61,6 +61,7 @@ def load_layered_from_files(*paths)
       # result is the same as {SanctoraleLoader#load_from_file}.
       #
       # @return [Sanctorale]
+      # @since 0.7.0
       def load_with_parents(path)
         loader = SanctoraleLoader.new
 

lib/calendarium-romanum/version.rb

@@ -1,7 +1,7 @@
 require 'date'
 
 module CalendariumRomanum
-  VERSION = '0.6.0'.freeze
+  VERSION = '0.7.0'.freeze
 
-  RELEASE_DATE = Date.new(2018, 3, 27).freeze
+  RELEASE_DATE = Date.new(2020, 6, 21).freeze
 end