zakuro 0.6.0 → 0.6.1

data/lib/zakuro/era/japan/gengou.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 require_relative '../western/calendar'
-require_relative './gengou/parser'
-require_relative './gengou/type'
+
+require_relative './gengou/alignment'
 
 # :nodoc:
 module Zakuro
@@ -11,95 +11,56 @@ module Zakuro
   #
   module Japan
     #
-    # GengouResource 元号情報
+    # Gengou 元号
     #
-    module GengouResource
-      # @return [Array<Set>] 元号セット情報リスト
-      LIST = [
-        Parser.run(filepath: File.expand_path(
-          './gengou/yaml/set-001-until-south.yaml',
-          __dir__
-        )),
-        Parser.run(filepath: File.expand_path(
-          './gengou/yaml/set-002-from-north.yaml',
-          __dir__
-        )),
-        Parser.run(filepath: File.expand_path(
-          './gengou/yaml/set-003-modern.yaml',
-          __dir__
-        ))
-      ].freeze
-
-      # :reek:TooManyStatements { max_statements: 9 }
-
-      #
-      # 元号（1行目,2行目）を引き当てる
-      #
-      # * LIST配列の元号情報を配列順で「x行目」（1始まり）とする
-      # * 1行目にデータがあれば、第一要素に1行目のデータが設定される
-      # * 1行目と2行目にデータがあれば、第二要素に2行目のデータが設定される
-      # * 1行目にデータがなく、2行目以降に1つだけデータがあれば、第一要素にそのデータを設定してそれ以外の要素は未設定
-      # * 1行目にデータがなく、2行目以降に2つ以上のデータがあれば、第一要素に末尾行に一番近いデータを設定してそれ以外の要素は未設定
-      #
-      # @param [Western::Calendar] date 日
-      #
-      # @return [Array<Gengou>] 元号情報（1行目, 2行目）
-      #
-      def self.lines(date:)
-        lines = native_lines(date: date)
-        return lines unless lines[0].invalid?
-
-        first = Japan::Gengou.new
-        lines[1..].each.with_index(1) do |item, index|
-          next if item.invalid?
+    module Gengou
+      # @return [Integer] 1行目
+      FIRST_LINE = Alignment::Aligner::FIRST_LINE
+      # @return [Integer] 2行目
+      SECOND_LINE = Alignment::Aligner::SECOND_LINE
 
-          first = item
-          lines[index] = Japan::Gengou.new
-        end
-        lines[0] = first
-        lines
-      end
-
-      #
-      # 元号を引き当てる
       #
-      # * LISTから単純に元号を引き当てる
-      # * 1行目,2行目といった概念は無視する
+      # 該当行の元号を取得する
       #
-      # @param [Western::Calendar] date 日
+      # @param [Integer] line 行番号
+      # @param [Western::Calendar] start_date 開始日
+      # @param [Western::Calendar] last_date 終了日
       #
-      # @return [Array<Gengou>] 元号情報
+      # @return [Array<LinearGengou>] 該当行の元号
       #
-      def self.native_lines(date:)
-        result = Array.new(LIST.size)
-        LIST.each_with_index do |set, index|
-          result[index] = set.include_item(date: date)
-        end
-        result
+      def self.line(line: FIRST_LINE,
+                    start_date: Western::Calendar.new, last_date: Western::Calendar.new)
+        Alignment.get(
+          line: line, start_date: start_date, last_date: last_date
+        )
       end
 
       #
-      # 「日本暦日原典」1行目の元号を返す
+      # 1行目元号を取得する
       #
-      # @param [Western::Calendar] date 日
+      # @param [Western::Calendar] start_date 開始日
+      # @param [Western::Calendar] last_date 終了日
       #
-      # @return [Gengou] 元号情報（1行目）
+      # @return [Array<LinearGengou>] 1行目元号
       #
-      def self.first_line(date:)
-        lines = lines(date: date)
-        lines[0].clone
+      def self.first_line(start_date: Western::Calendar.new, last_date: Western::Calendar.new)
+        Alignment.get(
+          line: FIRST_LINE, start_date: start_date, last_date: last_date
+        )
       end
 
       #
-      # 「日本暦日原典」2行目の元号を返す
+      # 2行目元号を取得する
       #
-      # @param [Western::Calendar] date 日
+      # @param [Western::Calendar] start_date 開始日
+      # @param [Western::Calendar] last_date 終了日
       #
-      # @return [Gengou] 元号情報（2行目）
+      # @return [Array<LinearGengou>] 2行目元号
       #
-      def self.second_line(date:)
-        lines = lines(date: date)
-        lines[1].clone
+      def self.second_line(start_date: Western::Calendar.new, last_date: Western::Calendar.new)
+        Alignment.get(
+          line: SECOND_LINE, start_date: start_date, last_date: last_date
+        )
       end
     end
   end

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

@@ -23,7 +23,7 @@ module Zakuro
         # @return [Integer] 開始西暦年
         attr_reader :start_year
         # @return [Integer] 終了西暦年
-        attr_reader :end_year
+        attr_reader :last_year
         # @return [True] リリース済
         # @return [False] 未リリース
         attr_reader :released
@@ -34,20 +34,20 @@ module Zakuro
         # @param [String] name 暦名
         # @param [Western::Calendar] start_date 暦の開始日
         # @param [Integer] start_year 開始西暦年
-        # @param [Integer] end_year 終了西暦年
+        # @param [Integer] last_year 終了西暦年
         # @param [True, False] released リリース済 / 未リリース
         #
-        def initialize(name:, start_date:, start_year:, end_year:, released:)
+        def initialize(name:, start_date:, start_year:, last_year:, released:)
           @name = name
           @start_date = start_date
           @start_year = start_year
-          @end_year = end_year
+          @last_year = last_year
           @released = released
         end
       end
 
       # TODO: yamlにする
-      # TODO: end_year は不要
+      # TODO: last_year は不要
 
       # @return [Array<Range>] 全和暦
       LIST = [
@@ -56,7 +56,7 @@ module Zakuro
           name: 'Genka',
           start_date: Western::Calendar.new(year: 445, month: 1, day: 24),
           start_year: 445,
-          end_year: 697,
+          last_year: 697,
           released: true
         ),
         # 文武天皇02年01月01日
@@ -64,7 +64,7 @@ module Zakuro
           name: 'Gihou',
           start_date: Western::Calendar.new(year: 698, month: 2, day: 16),
           start_year: 698,
-          end_year: 763,
+          last_year: 763,
           released: true
         ),
         # 天平宝字08年01月01日
@@ -72,7 +72,7 @@ module Zakuro
           name: 'Daien',
           start_date: Western::Calendar.new(year: 764, month: 2, day: 7),
           start_year: 764,
-          end_year: 861,
+          last_year: 861,
           released: true
         ),
         # 貞観02年01月01日
@@ -80,7 +80,7 @@ module Zakuro
           name: 'Senmyou',
           start_date: Western::Calendar.new(year: 862, month: 2, day: 3),
           start_year: 862,
-          end_year: 1684,
+          last_year: 1684,
           released: true
         ),
         # 貞享02年01月01日
@@ -88,7 +88,7 @@ module Zakuro
           name: 'Joukyou',
           start_date: Western::Calendar.new(year: 1685, month: 2, day: 4),
           start_year: 1685,
-          end_year: 1754,
+          last_year: 1754,
           released: false
         ),
         # 宝暦05年01月01日
@@ -96,7 +96,7 @@ module Zakuro
           name: 'Houryaku',
           start_date: Western::Calendar.new(year: 1755, month: 2, day: 11),
           start_year: 1755,
-          end_year: 1797,
+          last_year: 1797,
           released: false
         ),
         # 寛政10年01月01日
@@ -104,7 +104,7 @@ module Zakuro
           name: 'Kansei',
           start_date: Western::Calendar.new(year: 1798, month: 2, day: 16),
           start_year: 1798,
-          end_year: 1843,
+          last_year: 1843,
           released: false
         ),
         # 天保13年01月01日
@@ -112,7 +112,7 @@ module Zakuro
           name: 'Tenpou',
           start_date: Western::Calendar.new(year: 1844, month: 2, day: 18),
           start_year: 1844,
-          end_year: 1867,
+          last_year: 1867,
           released: false
         ),
         # 明治01年09月08日
@@ -120,7 +120,7 @@ module Zakuro
           name: 'Gregorio',
           start_date: Western::Calendar.new(year: 1868, month: 10, day: 23),
           start_year: 1868,
-          end_year: 9999,
+          last_year: 9999,
           released: false
         )
       ].freeze
@@ -129,17 +129,17 @@ module Zakuro
       # 年を基準に暦を引き当てる
       #
       # @param [Integer] start_year 開始西暦年
-      # @param [Integer] end_year 終了西暦年
+      # @param [Integer] last_year 終了西暦年
       #
       # @return [Array<Range>] 和暦
       #
-      def self.ranges_with_year(start_year:, end_year:)
+      def self.ranges_with_year(start_year:, last_year:)
         result = []
 
         LIST.each do |range|
-          next if start_year > range.end_year
+          next if start_year > range.last_year
 
-          next if end_year < range.start_year
+          next if last_year < range.start_year
 
           result.push(range)
         end

data/lib/zakuro/merchant.rb

@@ -4,6 +4,8 @@ require_relative './era/western/calendar'
 
 require_relative './calculation/summary/single'
 
+require_relative './calculation/summary/range'
+
 require_relative './condition'
 
 require_relative './output/error'
@@ -50,19 +52,55 @@ module Zakuro
     # 承諾する
     #
     # @return [Result::SingleDay] 和暦日
+    # @return [Result::Range] 和暦日範囲
     #
     def commit
       date = condition.date
 
-      # TODO: does not have no patterns now
-      return {} unless date
+      return single(date: date) if date
+
+      range = condition.range
+
+      return range(range: range) if range
+
+      {}
+    end
+
+    private
 
+    #
+    # 1日検索
+    #
+    # @param [Date] date 西暦日
+    #
+    # @return [Result::Single] 検索結果
+    #
+    def single(date:)
       western_date = Western::Calendar.create(date: date)
 
-      # TODO: 引数不要
+      # TODO: condition で設定する
       context = Context.new(version_name: '')
 
       Calculation::Summary::Single.get(context: context, date: western_date)
     end
+
+    #
+    # 期間検索
+    #
+    # @param [Catalog::Range] range 期間
+    #
+    # @return [Result::Range] 和暦日範囲
+    #
+    def range(range:)
+      start_date = Western::Calendar.create(date: range[:start])
+      last_date = Western::Calendar.create(date: range[:last])
+
+      # TODO: condition で設定する
+      context = Context.new(version_name: '')
+
+      Calculation::Summary::Range.get(
+        context: context, start_date: start_date, last_date: last_date
+      )
+    end
   end
 end

data/lib/zakuro/operation/month/validator.rb

@@ -150,7 +150,7 @@ module Zakuro
         # @return [String] ID
         attr_reader :id
         # @return [String] 親ID
-        attr_reader :parend_id
+        attr_reader :parent_id
         # @return [String] 西暦日
         attr_reader :western_date
         # @return [String] 有効行

data/lib/zakuro/result/result.rb

@@ -33,5 +33,22 @@ module Zakuro
         @operation = operation
       end
     end
+
+    #
+    # Range 期間検索結果
+    #
+    class Range < Core
+      attr_reader :list
+
+      #
+      # 初期化
+      #
+      # @param [Array<Data::Single>] list 期間内データ
+      #
+      def initialize(list: [])
+        super
+        @list = list
+      end
+    end
   end
 end

data/lib/zakuro/version/senmyou/README.md

@@ -94,21 +94,25 @@
 
 計算の多くはそれぞれの暦に依存するが、まずは共通の計算部分を列挙する
 
-### ある元号の2年目以降について
+### 元号の求め方
 
-各元号の1年（元年）の始まりは固定値のため、西暦にて開始日を持つ（例: 正慶1年1月1日 = 1332/01/28）
+元慶（877-6-1 ～ 885-3-10）をもとに考える
 
-日本の旧暦（太陰太陽暦）において、元号は1月1日を境に改元または継続する
+元号開始年が存在する元号年（877）から、次の元号の開始年（885） + 1 までを和暦計算する。これをAとする
 
-NOTE: これは『日本暦日原典』をベースにした場合であり、多くの場合、実際の改元は1月1日ではない [返却される元号が実際の存在期間と一致しない](https://github.com/pldb/zakuro/issues/3)
+元号のはじまりは固定値のため、西暦開始日と、それに対応する和暦開始日を持つ（例: 元慶01年04月16日 = 877-6-1）
 
-ここで問題となるのは、元号2年目以降はその前年までの計算結果が必要になることである
+この和暦開始日は必ずAの1年目に存在するため、1年目の和暦日を特定し、その日と西暦開始日を関連付ける
 
-西暦（太陽暦）のように1年あたりの日数は一定しない
+もし元慶2年以降を計算したい場合は、Aの西暦開始日から該当年月日までを加算で求める
+
+具体的には、和暦上の月の大小（29日 or 30日）を用いた加算となる
+
+念のため補足するが、西暦（太陽暦）のように1年あたりの日数は一定しない
 
 平年（353/354/355/356）または閏年(383/384/385）のパターンがあり、月の大小（29/30）や閏月（中気のない月）の有無で変動する
 
-この日数を求めることで、初めて2年目の開始日が求められる（1332/01/28 + 355日 = 1333/1/17 = 正慶2年1月1日）
+したがって、2年目以降を加算なしに特定することはできない
 
 ### 南北朝について
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: zakuro
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.6.1
 platform: ruby
 authors:
 - pldb
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-01-15 00:00:00.000000000 Z
+date: 2022-03-02 00:00:00.000000000 Z
 dependencies: []
 description: mainly lunar solar calendar
 email:
@@ -48,11 +48,16 @@ files:
 - lib/zakuro/calculation/cycle/abstract_remainder.rb
 - lib/zakuro/calculation/cycle/abstract_solar_term.rb
 - lib/zakuro/calculation/cycle/zodiac.rb
-- lib/zakuro/calculation/gengou/internal/counter.rb
-- lib/zakuro/calculation/gengou/internal/reserve.rb
-- lib/zakuro/calculation/gengou/internal/reserve/interval.rb
-- lib/zakuro/calculation/gengou/internal/reserve/list.rb
-- lib/zakuro/calculation/gengou/scroll.rb
+- lib/zakuro/calculation/era/gengou/internal/connector.rb
+- lib/zakuro/calculation/era/gengou/internal/counter.rb
+- lib/zakuro/calculation/era/gengou/internal/publisher.rb
+- lib/zakuro/calculation/era/gengou/internal/reserve.rb
+- lib/zakuro/calculation/era/gengou/internal/reserve/list.rb
+- lib/zakuro/calculation/era/gengou/internal/reserve/range.rb
+- lib/zakuro/calculation/era/gengou/scroll.rb
+- lib/zakuro/calculation/era/version/internal/crawler.rb
+- lib/zakuro/calculation/era/version/internal/range.rb
+- lib/zakuro/calculation/era/version/version.rb
 - lib/zakuro/calculation/monthly/abstract_lunar_phase.rb
 - lib/zakuro/calculation/monthly/first_day.rb
 - lib/zakuro/calculation/monthly/initialized_month.rb
@@ -65,26 +70,33 @@ files:
 - lib/zakuro/calculation/range/operated_solar_terms.rb
 - lib/zakuro/calculation/range/transfer/gengou_scroller.rb
 - lib/zakuro/calculation/range/transfer/year_boundary.rb
+- lib/zakuro/calculation/specifier/internal/month.rb
+- lib/zakuro/calculation/specifier/multiple_day.rb
 - lib/zakuro/calculation/specifier/single_day.rb
 - lib/zakuro/calculation/stella/lunar/abstract_location.rb
 - lib/zakuro/calculation/stella/lunar/choukei_value.rb
 - lib/zakuro/calculation/stella/solar/abstract_average.rb
 - lib/zakuro/calculation/stella/solar/abstract_location.rb
 - lib/zakuro/calculation/stella/solar/choukei_value.rb
+- lib/zakuro/calculation/summary/internal/operation.rb
+- lib/zakuro/calculation/summary/range.rb
 - lib/zakuro/calculation/summary/single.rb
 - lib/zakuro/calculation/type/old_float.rb
-- lib/zakuro/calculation/version/internal/crawler.rb
-- lib/zakuro/calculation/version/internal/range.rb
-- lib/zakuro/calculation/version/version.rb
 - lib/zakuro/condition.rb
 - lib/zakuro/era/japan/calendar.rb
 - lib/zakuro/era/japan/gengou.rb
-- lib/zakuro/era/japan/gengou/parser.rb
-- lib/zakuro/era/japan/gengou/type.rb
-- lib/zakuro/era/japan/gengou/validator.rb
-- lib/zakuro/era/japan/gengou/yaml/set-001-until-south.yaml
-- lib/zakuro/era/japan/gengou/yaml/set-002-from-north.yaml
-- lib/zakuro/era/japan/gengou/yaml/set-003-modern.yaml
+- lib/zakuro/era/japan/gengou/alignment.rb
+- lib/zakuro/era/japan/gengou/alignment/aligner.rb
+- lib/zakuro/era/japan/gengou/alignment/division.rb
+- lib/zakuro/era/japan/gengou/alignment/line.rb
+- lib/zakuro/era/japan/gengou/alignment/linear_gengou.rb
+- lib/zakuro/era/japan/gengou/resource.rb
+- lib/zakuro/era/japan/gengou/resource/parser.rb
+- lib/zakuro/era/japan/gengou/resource/type.rb
+- lib/zakuro/era/japan/gengou/resource/validator.rb
+- lib/zakuro/era/japan/gengou/resource/yaml/set-001-until-south.yaml
+- lib/zakuro/era/japan/gengou/resource/yaml/set-002-from-north.yaml
+- lib/zakuro/era/japan/gengou/resource/yaml/set-003-modern.yaml
 - lib/zakuro/era/japan/version.rb
 - lib/zakuro/era/western/calendar.rb
 - lib/zakuro/merchant.rb
@@ -187,7 +199,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
@@ -202,8 +214,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
-signing_key: 
+rubygems_version: 3.1.2
+signing_key:
 specification_version: 4
 summary: japanese calendar library.
 test_files: []

data/lib/zakuro/calculation/gengou/internal/counter.rb

@@ -1,129 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../../../era/japan/gengou'
-require_relative '../../../era/japan/calendar'
-require_relative '../../../era/western/calendar'
-
-# :nodoc:
-module Zakuro
-  # :nodoc:
-  module Calculation
-    # :nodoc:
-    module Gengou
-      #
-      # Counter 加算元号
-      #
-      class Counter
-        # @return [Integer] 不正値
-        INVALID_YEAR = -1
-
-        # @return [Japan::Gengou] 元号
-        attr_reader :gengou
-        # @return [Integer] 元号年
-        attr_reader :japan_year
-        # @return [Integer] 西暦年
-        attr_reader :western_year
-
-        #
-        # 初期化
-        #
-        # @param [Japan::Gengou] gengou 元号
-        #
-        def initialize(gengou: Japan::Gengou.new)
-          @gengou = gengou
-          @japan_year = gengou.both_start_year.japan
-          @western_year = gengou.both_start_year.western
-        end
-
-        #
-        # 和暦開始日を取得する
-        #
-        # @return [Japan::Calendar] 和暦開始日
-        #
-        def japan_start_date
-          return Japan::Calendar.new if @gengou.invalid?
-
-          @gengou.both_start_date.japan
-        end
-
-        #
-        # 西暦開始日を取得する
-        #
-        # @return [Western::Calendar] 西暦開始日
-        #
-        def western_start_date
-          return Western::Calendar.new if @gengou.invalid?
-
-          @gengou.both_start_date.western
-        end
-
-        #
-        # 西暦終了日を取得する
-        #
-        # @return [Western::Calendar] 西暦終了日
-        #
-        def western_end_date
-          return Western::Calendar.new if @gengou.invalid?
-
-          @gengou.end_date
-        end
-
-        #
-        # 次年にする
-        #
-        # @return [MultiGengou] 自身
-        #
-        def next_year
-          @japan_year += 1
-          @western_year += 1
-
-          self
-        end
-
-        #
-        # 元号名を取得する
-        #
-        # @return [String] 元号名
-        #
-        def name
-          return '' unless @gengou
-
-          @gengou.name
-        end
-
-        #
-        # 不正か
-        #
-        # @return [True] 不正
-        # @return [False] 不正なし
-        #
-        def invalid?
-          @gengou.invalid? || @japan_year == INVALID_YEAR || @western_year == INVALID_YEAR
-        end
-
-        #
-        # 指定した日が元号に含まれるか
-        #
-        # @param [Western::Calendar] date 日
-        #
-        # @return [True] 含まれる
-        # @return [False] 含まれない
-        #
-        def include?
-          @gengou.include?
-        end
-
-        #
-        # ディープコピー
-        #
-        # @param [MultiGengou] obj 自身
-        #
-        def initialize_copy(obj)
-          @gengou = obj.gengou.clone
-          @japan_year = obj.japan_year
-          @western_year = obj.western_year
-        end
-      end
-    end
-  end
-end