zakuro 0.6.0 → 0.7.2

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

@@ -0,0 +1,113 @@
+# frozen_string_literal: true
+
+require_relative '../../range/dated_operation_range'
+
+require_relative '../../range/dated_full_range'
+
+require_relative './specifier/single_day'
+
+require_relative '../internal/operation'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Calculation
+    # :nodoc:
+    module Summary
+      # :nodoc:
+      module Western
+        #
+        # Single 一日
+        #
+        module Single
+          #
+          # 生成する
+          #
+          # @param [Context::Context] context 暦コンテキスト
+          # @param [Western::Calendar] date 西暦日
+          #
+          # @return [Result::Single] 一日検索結果（和暦日）
+          #
+          def self.get(context:, date: Western::Calendar.new)
+            years = get_full_range_years(context: context, date: date)
+
+            data = get_data(context: context, years: years, date: date)
+
+            operation = get_operation(years: years, date: date)
+
+            Result::Single.new(
+              data: data,
+              operation: operation
+            )
+          end
+
+          #
+          # 完全範囲を取得する
+          #
+          # @param [Context::Context] context 暦コンテキスト
+          # @param [Western::Calendar] date 西暦日
+          #
+          # @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)
+            full_range.get
+          end
+          private_class_method :get_full_range_years
+
+          #
+          # 運用結果範囲を取得する
+          #
+          # @param [Context::Context] context 暦コンテキスト
+          # @param [Array<Calculation::Base::Year>] years 完全範囲
+          # @param [Western::Calendar] date 西暦日
+          #
+          # @return [Array<Base::OperatedYear>] 運用結果範囲
+          #
+          def self.get_operation_range_years(context:, years:, date: Western::Calendar.new)
+            operation_range = Calculation::Range::DatedOperationRange.new(
+              context: context, start_date: date, years: years
+            )
+            operation_range.get
+          end
+          private_class_method :get_operation_range_years
+
+          #
+          # 1日を取得する
+          #
+          # @param [Context::Context] context 暦コンテキスト
+          # @param [Array<Calculation::Base::Year>] years 完全範囲
+          # @param [Western::Calendar] date 西暦日
+          #
+          # @return [Data::SingleDay] 1日
+          #
+          def self.get_data(context:, years:, date: Western::Calendar.new)
+            operated_years = get_operation_range_years(context: context, years: years, date: date)
+
+            Specifier::SingleDay.get(
+              years: operated_years, date: date
+            )
+          end
+          private_class_method :get_data
+
+          #
+          # 完全範囲を取得する
+          #
+          # @param [Array<Calculation::Base::Year>] years 完全範囲
+          # @param [Western::Calendar] date 西暦日
+          #
+          # @return [Array<Calculation::Base::Year>] 完全範囲
+          #
+          def self.get_operation(years:, date: Western::Calendar.new)
+            calc_date = Specifier::SingleDay.get(
+              years: years, date: date
+            )
+
+            Operation.create(calc_date: calc_date)
+          end
+          private_class_method :get_operation
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,174 @@
+# frozen_string_literal: true
+
+require_relative '../../../../era/western/calendar'
+require_relative '../../../../output/response'
+require_relative '../../../../output/logger'
+
+require_relative '../../../base/year'
+
+require_relative '../../internal/month'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Calculation
+    # :nodoc:
+    module Summary
+      # :nodoc:
+      module Western
+        # :nodoc:
+        module Specifier
+          #
+          # MultipleDay 複数日検索
+          #
+          module MultipleDay
+            # @return [Output::Logger] ロガー
+            LOGGER = Output::Logger.new(location: 'specifier')
+
+            #
+            # 取得する
+            #
+            # @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(context:, years: [], start_date: Western::Calendar.new,
+                         last_date: Western::Calendar.new)
+              months = specify(
+                context: context, years: years, start_date: start_date, last_date: last_date
+              )
+
+              result = []
+              months.each do |month|
+                result |= month.get
+              end
+
+              result
+            end
+
+            #
+            # 年を特定する
+            #
+            # @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(context:, years: [], start_date: Western::Calendar.new,
+                             last_date: Western::Calendar.new)
+              result = []
+              years.each do |year|
+                result |= specify_month(
+                  context: context, year: year, start_date: start_date, last_date: last_date
+                )
+              end
+
+              result
+            end
+            private_class_method :specify
+
+            # :reek:TooManyStatements { max_statements: 7 }
+
+            #
+            # 月を特定する
+            #
+            # @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(context:, year:, start_date: Western::Calendar.new,
+                                   last_date: Western::Calendar.new)
+              months = year.months
+
+              specify_months = []
+              months.each do |month|
+                next unless include?(month: month, start_date: start_date, last_date: last_date)
+
+                monthly_start_date = month.western_date.clone
+                monthly_last_date = month.last_date.clone
+
+                monthly_start_date = start_date.clone if start_date > monthly_start_date
+
+                monthly_last_date = last_date.clone if last_date < monthly_last_date
+
+                specify_months.push(
+                  Month.new(context: context, year: year, month: month,
+                            start_date: monthly_start_date, last_date: monthly_last_date)
+                )
+              end
+
+              specify_months
+            end
+            private_class_method :specify_month
+
+            #
+            # 月が範囲に含まれるか
+            #
+            # @param [Calculation::Monthly::Month] month 月
+            # @param [Western::Calendar] start_date 西暦開始日
+            # @param [Western::Calendar] last_date 西暦終了日
+            #
+            # @return [True] 含む
+            # @return [False] 含まない
+            #
+            def self.include?(month:, start_date:, last_date:)
+              monthly_start_date = month.western_date.clone
+              monthly_last_date = month.last_date.clone
+
+              return false if monthly_start_date.invalid?
+
+              return false if monthly_last_date.invalid?
+
+              return false if under(monthly_start_date: monthly_start_date,
+                                    start_date: start_date, last_date: last_date)
+
+              return false if over(monthly_last_date: monthly_last_date,
+                                   start_date: start_date, last_date: last_date)
+
+              true
+            end
+            private_class_method :include?
+
+            #
+            # 範囲が月より前にあるか
+            #
+            # @param [Western::Calendar] monthly_start_date 月初日
+            # @param [Western::Calendar] start_date 西暦開始日
+            # @param [Western::Calendar] last_date 西暦終了日
+            #
+            # @return [True] 前にある
+            # @return [False] 前にない
+            #
+            def self.under(monthly_start_date:, start_date:, last_date:)
+              start_date < monthly_start_date && last_date < monthly_start_date
+            end
+            private_class_method :under
+
+            #
+            # 範囲が月より後にあるか
+            #
+            # @param [Western::Calendar] monthly_start_date 月末日
+            # @param [Western::Calendar] start_date 西暦開始日
+            # @param [Western::Calendar] last_date 西暦終了日
+            #
+            # @return [True] 後にある
+            # @return [False] 後にない
+            #
+            def self.over(monthly_last_date:, start_date:, last_date:)
+              start_date > monthly_last_date && last_date > monthly_last_date
+            end
+            private_class_method :over
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+require_relative '../../../../era/western/calendar'
+require_relative '../../../../output/response'
+require_relative '../../../../output/logger'
+
+require_relative '../../../base/year'
+
+require_relative '../../internal/day'
+require_relative '../../internal/option'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Calculation
+    # :nodoc:
+    module Summary
+      # :nodoc:
+      module Western
+        # :nodoc:
+        module Specifier
+          #
+          # SingleDay 一日検索
+          #
+          module SingleDay
+            # @return [Output::Logger] ロガー
+            LOGGER = Output::Logger.new(location: 'specifier')
+
+            #
+            # 取得する
+            #
+            # @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)
+
+              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
+
+            #
+            # 年を特定する
+            #
+            # @param [Array<Year>] years 範囲
+            # @param [Western::Calendar] date 西暦日
+            #
+            # @return [Base::Year] 対象年
+            # @return [Monthly::Month] 対象月
+            #
+            # @raise [ArgumentError] 引数エラー
+            #
+            def self.specify(years:, date:)
+              years.each do |year|
+                month = specify_month(year: year, date: date)
+                return year, month unless month.invalid?
+              end
+
+              raise ArgumentError, "invalid year range. date: #{date.format}"
+            end
+            private_class_method :specify
+
+            # :reek:TooManyStatements { max_statements: 7 }
+
+            #
+            # 月を特定する
+            #
+            # @param [Base::Year] year 年
+            # @param [Western::Calendar] date 西暦日
+            #
+            # @return [Monthly::Month] 対象月
+            #
+            def self.specify_month(year:, date:)
+              months = year.months
+
+              months.each do |month|
+                western_date = month.western_date
+                next if western_date.invalid?
+
+                return month if month.include?(date: date)
+              end
+
+              Monthly::Month.new
+            end
+            private_class_method :specify_month
+          end
+        end
+      end
+    end
+  end
+end

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:
@@ -18,10 +20,9 @@ module Zakuro
       #
       # 初期化
       #
-      # @param [Date] date 西暦日
+      # @param [Date, String] date 西暦日/和暦日
       #
       def initialize(date:)
-        # TODO: 和暦日（String）から西暦日（Date）への変換
         @date = date
       end
 
@@ -30,7 +31,7 @@ module Zakuro
       #
       # @param [Date] date 日付
       #
-      # @return [Array<String>] エラーメッセージ
+      # @return [Array<Exception::Case::Preset>] エラープリセット配列
       #
       def self.validate(date:)
         failed = []
@@ -38,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
@@ -55,7 +61,7 @@ module Zakuro
       #
       # 初期化
       #
-      # @param [Hash<Symbol>] hash パラメータ
+      # @param [Hash<Symbol, Object>] hash パラメータ
       # @option hash [Symbol] :start 開始日
       # @option hash [Symbol] :start 終了日
       #
@@ -69,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
 
@@ -87,6 +98,20 @@ module Zakuro
 
         failed
       end
+
+      #
+      # 不正か
+      #
+      # @return [True] 不正
+      # @return [False] 不正なし
+      #
+      def invalid?
+        return true unless @start
+
+        return true unless @end
+
+        false
+      end
     end
 
     #
@@ -111,7 +136,7 @@ module Zakuro
       #
       # @param [Array<String>] columns 列
       #
-      # @return [Array<String>] エラーメッセージ
+      # @return [Array<Exception::Case::Preset>] エラープリセット配列
       #
       def self.validate(columns:)
         # TODO: 列内容のバリデーション
@@ -121,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
@@ -131,8 +161,8 @@ module Zakuro
     # Options オプション
     # 取得内容を変更する
     #
-    #   * unit: 年/月/日
-    #   * lost_days: 没日あり
+    #   * version: 暦
+    #   * dropped_days: 没日あり
     #   * seasons: 四季あり
     #
     class Options
@@ -142,7 +172,7 @@ module Zakuro
       #
       # 初期化
       #
-      # @param [Array<String>] options オプション
+      # @param [Hash<Symbol, Object>] options オプション
       #
       def initialize(options: [])
         @options = options
@@ -153,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 = []
@@ -163,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
@@ -180,7 +214,7 @@ module Zakuro
     attr_reader :range
     # @return [Array<String>] 列
     attr_reader :columns
-    # @return [Array<String>] オプション
+    # @return [Hash<String, Object>] オプション
     attr_reader :options
 
     #
@@ -190,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 }
@@ -206,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