zakuro 0.6.0 → 0.7.2

data/lib/zakuro/calculation/range/{full_range.rb → abstract_full_range.rb}

@@ -1,17 +1,15 @@
 # frozen_string_literal: true
 
-require_relative '../../version/context'
+require_relative '../../context/context'
 
 require_relative '../../era/western/calendar'
 require_relative '../../output/logger'
 
-require_relative '../gengou/scroll'
+require_relative '../era/version/version'
 
 require_relative '../base/gengou'
 require_relative '../base/year'
 
-require_relative '../version/version'
-
 require_relative './transfer/year_boundary'
 
 require_relative './transfer/gengou_scroller'
@@ -36,13 +34,13 @@ module Zakuro
       #   * 引き当てたい日付が元旦ではない場合、その月日に従い元号を再度求める
       #   * この再計算が必要になるのは、元号が切り替わる年のみである
       #
-      class FullRange
-        # @return [Context] 暦コンテキスト
+      class AbstractFullRange
+        # @return [Context::Context] 暦コンテキスト
         attr_reader :context
         # @return [Western::Calendar] 開始日
         attr_reader :start_date
         # @return [Western::Calendar] 終了日
-        attr_reader :end_date
+        attr_reader :last_date
         # @return [MultiGengouRoller] 改元処理
         attr_reader :scroll
 
@@ -52,18 +50,19 @@ module Zakuro
         #
         # 初期化
         #
-        # @param [Context] context 暦コンテキスト
+        # @param [Context::Context] context 暦コンテキスト
+        # @param [Gengou::AbstractScroll] scroll 元号スクロール
         # @param [Western::Calendar] start_date 開始日
-        # @param [Western::Calendar] end_date 終了日
+        # @param [Western::Calendar] last_date 終了日
         #
-        def initialize(context:, start_date: Western::Calendar.new, end_date: Western::Calendar.new)
+        def initialize(context:, scroll:,
+                       start_date: Western::Calendar.new, last_date: Western::Calendar.new)
           @start_date = start_date
-          @end_date = end_date
+          @last_date = last_date
           return if invalid?
 
-          # TODO: 現時点では使用していない。特定の暦を指定できるようになった状態で使用する
           @context = context
-          @scroll = Gengou::Scroll.new(start_date: start_date, end_date: end_date)
+          @scroll = scroll
         end
 
         #
@@ -104,19 +103,22 @@ module Zakuro
           result = []
 
           start_year = @scroll.western_start_year
-          end_year = @scroll.western_end_year
+          last_year = @scroll.western_last_year
 
-          versions = Version.get(start_year: start_year, end_year: end_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)
+            specified_context = Context::Context.new(
+              version: version.name, options: context.option.hash
+            )
             start_year = version.start_year
-            end_year = version.end_year
+            last_year = version.last_year
             # 最後の暦だけ1年足す（次の元号の開始年まで計算するケースあり）
-            end_year += 1 if (index + 1) == versions.size
+            last_year += 1 if (index + 1) == versions.size
 
             years = boundary_resolved_ranges(
-              context: context, start_year: start_year, end_year: end_year
+              context: specified_context, start_year: start_year, last_year: last_year
             )
             result.concat(years)
           end
@@ -127,15 +129,15 @@ module Zakuro
         #
         # 年境界解決済みの範囲
         #
-        # @param [Context] context 暦コンテキスト
+        # @param [Context::Context] context 暦コンテキスト
         # @param [Integer] start_year 開始西暦年
-        # @param [Integer] end_year 終了西暦年
+        # @param [Integer] last_year 終了西暦年
         #
         # @return [Array<Base::Year>] 年境界解決済みの範囲
         #
-        def boundary_resolved_ranges(context:, start_year:, end_year:)
+        def boundary_resolved_ranges(context:, start_year:, last_year:)
           ranges = annual_ranges(
-            context: context, start_year: start_year, end_year: end_year
+            context: context, start_year: start_year, last_year: last_year
           )
 
           Transfer::YearBoundary.get(
@@ -146,17 +148,17 @@ module Zakuro
         #
         # 完全範囲内の年データを取得する
         #
-        # @param [Context] context 暦コンテキスト
+        # @param [Context::Context] context 暦コンテキスト
         # @param [Integer] start_year 開始西暦年
-        # @param [Integer] end_year 終了西暦年
+        # @param [Integer] last_year 終了西暦年
         #
         # @return [Array<Base::Year>] 年データ（冬至基準）
         #
-        def annual_ranges(context:, start_year:, end_year:)
+        def annual_ranges(context:, start_year:, last_year:)
           annual_range = context.resolver.annual_range
 
           years = []
-          (start_year..(end_year + 1)).each do |year|
+          (start_year..(last_year + 1)).each do |year|
             years.push(
               annual_range.get(
                 context: context, western_year: year

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

@@ -13,30 +13,28 @@ module Zakuro
     # :nodoc:
     module Range
       #
-      # OperatedRange 運用結果範囲
+      # AbstractOperationRange 運用結果範囲
       #
       # 何らかの理由により、計算された暦とは異なる運用結果である場合、その結果に合わせて計算結果を上書きする
-      class OperatedRange
+      class AbstractOperationRange
         # @return [Array<Year>] 年データ（完全範囲）
         attr_reader :years
         # @return [OperatedSolarTerms] 運用時二十四節気
         attr_reader :operated_solar_terms
-        # @return [Context] 暦コンテキスト
+        # @return [Context::Context] 暦コンテキスト
         attr_reader :context
 
         #
         # 初期化
         #
-        # @param [Context] context 暦コンテキスト
-        # @param [Western::Calendar] start_date 開始日
-        # @param [Western::Calendar] end_date 終了日
+        # @param [Context::Context] context 暦コンテキスト
+        # @param [Gengou::AbstractScroll] scroll 元号スクロール
         # @param [Array<Year>] years 年データ（完全範囲）
         #
-        def initialize(context:, start_date: Western::Calendar.new, end_date: Western::Calendar.new,
-                       years: [])
+        def initialize(context:, scroll:, years: [])
           @context = context
           @years = years
-          @scroll = Gengou::Scroll.new(start_date: start_date, end_date: end_date)
+          @scroll = scroll
           @operated_solar_terms = OperatedSolarTerms.new(context: context, years: @years)
           @operated_solar_terms.create
         end
@@ -49,9 +47,9 @@ 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)
 
@@ -67,7 +65,7 @@ module Zakuro
           operated_years = []
 
           years.each do |year|
-            operated_year = OperatedRange.rewrite_year(
+            operated_year = AbstractOperationRange.rewrite_year(
               year: year,
               operated_solar_terms: @operated_solar_terms
             )
@@ -83,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
@@ -158,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
           )

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

@@ -29,7 +29,7 @@ module Zakuro
         #   * 対象年に対して、前年11月-当年11月までを出力する
         #   * 対象年（西暦）と計算年（元号x年）の紐付けは行わない
         #
-        # @param [Context] context 暦コンテキスト
+        # @param [Context::Context] context 暦コンテキスト
         # @param [Monthly::AbstractLunarPhase] lunar_phase 月の位相
         # @param [Solar::AbstractAverage] solar_average 定気（太陽軌道平均）
         #
@@ -51,7 +51,7 @@ module Zakuro
         #
         # 1年データを取得する
         #
-        # @param [Context] context 暦コンテキスト
+        # @param [Context::Context] context 暦コンテキスト
         # @param [Monthly::LunarPhase] lunar_phase 月の位相
         #
         # @return [Array<Month>] 1年データ

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

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

@@ -3,8 +3,6 @@
 require_relative '../../operation/operation'
 require_relative '../monthly/month'
 
-# TODO: solar_termの中はsrc/destだが、yamlはcalc/actual。統一したい。
-
 # :nodoc:
 module Zakuro
   # :nodoc:
@@ -23,13 +21,13 @@ module Zakuro
         # * 移動先の二十四節気：移動元からの二十四節気（追加対象）
         #
         attr_reader :directions
-        # @return [Context] 暦コンテキスト
+        # @return [Context::Context] 暦コンテキスト
         attr_reader :context
 
         #
         # 初期化
         #
-        # @param [Context] context 暦コンテキスト
+        # @param [Context::Context] context 暦コンテキスト
         # @param [Array<Year>] years 完全範囲（年データ）
         #
         def initialize(context:, years: [])
@@ -75,7 +73,7 @@ module Zakuro
         #
         # 年内の全ての月の移動方向を作成する
         #
-        # @param [Context] context 暦コンテキスト
+        # @param [Context::Context] context 暦コンテキスト
         # @param [Hash<String, SolarTerm>] directions 二十四節気の移動元/移動先（西暦日 -> 対応する二十四節気）
         # @param [Array<Month>] months 年内の全ての月
         #
@@ -100,7 +98,7 @@ module Zakuro
         #
         # 月毎の移動方向を作成する
         #
-        # @param [Context] context 暦コンテキスト
+        # @param [Context::Context] context 暦コンテキスト
         # @param [Month] 月
         # @param [Hash<String, SolarTerm>] directions 二十四節気の移動元/移動先（西暦日 -> 対応する二十四節気）
         # @param [Operation::SolarTerm::Diretion] 二十四節気（移動）
@@ -121,7 +119,7 @@ module Zakuro
         #
         # 移動先に有効な二十四節気（差し替える二十四節気）を指定する
         #
-        # @param [Context] context 暦コンテキスト
+        # @param [Context::Context] context 暦コンテキスト
         # @param [SolarTerm] solar_term 二十四節気（計算値）
         # @param [Hash<String, SolarTerm>] directions 二十四節気の移動元/移動先（西暦日 -> 対応する二十四節気）
         # @param [Operation::SolarTerm::Direction] source 二十四節気（移動）
@@ -143,7 +141,7 @@ module Zakuro
         #
         # 移動先に有効な二十四節気（差し替える二十四節気）を生成する
         #
-        # @param [Context] context 暦コンテキスト
+        # @param [Context::Context] context 暦コンテキスト
         # @param [SolarTerm] solar_term 二十四節気（計算値）
         # @param [Operation::SolarTerm::Direction] source 二十四節気（移動）
         #
@@ -167,7 +165,7 @@ module Zakuro
         #
         # 移動元に無効な二十四節気（連番のみ指定）を指定する
         #
-        # @param [Context] context 暦コンテキスト
+        # @param [Context::Context] context 暦コンテキスト
         # @param [Hash<String, SolarTerm>] directions 二十四節気の移動元/移動先（西暦日 -> 対応する二十四節気）
         # @param [Operation::SolarTerm::Destination] destination 二十四節気（移動先）
         #
@@ -188,14 +186,14 @@ module Zakuro
         #
         # @param [Western::Calendar] western_date 西暦日
         #
-        # @return [Context] 暦コンテキスト
+        # @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.new
+          Context::Context.new
         end
 
         #

data/lib/zakuro/calculation/range/transfer/year_boundary.rb

@@ -19,7 +19,7 @@ module Zakuro
           #
           # 年間範囲内の年データの開始月を変更する
           #
-          # @param [Context] context 暦コンテキスト
+          # @param [Context::Context] context 暦コンテキスト
           # @param [Array<Base::Year>] annual_ranges 年データ（冬至基準）
           #
           # @return [Array<Base::Year>] 年データ（元旦基準）
@@ -32,7 +32,7 @@ module Zakuro
           #
           # 年間範囲内の年データの開始月を変更する
           #
-          # @param [Context] context 暦コンテキスト
+          # @param [Context::Context] context 暦コンテキスト
           # @param [Array<Base::Year>] annual_ranges 年データ（冬至基準）
           #
           # @return [Array<Base::Year>] 年データ（元旦基準）
@@ -54,7 +54,7 @@ module Zakuro
           #
           # 年間範囲を昨年/今年で分類する
           #
-          # @param [Context] context 暦コンテキスト
+          # @param [Context::Context] context 暦コンテキスト
           # @param [Array<Base::Year>] annual_range 1年データ
           #
           def self.categorize(context:, annual_ranges:)
@@ -67,7 +67,7 @@ module Zakuro
           #
           # 各月を昨年/今年で分類する
           #
-          # @param [Context] context 暦コンテキスト
+          # @param [Context::Context] context 暦コンテキスト
           # @param [Array<Month>] annual_range 1年データ
           #
           def self.categorize_year(context:, annual_range:)
@@ -88,7 +88,7 @@ module Zakuro
           #
           # 年データの開始月を変更する
           #
-          # @param [Context] context 暦コンテキスト
+          # @param [Context::Context] context 暦コンテキスト
           # @param [Array<Base::Year>] annual_ranges 年データ（冬至基準）
           # @param [Integer] index 対象年の要素番号
           #
@@ -108,7 +108,7 @@ module Zakuro
           #
           # 当年データを生成する
           #
-          # @param [Context] context 暦コンテキスト
+          # @param [Context::Context] context 暦コンテキスト
           # @param [Array<Month>] annual_range 1年データ
           #
           # @return [Base::Year] 当年月ありの対象年

data/lib/zakuro/calculation/stella/solar/abstract_location.rb

@@ -105,6 +105,8 @@ module Zakuro
         #
         # 初回の入定気を定める
         #
+        # @raise [ArgumentError] 引数エラー
+        #
         def define_first
           # 入定気の起算方法
           # 概要:

data/lib/zakuro/calculation/summary/internal/day.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require_relative '../../../calculation/base/day'
+require_relative '../../../era/western/calendar'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Calculation
+    # :nodoc:
+    module Summary
+      #
+      # Day 特定日
+      #
+      module Day
+        #
+        # 日を取得する
+        #
+        # @param [Month] month 月
+        # @param [Western::Calendar] date 現在西暦日
+        #
+        # @return [Calculation::Base::Day] 特定日
+        #
+        def self.get(month:, date: Western::Calendar.new)
+          first_date = month.western_date
+          days = date - first_date
+          remainder = month.remainder
+          remainder = remainder.add(
+            # 常に参照元のRemainderクラスで生成する
+            remainder.class.new(day: days, minute: 0, second: 0)
+          )
+
+          Calculation::Base::Day.new(
+            number: days + 1, western_date: date, remainder: remainder
+          )
+        end
+      end
+    end
+  end
+end

data/lib/zakuro/calculation/summary/internal/month.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+require_relative '../../../output/response'
+
+require_relative './day'
+require_relative './option'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Calculation
+    # :nodoc:
+    module Summary
+      #
+      # Month 特定月
+      #
+      class Month
+        # @return [Context::Context] 暦コンテキスト
+        attr_reader :context
+        # @return [Western::Calendar] 西暦開始日
+        attr_reader :start_date
+        # @return [Western::Calendar] 西暦終了日
+        attr_reader :last_date
+        # @return [Base::Year] 年
+        attr_reader :year
+        # @return [Monthly::Month] 月
+        attr_reader :month
+
+        #
+        # 初期化
+        #
+        # @param [Context::Context] context 暦コンテキスト
+        # @param [Western::Calendar] start_date 西暦開始日
+        # @param [Western::Calendar] last_date 西暦終了日
+        # @param [Base::Year] year 年
+        # @param [Monthly::Month] month 月
+        #
+        def initialize(context:, start_date:, last_date:, year:, month:)
+          @context = context
+          @start_date = start_date
+          @last_date = last_date
+          @year = year
+          @month = month
+        end
+
+        #
+        # 取得する
+        #
+        # @return [Array<Result::Data::SingleDay>] 1日データ
+        #
+        def get
+          result = []
+          first_date = @month.western_date.clone
+
+          (0..@month.days).each do |index|
+            current_date = first_date.clone + index
+
+            next unless include?(date: current_date)
+
+            day = Day.get(month: @month, date: current_date)
+
+            options = Option.create(month: @month, day: day)
+
+            single_day = Output::Response::SingleDay.create(
+              year: @year, month: @month, day: day, options: options
+            )
+
+            result.push(single_day)
+          end
+
+          result
+        end
+
+        #
+        # 含まれるか
+        #
+        # @param [Western::Calendar] date 西暦日
+        #
+        # @return [True] 含む
+        # @return [False] 含まない
+        #
+        def include?(date:)
+          return false if date < @start_date
+
+          return false if date > @last_date
+
+          true
+        end
+      end
+    end
+  end
+end