zakuro 0.6.1 → 0.8.0

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

@@ -0,0 +1,193 @@
+# frozen_string_literal: true
+
+require_relative './operated_solar_term'
+require_relative '../../operation/operation'
+require_relative '../base/operated_year'
+require_relative '../../calculation/monthly/operated_month'
+require_relative './transfer/gengou_scroller'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Calculation
+    # :nodoc:
+    module Range
+      #
+      # AbstractOperationRange 運用結果範囲
+      #
+      # 何らかの理由により、計算された暦とは異なる運用結果である場合、その結果に合わせて計算結果を上書きする
+      class AbstractOperationRange
+        # @return [Array<Year>] 年データ（完全範囲）
+        attr_reader :years
+        # @return [OperatedSolarTerm] 運用時二十四節気
+        attr_reader :operated_solar_term
+        # @return [Context::Context] 暦コンテキスト
+        attr_reader :context
+
+        #
+        # 初期化
+        #
+        # @param [Context::Context] context 暦コンテキスト
+        # @param [Gengou::AbstractScroll] scroll 元号スクロール
+        # @param [Array<Year>] years 年データ（完全範囲）
+        #
+        def initialize(context:, scroll:, years: [])
+          @context = context
+          @years = years
+          @scroll = scroll
+          @operated_solar_term = OperatedSolarTerm.new(context: context, years: @years)
+          operated_solar_term.create
+        end
+
+        #
+        # 運用結果範囲を取得する
+        #
+        # @return [Array<Year>] 運用結果範囲
+        #
+        def get
+          operated_years = rewrite
+
+          self.class.move(operated_years: operated_years)
+
+          self.class.commit(operated_years: operated_years)
+
+          Transfer::GengouScroller.set(scroll: @scroll, years: operated_years)
+
+          operated_years
+        end
+
+        #
+        # 運用結果に書き換える
+        #
+        # @return [Array<OperatedYear>] 運用結果範囲
+        #
+        def rewrite
+          operated_years = []
+
+          years.each do |year|
+            operated_year = self.class.rewrite_year(
+              year: year,
+              operated_solar_term: operated_solar_term
+            )
+            operated_years.push(operated_year)
+          end
+
+          operated_years
+        end
+
+        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
+
+          #
+          # 運用情報では来年に属する月を来年に寄せる
+          #
+          # @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
+
+          #
+          # 運用情報では昨年に属する月を昨年に寄せる
+          #
+          # @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
+
+          #
+          # 年を確定させる
+          #
+          # @param [Array<OperatedYear>] operated_years 運用結果範囲
+          #
+          def commit(operated_years:)
+            operated_years.each(&:commit)
+          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
+
+          #
+          # 履歴情報の有無に応じた月にする
+          #
+          # @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
+
+          # :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
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require_relative '../era/gengou/dated_scroll'
+require_relative './abstract_full_range'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Calculation
+    # :nodoc:
+    module Range
+      #
+      # DatedFullRange 完全範囲
+      #
+      class DatedFullRange < AbstractFullRange
+        #
+        # 初期化
+        #
+        # @param [Context::Context] context 暦コンテキスト
+        # @param [Western::Calendar] start_date 開始日
+        # @param [Western::Calendar] last_date 終了日
+        #
+        def initialize(context:,
+                       start_date: Western::Calendar.new, last_date: Western::Calendar.new)
+          scroll = Gengou::DatedScroll.new(start_date: start_date, last_date: last_date)
+
+          super(context: context, scroll: scroll, start_date: start_date, last_date: last_date)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require_relative '../era/gengou/dated_scroll'
+
+require_relative './abstract_operation_range'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Calculation
+    # :nodoc:
+    module Range
+      #
+      # DatedOperationRange 運用結果範囲
+      #
+      class DatedOperationRange < AbstractOperationRange
+        #
+        # 初期化
+        #
+        # @param [Context::Context] context 暦コンテキスト
+        # @param [Western::Calendar] start_date 開始日
+        # @param [Western::Calendar] last_date 終了日
+        # @param [Array<Year>] years 年データ（完全範囲）
+        #
+        def initialize(context:, start_date: Western::Calendar.new,
+                       last_date: Western::Calendar.new, years: [])
+          scroll = Gengou::DatedScroll.new(start_date: start_date, last_date: last_date)
+          super(context: context, scroll: scroll, years: years)
+        end
+      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 暦コンテキスト
-        # @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

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require_relative '../era/gengou/named_scroll'
+require_relative './abstract_full_range'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Calculation
+    # :nodoc:
+    module Range
+      #
+      # NamedFullRange 完全範囲
+      #
+      class NamedFullRange < AbstractFullRange
+        # @return [String] 不正元号名
+        INVALID_NAME = Japan::Calendar::EMPTY
+
+        #
+        # 初期化
+        #
+        # @param [Context::Context] context 暦コンテキスト
+        # @param [String] start_name 開始元号名
+        # @param [String] last_name 終了元号名
+        #
+        def initialize(context:, start_name: INVALID_NAME, last_name: INVALID_NAME)
+          scroll = Gengou::NamedScroll.new(start_name: start_name, last_name: last_name)
+          range = scroll.range
+
+          super(
+            context: context, scroll: scroll,
+            start_date: range.western_start_date, last_date: range.western_last_date
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require_relative '../era/gengou/named_scroll'
+
+require_relative './abstract_operation_range'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Calculation
+    # :nodoc:
+    module Range
+      #
+      # NamedOperationRange 運用結果範囲
+      #
+      class NamedOperationRange < AbstractOperationRange
+        # @return [String] 不正元号名
+        INVALID_NAME = Japan::Calendar::EMPTY
+
+        #
+        # 初期化
+        #
+        # @param [Context::Context] context 暦コンテキスト
+        # @param [String] start_name 開始元号名
+        # @param [String] last_name 終了元号名
+        # @param [Array<Year>] years 年データ（完全範囲）
+        #
+        def initialize(context:, start_name: INVALID_NAME, last_name: INVALID_NAME, years: [])
+          scroll = Gengou::NamedScroll.new(start_name: start_name, last_name: last_name)
+
+          super(context: context, scroll: scroll, years: years)
+        end
+      end
+    end
+  end
+end