zakuro 0.7.0 → 0.9.0

data/lib/zakuro/calculation/range/abstract_full_range.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require_relative '../../version/context'
+require_relative '../../context/context'
 
 require_relative '../../era/western/calendar'
 require_relative '../../output/logger'
@@ -35,7 +35,7 @@ module Zakuro
       #   * この再計算が必要になるのは、元号が切り替わる年のみである
       #
       class AbstractFullRange
-        # @return [Context] 暦コンテキスト
+        # @return [Context::Context] 暦コンテキスト
         attr_reader :context
         # @return [Western::Calendar] 開始日
         attr_reader :start_date
@@ -50,7 +50,7 @@ module Zakuro
         #
         # 初期化
         #
-        # @param [Context] context 暦コンテキスト
+        # @param [Context::Context] context 暦コンテキスト
         # @param [Gengou::AbstractScroll] scroll 元号スクロール
         # @param [Western::Calendar] start_date 開始日
         # @param [Western::Calendar] last_date 終了日
@@ -61,7 +61,6 @@ module Zakuro
           @last_date = last_date
           return if invalid?
 
-          # TODO: 現時点では使用していない。特定の暦を指定できるようになった状態で使用する
           @context = context
           @scroll = scroll
         end
@@ -73,7 +72,7 @@ module Zakuro
         # @return [False] 有効
         #
         def invalid?
-          @start_date.invalid?
+          start_date.invalid?
         end
 
         #
@@ -101,33 +100,19 @@ module Zakuro
         # @return [Array<Base::Year>] 完全範囲
         #
         def version_ranges
-          result = []
-
-          start_year = @scroll.western_start_year
-          last_year = @scroll.western_last_year
+          start_year = scroll.western_start_year
+          last_year = scroll.western_last_year
 
+          # TODO: context にデフォルト暦名が設定されている場合は使用しない
           versions = Version.get(start_year: start_year, last_year: last_year)
 
-          versions.each_with_index do |version, index|
-            context = Context.new(version_name: version.name)
-            start_year = version.start_year
-            last_year = version.last_year
-            # 最後の暦だけ1年足す（次の元号の開始年まで計算するケースあり）
-            last_year += 1 if (index + 1) == versions.size
-
-            years = boundary_resolved_ranges(
-              context: context, start_year: start_year, last_year: last_year
-            )
-            result.concat(years)
-          end
-
-          result
+          collect_version_ranges(versions: versions, start_year: start_year, last_year: last_year)
         end
 
         #
         # 年境界解決済みの範囲
         #
-        # @param [Context] context 暦コンテキスト
+        # @param [Context::Context] context 暦コンテキスト
         # @param [Integer] start_year 開始西暦年
         # @param [Integer] last_year 終了西暦年
         #
@@ -146,7 +131,7 @@ module Zakuro
         #
         # 完全範囲内の年データを取得する
         #
-        # @param [Context] context 暦コンテキスト
+        # @param [Context::Context] context 暦コンテキスト
         # @param [Integer] start_year 開始西暦年
         # @param [Integer] last_year 終了西暦年
         #
@@ -166,6 +151,36 @@ module Zakuro
 
           years
         end
+
+        #
+        # 暦別範囲を収集する
+        #
+        # @param [Array<Version::Range>] versions 暦の範囲
+        # @param [Integer] start_year 開始西暦年
+        # @param [Integer] last_year 終了西暦年
+        #
+        # @return [Array<Base::Year>] 完全範囲
+        #
+        def collect_version_ranges(versions:, start_year:, last_year:)
+          result = []
+
+          versions.each_with_index do |version, index|
+            specified_context = Context::Context.new(
+              version: version.name, options: context.option.hash
+            )
+            start_year = version.start_year
+            last_year = version.last_year
+            # 最後の暦だけ1年足す（次の元号の開始年まで計算するケースあり）
+            last_year += 1 if (index + 1) == versions.size
+
+            years = boundary_resolved_ranges(
+              context: specified_context, start_year: start_year, last_year: last_year
+            )
+            result.concat(years)
+          end
+
+          result
+        end
       end
     end
   end

data/lib/zakuro/calculation/range/abstract_operation_range.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require_relative './operated_solar_terms'
+require_relative './operated_solar_term'
 require_relative '../../operation/operation'
 require_relative '../base/operated_year'
 require_relative '../../calculation/monthly/operated_month'
@@ -19,15 +19,15 @@ module Zakuro
       class AbstractOperationRange
         # @return [Array<Year>] 年データ（完全範囲）
         attr_reader :years
-        # @return [OperatedSolarTerms] 運用時二十四節気
-        attr_reader :operated_solar_terms
-        # @return [Context] 暦コンテキスト
+        # @return [OperatedSolarTerm] 運用時二十四節気
+        attr_reader :operated_solar_term
+        # @return [Context::Context] 暦コンテキスト
         attr_reader :context
 
         #
         # 初期化
         #
-        # @param [Context] context 暦コンテキスト
+        # @param [Context::Context] context 暦コンテキスト
         # @param [Gengou::AbstractScroll] scroll 元号スクロール
         # @param [Array<Year>] years 年データ（完全範囲）
         #
@@ -35,8 +35,8 @@ module Zakuro
           @context = context
           @years = years
           @scroll = scroll
-          @operated_solar_terms = OperatedSolarTerms.new(context: context, years: @years)
-          @operated_solar_terms.create
+          @operated_solar_term = OperatedSolarTerm.new(context: context, years: @years)
+          operated_solar_term.create
         end
 
         #
@@ -47,9 +47,9 @@ module Zakuro
         def get
           operated_years = rewrite
 
-          AbstractOperationRange.move(operated_years: operated_years)
+          self.class.move(operated_years: operated_years)
 
-          AbstractOperationRange.commit(operated_years: operated_years)
+          self.class.commit(operated_years: operated_years)
 
           Transfer::GengouScroller.set(scroll: @scroll, years: operated_years)
 
@@ -65,9 +65,9 @@ module Zakuro
           operated_years = []
 
           years.each do |year|
-            operated_year = AbstractOperationRange.rewrite_year(
+            operated_year = self.class.rewrite_year(
               year: year,
-              operated_solar_terms: @operated_solar_terms
+              operated_solar_term: operated_solar_term
             )
             operated_years.push(operated_year)
           end
@@ -75,115 +75,117 @@ module Zakuro
           operated_years
         end
 
-        #
-        # 運用情報で年を跨ぐ月をその年に寄せる
-        #
-        # @param [Array<OperatedYear>] operated_years 運用結果範囲
-        #
-        def self.move(operated_years:)
-          move_into_next_year(operated_years: operated_years)
-          move_into_last_year(operated_years: operated_years)
-        end
-
-        #
-        # 運用情報では来年に属する月を来年に寄せる
-        #
-        # @param [Array<OperatedYear>] operated_years 運用結果範囲
-        #
-        def self.move_into_next_year(operated_years:)
-          operated_years.each_cons(2) do |current_year, next_year|
-            months = current_year.pop_next_year_months
-
-            next_year.unshift_months(months)
+        class << self
+          #
+          # 運用情報で年を跨ぐ月をその年に寄せる
+          #
+          # @param [Array<OperatedYear>] operated_years 運用結果範囲
+          #
+          def move(operated_years:)
+            move_into_next_year(operated_years: operated_years)
+            move_into_last_year(operated_years: operated_years)
           end
-        end
 
-        #
-        # 運用情報では昨年に属する月を昨年に寄せる
-        #
-        # @param [Array<OperatedYear>] operated_years 運用結果範囲
-        #
-        def self.move_into_last_year(operated_years:)
-          rerversed_year = operated_years.reverse!
-          rerversed_year.each_cons(2) do |current_year, last_year|
-            months = current_year.shift_last_year_months
-            last_year.push_months(months)
+          #
+          # 運用情報では来年に属する月を来年に寄せる
+          #
+          # @param [Array<OperatedYear>] operated_years 運用結果範囲
+          #
+          def move_into_next_year(operated_years:)
+            operated_years.each_cons(2) do |current_year, next_year|
+              months = current_year.pop_next_year_months
+
+              next_year.unshift_months(months)
+            end
           end
 
-          rerversed_year.reverse!
-        end
-
-        #
-        # 年を確定させる
-        #
-        # @param [Array<OperatedYear>] operated_years 運用結果範囲
-        #
-        def self.commit(operated_years:)
-          operated_years.each(&:commit)
-        end
-
-        #
-        # 年を書き換える
-        #
-        # @param [Year] year 年
-        # @param [OperatedSolarTerms] operated_solar_terms 運用時二十四節気
-        #
-        # @return [OperatedYear] 年
-        #
-        def self.rewrite_year(year:, operated_solar_terms:)
-          context = year.context
-          result = Base::OperatedYear.new(context: context)
-          year.months.each do |month|
-            result.push(month: resolve_month(
-              context: context, month: month,
-              operated_solar_terms: operated_solar_terms
-            ))
+          #
+          # 運用情報では昨年に属する月を昨年に寄せる
+          #
+          # @param [Array<OperatedYear>] operated_years 運用結果範囲
+          #
+          def move_into_last_year(operated_years:)
+            rerversed_year = operated_years.reverse!
+            rerversed_year.each_cons(2) do |current_year, last_year|
+              months = current_year.shift_last_year_months
+              last_year.push_months(months)
+            end
+
+            rerversed_year.reverse!
           end
 
-          result
-        end
-
-        #
-        # 履歴情報の有無に応じた月にする
-        #
-        # @param [Context] context 暦コンテキスト
-        # @param [Month] month 月
-        # @param [OperatedSolarTerms] operated_solar_terms 運用時二十四節気
-        #
-        # @return [Month] 月
-        #
-        def self.resolve_month(context:, month:, operated_solar_terms:)
-          history = Operation.specify_history(western_date: month.western_date)
+          #
+          # 年を確定させる
+          #
+          # @param [Array<OperatedYear>] operated_years 運用結果範囲
+          #
+          def commit(operated_years:)
+            operated_years.each(&:commit)
+          end
 
-          AbstractOperationRange.rewrite_month(
-            context: context, month: month, history: history,
-            operated_solar_terms: operated_solar_terms
-          )
-        end
+          #
+          # 年を書き換える
+          #
+          # @param [Year] year 年
+          # @param [OperatedSolarTerm] operated_solar_term 運用時二十四節気
+          #
+          # @return [OperatedYear] 年
+          #
+          def rewrite_year(year:, operated_solar_term:)
+            context = year.context
+            result = Base::OperatedYear.new(context: context)
+            year.months.each do |month|
+              result.push(month: resolve_month(
+                context: context, month: month,
+                operated_solar_term: operated_solar_term
+              ))
+            end
+
+            result
+          end
 
-        # :reek:LongParameterList {max_params: 4}
+          #
+          # 履歴情報の有無に応じた月にする
+          #
+          # @param [Context] context 暦コンテキスト
+          # @param [Month] month 月
+          # @param [OperatedSolarTerm] operated_solar_term 運用時二十四節気
+          #
+          # @return [Month] 月
+          #
+          def resolve_month(context:, month:, operated_solar_term:)
+            history = Operation.specify_history(western_date: month.western_date)
+
+            rewrite_month(
+              context: context, month: month, history: history,
+              operated_solar_term: operated_solar_term
+            )
+          end
 
-        #
-        # 月を運用結果に書き換える
-        #
-        # @param [Context] context 暦コンテキスト
-        # @param [Month] month 月
-        # @param [Operation::MonthHistory] history 変更履歴
-        # @param [OperatedSolarTerms] operated_solar_terms 運用時二十四節気
-        #
-        # @return [Month] 月（運用結果）
-        #
-        def self.rewrite_month(context:, month:, history:, operated_solar_terms:)
-          operated_month = Monthly::OperatedMonth.new(
-            context: context,
-            month_label: month.month_label, first_day: month.first_day,
-            solar_terms: month.solar_terms, history: history, gengou: month.gengou,
-            operated_solar_terms: operated_solar_terms
-          )
+          # :reek:LongParameterList {max_params: 4}
+
+          #
+          # 月を運用結果に書き換える
+          #
+          # @param [Context] context 暦コンテキスト
+          # @param [Month] month 月
+          # @param [Operation::MonthHistory] history 変更履歴
+          # @param [OperatedSolarTerm] operated_solar_term 運用時二十四節気
+          #
+          # @return [Month] 月（運用結果）
+          #
+          def rewrite_month(context:, month:, history:, operated_solar_term:)
+            operated_month = Monthly::OperatedMonth.new(
+              context: context,
+              month_label: month.month_label, first_day: month.first_day,
+              solar_terms: month.solar_terms, history: history, gengou: month.gengou,
+              operated_solar_term: operated_solar_term
+            )
 
-          operated_month.rewrite unless history.invalid?
+            operated_month.rewrite unless history.invalid?
 
-          operated_month
+            operated_month
+          end
         end
       end
     end

data/lib/zakuro/calculation/range/dated_full_range.rb

@@ -16,7 +16,7 @@ module Zakuro
         #
         # 初期化
         #
-        # @param [Context] context 暦コンテキスト
+        # @param [Context::Context] context 暦コンテキスト
         # @param [Western::Calendar] start_date 開始日
         # @param [Western::Calendar] last_date 終了日
         #

data/lib/zakuro/calculation/range/dated_operation_range.rb

@@ -17,7 +17,7 @@ module Zakuro
         #
         # 初期化
         #
-        # @param [Context] context 暦コンテキスト
+        # @param [Context::Context] context 暦コンテキスト
         # @param [Western::Calendar] start_date 開始日
         # @param [Western::Calendar] last_date 終了日
         # @param [Array<Year>] years 年データ（完全範囲）

data/lib/zakuro/calculation/range/medieval_annual_range.rb

@@ -23,82 +23,83 @@ module Zakuro
         # @return [Output::Logger] ロガー
         LOGGER = Output::Logger.new(location: 'medieval_annual_range')
 
-        #
-        # 一覧取得する
-        #
-        #   * 対象年に対して、前年11月-当年11月までを出力する
-        #   * 対象年（西暦）と計算年（元号x年）の紐付けは行わない
-        #
-        # @param [Context] context 暦コンテキスト
-        # @param [Monthly::AbstractLunarPhase] lunar_phase 月の位相
-        # @param [Solar::AbstractAverage] solar_average 定気（太陽軌道平均）
-        #
-        # @return [Array<Month>] 1年データ
-        #
-        def self.get(context:, lunar_phase:, solar_average:)
-          annual_range = initialized_annual_range(context: context, lunar_phase: lunar_phase)
+        class << self
+          #
+          # 一覧取得する
+          #
+          #   * 対象年に対して、前年11月-当年11月までを出力する
+          #   * 対象年（西暦）と計算年（元号x年）の紐付けは行わない
+          #
+          # @param [Context::Context] context 暦コンテキスト
+          # @param [Monthly::AbstractLunarPhase] lunar_phase 月の位相
+          # @param [Solar::AbstractAverage] solar_average 定気（太陽軌道平均）
+          #
+          # @return [Array<Month>] 1年データ
+          #
+          def get(context:, lunar_phase:, solar_average:)
+            annual_range = initialized_annual_range(context: context, lunar_phase: lunar_phase)
 
-          apply_big_and_small_of_the_month(annual_range: annual_range)
+            apply_big_and_small_of_the_month(annual_range: annual_range)
 
-          solar_average.set(annual_range: annual_range)
+            solar_average.set(annual_range: annual_range)
 
-          # 月間隔を取得するためだけの末尾要素を削除
-          annual_range.pop
+            # 月間隔を取得するためだけの末尾要素を削除
+            annual_range.pop
 
-          initialize_month_label(annual_range: annual_range)
-        end
+            initialize_month_label(annual_range: annual_range)
+          end
 
-        #
-        # 1年データを取得する
-        #
-        # @param [Context] context 暦コンテキスト
-        # @param [Monthly::LunarPhase] lunar_phase 月の位相
-        #
-        # @return [Array<Month>] 1年データ
-        #
-        def self.initialized_annual_range(context:, lunar_phase:)
-          result = []
+          private
 
-          # 14ヶ月分を生成する（閏年で最大13ヶ月 + 末月の大小/二十四節気を求めるために必要な月）
-          (0..13).each do |_index|
-            adjusted = lunar_phase.next_month
+          #
+          # 1年データを取得する
+          #
+          # @param [Context::Context] context 暦コンテキスト
+          # @param [Monthly::LunarPhase] lunar_phase 月の位相
+          #
+          # @return [Array<Month>] 1年データ
+          #
+          def initialized_annual_range(context:, lunar_phase:)
+            result = []
 
-            result.push(
-              Monthly::InitializedMonth.new(
-                context: context,
-                month_label: Monthly::MonthLabel.new,
-                first_day: Monthly::FirstDay.new(remainder: adjusted),
-                phase_index: 0
+            # 14ヶ月分を生成する（閏年で最大13ヶ月 + 末月の大小/二十四節気を求めるために必要な月）
+            (0..13).each do |_index|
+              adjusted = lunar_phase.next_month
+
+              result.push(
+                Monthly::InitializedMonth.new(
+                  context: context,
+                  month_label: Monthly::MonthLabel.new,
+                  first_day: Monthly::FirstDay.new(remainder: adjusted),
+                  phase_index: 0
+                )
               )
-            )
-          end
+            end
 
-          result
-        end
-        private_class_method :initialized_annual_range
+            result
+          end
 
-        #
-        # 1年データの各月に月の大小を設定する
-        #
-        # @param [Array<Month>] annual_range 1年データ
-        #
-        def self.apply_big_and_small_of_the_month(annual_range:)
-          # NOTE: 最後の月は処理できない（=計算外の余分な月が最後に必要である）
-          annual_range.each_cons(2) do |(current_month, next_month)|
-            current_month.eval_many_days(next_month_day: next_month.remainder.day)
+          #
+          # 1年データの各月に月の大小を設定する
+          #
+          # @param [Array<Month>] annual_range 1年データ
+          #
+          def apply_big_and_small_of_the_month(annual_range:)
+            # NOTE: 最後の月は処理できない（=計算外の余分な月が最後に必要である）
+            annual_range.each_cons(2) do |(current_month, next_month)|
+              current_month.eval_many_days(next_month_day: next_month.remainder.day)
+            end
           end
-        end
-        private_class_method :apply_big_and_small_of_the_month
 
-        #
-        # 月表示情報を更新する
-        #
-        # @param [Array<Month>] annual_range 1年データ
-        #
-        def self.initialize_month_label(annual_range:)
-          annual_range.each(&:rename_month_label_by_solar_term)
+          #
+          # 月表示情報を更新する
+          #
+          # @param [Array<Month>] annual_range 1年データ
+          #
+          def initialize_month_label(annual_range:)
+            annual_range.each(&:rename_month_label_by_solar_term)
+          end
         end
-        private_class_method :initialize_month_label
       end
     end
   end

data/lib/zakuro/calculation/range/named_full_range.rb

@@ -19,7 +19,7 @@ module Zakuro
         #
         # 初期化
         #
-        # @param [Context] context 暦コンテキスト
+        # @param [Context::Context] context 暦コンテキスト
         # @param [String] start_name 開始元号名
         # @param [String] last_name 終了元号名
         #

data/lib/zakuro/calculation/range/named_operation_range.rb

@@ -20,7 +20,7 @@ module Zakuro
         #
         # 初期化
         #
-        # @param [Context] context 暦コンテキスト
+        # @param [Context::Context] context 暦コンテキスト
         # @param [String] start_name 開始元号名
         # @param [String] last_name 終了元号名
         # @param [Array<Year>] years 年データ（完全範囲）