zakuro 0.9.4 → 1.0.0

data/lib/zakuro/output/logger.rb

@@ -36,7 +36,7 @@ module Zakuro
       def debug(*messages)
         return if none?
 
-        return if LEVEL >= LEVELS[:debug]
+        return if LEVELS[:debug] < LEVEL
 
         output('DEBUG', *messages)
       end
@@ -49,7 +49,7 @@ module Zakuro
       def info(*messages)
         return if none?
 
-        return if LEVEL >= LEVELS[:info]
+        return if LEVELS[:info] < LEVEL
 
         output('INFO', *messages)
       end
@@ -63,7 +63,7 @@ module Zakuro
       def error(error, *messages)
         return if none?
 
-        return if LEVEL >= LEVELS[:error]
+        return if LEVELS[:error] < LEVEL
 
         output('ERROR', *messages)
         output('ERROR', error.message)
@@ -79,7 +79,7 @@ module Zakuro
       # @return [False] 出力あり
       #
       def none?
-        LEVEL < LEVELS[:debug]
+        LEVELS[:debug] >= LEVEL
       end
 
       #

data/lib/zakuro/parameter/catalog/basis_date.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require_relative '../../exception/exception'
+
+require 'date'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Parameter
+    # :nodoc:
+    module Catalog
+      #
+      # BasisDate 基準日
+      #
+      class BasisDate
+        # @return [Date] 西暦日
+        attr_reader :date
+
+        #
+        # 初期化
+        #
+        # @param [Date, String] date 西暦日/和暦日
+        #
+        def initialize(date:)
+          @date = date
+        end
+
+        class << self
+          #
+          # 検証する
+          #
+          # @param [Date] date 日付
+          #
+          # @return [Array<Exception::Case::Preset>] エラープリセット配列
+          #
+          def validate(date:)
+            failed = []
+            return failed unless date
+
+            return failed if date.is_a?(Date) || date.is_a?(String)
+
+            failed.push(
+              Exception::Case::Preset.new(
+                date.class,
+                template: Exception::Case::Pattern::INVALID_DATE_TYPE
+              )
+            )
+            failed
+          end
+        end
+      end
+    end
+  end
+end

data/lib/zakuro/parameter/catalog/column.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require_relative '../../exception/exception'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Parameter
+    # :nodoc:
+    module Catalog
+      #
+      # Column 特定の列（フィールド）
+      # @note 指定された列のみ出力する
+      #
+      class Column
+        # @return [Array<String>] 列
+        attr_reader :columns
+
+        #
+        # 初期化
+        #
+        # @param [Array<String>] columns 列
+        #
+        def initialize(columns: [])
+          @columns = columns
+        end
+
+        class << self
+          #
+          # 検証する
+          #
+          # @param [Array<String>] columns 列
+          #
+          # @return [Array<Exception::Case::Preset>] エラープリセット配列
+          #
+          def validate(columns:)
+            # TODO: 列内容のバリデーション
+            failed = []
+
+            return failed unless columns
+
+            return failed if columns.is_a?(Array)
+
+            failed.push(
+              Exception::Case::Preset.new(
+                hash.class,
+                template: Exception::Case::Pattern::INVALID_COLUMN_TYPE
+              )
+            )
+
+            failed
+          end
+        end
+      end
+    end
+  end
+end

data/lib/zakuro/parameter/catalog/option.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+require_relative '../../exception/exception'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Parameter
+    # :nodoc:
+    module Catalog
+      #
+      # Option オプション
+      # 取得内容を変更する
+      #
+      #   * version: 暦
+      #   * dropped_days: 没日あり
+      #   * seasons: 四季あり
+      #
+      class Option
+        # @return [Array<String>] オプション
+        attr_reader :options
+
+        #
+        # 初期化
+        #
+        # @param [Hash<Symbol, Object>] options オプション
+        #
+        def initialize(options: [])
+          @options = options
+        end
+
+        # TODO: オプションキーのバリデーション
+
+        class << self
+          #
+          # 検証する
+          #
+          # @param [Hash<Symbol, Object>] options オプション
+          #
+          # @return [Array<Exception::Case::Preset>] エラープリセット配列
+          #
+          def validate(options:)
+            failed = []
+            return failed unless options
+
+            return failed if options.is_a?(Hash)
+
+            failed.push(
+              Exception::Case::Preset.new(
+                hash.class,
+                template: Exception::Case::Pattern::INVALID_OPTION_TYPE
+              )
+            )
+            failed
+          end
+        end
+      end
+    end
+  end
+end

data/lib/zakuro/parameter/catalog/range.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+require_relative '../../exception/exception'
+
+require_relative './basis_date'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Parameter
+    # :nodoc:
+    module Catalog
+      #
+      # Range 範囲（開始日-終了日）
+      #
+      class Range
+        # @return [Date] 開始日
+        attr_reader :start
+        # @return [Date] 終了日
+        attr_reader :last
+
+        #
+        # 初期化
+        #
+        # @param [Hash<Symbol, Object>] hash パラメータ
+        # @option hash [Symbol] :start 開始日
+        # @option hash [Symbol] :start 終了日
+        #
+        def initialize(hash: {})
+          @start = hash[:start]
+          @last = hash[:last]
+        end
+
+        # :reek:TooManyStatements { max_statements: 7 }
+
+        class << self
+          #
+          # 検証する
+          #
+          # @param [Hash<Symbol, Object>] hash パラメータ
+          #
+          # @return [Array<Exception::Case::Preset>] エラープリセット
+          #
+          def validate(hash:)
+            failed = []
+            return failed unless hash
+
+            unless hash.is_a?(Hash)
+              failed.push(
+                Exception::Case::Preset.new(
+                  hash.class,
+                  template: Exception::Case::Pattern::INVALID_RANGE_TYPE
+                )
+              )
+              return failed
+            end
+
+            failed.concat(BasisDate.validate(date: hash[:start]))
+            failed.concat(BasisDate.validate(date: hash[:last]))
+
+            failed
+          end
+        end
+
+        #
+        # 不正か
+        #
+        # @return [True] 不正
+        # @return [False] 不正なし
+        #
+        def invalid?
+          return true unless @start
+
+          return true unless @end
+
+          false
+        end
+      end
+    end
+  end
+end

data/lib/zakuro/parameter/condition.rb

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+
+require_relative '../exception/exception'
+
+require_relative './catalog/basis_date'
+require_relative './catalog/column'
+require_relative './catalog/option'
+require_relative './catalog/range'
+
+# :nodoc:
+module Zakuro
+  # :nodoc:
+  module Parameter
+    #
+    # Condition 条件
+    #
+    class Condition
+      # @return [Date] 基準日
+      attr_reader :date
+      # @return [Hash<Symbol, Date>] 範囲
+      attr_reader :range
+      # @return [Array<String>] 列
+      attr_reader :columns
+      # @return [Hash<String, Object>] オプション
+      attr_reader :options
+
+      #
+      # 初期化
+      #
+      # @param [Hash<Symbol, Object>] hash パラメータ
+      # @option hash [Date] :date 基準日
+      # @option hash [Hash<Symbol, Date>] :range 範囲
+      # @option hash [Array<String>] :columns 列
+      # @option hash [Hash<String, Object>] :options オプション
+      #
+      def initialize(hash: {})
+        @date = hash[:date]
+        @range = hash[:range]
+        @columns = hash[:columns]
+        @options = hash[:options] || {}
+      end
+
+      #
+      # 上書きする
+      #
+      # @param [Hash<Symbol, Object>] hash パラメータ
+      #
+      def rewrite(hash: {})
+        instance_variables.each do |var|
+          key = var.to_s.delete('@')
+          val = hash[key.intern]
+
+          next unless val
+
+          instance_variable_set(var, val)
+        end
+      end
+
+      # :reek:TooManyStatements { max_statements: 8 }
+
+      class << self
+        #
+        # 検証する
+        #
+        # @param [Hash<Symbol, Object>] hash パラメータ
+        #
+        # @return [Array<Exception::Case::Preset>] エラープリセット配列
+        #
+        def validate(hash:)
+          failed = []
+
+          unless hash.is_a?(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
+
+        private
+
+        #
+        # ハッシュ内を検証する
+        #
+        # @param [Hash<Symbol, Object>] hash パラメータ
+        #
+        # @return [Array<Exception::Case::Preset>] エラープリセット配列
+        #
+        def validate_hash(hash:)
+          failed = []
+          failed.concat(Catalog::BasisDate.validate(date: hash[:date]))
+          failed.concat(Catalog::Range.validate(hash: hash[:range]))
+          failed.concat(Catalog::Column.validate(columns: hash[:columns]))
+          failed.concat(Catalog::Option.validate(options: hash[:options]))
+
+          failed
+        end
+      end
+    end
+  end
+end

data/lib/zakuro/result/core.rb

@@ -2,7 +2,7 @@
 
 require 'json'
 
-require_relative '../tools/stringifier'
+require_relative '../tool/stringifier'
 
 # :nodoc:
 module Zakuro
@@ -25,7 +25,7 @@ module Zakuro
       # @return [Hash<String, Object>] ハッシュ
       #
       def to_h
-        Tools::Stringifier.to_h(obj: self, class_prefix: 'Zakuro::Result')
+        Tool::Stringifier.to_h(obj: self, class_prefix: 'Zakuro::Result')
       end
 
       #

data/lib/zakuro/{tools → tool}/remainder_comparer.rb

@@ -4,14 +4,12 @@ require_relative '../output/logger'
 
 require_relative '../calculation/cycle/abstract_remainder'
 
-# TODO: Tools -> Tool
-
 # :nodoc:
 module Zakuro
   #
-  # Tools 汎用メソッド群
+  # Tool 汎用メソッド群
   #
-  module Tools
+  module Tool
     #
     # RemainderComparer 大余小余比較
     #

data/lib/zakuro/{tools → tool}/stringifier.rb

@@ -5,9 +5,9 @@ require_relative './typeof'
 # :nodoc:
 module Zakuro
   #
-  # Tools 汎用メソッド群
+  # Tool 汎用メソッド群
   #
-  module Tools
+  module Tool
     #
     # Stringifier 文字列処理
     #
@@ -48,7 +48,7 @@ module Zakuro
           return obj unless obj
 
           # 日付をフォーマットする
-          return obj.format if formatted && Tools::Typeof.time?(obj: obj)
+          return obj.format if formatted && Tool::Typeof.time?(obj: obj)
 
           # 同じモジュール内のオブジェクトは再帰する
           if obj.class.name.start_with?(class_prefix)

data/lib/zakuro/{tools → tool}/typeconv.rb

@@ -5,9 +5,9 @@ require_relative '../output/logger'
 # :nodoc:
 module Zakuro
   #
-  # Tools 汎用メソッド群
+  # Tool 汎用メソッド群
   #
-  module Tools
+  module Tool
     # :reek:UncommunicativeVariableName {accept: e}
 
     #

data/lib/zakuro/{tools → tool}/typeof.rb

@@ -7,9 +7,9 @@ require_relative '../era/western/calendar'
 # :nodoc:
 module Zakuro
   #
-  # Tools 汎用メソッド群
+  # Tool 汎用メソッド群
   #
-  module Tools
+  module Tool
     #
     # Typeof 型判定
     #

data/lib/zakuro/version/daien/const/number.rb

@@ -3,53 +3,56 @@
 # :nodoc:
 module Zakuro
   # :nodoc:
-  module Daien
-    #
-    # Const 定数
-    #
-    module Const
+  module Version
+    # :nodoc:
+    module Daien
       #
-      # Number 数値
+      # Const 定数
       #
-      module Number
+      module Const
         #
-        # Cycle 周期
+        # Number 数値
         #
-        module Cycle
-          # @return [Integer] 通法（1日=3040分）
-          DAY = 3040
+        module Number
           #
-          # @return [Float] 転日（1近点月 = 27日1685分79秒（1分=80秒））
-          # @note 小数点以下の値によって大幅に結果が変わる。除算結果を設定した
+          # Cycle 周期
           #
-          ANOMALISTIC_MONTH = 83_765 + (79.0 / 80)
-          # @return [Integer] 朔望月
-          SYNODIC_MONTH = 89_773
-          # @return [Integer] 一年
-          YEAR = 1_110_343
-        end
+          module Cycle
+            # @return [Integer] 通法（1日=3040分）
+            DAY = 3040
+            #
+            # @return [Float] 転日（1近点月 = 27日1685分79秒（1分=80秒））
+            # @note 小数点以下の値によって大幅に結果が変わる。除算結果を設定した
+            #
+            ANOMALISTIC_MONTH = 83_765 + (79.0 / 80)
+            # @return [Integer] 朔望月
+            SYNODIC_MONTH = 89_773
+            # @return [Integer] 一年
+            YEAR = 1_110_343
+          end
 
-        #
-        # Derivation 導出
-        #
-        module Derivation
-          # @return [Integer] 通余:  (YEAR - DAY * 12 * 30)
-          #   1110343 - 1094400
-          REMAINDER_ALL_YEAR = 15_943
-          # @return [Integer] 旬周（60日） DAY * 60
-          SIXTY_DAYS = 182_400
-          # @return [Integer] 朔虚分: (30 * 3040) % (29 * 3040 + 1613)
-          REMAINDER_IDEAL_MONTH = 1427
-        end
+          #
+          # Derivation 導出
+          #
+          module Derivation
+            # @return [Integer] 通余:  (YEAR - DAY * 12 * 30)
+            #   1110343 - 1094400
+            REMAINDER_ALL_YEAR = 15_943
+            # @return [Integer] 旬周（60日） DAY * 60
+            SIXTY_DAYS = 182_400
+            # @return [Integer] 朔虚分: (30 * 3040) % (29 * 3040 + 1613)
+            REMAINDER_IDEAL_MONTH = 1427
+          end
 
-        #
-        # 累積
-        #
-        module Stack
-          # @return [Integer] 積年（甲子夜半朔旦冬至〜暦の開始前）
-          TOTAL_YEAR = 96_961_740
-          # @return [Integer] 暦の開始年（開元12年）
-          BEGIN_YEAR = 724
+          #
+          # 累積
+          #
+          module Stack
+            # @return [Integer] 積年（甲子夜半朔旦冬至〜暦の開始前）
+            TOTAL_YEAR = 96_961_740
+            # @return [Integer] 暦の開始年（開元12年）
+            BEGIN_YEAR = 724
+          end
         end
       end
     end

data/lib/zakuro/version/daien/const/remainder.rb

@@ -5,52 +5,55 @@ require_relative '../cycle/remainder'
 # :nodoc:
 module Zakuro
   # :nodoc:
-  module Daien
-    #
-    # Const 定数
-    #
-    module Const
+  module Version
+    # :nodoc:
+    module Daien
       #
-      # Remainder 大余小余
+      # Const 定数
       #
-      module Remainder
+      module Const
         #
-        # Solar 太陽
+        # Remainder 大余小余
         #
-        module Solar
-          # @return [Remainder] 気策（24分の1年）
-          # 1年（1_110_343） / 24 / 1日（3040）= 15 余り 664.2916666666642
-          #   * 0.2916666666642 * 24（1分=24秒） = 6.999999999940799 ≒ 7
-          SOLAR_TERM_AVERAGE = Cycle::Remainder.new(day: 15, minute: 664, second: 7)
+        module Remainder
           #
-          # @note 揲法 89773 = 29-1613
-          #   * 89773 / 4 = 22443.25 / 3040 = 7 余り 1163.25
-          #   * 0.25 * 24（1分=24秒） = 6
+          # Solar 太陽
           #
-          # @return [Cycle::Remainder] 弦（1分=80秒）
-          QUARTER = Cycle::Remainder.new(day: 7, minute: 1163, second: 6)
+          module Solar
+            # @return [Remainder] 気策（24分の1年）
+            # 1年（1_110_343） / 24 / 1日（3040）= 15 余り 664.2916666666642
+            #   * 0.2916666666642 * 24（1分=24秒） = 6.999999999940799 ≒ 7
+            SOLAR_TERM_AVERAGE = Cycle::Remainder.new(day: 15, minute: 664, second: 7)
+            #
+            # @note 揲法 89773 = 29-1613
+            #   * 89773 / 4 = 22443.25 / 3040 = 7 余り 1163.25
+            #   * 0.25 * 24（1分=24秒） = 6
+            #
+            # @return [Cycle::Remainder] 弦（1分=80秒）
+            QUARTER = Cycle::Remainder.new(day: 7, minute: 1163, second: 6)
 
-          # @return [Cycle::Remainder] 有没判定
-          DROPPED_DATE_LIMIT = Cycle::Remainder.new(day: 0, minute: 2375, second: 17)
+            # @return [Cycle::Remainder] 有没判定
+            DROPPED_DATE_LIMIT = Cycle::Remainder.new(day: 0, minute: 2375, second: 17)
 
-          # @return [Cycle::Remainder] 有滅判定
-          VANISHED_DATE_LIMIT = Cycle::Remainder.new(day: 0, minute: 1427, second: 0)
-        end
+            # @return [Cycle::Remainder] 有滅判定
+            VANISHED_DATE_LIMIT = Cycle::Remainder.new(day: 0, minute: 1427, second: 0)
+          end
 
-        #
-        # Lunar 月
-        #
-        module Lunar
-          # @return [Cycle::LunarRemainder] 転日（1近点月）
-          ANOMALISTIC_MONTH = \
-            Cycle::LunarRemainder.new(day: 27, minute: 1685, second: 79)
           #
-          # @note 揲法 89773 = 29-1613
-          #   * 89773 / 4 = 22443.25 / 3040 = 7 余り 1163.25
-          #   * 0.25 * 80（1分=80秒） = 20
+          # Lunar 月
           #
-          # @return [Cycle::LunarRemainder] 弦（1分=80秒）
-          QUARTER = Cycle::LunarRemainder.new(day: 7, minute: 1163, second: 20)
+          module Lunar
+            # @return [Cycle::LunarRemainder] 転日（1近点月）
+            ANOMALISTIC_MONTH = \
+              Cycle::LunarRemainder.new(day: 27, minute: 1685, second: 79)
+            #
+            # @note 揲法 89773 = 29-1613
+            #   * 89773 / 4 = 22443.25 / 3040 = 7 余り 1163.25
+            #   * 0.25 * 80（1分=80秒） = 20
+            #
+            # @return [Cycle::LunarRemainder] 弦（1分=80秒）
+            QUARTER = Cycle::LunarRemainder.new(day: 7, minute: 1163, second: 20)
+          end
         end
       end
     end