zakuro 0.7.2 → 0.8.0

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,8 +19,8 @@ module Zakuro
       class AbstractOperationRange
         # @return [Array<Year>] 年データ（完全範囲）
         attr_reader :years
-        # @return [OperatedSolarTerms] 運用時二十四節気
-        attr_reader :operated_solar_terms
+        # @return [OperatedSolarTerm] 運用時二十四節気
+        attr_reader :operated_solar_term
         # @return [Context::Context] 暦コンテキスト
         attr_reader :context
 
@@ -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/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] 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] 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/operated_solar_term.rb

@@ -0,0 +1,220 @@
+# frozen_string_literal: true
+
+require_relative '../../operation/operation'
+require_relative '../monthly/month'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Calculation
+    # :nodoc:
+    module Range
+      #
+      # OperatedSolarTerm 運用時二十四節気
+      #
+      class OperatedSolarTerm
+        # @return [Array<Year>] 完全範囲（年データ）
+        attr_reader :years
+        # @return [Hash<String, SolarTerm>] 二十四節気の移動元/移動先（西暦日 -> 対応する二十四節気）
+        #
+        # * 移動元の二十四節気：無効な大余小余あり（削除対象）
+        # * 移動先の二十四節気：移動元からの二十四節気（追加対象）
+        #
+        attr_reader :directions
+        # @return [Context::Context] 暦コンテキスト
+        attr_reader :context
+
+        #
+        # 初期化
+        #
+        # @param [Context::Context] context 暦コンテキスト
+        # @param [Array<Year>] years 完全範囲（年データ）
+        #
+        def initialize(context:, years: [])
+          @context = context
+          @years = years
+          @directions = {}
+        end
+
+        #
+        # データ生成する
+        #
+        # @return [<Type>] <description>
+        #
+        def create
+          @directions = create_directions
+        end
+
+        #
+        # 二十四節気を取得する
+        #
+        # @param [Western::Calendar] western_date 月初日の西暦日
+        #
+        # @return [True] 対象あり
+        # @return [False] 対象なし
+        # @return [SolarTerm] 二十四節気
+        #
+        def get(western_date: Western::Calendar.new)
+          context = current_context(western_date: western_date)
+
+          solar_term_class = context.resolver.solar_term
+          solar_term = directions.fetch(western_date.format, solar_term_class.new)
+
+          # 合致しない場合
+          return false, solar_term_class.new if solar_term.empty?
+
+          # 合致した上で、二十四節気が移動元（削除対象）の場合
+          # 合致した上で、二十四節気が移動先（追加対象）の場合
+          [true, solar_term]
+        end
+
+        # :reek:LongParameterList {max_params: 4}
+
+        class << self
+          # :reek:TooManyStatements { max_statements: 6 }
+
+          #
+          # 年内の全ての月の移動方向を作成する
+          #
+          # @param [Context::Context] context 暦コンテキスト
+          # @param [Hash<String, SolarTerm>] directions 二十四節気の移動元/移動先（西暦日 -> 対応する二十四節気）
+          # @param [Array<Month>] months 年内の全ての月
+          #
+          def create_directions_with_months(context:, directions: {}, months: [])
+            months.each do |month|
+              history = Operation.specify_history(western_date: month.western_date)
+
+              next if history.invalid?
+
+              direction = history.diffs.solar_term
+
+              next if direction.invalid?
+
+              create_directions_each_month(
+                context: context, directions: directions, direction: direction, month: month
+              )
+            end
+          end
+
+          #
+          # 月毎の移動方向を作成する
+          #
+          # @param [Context::Context] context 暦コンテキスト
+          # @param [Month] 月
+          # @param [Hash<String, SolarTerm>] directions 二十四節気の移動元/移動先（西暦日 -> 対応する二十四節気）
+          # @param [Operation::SolarTerm::Diretion] 二十四節気（移動）
+          #
+          def create_directions_each_month(context:, month:, directions: {},
+                                           direction: Operation::SolarTerm::Diretion.new)
+
+            month.solar_terms.each do |solar_term|
+              push_source(context: context, directions: directions,
+                          direction: direction, solar_term: solar_term)
+            end
+            push_destination(context: context, directions: directions,
+                             destination: direction.destination)
+          end
+
+          # :reek:LongParameterList {max_params: 4}
+
+          #
+          # 移動先に有効な二十四節気（差し替える二十四節気）を指定する
+          #
+          # @param [Context::Context] context 暦コンテキスト
+          # @param [SolarTerm] solar_term 二十四節気（計算値）
+          # @param [Hash<String, SolarTerm>] directions 二十四節気の移動元/移動先（西暦日 -> 対応する二十四節気）
+          # @param [Operation::SolarTerm::Direction] source 二十四節気（移動）
+          #
+          def push_source(context:, solar_term:, directions: {},
+                          direction: Operation::SolarTerm::Direction.new)
+            source = direction.source
+
+            return if source.invalid?
+
+            return unless source.index == solar_term.index
+
+            # 移動先に移動元の二十四節気を指定する
+            directions[source.to.format] = created_source(
+              context: context, direction: direction, solar_term: solar_term
+            )
+          end
+
+          #
+          # 移動先に有効な二十四節気（差し替える二十四節気）を生成する
+          #
+          # @param [Context::Context] context 暦コンテキスト
+          # @param [SolarTerm] solar_term 二十四節気（計算値）
+          # @param [Operation::SolarTerm::Direction] source 二十四節気（移動）
+          #
+          # @return [SolarTerm] 二十四節気（運用値）
+          #
+          def created_source(context:, solar_term:,
+                             direction: Operation::SolarTerm::Direction.new)
+            operated_solar_term = solar_term.clone
+            remainder_class_name = context.resolver.remainder
+
+            unless direction.invalid_days?
+              # 二十四節気の大余をずらす
+              operated_solar_term.remainder.add!(
+                remainder_class_name.new(day: direction.days, minute: 0, second: 0)
+              )
+            end
+
+            operated_solar_term
+          end
+
+          #
+          # 移動元に無効な二十四節気（連番のみ指定）を指定する
+          #
+          # @param [Context::Context] context 暦コンテキスト
+          # @param [Hash<String, SolarTerm>] directions 二十四節気の移動元/移動先（西暦日 -> 対応する二十四節気）
+          # @param [Operation::SolarTerm::Destination] destination 二十四節気（移動先）
+          #
+          def push_destination(context:, directions: {},
+                               destination: Operation::SolarTerm::Destination.new)
+            return if destination.invalid?
+
+            solar_term_class = context.resolver.solar_term
+            directions[destination.from.format] = solar_term_class.new(
+              index: destination.index
+            )
+          end
+        end
+
+        private
+
+        #
+        # 日付に対応する暦コンテキストを取得する
+        #
+        # @param [Western::Calendar] western_date 西暦日
+        #
+        # @return [Context::Context] 暦コンテキスト
+        #
+        def current_context(western_date: Western::Calendar.new)
+          years.each do |year|
+            return year.context if western_date >= year.new_year_date
+          end
+
+          Context::Context.new
+        end
+
+        #
+        # 二十四節気の移動元/移動先を生成する
+        #
+        # @return [Hash<String, SolarTerm>] 二十四節気の移動元/移動先（西暦日 -> 対応する二十四節気）
+        #
+        def create_directions
+          directions = {}
+
+          years.each do |year|
+            self.class.create_directions_with_months(
+              context: year.context, directions: directions, months: year.months
+            )
+          end
+
+          directions
+        end
+      end
+    end
+  end
+end