zakuro 0.9.4 → 1.0.0

data/lib/zakuro/version/genka/cycle/remainder.rb

@@ -7,88 +7,91 @@ require_relative '../const/number'
 # :nodoc:
 module Zakuro
   # :nodoc:
-  module Genka
+  module Version
     # :nodoc:
-    module Cycle
-      #
-      # Remainder 時刻情報（大余小余）
-      #
-      class Remainder < Calculation::Cycle::AbstractRemainder
-        #
-        # @note 『歴代天文律暦等志彙編　六』中華書房 p.1727
-        # 「推弦望法..加朔大餘七，小餘二百八十七，小分三，小分満四從小餘」
-        #
-        # @return [Integer] 分（1分=4秒）
-        MINUTE = 4
+    module Genka
+      # :nodoc:
+      module Cycle
+        #
+        # Remainder 時刻情報（大余小余）
+        #
+        class Remainder < Calculation::Cycle::AbstractRemainder
+          #
+          # @note 『歴代天文律暦等志彙編　六』中華書房 p.1727
+          # 「推弦望法..加朔大餘七，小餘二百八十七，小分三，小分満四從小餘」
+          #
+          # @return [Integer] 分（1分=4秒）
+          MINUTE = 4
 
-        #
-        # 初期化
-        #
-        # @param [Integer] day 大余（"日"に相当）
-        # @param [Integer] minute 小余（"分"に相当）
-        # @param [Integer] second 秒
-        # @param [Integer] total 繰り上げなしの小余
-        #
-        def initialize(day: -1, minute: -1, second: -1, total: -1)
-          super(base_day: Const::Number::Cycle::DAY, base_minute: MINUTE,
-                day: day, minute: minute, second: second, total: total)
-        end
+          #
+          # 初期化
+          #
+          # @param [Integer] day 大余（"日"に相当）
+          # @param [Integer] minute 小余（"分"に相当）
+          # @param [Integer] second 秒
+          # @param [Integer] total 繰り上げなしの小余
+          #
+          def initialize(day: -1, minute: -1, second: -1, total: -1)
+            super(base_day: Const::Number::Cycle::DAY, base_minute: MINUTE,
+                  day: day, minute: minute, second: second, total: total)
+          end
 
-        #
-        # 特定の文字フォーマットにして出力する
-        #
-        # @return [String] フォーマットした結果
-        #
-        def format(form: '%.4f', digit: 4)
-          return '' if invalid?
+          #
+          # 特定の文字フォーマットにして出力する
+          #
+          # @return [String] フォーマットした結果
+          #
+          def format(form: '%.4f', digit: 4)
+            return '' if invalid?
 
-          decimal = day + minute / base_day.to_f
+            decimal = day + minute / base_day.to_f
 
-          # NOTE: 親クラスを迂回する
-          Kernel.instance_method(:format).bind(self).call(form, decimal.round(digit))
+            # NOTE: 親クラスを迂回する
+            Kernel.instance_method(:format).bind(self).call(form, decimal.round(digit))
+          end
         end
-      end
 
-      #
-      # TermRemainder 時刻情報（大余小余）
-      #
-      class TermRemainder < Calculation::Cycle::AbstractRemainder
         #
-        # @note 『歴代天文律暦等志彙編　六』中華書房 p.1726
-        # 「氣法，二十四」
+        # TermRemainder 時刻情報（大余小余）
         #
-        # @return [Integer] 分（1分=24秒）
-        MINUTE = 24
+        class TermRemainder < Calculation::Cycle::AbstractRemainder
+          #
+          # @note 『歴代天文律暦等志彙編　六』中華書房 p.1726
+          # 「氣法，二十四」
+          #
+          # @return [Integer] 分（1分=24秒）
+          MINUTE = 24
 
-        #
-        # 初期化
-        #
-        # @param [Integer] day 大余（"日"に相当）
-        # @param [Integer] minute 小余（"分"に相当）
-        # @param [Integer] second 秒
-        # @param [Integer] total 繰り上げなしの小余
-        #
-        def initialize(day: -1, minute: -1, second: -1, total: -1)
-          super(base_day: Const::Number::Cycle::TERM_DAY, base_minute: MINUTE,
-                day: day, minute: minute, second: second, total: total)
-        end
+          #
+          # 初期化
+          #
+          # @param [Integer] day 大余（"日"に相当）
+          # @param [Integer] minute 小余（"分"に相当）
+          # @param [Integer] second 秒
+          # @param [Integer] total 繰り上げなしの小余
+          #
+          def initialize(day: -1, minute: -1, second: -1, total: -1)
+            super(base_day: Const::Number::Cycle::TERM_DAY, base_minute: MINUTE,
+                  day: day, minute: minute, second: second, total: total)
+          end
 
-        #
-        # 特定の文字フォーマットにして出力する
-        #
-        # @return [String] フォーマットした結果
-        #
-        def format(form: '%.4f', digit: 4)
-          return '' if invalid?
+          #
+          # 特定の文字フォーマットにして出力する
+          #
+          # @return [String] フォーマットした結果
+          #
+          def format(form: '%.4f', digit: 4)
+            return '' if invalid?
 
-          decimal = day + minute / base_day.to_f
-          # NOTE: roundなしで format を使用した場合は、四捨五入が正しく実行されないことが判明した
-          # 具体的には、468年の中気は '55.7813' だが '55.7812' になる
-          # これは '55.7812500' を4桁にした際に、境界値の少数点以下5桁目の '5' が切り捨てを受けたためである
-          # format による四捨五入は避け、roundによる四捨五入を採用する
+            decimal = day + minute / base_day.to_f
+            # NOTE: roundなしで format を使用した場合は、四捨五入が正しく実行されないことが判明した
+            # 具体的には、468年の中気は '55.7813' だが '55.7812' になる
+            # これは '55.7812500' を4桁にした際に、境界値の少数点以下5桁目の '5' が切り捨てを受けたためである
+            # format による四捨五入は避け、roundによる四捨五入を採用する
 
-          # NOTE: 親クラスを迂回する
-          Kernel.instance_method(:format).bind(self).call(form, decimal.round(digit))
+            # NOTE: 親クラスを迂回する
+            Kernel.instance_method(:format).bind(self).call(form, decimal.round(digit))
+          end
         end
       end
     end

data/lib/zakuro/version/genka/cycle/solar_term.rb

@@ -9,24 +9,27 @@ require_relative './remainder'
 # :nodoc:
 module Zakuro
   # :nodoc:
-  module Genka
+  module Version
     # :nodoc:
-    module Cycle
-      #
-      # SolarTerm 二十四節気
-      #
-      class SolarTerm < Calculation::Cycle::AbstractSolarTerm
-        # @return [Remainder] 気策（24分の1年）
-        SOLAR_TERM_AVERAGE = Const::Remainder::SOLAR_TERM_AVERAGE
-
-        #
-        # 初期化
+    module Genka
+      # :nodoc:
+      module Cycle
         #
-        # @param [Integer] index 連番
-        # @param [Remainder] remainder 時刻情報（大余小余）
+        # SolarTerm 二十四節気
         #
-        def initialize(index: -1, remainder: TermRemainder.new)
-          super(index: index, remainder: remainder, average: SOLAR_TERM_AVERAGE)
+        class SolarTerm < Calculation::Cycle::AbstractSolarTerm
+          # @return [Remainder] 気策（24分の1年）
+          SOLAR_TERM_AVERAGE = Const::Remainder::SOLAR_TERM_AVERAGE
+
+          #
+          # 初期化
+          #
+          # @param [Integer] index 連番
+          # @param [Remainder] remainder 時刻情報（大余小余）
+          #
+          def initialize(index: -1, remainder: TermRemainder.new)
+            super(index: index, remainder: remainder, average: SOLAR_TERM_AVERAGE)
+          end
         end
       end
     end

data/lib/zakuro/version/genka/genka.rb

@@ -2,10 +2,13 @@
 
 # :nodoc:
 module Zakuro
-  #
-  # Genka 元嘉暦
-  #
-  module Genka
-    # none
+  # :nodoc:
+  module Version
+    #
+    # Genka 元嘉暦
+    #
+    module Genka
+      # none
+    end
   end
 end

data/lib/zakuro/version/genka/monthly/lunar_phase.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require_relative '../../../calculation/monthly/const'
+require_relative '../../../calculation/monthly/internal/part/const'
 
 require_relative '../const/remainder'
 
@@ -13,94 +13,97 @@ require_relative '../stella/origin/january'
 # :nodoc:
 module Zakuro
   # :nodoc:
-  module Genka
+  module Version
     # :nodoc:
-    module Monthly
-      #
-      # LunarPhase 月の位相
-      #
-      class LunarPhase
-        # @return [Cycle::Remainder] 弦
-        QUARTER = Const::Remainder::QUARTER
-
-        # @return [Array<String>] 月内の弦
-        PHASE_INDEXES = Calculation::Monthly::Const::PHASE_INDEXES
-
-        # @return [Integer] 弦の位置
-        attr_reader :index
-        # @return [Cycle::AbstractRemainder] 経
-        attr_reader :remainder
-
-        #
-        # 初期化
-        #
-        # @param [Cycle::Remainder] remainder 正月経朔
-        #
-        def initialize(remainder:)
-          # 経
-          @remainder = remainder
-
-          # 弦の位置
-          @index = 0
-        end
-
-        #
-        # 次の弦に進める
-        #
-        # @return [Remainder] 経朔
-        #
-        def next_phase
-          adjusted = remainder.clone
+    module Genka
+      # :nodoc:
+      module Monthly
+        #
+        # LunarPhase 月の位相
+        #
+        class LunarPhase
+          # @return [Cycle::Remainder] 弦
+          QUARTER = Const::Remainder::QUARTER
+
+          # @return [Array<String>] 月内の弦
+          PHASE_INDEXES = Calculation::Monthly::Const::PHASE_INDEXES
+
+          # @return [Integer] 弦の位置
+          attr_reader :index
+          # @return [Cycle::AbstractRemainder] 経
+          attr_reader :remainder
+
+          #
+          # 初期化
+          #
+          # @param [Cycle::Remainder] remainder 正月経朔
+          #
+          def initialize(remainder:)
+            # 経
+            @remainder = remainder
+
+            # 弦の位置
+            @index = 0
+          end
 
-          add_quarter_moon_size
+          #
+          # 次の弦に進める
+          #
+          # @return [Remainder] 経朔
+          #
+          def next_phase
+            adjusted = remainder.clone
 
-          adjusted
-        end
+            add_quarter_moon_size
 
-        #
-        # 次の月に進める
-        # @note 進めた後の月の経朔ではなく、当月のものを返却する
-        #
-        # @return [Remainder] 当月初の経朔
-        #
-        def next_month
-          result = nil
-          PHASE_INDEXES.each_with_index do |_phase, index|
-            adjust = next_phase
-            result = adjust if index.zero?
+            adjusted
           end
 
-          result
-        end
-
-        #
-        # 経朔を返す
-        #
-        #  元嘉暦には経朔しかないが他の暦と揃える
-        #
-        # @return [Remainder] 経朔
-        #
-        def average_remainder
-          @remainder
-        end
+          #
+          # 次の月に進める
+          # @note 進めた後の月の経朔ではなく、当月のものを返却する
+          #
+          # @return [Remainder] 当月初の経朔
+          #
+          def next_month
+            result = nil
+            PHASE_INDEXES.each_with_index do |_phase, index|
+              adjust = next_phase
+              result = adjust if index.zero?
+            end
+
+            result
+          end
 
-        private
+          #
+          # 経朔を返す
+          #
+          #  元嘉暦には経朔しかないが他の暦と揃える
+          #
+          # @return [Remainder] 経朔
+          #
+          def average_remainder
+            @remainder
+          end
 
-        #
-        # 次の弦に進める
-        #
-        # @return [Integer] 弦
-        #
-        def next_index
-          @index += 1
-          @index = 0 if index >= PHASE_INDEXES.size
-          @index
-        end
+          private
+
+          #
+          # 次の弦に進める
+          #
+          # @return [Integer] 弦
+          #
+          def next_index
+            @index += 1
+            @index = 0 if index >= PHASE_INDEXES.size
+            @index
+          end
 
-        def add_quarter_moon_size
-          remainder.add!(QUARTER)
+          def add_quarter_moon_size
+            remainder.add!(QUARTER)
 
-          next_index
+            next_index
+          end
         end
       end
     end

data/lib/zakuro/version/genka/option/dropped_date/parameter.rb

@@ -9,20 +9,23 @@ require_relative '../../cycle/remainder'
 # :nodoc:
 module Zakuro
   # :nodoc:
-  module Genka
+  module Version
     # :nodoc:
-    module Option
+    module Genka
       # :nodoc:
-      module DroppedDate
-        #
-        # Parameter 引数
-        #
-        class Parameter < Calculation::Option::DroppedDate::AbstractParameter
+      module Option
+        # :nodoc:
+        module DroppedDate
           #
-          # 初期化
+          # Parameter 引数
           #
-          def initialize
-            super(valid: false)
+          class Parameter < Calculation::Option::DroppedDate::AbstractParameter
+            #
+            # 初期化
+            #
+            def initialize
+              super(valid: false)
+            end
           end
         end
       end

data/lib/zakuro/version/genka/option/vanished_date/parameter.rb

@@ -9,20 +9,23 @@ require_relative '../../cycle/remainder'
 # :nodoc:
 module Zakuro
   # :nodoc:
-  module Genka
+  module Version
     # :nodoc:
-    module Option
+    module Genka
       # :nodoc:
-      module VanishedDate
-        #
-        # Parameter 引数
-        #
-        class Parameter < Calculation::Option::VanishedDate::AbstractParameter
+      module Option
+        # :nodoc:
+        module VanishedDate
           #
-          # 初期化
+          # Parameter 引数
           #
-          def initialize
-            super(valid: false)
+          class Parameter < Calculation::Option::VanishedDate::AbstractParameter
+            #
+            # 初期化
+            #
+            def initialize
+              super(valid: false)
+            end
           end
         end
       end

data/lib/zakuro/version/genka/range/annual_range.rb

@@ -8,71 +8,74 @@ require_relative '../stella/solar/average'
 # :nodoc:
 module Zakuro
   # :nodoc:
-  module Genka
+  module Version
     # :nodoc:
-    module Range
-      #
-      # AnnualRange 年間範囲
-      #
-      module AnnualRange
-        # @return [Output::Logger] ロガー
-        LOGGER = Output::Logger.new(location: 'annual_range')
+    module Genka
+      # :nodoc:
+      module Range
+        #
+        # AnnualRange 年間範囲
+        #
+        module AnnualRange
+          # @return [Output::Logger] ロガー
+          LOGGER = Output::Logger.new(location: 'annual_range')
 
-        class << self
-          #
-          # 一覧取得する
-          #
-          #   * 対象年に対して、当年1月-翌年1月までを出力する
-          #   * 対象年（西暦）と計算年（元号x年）の紐付けは行わない
-          #
-          # @param [Context::Context] context 暦コンテキスト
-          # @param [Integer] western_year 西暦年
-          #
-          # @return [Array<Month>] 1年データ
-          #
-          def get(context:, western_year:)
-            # 正月中気
-            solar_term = Cycle::SolarTerm.new(
-              index: 4, remainder: Origin::FirstTerm.get(western_year: western_year)
-            )
-            # 正月に立春が含まれる可能性があるので、立春まで戻しておく
-            solar_term.prev_term!
+          class << self
+            #
+            # 一覧取得する
+            #
+            #   * 対象年に対して、当年1月-翌年1月までを出力する
+            #   * 対象年（西暦）と計算年（元号x年）の紐付けは行わない
+            #
+            # @param [Context::Context] context 暦コンテキスト
+            # @param [Integer] western_year 西暦年
+            #
+            # @return [Array<Month>] 1年データ
+            #
+            def get(context:, western_year:)
+              # 正月中気
+              solar_term = Cycle::SolarTerm.new(
+                index: 4, remainder: Origin::FirstTerm.get(western_year: western_year)
+              )
+              # 正月に立春が含まれる可能性があるので、立春まで戻しておく
+              solar_term.prev_term!
 
-            # 経
-            remainder = Origin::January.get(western_year: western_year)
+              # 経
+              remainder = Origin::January.get(western_year: western_year)
 
-            lunar_phase = Monthly::LunarPhase.new(remainder: remainder)
+              lunar_phase = Monthly::LunarPhase.new(remainder: remainder)
 
-            solar_average = Solar::Average.new(solar_term: solar_term)
+              solar_average = Solar::Average.new(solar_term: solar_term)
 
-            annual_range = Calculation::Range::MedievalAnnualRange.get(
-              context: context, lunar_phase: lunar_phase, solar_average: solar_average
-            )
+              annual_range = Calculation::Range::MedievalAnnualRange.get(
+                context: context, lunar_phase: lunar_phase, solar_average: solar_average
+              )
 
-            pop_months_on_next_year(annual_range: annual_range)
-          end
+              pop_months_on_next_year(annual_range: annual_range)
+            end
 
-          private
+            private
 
-          #
-          # 来年の月を除去する
-          #
-          # @param [Array<Month>] annual_range 1年データ
-          #
-          # @return [Array<Month>] 1年データ
-          #
-          def pop_months_on_next_year(annual_range:)
-            result = []
-            number = 0
-            annual_range.each do |month|
-              # 来年
-              break if number > month.month_label.number
+            #
+            # 来年の月を除去する
+            #
+            # @param [Array<Month>] annual_range 1年データ
+            #
+            # @return [Array<Month>] 1年データ
+            #
+            def pop_months_on_next_year(annual_range:)
+              result = []
+              number = 0
+              annual_range.each do |month|
+                # 来年
+                break if number > month.month_label.number
 
-              number = month.month_label.number
-              result.push(month)
-            end
+                number = month.month_label.number
+                result.push(month)
+              end
 
-            result
+              result
+            end
           end
         end
       end