zakuro 0.6.0 → 0.7.2

data/lib/zakuro/context/option.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Context
+    #
+    # Option オプション値
+    #
+    class Option
+      # @return [String] 無効暦名
+      INVALID_VERSION_NAME = ''
+      # @return [Array<String>] 暦名
+      VERSION_NAMES = %w[Genka Gihou Daien Senmyou Joukyou Kansei Tenpou Gregorio].freeze
+
+      # @return [String] 没日オプションキー名
+      DROPPED_DATE_KEY = 'dropped_date'
+
+      # @return [Hash<String, Object>] オプション値
+      attr_reader :hash
+      # @return [String] デフォルト暦名
+      attr_reader :default_version
+
+      #
+      # 初期化
+      #
+      # @param [String] default_version デフォルト暦名
+      #
+      # @param [Hash<String, Object>] options オプション値
+      #
+      def initialize(default_version: INVALID_VERSION_NAME, hash: {})
+        @default_version = default_version
+        @hash = hash
+      end
+
+      #
+      # 暦名を返す
+      #
+      # @return [String] 暦名
+      #
+      def version
+        version = self.class.version(version: @default_version)
+
+        return version if self.class.version?(version: version)
+
+        version = hash['version']
+
+        self.class.version(version: version)
+      end
+
+      #
+      # 有効なデフォルト暦名か
+      #
+      # @return [True] 有効
+      # @return [False] 無効
+      #
+      def default_version?
+        self.class.version?(version: @default_version)
+      end
+
+      #
+      # 有効な暦名か
+      #
+      # @return [True] 有効
+      # @return [False] 無効
+      #
+      def version?
+        self.class.version?(version: version)
+      end
+
+      #
+      # 没日か
+      #
+      # @return [True] 没日あり
+      # @return [False] 没日なし
+      #
+      def dropped_date?
+        value = @hash[DROPPED_DATE_KEY]
+
+        return true if value.is_a?(TrueClass)
+
+        false
+      end
+
+      #
+      # 暦名を返す
+      #
+      # @param [String] version 暦名
+      #
+      # @return [String] 暦名
+      #
+      def self.version(version: INVALID_VERSION_NAME)
+        return INVALID_VERSION_NAME unless version
+
+        return INVALID_VERSION_NAME if version.empty?
+
+        return INVALID_VERSION_NAME unless VERSION_NAMES.include?(version)
+
+        version
+      end
+
+      #
+      # 有効な暦か
+      #
+      # @param [String] version 暦名
+      #
+      # @return [True] 有効
+      # @return [False] 無効
+      #
+      def self.version?(version: INVALID_VERSION_NAME)
+        return false if version == INVALID_VERSION_NAME
+
+        true
+      end
+    end
+  end
+end

data/lib/zakuro/context/version_class_resolver.rb

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+require_relative '../version/genka/cycle/remainder'
+require_relative '../version/genka/cycle/solar_term'
+require_relative '../version/genka/range/annual_range'
+require_relative '../version/genka/option/dropped_date/parameter'
+
+require_relative '../version/gihou/cycle/remainder'
+require_relative '../version/gihou/cycle/solar_term'
+require_relative '../version/gihou/range/annual_range'
+require_relative '../version/gihou/option/dropped_date/parameter'
+
+require_relative '../version/daien/cycle/remainder'
+require_relative '../version/daien/cycle/solar_term'
+require_relative '../version/daien/range/annual_range'
+require_relative '../version/daien/option/dropped_date/parameter'
+
+require_relative '../version/senmyou/cycle/remainder'
+require_relative '../version/senmyou/cycle/solar_term'
+require_relative '../version/senmyou/range/annual_range'
+require_relative '../version/senmyou/option/dropped_date/parameter'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Context
+    #
+    # VersionClassResolver 暦リゾルバー
+    #
+    class VersionClassResolver
+      # @return [String] 暦名
+      attr_reader :version_name
+
+      # @return [Hash<String, String>] 関連
+      CLASSES = {
+        'remainder' => 'Zakuro::$VERSION::Cycle::Remainder',
+        'solar_term' => 'Zakuro::$VERSION::Cycle::SolarTerm',
+        'annual_range' => 'Zakuro::$VERSION::Range::AnnualRange',
+        'dropped_date_parameter' => 'Zakuro::$VERSION::Option::DroppedDate::Parameter'
+      }.freeze
+
+      #
+      # 初期化
+      #
+      # @param [String] version_name 暦名
+      #
+      def initialize(version_name:)
+        @version_name = version_name
+      end
+
+      #
+      # 該当の暦のクラスを取得する
+      #
+      # @param [String] version_name 暦名
+      # @param [String] class_name クラス名
+      #
+      # @return [Object] 該当クラス
+      #
+      # @raise [ArgumentError] 引数エラー
+      #
+      def self.get_class(version_name:, class_name:)
+        constant = CLASSES.fetch(class_name, '')
+
+        raise ArgumentError.new, 'invalid class name' if constant == ''
+
+        resolved_constant = constant.gsub('$VERSION', version_name)
+
+        Object.const_get(resolved_constant)
+      end
+
+      #
+      # 大余小余（暦別）クラスを返す
+      #
+      # @return [Class] 大余小余（暦別）クラス
+      #
+      def remainder
+        VersionClassResolver.get_class(version_name: @version_name, class_name: 'remainder')
+      end
+
+      #
+      # 二十四節気クラスを返す
+      #
+      # @return [Class] 二十四節気クラス
+      #
+      def solar_term
+        VersionClassResolver.get_class(version_name: @version_name, class_name: 'solar_term')
+      end
+
+      #
+      # 年間範囲クラスを返す
+      #
+      # @return [Class] 年間範囲クラス
+      #
+      def annual_range
+        VersionClassResolver.get_class(version_name: @version_name, class_name: 'annual_range')
+      end
+
+      #
+      # 没日引数を返す
+      #
+      # @return [Class] 没日引数クラス
+      #
+      def dropped_date_parameter
+        VersionClassResolver.get_class(
+          version_name: @version_name, class_name: 'dropped_date_parameter'
+        )
+      end
+    end
+  end
+end

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

@@ -0,0 +1,125 @@
+# frozen_string_literal: true
+
+require_relative '../../../western/calendar'
+
+require_relative './line'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Japan
+    # :nodoc:
+    module Gengou
+      #
+      # Alignment 整列
+      #
+      module Alignment
+        #
+        # Aligner 元号整列
+        #
+        class Aligner
+          # @return [Integer] 1行目元号
+          FIRST_LINE = 0
+
+          # @return [Integer] 2行目元号
+          SECOND_LINE = 1
+
+          # @return [Array<Integer>] 元号リスト
+          LINE_INDEXES = [FIRST_LINE, SECOND_LINE].freeze
+
+          # @return [Integer] 行数
+          LINE_SIZE = LINE_INDEXES.size
+
+          # @return [Array<Line>] 行元号
+          attr_reader :lines
+
+          #
+          # 初期化
+          #
+          # @param [Array<Set>] resources 元号解析結果
+          #
+          def initialize(resources: [])
+            @lines = []
+            (1..LINE_SIZE).each do |_index|
+              @lines.push(Line.new)
+            end
+
+            save(resources: resources)
+          end
+
+          #
+          # 行元号に追加する
+          #
+          # @param [Set] set 元号セット
+          #
+          def push(set:)
+            list = set.list
+            list.each do |gengou|
+              push_gengou(gengou: gengou)
+            end
+          end
+
+          #
+          # 指定した範囲内の元号を取得する
+          #
+          # @param [Integer] line 行
+          # @param [Western::Calendar] start_date 開始日
+          # @param [Western::Calendar] last_date 終了日
+          #
+          # @return [Array<LinearGengou>] 元号
+          #
+          # @raise [ArgumentError] 引数エラー
+          #
+          def get(line:, start_date:, last_date:)
+            raise ArgumentError.new, 'invalid line number' unless LINE_INDEXES.include?(line)
+
+            @lines[line].get(start_date: start_date, last_date: last_date)
+          end
+
+          #
+          # 指定した範囲内の元号を取得する（元号名）
+          #
+          # @param [Integer] line 行
+          # @param [String] name 元号名
+          #
+          # @return [Array<LinearGengou>] 元号
+          #
+          # @raise [ArgumentError] 引数エラー
+          #
+          def get_by_name(line:, name:)
+            raise ArgumentError.new, 'invalid line number' unless LINE_INDEXES.include?(line)
+
+            @lines[line].get_by_name(name: name)
+          end
+
+          private
+
+          #
+          # 保存する
+          #
+          # @param [Array<Set>] resources 元号解析結果
+          #
+          def save(resources: [])
+            resources.each do |set|
+              push(set: set)
+            end
+          end
+
+          #
+          # 元号を追加する
+          #
+          # @param [Gengou] gengou 元号
+          #
+          def push_gengou(gengou:)
+            rest = [
+              LinearGengou.new(gengou: gengou)
+            ]
+            @lines.each do |line|
+              rest = line.push(list: rest)
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,168 @@
+# frozen_string_literal: true
+
+require_relative './linear_gengou'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Japan
+    # :nodoc:
+    module Gengou
+      # :nodoc:
+      module Alignment
+        #
+        # Division 元号区分
+        #
+        module Division
+          #
+          # 重複した範囲を返す
+          #
+          # @param [LinearGengou] this 残り元号
+          # @param [LinearGengou] other 比較元号
+          #
+          # @return [Array<LinearGengou>] 重複分
+          #
+          def self.match(this:, other:)
+            result = []
+            if other.in?(start_date: this.start_date, last_date: this.last_date)
+              result.push(this)
+              return result
+            end
+
+            if other.out?(start_date: this.start_date, last_date: this.last_date)
+              # 該当なし
+              return result
+            end
+
+            if other.covered?(start_date: this.start_date, last_date: this.last_date)
+              # 範囲内のみ返す
+              result.push(trim_gengou(this: this, other: other))
+              return result
+            end
+
+            result.push(narrow_gengou(this: this, other: other))
+
+            result
+          end
+
+          #
+          # 範囲が重複しない差分を返す
+          #
+          # @param [LinearGengou] this 積元号
+          # @param [LinearGengou] other 比較元号
+          #
+          # @return [Array<LinearGengou>] 差分
+          #
+          def self.mismatch(this:, other:)
+            result = []
+            if other.in?(start_date: this.start_date, last_date: this.last_date)
+              # 該当なし
+              return result
+            end
+
+            if other.out?(start_date: this.start_date, last_date: this.last_date)
+              result.push(this)
+              return result
+            end
+
+            if other.covered?(start_date: this.start_date, last_date: this.last_date)
+              result |= split_gengou(this: this, other: other)
+              return result
+            end
+
+            result.push(shave_gengou(this: this, other: other))
+            result
+          end
+
+          #
+          # 比較により分離した元号をつなげる
+          #
+          # @param [Array<LinearGengou>] list 元号
+          #
+          # @return [Array<LinearGengou>] 同一元号がつながった元号
+          #
+          def self.connect(list: []) # rubocop:disable Metrics/MethodLength
+            result = []
+            list.each do |linear_gengou|
+              if result.size.zero?
+                result.push(linear_gengou)
+                next
+              end
+
+              before = result[-1]
+
+              if unconnectable?(current: linear_gengou, before: before)
+                result.push(linear_gengou)
+                next
+              end
+
+              result[-1] = LinearGengou.new(
+                start_date: before.start_date, last_date: linear_gengou.last_date,
+                gengou: linear_gengou.gengou
+              )
+            end
+
+            result
+          end
+
+          def self.unconnectable?(current:, before:)
+            return true unless current.gengou.name == before.gengou.name
+
+            return true unless (before.last_date.clone + 1) == current.start_date
+
+            false
+          end
+          private_class_method :unconnectable?
+
+          def self.split_gengou(this:, other:)
+            [
+              LinearGengou.new(
+                start_date: this.start_date.clone, last_date: other.start_date.clone - 1,
+                gengou: this.gengou
+              ),
+              LinearGengou.new(
+                start_date: other.last_date.clone + 1, last_date: this.last_date.clone,
+                gengou: this.gengou
+              )
+            ]
+          end
+          private_class_method :split_gengou
+
+          def self.trim_gengou(this:, other:)
+            LinearGengou.new(
+              start_date: other.start_date, last_date: other.last_date,
+              gengou: this.gengou
+            )
+          end
+          private_class_method :trim_gengou
+
+          def self.narrow_gengou(this:, other:)
+            start = this.start_date > other.start_date ? this.start_date : other.start_date
+            last = this.last_date < other.last_date ? this.last_date : other.last_date
+
+            LinearGengou.new(
+              start_date: start.clone, last_date: last.clone, gengou: this.gengou
+            )
+          end
+          private_class_method :narrow_gengou
+
+          def self.shave_gengou(this:, other:) # rubocop:disable Metrics/AbcSize
+            start = this.start_date
+            last = this.last_date
+
+            # 開始日が比較元号の開始日より前の範囲
+            last = other.start_date.clone - 1 if this.start_date < other.start_date
+
+            # 終了日が比較元号の開始日より後の範囲
+            start = other.last_date.clone + 1 if this.last_date > other.last_date
+
+            LinearGengou.new(
+              start_date: start.clone, last_date: last.clone, gengou: this.gengou
+            )
+          end
+          private_class_method :shave_gengou
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,175 @@
+# frozen_string_literal: true
+
+require_relative './division'
+
+require_relative './linear_gengou'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Japan
+    # :nodoc:
+    module Gengou
+      # :nodoc:
+      module Alignment
+        #
+        # Line 行
+        #
+        class Line
+          # @return [Array<LinearGengou>] 元号
+          attr_reader :list
+
+          #
+          # 初期化
+          #
+          def initialize
+            @list = []
+          end
+
+          #
+          # 追加する
+          #
+          # 下記のパターンが存在し、戻り値は重複分となる
+          #
+          # 1. 完全に範囲外（開始日より前）
+          #   [@list]:      |-------|-------|
+          #   [list]:  |---|
+          # 2. 前半のみ範囲外
+          #   [@list]:      |-------|-------|
+          #   [list]:  |------|
+          # 3. 範囲内
+          #   [@list]: |-------|-------|
+          #   [list]:  |------|
+          # 4. 後半のみ範囲外
+          #   [@list]: |-------|-------|
+          #   [list]:              |------|
+          # 5. 完全に範囲外（開始日より後）
+          #   [@list]: |-------|-------|
+          #   [list]:                   |----|
+          # 6. 両端が範囲外
+          #   [@list]:   |-------|-------|
+          #   [list]:  |--------------------|
+          #
+          # @param [Array<LinearGengou>] list 元号
+          #
+          # @return [Array<LinearGengou>] 未登録元号
+          #
+          def push(list: [])
+            rest = rest(list: list)
+
+            insert(list: list)
+
+            rest
+          end
+
+          #
+          # 範囲内の元号を取得する
+          #
+          # @param [Western::Calendar] start_date 開始日
+          # @param [Western::Calendar] last_date 終了日
+          #
+          # @return [Array<LinearGengou>] 元号
+          #
+          def get(start_date:, last_date:)
+            result = []
+            @list.each do |gengou|
+              next if gengou.out?(start_date: start_date, last_date: last_date)
+
+              # 1日でも範囲内であれば対象とみなす
+              result.push(gengou)
+            end
+
+            result
+          end
+
+          #
+          # 範囲内の元号を取得する（元号名）
+          #
+          # @param [String] name 元号名
+          #
+          # @return [Array<LinearGengou>] 元号
+          #
+          def get_by_name(name:)
+            result = []
+            @list.each do |gengou|
+              result.push(gengou) if gengou.name == name
+            end
+
+            result
+          end
+
+          private
+
+          #
+          # 重複分（空きがないため追加できない範囲の元号）を返す
+          #
+          # @param [Array<LinearGengou>] list 元号
+          #
+          # @return [Array<LinearGengou>] 重複分元号
+          #
+          def rest(list: [])
+            result = []
+
+            @list.each do |gengou|
+              result |= and!(rest: list, other: gengou)
+            end
+
+            Division.connect(list: result)
+          end
+
+          #
+          # 空き範囲に元号を登録する
+          #
+          # @param [Array<LinearGengou>] list 元号
+          #
+          def insert(list: [])
+            surplus_result = list.clone
+            @list.each do |gengou|
+              surplus_result = not!(surplus: surplus_result, other: gengou)
+            end
+
+            surplus_result = Division.connect(list: surplus_result)
+
+            surplus_result.each do |gengou|
+              @list.push(gengou)
+            end
+          end
+
+          #
+          # 重複した範囲を返す
+          #
+          # @param [Array<LinearGengou>] rest 残り元号
+          # @param [LinearGengou] other 比較元号
+          #
+          # @return [Array<LinearGengou>] 重複分
+          #
+          def and!(rest:, other:)
+            result = []
+            rest.each do |gengou|
+              result |= Division.match(this: gengou, other: other)
+            end
+
+            result
+          end
+
+          #
+          # 範囲が重複しない差分を返す
+          #
+          # @param [Array<LinearGengou>] surplus 積元号
+          # @param [LinearGengou] other 比較元号
+          #
+          # @return [Array<LinearGengou>] 差分
+          #
+          def not!(surplus:, other:)
+            result = []
+            surplus.each do |gengou|
+              result |= Division.mismatch(this: gengou, other: other)
+            end
+
+            result
+          end
+        end
+      end
+    end
+  end
+end