zakuro 0.5.0 → 0.7.0

data/lib/zakuro/calculation/era/version/internal/crawler.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require_relative '../../../../era/japan/version'
+require_relative './range'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Calculation
+    # :nodoc:
+    module Version
+      #
+      # 暦検索
+      #
+      module Crawler
+        #
+        # 暦の範囲を取得する
+        #
+        # @param [Integer] start_year 開始西暦年
+        # @param [Integer] last_year 終了西暦年
+        #
+        # @return [Array<Range>] 暦の範囲
+        #
+        def self.get(start_year:, last_year:)
+          ranges = Japan::Version.ranges_with_year(start_year: start_year, last_year: last_year)
+
+          result = []
+
+          ranges.each do |range|
+            next unless range.released
+
+            range_start_year = range.start_year
+            range_start_year = start_year if start_year > range.start_year
+
+            range_last_year = range.last_year
+            range_last_year = last_year if last_year < range.last_year
+
+            result.push(
+              Range.new(
+                name: range.name, start_date: range.start_date.clone,
+                start_year: range_start_year, last_year: range_last_year
+              )
+            )
+          end
+
+          result
+        end
+      end
+    end
+  end
+end

data/lib/zakuro/calculation/era/version/internal/range.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Calculation
+    # :nodoc:
+    module Version
+      #
+      # Range 暦（範囲）
+      #
+      class Range
+        # @return [String] 暦名
+        attr_reader :name
+        # @return [Western::Calendar] 暦の開始日
+        attr_reader :start_date
+        # @return [Integer] 開始西暦年
+        attr_reader :start_year
+        # @return [Integer] 終了西暦年
+        attr_reader :last_year
+
+        #
+        # 初期化
+        #
+        # @param [String] name 暦名
+        # @param [Western::Calendar] start_date 暦の開始日
+        # @param [Integer] start_year 開始西暦年
+        # @param [Integer] last_year 終了西暦年
+        #
+        def initialize(name:, start_date:, start_year:, last_year:)
+          @name = name
+          @start_date = start_date
+          @start_year = start_year
+          @last_year = last_year
+        end
+      end
+    end
+  end
+end

data/lib/zakuro/calculation/era/version/version.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require_relative './internal/crawler'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Calculation
+    # :nodoc:
+    module Version
+      #
+      # 暦の範囲を取得する
+      #
+      # @param [Integer] start_year 開始西暦年
+      # @param [Integer] last_year 終了西暦年
+      #
+      # @return [Array<Range>] 暦の範囲
+      #
+      def self.get(start_year:, last_year:)
+        Crawler.get(start_year: start_year, last_year: last_year)
+      end
+    end
+  end
+end

data/lib/zakuro/calculation/monthly/first_day.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require_relative '../../era/western'
+require_relative '../../era/western/calendar'
 
 # :nodoc:
 module Zakuro
@@ -23,7 +23,8 @@ module Zakuro
         # @param [Remainder] remainder 西暦日
         # @param [Western::Calendar] western_date 大余小余
         #
-        def initialize(western_date: Western::Calendar.new, remainder:)
+        def initialize(western_date: Western::Calendar.new,
+                       remainder: Calculation::Cycle::AbstractRemainder.new)
           # 西暦日
           @western_date = western_date
           # 大余小余

data/lib/zakuro/calculation/monthly/month.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require_relative '../base/gengou'
 require_relative './first_day'
 require_relative './month_label'
 
@@ -21,6 +22,8 @@ module Zakuro
         attr_reader :first_day
         # @return [Array<SolarTerm>] 二十四節気
         attr_reader :solar_terms
+        # @return [Base::Gengou] 元号
+        attr_reader :gengou
 
         #
         # 初期化
@@ -29,13 +32,25 @@ module Zakuro
         # @param [MonthLabel] month_label 月表示名
         # @param [FirstDay] first_day 月初日（朔日）
         # @param [Array<SolarTerm>] solar_terms 二十四節気
+        # @param [Base::Gengou] gengou 元号
         #
-        def initialize(context:, month_label: MonthLabel.new, first_day: FirstDay.new,
-                       solar_terms: [])
+        def initialize(context: Context.new, month_label: MonthLabel.new, first_day: FirstDay.new,
+                       solar_terms: [], gengou: Base::Gengou.new)
           @context = context
           @month_label = month_label
           @first_day = first_day
           @solar_terms = solar_terms
+          @gengou = gengou
+        end
+
+        #
+        # 不正か
+        #
+        # @return [True] 不正
+        # @return [False] 不正なし
+        #
+        def invalid?
+          @context.invalid?
         end
 
         #
@@ -181,6 +196,77 @@ module Zakuro
         def same?(other:)
           number == other.number && leaped? == other.leaped?
         end
+
+        #
+        # 月の終了日を返す
+        #
+        # @return [Western::Calendar] 月の終了日
+        #
+        def last_date
+          return Western::Calendar.new if western_date.invalid?
+
+          western_date.clone + days - 1
+        end
+
+        #
+        # 範囲内か
+        #
+        # @param [Western::Calendar] date 日付
+        #
+        # @return [True] 範囲内
+        # @return [False] 範囲外
+        #
+        def include?(date:)
+          return false if invalid?
+
+          start_date = western_date
+          return false if start_date.invalid?
+
+          return false if date < start_date
+
+          return false if date > last_date
+
+          true
+        end
+
+        #
+        # 範囲内か
+        #
+        # @param [Japan::Calendar] date 日付
+        #
+        # @return [True] 範囲内
+        # @return [False] 範囲外
+        #
+        def include_by_japan_date?(date:)
+          return false if invalid?
+
+          linear_gengou = @gengou.match_by_name(name: date.gengou)
+          return false if linear_gengou.invalid?
+
+          return false unless linear_gengou.name == date.gengou
+
+          return false unless linear_gengou.year == date.year
+
+          same_by_japan_date?(date: date)
+        end
+
+        private
+
+        #
+        # 同一の月情報かを検証する
+        #
+        # @param [Japan::Calendar] date 日付
+        #
+        # @return [True] 同一の月
+        # @return [False] 異なる月
+        #
+        def same_by_japan_date?(date: Japan::Calendar.new)
+          return false unless number == date.month
+
+          return false unless leaped? == date.leaped
+
+          true
+        end
       end
     end
   end

data/lib/zakuro/calculation/monthly/operated_month.rb

@@ -34,10 +34,10 @@ module Zakuro
         # @param [Operation::MonthHistory] history 変更履歴（月）
         #
         def initialize(context:, operated_solar_terms:, month_label: MonthLabel.new,
-                       first_day: FirstDay.new, solar_terms: [],
+                       first_day: FirstDay.new, solar_terms: [], gengou: Base::Gengou.new,
                        history: Operation::MonthHistory.new)
           super(context: context, month_label: month_label, first_day: first_day,
-                solar_terms: solar_terms)
+                solar_terms: solar_terms, gengou: gengou)
           @history = history
           @operated_solar_terms = operated_solar_terms
           @moved = false
@@ -80,7 +80,7 @@ module Zakuro
           default = month_label.send(method_name)
           return default if diff.invalid?
 
-          diff.actual
+          diff.dest
         end
 
         #

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

@@ -0,0 +1,172 @@
+# frozen_string_literal: true
+
+require_relative '../../version/context'
+
+require_relative '../../era/western/calendar'
+require_relative '../../output/logger'
+
+require_relative '../era/version/version'
+
+require_relative '../base/gengou'
+require_relative '../base/year'
+
+require_relative './transfer/year_boundary'
+
+require_relative './transfer/gengou_scroller'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Calculation
+    # :nodoc:
+    module Range
+      # :reek:TooManyInstanceVariables { max_instance_variables: 6 }
+
+      #
+      # FullRange 完全範囲
+      #   ある日からある日の範囲を計算可能な年月範囲
+      #   * 前提として元号年はその元号の開始年から数える
+      #   * ある日の元号年を求める場合、その元号が含まれる最初の年まで遡る
+      #   * 元号は一つとは限らない。南北朝などで二つある場合は、古い方の元号から求める
+      #
+      # NOTE: 割り当てた元号は年初を基準にした元号年である
+      #   * 元旦を基準にした時の正しい元号を設定している
+      #   * 引き当てたい日付が元旦ではない場合、その月日に従い元号を再度求める
+      #   * この再計算が必要になるのは、元号が切り替わる年のみである
+      #
+      class AbstractFullRange
+        # @return [Context] 暦コンテキスト
+        attr_reader :context
+        # @return [Western::Calendar] 開始日
+        attr_reader :start_date
+        # @return [Western::Calendar] 終了日
+        attr_reader :last_date
+        # @return [MultiGengouRoller] 改元処理
+        attr_reader :scroll
+
+        # @return [Output::Logger] ロガー
+        LOGGER = Output::Logger.new(location: 'full_range')
+
+        #
+        # 初期化
+        #
+        # @param [Context] context 暦コンテキスト
+        # @param [Gengou::AbstractScroll] scroll 元号スクロール
+        # @param [Western::Calendar] start_date 開始日
+        # @param [Western::Calendar] last_date 終了日
+        #
+        def initialize(context:, scroll:,
+                       start_date: Western::Calendar.new, last_date: Western::Calendar.new)
+          @start_date = start_date
+          @last_date = last_date
+          return if invalid?
+
+          # TODO: 現時点では使用していない。特定の暦を指定できるようになった状態で使用する
+          @context = context
+          @scroll = scroll
+        end
+
+        #
+        # 無効か
+        #
+        # @return [True] 無効
+        # @return [False] 有効
+        #
+        def invalid?
+          @start_date.invalid?
+        end
+
+        #
+        # 完全範囲を取得する
+        #
+        # @return [Array<Base::Year>] 完全範囲
+        #
+        def get
+          return [] if invalid?
+
+          years = version_ranges
+
+          years.each(&:commit)
+
+          Transfer::GengouScroller.set(scroll: scroll, years: years)
+
+          years
+        end
+
+        private
+
+        #
+        # 暦別範囲
+        #
+        # @return [Array<Base::Year>] 完全範囲
+        #
+        def version_ranges
+          result = []
+
+          start_year = @scroll.western_start_year
+          last_year = @scroll.western_last_year
+
+          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
+        end
+
+        #
+        # 年境界解決済みの範囲
+        #
+        # @param [Context] context 暦コンテキスト
+        # @param [Integer] start_year 開始西暦年
+        # @param [Integer] last_year 終了西暦年
+        #
+        # @return [Array<Base::Year>] 年境界解決済みの範囲
+        #
+        def boundary_resolved_ranges(context:, start_year:, last_year:)
+          ranges = annual_ranges(
+            context: context, start_year: start_year, last_year: last_year
+          )
+
+          Transfer::YearBoundary.get(
+            context: context, annual_ranges: ranges
+          )
+        end
+
+        #
+        # 完全範囲内の年データを取得する
+        #
+        # @param [Context] context 暦コンテキスト
+        # @param [Integer] start_year 開始西暦年
+        # @param [Integer] last_year 終了西暦年
+        #
+        # @return [Array<Base::Year>] 年データ（冬至基準）
+        #
+        def annual_ranges(context:, start_year:, last_year:)
+          annual_range = context.resolver.annual_range
+
+          years = []
+          (start_year..(last_year + 1)).each do |year|
+            years.push(
+              annual_range.get(
+                context: context, western_year: year
+              )
+            )
+          end
+
+          years
+        end
+      end
+    end
+  end
+end

data/lib/zakuro/calculation/range/{operated_range.rb → abstract_operation_range.rb}

@@ -4,6 +4,7 @@ require_relative './operated_solar_terms'
 require_relative '../../operation/operation'
 require_relative '../base/operated_year'
 require_relative '../../calculation/monthly/operated_month'
+require_relative './transfer/gengou_scroller'
 
 # :nodoc:
 module Zakuro
@@ -12,10 +13,10 @@ module Zakuro
     # :nodoc:
     module Range
       #
-      # OperatedRange 運用結果範囲
+      # AbstractOperationRange 運用結果範囲
       #
       # 何らかの理由により、計算された暦とは異なる運用結果である場合、その結果に合わせて計算結果を上書きする
-      class OperatedRange
+      class AbstractOperationRange
         # @return [Array<Year>] 年データ（完全範囲）
         attr_reader :years
         # @return [OperatedSolarTerms] 運用時二十四節気
@@ -27,11 +28,13 @@ module Zakuro
         # 初期化
         #
         # @param [Context] context 暦コンテキスト
+        # @param [Gengou::AbstractScroll] scroll 元号スクロール
         # @param [Array<Year>] years 年データ（完全範囲）
         #
-        def initialize(context:, years: [])
+        def initialize(context:, scroll:, years: [])
           @context = context
           @years = years
+          @scroll = scroll
           @operated_solar_terms = OperatedSolarTerms.new(context: context, years: @years)
           @operated_solar_terms.create
         end
@@ -44,9 +47,11 @@ module Zakuro
         def get
           operated_years = rewrite
 
-          OperatedRange.move(operated_years: operated_years)
+          AbstractOperationRange.move(operated_years: operated_years)
 
-          OperatedRange.commit(operated_years: operated_years)
+          AbstractOperationRange.commit(operated_years: operated_years)
+
+          Transfer::GengouScroller.set(scroll: @scroll, years: operated_years)
 
           operated_years
         end
@@ -60,8 +65,8 @@ module Zakuro
           operated_years = []
 
           years.each do |year|
-            operated_year = OperatedRange.rewrite_year(
-              context: context, year: year,
+            operated_year = AbstractOperationRange.rewrite_year(
+              year: year,
               operated_solar_terms: @operated_solar_terms
             )
             operated_years.push(operated_year)
@@ -76,7 +81,6 @@ module Zakuro
         # @param [Array<OperatedYear>] operated_years 運用結果範囲
         #
         def self.move(operated_years:)
-          # FIXME: この方式は完全ではない。範囲の1年前/1年後が必要
           move_into_next_year(operated_years: operated_years)
           move_into_last_year(operated_years: operated_years)
         end
@@ -121,16 +125,14 @@ module Zakuro
         #
         # 年を書き換える
         #
-        # @param [Context] context 暦コンテキスト
         # @param [Year] year 年
         # @param [OperatedSolarTerms] operated_solar_terms 運用時二十四節気
         #
         # @return [OperatedYear] 年
         #
-        def self.rewrite_year(context:, year:, operated_solar_terms:)
-          result = Base::OperatedYear.new(
-            multi_gengou: year.multi_gengou, new_year_date: year.new_year_date
-          )
+        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,
@@ -153,7 +155,7 @@ module Zakuro
         def self.resolve_month(context:, month:, operated_solar_terms:)
           history = Operation.specify_history(western_date: month.western_date)
 
-          OperatedRange.rewrite_month(
+          AbstractOperationRange.rewrite_month(
             context: context, month: month, history: history,
             operated_solar_terms: operated_solar_terms
           )
@@ -175,7 +177,7 @@ module Zakuro
           operated_month = Monthly::OperatedMonth.new(
             context: context,
             month_label: month.month_label, first_day: month.first_day,
-            solar_terms: month.solar_terms, history: history,
+            solar_terms: month.solar_terms, history: history, gengou: month.gengou,
             operated_solar_terms: operated_solar_terms
           )
 

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 暦コンテキスト
+        # @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 暦コンテキスト
+        # @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/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 暦コンテキスト
+        # @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 暦コンテキスト
+        # @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