zakuro 0.7.0 → 0.7.2

data/lib/zakuro/calculation/summary/western/single.rb

@@ -23,7 +23,7 @@ module Zakuro
           #
           # 生成する
           #
-          # @param [Context] context 暦コンテキスト
+          # @param [Context::Context] context 暦コンテキスト
           # @param [Western::Calendar] date 西暦日
           #
           # @return [Result::Single] 一日検索結果（和暦日）
@@ -44,10 +44,10 @@ module Zakuro
           #
           # 完全範囲を取得する
           #
-          # @param [Context] context 暦コンテキスト
+          # @param [Context::Context] context 暦コンテキスト
           # @param [Western::Calendar] date 西暦日
           #
-          # @return [Array<Base::Year>] 完全範囲
+          # @return [Array<Calculation::Base::Year>] 完全範囲
           #
           def self.get_full_range_years(context:, date: Western::Calendar.new)
             full_range = Calculation::Range::DatedFullRange.new(context: context, start_date: date)
@@ -58,8 +58,8 @@ module Zakuro
           #
           # 運用結果範囲を取得する
           #
-          # @param [Context] context 暦コンテキスト
-          # @param [Array<Base::Year>] years 完全範囲
+          # @param [Context::Context] context 暦コンテキスト
+          # @param [Array<Calculation::Base::Year>] years 完全範囲
           # @param [Western::Calendar] date 西暦日
           #
           # @return [Array<Base::OperatedYear>] 運用結果範囲
@@ -75,8 +75,8 @@ module Zakuro
           #
           # 1日を取得する
           #
-          # @param [Context] context 暦コンテキスト
-          # @param [Array<Base::Year>] years 完全範囲
+          # @param [Context::Context] context 暦コンテキスト
+          # @param [Array<Calculation::Base::Year>] years 完全範囲
           # @param [Western::Calendar] date 西暦日
           #
           # @return [Data::SingleDay] 1日
@@ -93,10 +93,10 @@ module Zakuro
           #
           # 完全範囲を取得する
           #
-          # @param [Context] context 暦コンテキスト
+          # @param [Array<Calculation::Base::Year>] years 完全範囲
           # @param [Western::Calendar] date 西暦日
           #
-          # @return [Array<Base::Year>] 完全範囲
+          # @return [Array<Calculation::Base::Year>] 完全範囲
           #
           def self.get_operation(years:, date: Western::Calendar.new)
             calc_date = Specifier::SingleDay.get(

data/lib/zakuro/calculation/summary/western/specifier/multiple_day.rb

@@ -28,15 +28,18 @@ module Zakuro
             #
             # 取得する
             #
-            # @param [Array<Base::Year>] years 範囲
+            # @param [Context::Context] context 暦コンテキスト
+            # @param [Array<Calculation::Base::Year>] years 範囲
             # @param [Western::Calendar] start_date 西暦開始日
             # @param [Western::Calendar] last_date 西暦終了日
             #
             # @return [Array<Result::Data::SingleDay>] 期間検索結果（和暦日）
             #
-            def self.get(years: [], start_date: Western::Calendar.new,
+            def self.get(context:, years: [], start_date: Western::Calendar.new,
                          last_date: Western::Calendar.new)
-              months = specify(years: years, start_date: start_date, last_date: last_date)
+              months = specify(
+                context: context, years: years, start_date: start_date, last_date: last_date
+              )
 
               result = []
               months.each do |month|
@@ -49,18 +52,19 @@ module Zakuro
             #
             # 年を特定する
             #
-            # @param [Array<Year>] years 範囲
+            # @param [Context::Context] context 暦コンテキスト
+            # @param [Array<Calculation::Base::Year>] years 範囲
             # @param [Western::Calendar] start_date 西暦開始日
             # @param [Western::Calendar] last_date 西暦終了日
             #
             # @return [Array<Month>] 特定月
             #
-            def self.specify(years: [], start_date: Western::Calendar.new,
+            def self.specify(context:, years: [], start_date: Western::Calendar.new,
                              last_date: Western::Calendar.new)
               result = []
               years.each do |year|
                 result |= specify_month(
-                  year: year, start_date: start_date, last_date: last_date
+                  context: context, year: year, start_date: start_date, last_date: last_date
                 )
               end
 
@@ -73,13 +77,14 @@ module Zakuro
             #
             # 月を特定する
             #
-            # @param [Year] year 年
+            # @param [Context::Context] context 暦コンテキスト
+            # @param [Calculation::Base::Year] year 年
             # @param [Western::Calendar] start_date 西暦開始日
             # @param [Western::Calendar] last_date 西暦終了日
             #
             # @return [Month] 対象月
             #
-            def self.specify_month(year:, start_date: Western::Calendar.new,
+            def self.specify_month(context:, year:, start_date: Western::Calendar.new,
                                    last_date: Western::Calendar.new)
               months = year.months
 
@@ -95,7 +100,7 @@ module Zakuro
                 monthly_last_date = last_date.clone if last_date < monthly_last_date
 
                 specify_months.push(
-                  Month.new(year: year, month: month,
+                  Month.new(context: context, year: year, month: month,
                             start_date: monthly_start_date, last_date: monthly_last_date)
                 )
               end
@@ -107,7 +112,7 @@ module Zakuro
             #
             # 月が範囲に含まれるか
             #
-            # @param [Monthly::Month] month 月
+            # @param [Calculation::Monthly::Month] month 月
             # @param [Western::Calendar] start_date 西暦開始日
             # @param [Western::Calendar] last_date 西暦終了日
             #

data/lib/zakuro/calculation/summary/western/specifier/single_day.rb

@@ -6,6 +6,9 @@ require_relative '../../../../output/logger'
 
 require_relative '../../../base/year'
 
+require_relative '../../internal/day'
+require_relative '../../internal/option'
+
 # :nodoc:
 module Zakuro
   # :nodoc:
@@ -26,20 +29,20 @@ module Zakuro
             #
             # 取得する
             #
-            # @param [Array<Year>] yeas 範囲
+            # @param [Array<Calculation::Base::Year>] years 範囲
             # @param [Western::Calendar] date 西暦日
             #
             # @return [Result::Data::SingleDay] 和暦日
             #
             def self.get(years: [], date: Western::Calendar.new)
               year, month = specify(years: years, date: date)
-              first_date = month.western_date
 
-              Output::Response::SingleDay.save_single_day(
-                param: Output::Response::SingleDay::Param.new(
-                  year: year, month: month,
-                  date: date, days: date - first_date
-                )
+              day = Day.get(month: month, date: date)
+
+              options = Option.create(month: month, day: day)
+
+              Output::Response::SingleDay.create(
+                year: year, month: month, day: day, options: options
               )
             end
 
@@ -52,6 +55,8 @@ module Zakuro
             # @return [Base::Year] 対象年
             # @return [Monthly::Month] 対象月
             #
+            # @raise [ArgumentError] 引数エラー
+            #
             def self.specify(years:, date:)
               years.each do |year|
                 month = specify_month(year: year, date: date)

data/lib/zakuro/calculation/type/optional.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Calculation
+    # :nodoc:
+    module Type
+      #
+      # Optional 参照管理
+      #
+      # * インスタンスのnil操作を避ける
+      # * safe navigation operator を使用しない
+      #
+      class Optional
+        #
+        # 初期化
+        #
+        # @param [Object] obj インスタンス
+        #
+        def initialize(obj: nil)
+          @obj = obj
+        end
+
+        #
+        # インスタンスを取得する
+        #
+        # @return [Object] インスタンス
+        #
+        def get
+          @obj
+        end
+
+        #
+        # 不正か
+        #
+        # @return [True] 不正
+        # @return [False] 不正なし
+        #
+        def invalid?
+          @obj.nil?
+        end
+      end
+    end
+  end
+end

data/lib/zakuro/condition.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require_relative './exception/exception'
+
 require 'date'
 
 # :nodoc:
@@ -29,7 +31,7 @@ module Zakuro
       #
       # @param [Date] date 日付
       #
-      # @return [Array<String>] エラーメッセージ
+      # @return [Array<Exception::Case::Preset>] エラープリセット配列
       #
       def self.validate(date:)
         failed = []
@@ -37,7 +39,12 @@ module Zakuro
 
         return failed if date.is_a?(Date) || date.is_a?(String)
 
-        failed.push("invalid date: #{date}")
+        failed.push(
+          Exception::Case::Preset.new(
+            date.class,
+            template: Exception::Case::Pattern::INVALID_DATE_TYPE
+          )
+        )
         failed
       end
     end
@@ -54,7 +61,7 @@ module Zakuro
       #
       # 初期化
       #
-      # @param [Hash<Symbol>] hash パラメータ
+      # @param [Hash<Symbol, Object>] hash パラメータ
       # @option hash [Symbol] :start 開始日
       # @option hash [Symbol] :start 終了日
       #
@@ -68,16 +75,21 @@ module Zakuro
       #
       # 検証する
       #
-      # @param [Hash<Symbol>] hash パラメータ
+      # @param [Hash<Symbol, Object>] hash パラメータ
       #
-      # @return [Array<String>] エラーメッセージ
+      # @return [Array<Exception::Case::Preset>] エラープリセット
       #
       def self.validate(hash:)
         failed = []
         return failed unless hash
 
         unless hash.is_a?(Hash)
-          failed.push("invalid range type. #{hash}. should be hash")
+          failed.push(
+            Exception::Case::Preset.new(
+              hash.class,
+              template: Exception::Case::Pattern::INVALID_RANGE_TYPE
+            )
+          )
           return failed
         end
 
@@ -124,7 +136,7 @@ module Zakuro
       #
       # @param [Array<String>] columns 列
       #
-      # @return [Array<String>] エラーメッセージ
+      # @return [Array<Exception::Case::Preset>] エラープリセット配列
       #
       def self.validate(columns:)
         # TODO: 列内容のバリデーション
@@ -134,7 +146,12 @@ module Zakuro
 
         return failed if columns.is_a?(Array)
 
-        failed.push("invalid columns type. #{columns}. should be array")
+        failed.push(
+          Exception::Case::Preset.new(
+            hash.class,
+            template: Exception::Case::Pattern::INVALID_COLUMN_TYPE
+          )
+        )
 
         failed
       end
@@ -144,8 +161,8 @@ module Zakuro
     # Options オプション
     # 取得内容を変更する
     #
-    #   * unit: 年/月/日
-    #   * lost_days: 没日あり
+    #   * version: 暦
+    #   * dropped_days: 没日あり
     #   * seasons: 四季あり
     #
     class Options
@@ -155,7 +172,7 @@ module Zakuro
       #
       # 初期化
       #
-      # @param [Array<String>] options オプション
+      # @param [Hash<Symbol, Object>] options オプション
       #
       def initialize(options: [])
         @options = options
@@ -166,9 +183,9 @@ module Zakuro
       #
       # 検証する
       #
-      # @param [Array<String>] options オプション
+      # @param [Hash<Symbol, Object>] options オプション
       #
-      # @return [Array<String>] エラーメッセージ
+      # @return [Array<Exception::Case::Preset>] エラープリセット配列
       #
       def self.validate(options:)
         failed = []
@@ -176,8 +193,12 @@ module Zakuro
 
         return failed if options.is_a?(Hash)
 
-        failed.push("invalid options type. #{options}. should be hash")
-
+        failed.push(
+          Exception::Case::Preset.new(
+            hash.class,
+            template: Exception::Case::Pattern::INVALID_OPTION_TYPE
+          )
+        )
         failed
       end
     end
@@ -193,7 +214,7 @@ module Zakuro
     attr_reader :range
     # @return [Array<String>] 列
     attr_reader :columns
-    # @return [Array<String>] オプション
+    # @return [Hash<String, Object>] オプション
     attr_reader :options
 
     #
@@ -203,13 +224,13 @@ module Zakuro
     # @option hash [Date] :date 基準日
     # @option hash [Hash<Symbol, Date>] :range 範囲
     # @option hash [Array<String>] :columns 列
-    # @option hash [Array<String>] :options オプション
+    # @option hash [Hash<String, Object>] :options オプション
     #
     def initialize(hash: {})
       @date = hash[:date]
       @range = hash[:range]
       @columns = hash[:columns]
-      @options = hash[:options]
+      @options = hash[:options] || {}
     end
 
     # :reek:TooManyStatements { max_statements: 8 }
@@ -219,16 +240,35 @@ module Zakuro
     #
     # @param [Hash<Symbol, Object>] hash パラメータ
     #
-    # @return [Array<String>] エラーメッセージ
+    # @return [Array<Exception::Case::Preset>] エラープリセット配列
     #
     def self.validate(hash:)
       failed = []
 
       unless hash.is_a?(Hash)
-        failed.push("invalid condition type. #{hash}. should be hash")
+        failed.push(
+          Exception::Case::Preset.new(
+            hash.class,
+            template: Exception::Case::Pattern::INVALID_CONDITION_TYPE
+          )
+        )
         return failed
       end
 
+      failed.concat(validate_hash(hash: hash))
+
+      failed
+    end
+
+    #
+    # ハッシュ内を検証する
+    #
+    # @param [Hash<Symbol, Object>] hash パラメータ
+    #
+    # @return [Array<Exception::Case::Preset>] エラープリセット配列
+    #
+    def self.validate_hash(hash:)
+      failed = []
       failed.concat(Catalog::BasisDate.validate(date: hash[:date]))
       failed.concat(Catalog::Range.validate(hash: hash[:range]))
       failed.concat(Catalog::Columns.validate(columns: hash[:columns]))

data/lib/zakuro/context/context.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require_relative './option'
+
+require_relative './version_class_resolver'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Context
+    #
+    # Context 暦コンテキスト
+    #
+    class Context
+      # @return [Option] オプション
+      attr_reader :option
+      # @return [VersionClassResolver] 暦リゾルバー
+      attr_reader :resolver
+
+      #
+      # 初期化
+      #
+      # @param [Hash<String, Object>] options オプション値
+      #
+      # @raise [ArgumentError] 引数エラー
+      #
+      def initialize(version: Option::INVALID_VERSION_NAME, options: {})
+        @option = Option.new(default_version: version, hash: options)
+
+        @resolver = VersionClassResolver.new(version_name: option.version)
+      end
+
+      #
+      # 不正か
+      #
+      # @return [True] 不正
+      # @return [False] 不正なし
+      #
+      def invalid?
+        !@option.version?
+      end
+    end
+  end
+end

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