zakuro 0.0.1 → 0.0.2

data/lib/zakuro/version/senmyou/summary/specifier.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+require_relative '../../../era/western'
+require_relative './full_range'
+require_relative '../base/multi_gengou_roller'
+require_relative '../base/year'
+require_relative '../../../output/response'
+require_relative '../../../output/logger'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Senmyou
+    #
+    # SingleDaySpecifier 一日検索
+    #
+    module SingleDaySpecifier
+      # @return [Logger] ロガー
+      LOGGER = Logger.new(location: 'specifier')
+
+      #
+      # 取得する
+      #
+      # @param [Western::Calendar] date 西暦日
+      #
+      # @return [Response::SingleDay] 和暦日
+      #
+      def self.get(date:)
+        years = FullRange.new(start_date: date).get
+
+        year = specify_year(years: years, date: date)
+
+        year = transfer(year: year, date: date)
+
+        month, first_date = specify_month(year: year, date: date)
+
+        Response::SingleDay.save_single_day(
+          param: Response::SingleDay::Param.new(
+            year: year, month: month,
+            date: date, days: date - first_date
+          )
+        )
+      end
+
+      #
+      # 年を特定する
+      #
+      # @param [Array<Year>] years 範囲
+      # @param [Western::Calendar] date 西暦日
+      #
+      # @return [Year] 対象年
+      #
+      def self.specify_year(years:, date:)
+        years.reverse_each do |year|
+          return year if date >= year.new_year_date
+        end
+
+        raise ArgumentError, "invalid year range. date: #{date.format}"
+      end
+
+      #
+      # 改元する
+      #
+      # @param [Year] year 年
+      # @param [Western::Calendar] date 西暦日
+      #
+      # @return [Year] 改元後の年
+      #
+      def self.transfer(year:, date:)
+        multi_gengou = MultiGengouRoller.transfer(multi_gengou: year.multi_gengou, date: date)
+        Year.new(multi_gengou: multi_gengou, new_year_date: year.new_year_date,
+                 months: year.months, total_days: year.total_days)
+      end
+
+      # :reek:TooManyStatements { max_statements: 7 }
+
+      #
+      # 月を特定する
+      #
+      # @param [Year] year 年
+      # @param [Western::Calendar] date 西暦日
+      #
+      # @return [Month] 対象月
+      # @return [Western::Calendar] 月初日
+      #
+      def self.specify_month(year:, date:)
+        current_month_date = year.new_year_date.clone
+        next_month_date = current_month_date.clone
+        year.months.each do |month|
+          next_month_date += month.days
+          return month, current_month_date if next_month_date > date
+
+          current_month_date = next_month_date.clone
+        end
+
+        raise ArgumentError, "invalid month range. date: #{date.format}"
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: zakuro
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - pldb
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-08-01 00:00:00.000000000 Z
+date: 2020-10-05 00:00:00.000000000 Z
 dependencies: []
 description: mainly lunar solar calendar
 email:
@@ -23,10 +23,12 @@ files:
 - ".rubocop.yml"
 - Gemfile
 - LICENSE.txt
+- Makefile
 - README.md
 - Rakefile
 - bin/console
 - bin/setup
+- doc/gengou.md
 - images/12月以降の入定気.png
 - images/12月以降の月の進退.png
 - images/source/description.numbers
@@ -58,7 +60,8 @@ files:
 - lib/zakuro/version/kansei/kansei.rb
 - lib/zakuro/version/senmyou/README.md
 - lib/zakuro/version/senmyou/base/era.rb
-- lib/zakuro/version/senmyou/base/gengou.rb
+- lib/zakuro/version/senmyou/base/multi_gengou.rb
+- lib/zakuro/version/senmyou/base/multi_gengou_roller.rb
 - lib/zakuro/version/senmyou/base/remainder.rb
 - lib/zakuro/version/senmyou/base/solar_term.rb
 - lib/zakuro/version/senmyou/base/year.rb
@@ -69,8 +72,9 @@ files:
 - lib/zakuro/version/senmyou/stella/solar_average.rb
 - lib/zakuro/version/senmyou/stella/solar_orbit.rb
 - lib/zakuro/version/senmyou/stella/winter_solstice.rb
-- lib/zakuro/version/senmyou/summary/annual_data.rb
-- lib/zakuro/version/senmyou/summary/gengou_data.rb
+- lib/zakuro/version/senmyou/summary/annual_range.rb
+- lib/zakuro/version/senmyou/summary/full_range.rb
+- lib/zakuro/version/senmyou/summary/specifier.rb
 - lib/zakuro/version/taien/taien.rb
 - lib/zakuro/version/tenpou/tenpou.rb
 - lib/zakuro/version_factory.rb
@@ -83,7 +87,7 @@ metadata:
   homepage_uri: https://github.com/pldb/zakuro
   source_code_uri: https://github.com/pldb/zakuro
   changelog_uri: https://github.com/pldb/zakuro
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -98,8 +102,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
-signing_key: 
+rubygems_version: 3.1.2
+signing_key:
 specification_version: 4
 summary: japanese calendar library.
 test_files: []

data/lib/zakuro/version/senmyou/base/gengou.rb

@@ -1,210 +0,0 @@
-# frozen_string_literal: true
-
-require_relative './era'
-
-# :nodoc:
-module Zakuro
-  # :nodoc:
-  module Senmyou
-    #
-    # Gengou 元号
-    #
-    class Gengou
-      # @return [Japan::Gengou] 元号（1行目）
-      attr_reader :first_line
-      # @return [Japan::Gengou] 元号（2行目）
-      attr_reader :second_line
-      # @return [Integer] 年の日数
-      attr_reader :total_days
-      # @return [Western::Calendar] 元号内での最過去日（2つの元号が重複した場合はより過去の日となる）/ 次の元号年の年初（1月1日）
-      attr_reader :first_date
-
-      #
-      # 初期化
-      #
-      # @note (see #next_year)
-      #   次年度以降の first_date はその元号の1年目の最初の日を設定する
-      #
-      # @param [Western::Calendar] date 対象日
-      # @param [Japan::Gengou] first_line 元号（1行目）
-      #   * 計算結果を持ち越すため、自クラスでの初期化時のみ使用する
-      # @param [Japan::Gengou] second_line 元号（2行目）
-      #   * 計算結果を持ち越すため、自クラスでの初期化時のみ使用する
-      #
-      def initialize(date: Era::START_DATE, first_line: Japan::Gengou.new,
-                     second_line: Japan::Gengou.new)
-        @total_days = 0
-
-        if Gengou.first_called?(first_line: first_line,
-                                second_line: second_line)
-          initialize_first_called(date: date)
-          return
-        end
-        @first_line = first_line
-        @second_line = second_line
-        @first_date = date.clone
-      end
-
-      #
-      # 初期化で最初の呼び出しかどうかを判定する
-      #
-      # @note 以下の前提がある
-      #   * 初回呼び出しでは first_line/second_line を引数に指定しない（情報がないのでできない）
-      #   * 次回以降の呼び出し（ next_year ） では計算済みのfirst_line/second_lineを渡す
-      #
-      # @param [Japan::Gengou] first_line 元号（1行目）
-      # @param [Japan::Gengou] second_line 元号（2行目）
-      #
-      # @return [True] 初回呼び出し
-      # @return [False] 次回以降の呼び出し
-      #
-      def self.first_called?(first_line:, second_line:)
-        first_line.invalid? && second_line.invalid?
-      end
-
-      #
-      # 初期化（初回呼び出し）
-      #
-      # @param [Western::Calendar] date 日付
-      #
-      def initialize_first_called(date:)
-        raise ArgumentError, 'invalid senmyou date' unless Era.include?(date: date)
-
-        # 2つの元号が重なった時に、元号の開始日が最も古い日
-        @first_date = choise_oldest_gengou_date(
-          first_line: Era.first(start_date: date),
-          second_line: Era.second(start_date: date)
-        )
-        @first_line = Era.first(start_date: @first_date)
-        @second_line = Era.second(start_date: @first_date)
-
-        nil
-      end
-
-      #
-      # 十干十二支を取得する
-      #
-      # @return [String] 十干十二支
-      #
-      def zodiac_name
-        Era.zodiac_name(western_year: @first_date.year)
-      end
-
-      #
-      # 年の日数に加算する
-      #
-      # @param [Integer] days 日数
-      #
-      def add_days(days: 0)
-        @total_days += days
-
-        nil
-      end
-
-      #
-      # 次の年にする
-      #
-      # @return [Gengou] 次の年の元号
-      #
-      def next_year
-        next_date = @first_date.clone + @total_days
-        first = Gengou.next_first_line(gengou: @first_line, date: next_date)
-        second = Gengou.next_second_line(gengou: @second_line, date: next_date)
-
-        first, second = Gengou.swap_two_gengou_on_last_period(first: first,
-                                                              second: second)
-
-        Gengou.new(date: next_date,
-                   first_line: first, second_line: second)
-      end
-
-      #
-      # 南北朝の終末処理をする
-      #
-      # @note 特別対応。北朝の "明徳" を4年から主流にする（2行目から1行目にする）
-      #
-      # @param [Japan::Gengou] first 元号（1行目）
-      # @param [Japan::Gengou] second 元号（2行目）
-      #
-      # @return [Array<Japan::Gengou>] 元号（1行目）, 元号（2行目）
-      #
-      def self.swap_two_gengou_on_last_period(first:, second:)
-        if first.name == second.name
-          first = second
-          second = Japan::Gengou.new
-        end
-        [first, second]
-      end
-
-      #
-      # 元号（1行目）を次の年にする
-      #
-      # @param [Japan::Gengou] gengou 元号（1行目）
-      # @param [Western::Calendar] date 日付
-      #
-      # @return [Japan::Gengou] 翌年の元号（1行目）
-      #
-      def self.next_first_line(gengou:, date:)
-        return Era.first(start_date: date) unless gengou.include?(date: date)
-
-        next_gengou = gengou.clone
-        next_gengou.next_year
-        next_gengou
-      end
-
-      #
-      # 元号（2行目）を次の年にする
-      #
-      # @param [Japan::Gengou] gengou 元号（2行目）
-      # @param [Western::Calendar] date 日付
-      #
-      # @return [Japan::Gengou] 翌年の元号（2行目）
-      #
-      def self.next_second_line(gengou:, date:)
-        return Era.second(start_date: date) unless gengou.include?(date: date)
-
-        next_gengou = gengou.clone
-        next_gengou.next_year
-        next_gengou
-      end
-
-      #
-      # 元号内での最過去日を求める
-      # @note 2つの元号が重複した場合はより過去の日となる
-      #
-      # @param [Japan::Gengou] first_line 元号（1行目）
-      # @param [Japan::Gengou] second_line 元号（2行目）
-      #
-      # @return [Western::Calendar] 最過去日
-      #
-      def choise_oldest_gengou_date(first_line: @first_line,
-                                    second_line: @second_line)
-        first_start_date = first_line.start_date.clone
-        second_start_date = second_line.start_date.clone
-        # first_lineは常に存在する
-        return first_start_date if second_line.invalid?
-
-        first_start_date < second_start_date ? first_start_date : second_start_date
-      end
-
-      #
-      # 元号内での最未来日を求める
-      # @note 2つの元号が重複した場合はより未来の日となる
-      #
-      # @param [Japan::Gengou] first_line 元号（1行目）
-      # @param [Japan::Gengou] second_line 元号（2行目）
-      #
-      # @return [Western::Calendar] 最未来日
-      #
-      def choise_newest_gengou_date(first_line: @first_line,
-                                    second_line: @second_line)
-        first_end_date = first_line.end_date.clone
-        second_end_date = second_line.end_date.clone
-        # first_lineは常に存在する
-        return first_end_date if second_line.invalid?
-
-        first_end_date > second_end_date ? first_end_date : second_end_date
-      end
-    end
-  end
-end

data/lib/zakuro/version/senmyou/summary/gengou_data.rb

@@ -1,294 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../../../era/western'
-require_relative 'annual_data'
-require_relative '../../../output/response'
-require_relative '../base/era'
-require_relative '../base/gengou'
-require_relative '../base/year'
-
-# :nodoc:
-module Zakuro
-  # :nodoc:
-  module Senmyou
-    #
-    # GengouData 元号の年情報
-    #
-    module GengouData
-      def self.get_ancient_date(date: Western::Calendar.new)
-        SingleDay.get_ancient_date(date: date)
-      end
-
-      #
-      # SingleDay 1日データ
-      #
-      module SingleDay
-        #
-        # 1日データを取得する
-        #
-        # @param [Western::Calendar] date 年月日情報（西暦）
-        #
-        # @return [Response::SingleDay] 1日データ
-        #
-        def self.get_ancient_date(date: Western::Calendar.new)
-          raise ArgumentError, 'invalid senmyou date' unless Era.include?(date: date)
-
-          target = get_target(year_list: get_year_list(date: date), date: date)
-
-          Response::SingleDay.save_single_day(
-            param: Response::SingleDay::Param.new(
-              year: target.year, month: target.month,
-              date: target.date, days: target.days
-            )
-          )
-        end
-
-        #
-        # Target 対象
-        #
-        class Target
-          # @return [Year] 年
-          attr_reader :year
-          # @return [Month] 月
-          attr_reader :month
-          # @return [Western::Calendar] 日
-          attr_reader :date
-          # @return [Integer] 月初からの日数
-          attr_reader :days
-
-          #
-          # 初期化
-          #
-          # @param [Year] year 年
-          # @param [Month] month 月
-          # @param [Western::Calendar] date 日
-          # @param [Integer] days 月初からの日数
-          #
-          def initialize(year:, month:, date:, days:)
-            @year = year
-            @month = month
-            @date = date
-            @days = days
-          end
-        end
-
-        #
-        # MonthSearchResult 1年内に該当する月を検索した結果
-        #
-        class MonthSearchResult
-          # @return [Month] 月
-          attr_reader :target_month
-          # @return [Western::Calendar] 月初日
-          attr_reader :first_date
-          # @return [True] 該当データ引き当て済
-          # @return [False] 該当データ引き当てなし
-          attr_reader :breaked
-
-          #
-          # 初期化
-          #
-          # @param [Month] target_month 月
-          # @param [Western::Calendar] first_date 月初日
-          # @param [True, False] breaked 該当データ引き当て
-          #
-          def initialize(target_month: Month.new,
-                         first_date: Western::Calendar.new, breaked:)
-            @target_month = target_month
-            @first_date = first_date
-            @breaked = breaked
-          end
-        end
-
-        #
-        # 指定日に関連する暦の範囲だけ年データを生成する
-        #
-        # @param [Western::Calendar] date 西暦日
-        #
-        # @return [Array<Year>] 年データ
-        #
-        def self.get_year_list(date:)
-          # 元号の最初の年月日を取る
-          gengou = Gengou.new(date: date.clone)
-
-          # 南北朝には元号が2つ並び、必ずしも範囲が重ならないケースもある
-          # 対象日付に重なる元号から論理和の範囲を取り、処理漏れがないようにする
-          start_date = gengou.first_date.clone
-          # 最後の年は翌年から今年の冬至を求めるため範囲を1年広げる
-          newest_date = gengou.choise_newest_gengou_date.next_year
-
-          Series.get_year_list(
-            start_gengou: gengou, start_date: start_date, end_date: newest_date
-          )
-        end
-
-        #
-        # 対象を引き当てる
-        #
-        # @param [Array<Year>] year_list 年データ
-        # @param [Western::Calendar] date 西暦日
-        #
-        # @return [Target] 対象
-        #
-        def self.get_target(year_list:, date:)
-          # 対象年/対象月を引き当てる
-          year_list.each do |year|
-            result = get_target_month(date: date, year: year)
-
-            next unless result.breaked
-
-            return Target.new(
-              year: year, month: result.target_month, date: date,
-              # 対象日に調整する
-              days: date - result.first_date
-            )
-          end
-
-          raise ArgumentError, "invalid range: #{date.format}"
-        end
-
-        # :reek:TooManyStatements { max_statements: 6 }
-
-        #
-        # 対象の月を引き当てる
-        #
-        # @param [Western::Calendar] date 西暦日
-        # @param [Year] year 年
-        #
-        # @return [MonthSearchResult] 1年内に該当する月を検索した結果
-        #
-        def self.get_target_month(date:, year:)
-          first_date = year.gengou.first_date.clone
-          year.months.each do |month|
-            # 月末の日付を超える場合
-            next_first_date = first_date.clone + month.days
-            if date < next_first_date
-              return MonthSearchResult.new(target_month: month,
-                                           first_date: first_date, breaked: true)
-            end
-            first_date = next_first_date
-          end
-          MonthSearchResult.new(breaked: false)
-        end
-      end
-
-      #
-      # Series 和暦時系列データ
-      #
-      module Series
-        # :reek:TooManyInstanceVariables { max_instance_variables: 6 }
-
-        #
-        # TimeAdvance 時間進行
-        #
-        class TimeAdvance
-          #
-          # 初期化
-          #
-          # @param [Gengou] start_gengou 開始元号
-          # @param [Western::Calendar] start_date 開始日
-          # @param [Western::Calendar] end_date 終了日
-          #
-          def initialize(start_gengou:, start_date:, end_date:)
-            @current_date = start_date.clone
-            @end_date = end_date
-            @year_list = []
-            @western_year = start_date.year
-            @year = Year.new(gengou: start_gengou)
-          end
-
-          #
-          # 年データを収集する
-          #
-          # @return [Array<Year>] 年データ
-          #
-          def collect_year_list
-            push_current_year
-
-            # 2年目以降
-            while @current_date <= @end_date
-              compensate_last_year
-
-              push_current_year
-            end
-
-            @year_list
-          end
-
-          private
-
-          #
-          # 1年データを収集する
-          #
-          # @return [Array<Month>] 1年データ
-          #
-          def collect_annual_data
-            AnnualData.collect_annual_data_after_last_november_1st(
-              western_year: @western_year
-            )
-          end
-
-          #
-          # 昨年データの不足分を補完する
-          # 昨年11月1日から今年1月1日の前日のデータを1年前データとする
-          #
-          # @return [<Type>] <description>
-          #
-          def compensate_last_year
-            last_year = @year_list[@year_list.size - 1]
-            collect_annual_data.each do |month|
-              next unless month.is_last_year
-
-              # 昨年の月データのみ
-              last_year.push(month: month)
-              @current_date += month.days
-            end
-          end
-
-          # :reek:TooManyStatements { max_statements: 7 }
-
-          #
-          # 当年データを生成する
-          #
-          def push_current_year
-            next_year
-            collect_annual_data.each do |month|
-              next if month.is_last_year
-
-              @year.push(month: month)
-              @current_date += month.days
-            end
-            @year_list.push(@year)
-
-            @western_year += 1
-          end
-
-          #
-          # 次の元号年を取得する
-          #
-          def next_year
-            return if @year_list.empty?
-
-            @year = Year.new(gengou: @year.gengou.next_year)
-          end
-        end
-
-        #
-        # 期間内の年データ全てを返す
-        #
-        # @param [Gengou] start_gengou 開始元号
-        # @param [Western::Calendar] start_date 開始日
-        # @param [Western::Calendar] end_date 終了日
-        #
-        # @return [Array<Year>] 年データ
-        #
-        def self.get_year_list(start_gengou:, start_date:, end_date:)
-          advance = TimeAdvance.new(
-            start_gengou: start_gengou, start_date: start_date, end_date: end_date
-          )
-
-          advance.collect_year_list
-        end
-      end
-    end
-  end
-end