zakuro 0.7.0 → 0.9.0

data/lib/zakuro/era/western/calendar.rb

@@ -58,26 +58,28 @@ module Zakuro
       Type::DEFAULT => Date::ITALY
     }.freeze
 
-    #
-    # 日付種別からRuby標準のグレゴリオ暦開始日を引き当てる
-    #
-    # @param [Symbol] type 日付種別
-    #
-    # @return [Integer] Ruby標準のグレゴリオ暦開始日
-    #
-    def self.to_native_start(type:)
-      DATE_START.fetch(type, DATE_START[Type::DEFAULT])
-    end
+    class << self
+      #
+      # 日付種別からRuby標準のグレゴリオ暦開始日を引き当てる
+      #
+      # @param [Symbol] type 日付種別
+      #
+      # @return [Integer] Ruby標準のグレゴリオ暦開始日
+      #
+      def to_native_start(type:)
+        DATE_START.fetch(type, DATE_START[Type::DEFAULT])
+      end
 
-    #
-    # Ruby標準のグレゴリオ暦開始日から日付種別を引き当てる
-    #
-    # @param [Integer] start Ruby標準のグレゴリオ暦開始日
-    #
-    # @return [Symbol] 日付種別
-    #
-    def self.to_type(start:)
-      DATE_START.invert.fetch(start, Type::DEFAULT)
+      #
+      # Ruby標準のグレゴリオ暦開始日から日付種別を引き当てる
+      #
+      # @param [Integer] start Ruby標準のグレゴリオ暦開始日
+      #
+      # @return [Symbol] 日付種別
+      #
+      def to_type(start:)
+        DATE_START.invert.fetch(start, Type::DEFAULT)
+      end
     end
 
     #
@@ -131,8 +133,16 @@ module Zakuro
     # 定数 DATE_START のバリエーションで日付オブジェクトを初期化するだけで良い
     #
     class Calendar # rubocop:disable Metrics/ClassLength
-      attr_reader :param, :date
+      # @return [Parameter] 初期化引数
+      attr_reader :param
+      # @return [Date] 日付（Ruby日付型）
+      attr_reader :date
 
+      #
+      # 検証する
+      #
+      # @return [Array<String>] エラー文字列
+      #
       def validate
         failed = valid_type
 
@@ -150,9 +160,9 @@ module Zakuro
       #
       def valid_type
         failed = []
-        year = @param.year
-        month = @param.month
-        day = @param.day
+        year = param.year
+        month = param.month
+        day = param.day
         failed.push("wrong type. year: #{year}") unless year.is_a?(Integer)
         failed.push("wrong type. month: #{month}") unless month.is_a?(Integer)
         failed.push("wrong type. day: #{day}") unless day.is_a?(Integer)
@@ -169,10 +179,10 @@ module Zakuro
       def valid_date
         failed = []
 
-        year = @param.year
-        month = @param.month
-        day = @param.day
-        start = @param.start
+        year = param.year
+        month = param.month
+        day = param.day
+        start = param.start
         unless Date.valid_date?(year, month, day, start)
           failed.push("year: #{year}, month: #{month}, " \
                       "day: #{day}, start: #{start}")
@@ -188,6 +198,8 @@ module Zakuro
       # @param [Integer] day 日
       # @param [Symbol] type 日付種別
       #
+      # @raise [ArgumentError] 引数エラー
+      #
       def initialize(year: -4712, month: 1, day: 1, type: Type::DEFAULT)
         start = Western.to_native_start(type: type)
         @param = Parameter.new(year: year, month: month, day: day, start: start)
@@ -213,7 +225,7 @@ module Zakuro
       #
       def redate(type: Type::DEFAULT)
         start = DATE_START.fetch(type, DATE_START[Type::DEFAULT])
-        @date = @date.new_start(start)
+        @date = date.new_start(start)
         self
       end
 
@@ -225,7 +237,7 @@ module Zakuro
       # @return [Calendar] 年月日情報（西暦）
       #
       def +(other)
-        return @date.jd + other.date.jd if other.is_a?(Western::Calendar)
+        return date.jd + other.date.jd if other.is_a?(Western::Calendar)
 
         @date += other
         self
@@ -239,7 +251,7 @@ module Zakuro
       # @return [Calendar] 年月日情報（西暦）
       #
       def -(other)
-        return @date.jd - other.date.jd if other.is_a?(Western::Calendar)
+        return date.jd - other.date.jd if other.is_a?(Western::Calendar)
 
         @date -= other
         self
@@ -254,7 +266,7 @@ module Zakuro
       # @return [False] 以下（現在日/過去日である）
       #
       def >(other)
-        @date > other.date
+        date > other.date
       end
 
       #
@@ -266,7 +278,7 @@ module Zakuro
       # @return [False] より小さい（過去日である）
       #
       def >=(other)
-        @date >= other.date
+        date >= other.date
       end
 
       #
@@ -278,7 +290,7 @@ module Zakuro
       # @return [False] 以上（現在日/未来日である）
       #
       def <(other)
-        @date < other.date
+        date < other.date
       end
 
       #
@@ -290,7 +302,7 @@ module Zakuro
       # @return [False] より大きい（未来日である）
       #
       def <=(other)
-        @date <= other.date
+        date <= other.date
       end
 
       #
@@ -302,7 +314,7 @@ module Zakuro
       # @return [False] 等しくない（過去日/未来日である）
       #
       def ==(other)
-        @date == other.date
+        date == other.date
       end
 
       #
@@ -311,7 +323,7 @@ module Zakuro
       # @return [Integer] 年
       #
       def year
-        @date.year
+        date.year
       end
 
       #
@@ -320,7 +332,7 @@ module Zakuro
       # @return [Integer] 月
       #
       def month
-        @date.month
+        date.month
       end
 
       #
@@ -329,7 +341,7 @@ module Zakuro
       # @return [Integer] 日
       #
       def day
-        @date.day
+        date.day
       end
 
       #
@@ -340,7 +352,7 @@ module Zakuro
       # @return [Calendar] 年月日情報（西暦）
       #
       def next_year(num: 1)
-        @date = @date.next_year(num)
+        @date = date.next_year(num)
         self
       end
 
@@ -351,7 +363,7 @@ module Zakuro
       # @return [False] 無効値以外
       #
       def invalid?
-        (@date == Date.new)
+        (date == Date.new)
       end
 
       #
@@ -362,60 +374,64 @@ module Zakuro
       # @return [String] 年月日情報
       #
       def format(form: '%Y-%m-%d')
-        @date.strftime(form)
-      end
-
-      #
-      # 年月日情報（西暦）を生成する
-      #
-      # @param [Date] date Ruby標準日付
-      #
-      # @return [Calendar] 年月日情報（西暦）
-      #
-      def self.create(date: Date.new)
-        type = Western.to_type(start: date.start)
-        Calendar.new(year: date.year, month: date.month,
-                     day: date.day, type: type)
+        date.strftime(form)
       end
 
-      #
-      # 年月日情報（西暦）を生成する
-      #
-      # @param [String] text 日付文字列
-      # @param [Symbol] type 日付種別
-      #
-      # @return [Calendar] 年月日情報（西暦）
-      #
-      def self.parse(text: '', type: Type::DEFAULT)
-        unless Calendar.valid_date_string(text: text, type: type)
-          raise ArgumentError, "invalid date string: #{text}"
+      class << self
+        #
+        # 年月日情報（西暦）を生成する
+        #
+        # @param [Date] date Ruby標準日付
+        #
+        # @return [Calendar] 年月日情報（西暦）
+        #
+        def create(date: Date.new)
+          type = Western.to_type(start: date.start)
+          Calendar.new(year: date.year, month: date.month,
+                       day: date.day, type: type)
         end
 
-        start = DATE_START.fetch(type, DATE_START[Type::DEFAULT])
-        date = Date.parse(text, start)
-
-        Calendar.new(
-          year: date.year, month: date.month, day: date.day, type: type
-        )
-      end
+        #
+        # 年月日情報（西暦）を生成する
+        #
+        # @param [String] text 日付文字列
+        # @param [Symbol] type 日付種別
+        #
+        # @return [Calendar] 年月日情報（西暦）
+        #
+        # @raise [ArgumentError] 引数エラー
+        #
+        def parse(text: '', type: Type::DEFAULT)
+          unless valid_date_string(text: text, type: type)
+            raise ArgumentError, "invalid date string: #{text}"
+          end
+
+          start = DATE_START.fetch(type, DATE_START[Type::DEFAULT])
+          date = Date.parse(text, start)
+
+          Calendar.new(
+            year: date.year, month: date.month, day: date.day, type: type
+          )
+        end
 
-      #
-      # 日付文字列を検証する
-      #
-      # @param [String] text 日付文字列
-      # @param [Symbol] type 日付種別
-      #
-      # @return [True] 正しい
-      # @return [True] 正しくない
-      #
-      def self.valid_date_string(text: '', type: Type::DEFAULT)
-        start = DATE_START.fetch(type, DATE_START[Type::DEFAULT])
-        begin
-          Date.parse(text, start)
-        rescue ArgumentError => _e
-          return false
+        #
+        # 日付文字列を検証する
+        #
+        # @param [String] text 日付文字列
+        # @param [Symbol] type 日付種別
+        #
+        # @return [True] 正しい
+        # @return [True] 正しくない
+        #
+        def valid_date_string(text: '', type: Type::DEFAULT)
+          start = DATE_START.fetch(type, DATE_START[Type::DEFAULT])
+          begin
+            Date.parse(text, start)
+          rescue ArgumentError => _e
+            return false
+          end
+          true
         end
-        true
       end
     end
   end

data/lib/zakuro/exception/case/pattern.rb

@@ -14,21 +14,57 @@ module Zakuro
       module Pattern
         INTERNAL_ERROR = Template.new(
           code: 'ERROR_0001',
-          message: '致命的なエラーです。',
+          message: '内部エラーです。',
           length: 0
         )
 
+        INVALID_DATE_TYPE = Template.new(
+          code: 'ERROR_0101',
+          message: '日付の型は文字列/日付です。指定型:%s',
+          length: 1
+        )
+
+        INVALID_RANGE_TYPE = Template.new(
+          code: 'ERROR_0102',
+          message: '範囲の型はhashです。指定型:%s',
+          length: 1
+        )
+
+        INVALID_OPTION_TYPE = Template.new(
+          code: 'ERROR_0103',
+          message: 'オプションの型はhashです。指定型:%s',
+          length: 1
+        )
+
+        INVALID_COLUMN_TYPE = Template.new(
+          code: 'ERROR_0104',
+          message: '列の型は配列です。指定型:%s',
+          length: 1
+        )
+
+        INVALID_CONDITION_TYPE = Template.new(
+          code: 'ERROR_0105',
+          message: '条件の型は配列です。指定型:%s',
+          length: 1
+        )
+
         INVALID_DATE = Template.new(
-          code: 'ERROR_0002',
+          code: 'ERROR_0201',
           message: '一日検索の日付指定が誤っています。',
           length: 0
         )
 
         INVALID_RANGE = Template.new(
-          code: 'ERROR_0003',
+          code: 'ERROR_0202',
           message: '範囲検索の日付指定が誤っています。',
           length: 0
         )
+
+        UNCOMMITTABLE_DATE = Template.new(
+          code: 'ERROR_0203',
+          message: '検索不可能な日付指定です。',
+          length: 0
+        )
       end
     end
   end

data/lib/zakuro/exception/case/preset.rb

@@ -34,7 +34,7 @@ module Zakuro
         # @return [String] エラーコード
         #
         def code
-          @template.code
+          template.code
         end
 
         #
@@ -43,7 +43,7 @@ module Zakuro
         # @return [String] メッセージ
         #
         def message
-          @template.format(*args)
+          template.format(*args)
         end
       end
     end

data/lib/zakuro/exception/exception.rb

@@ -2,11 +2,11 @@
 
 require_relative '../output/logger'
 
-require_relative './cause'
-
+require_relative './case/preset'
 require_relative './case/pattern'
 
 require_relative './zakuro_error'
+require_relative './cause'
 
 # :nodoc:
 module Zakuro
@@ -18,20 +18,22 @@ module Zakuro
     # @return [String] 共通メッセージ
     MESSAGE = 'an error has occurred'
 
-    #
-    # 例外を取得する
-    #
-    # @param [Array<Template>] presets 原因プリセット
-    #
-    # @return [ZakuroError] ライブラリエラー
-    #
-    def self.get(presets: [])
-      causes = []
-      presets.each do |preset|
-        causes.push(Cause.new(code: preset.code, message: preset.message))
+    class << self
+      #
+      # 例外を取得する
+      #
+      # @param [Array<Case::Preset>] presets 原因プリセット
+      #
+      # @return [ZakuroError] ライブラリエラー
+      #
+      def get(presets: [])
+        causes = []
+        presets.each do |preset|
+          causes.push(Cause.new(code: preset.code, message: preset.message))
+        end
+
+        ZakuroError.new(msg: MESSAGE, causes: causes)
       end
-
-      ZakuroError.new(msg: MESSAGE, causes: causes)
     end
   end
 end

data/lib/zakuro/exception/zakuro_error.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'json'
 require_relative './cause'
 
 # :nodoc:
@@ -20,8 +21,25 @@ module Zakuro
       # @param [Array<Cause>] causes 原因
       #
       def initialize(msg: '', causes: [])
-        super(msg)
         @causes = causes
+        out = "#{msg}:#{text}"
+        super(out)
+      end
+
+      private
+
+      #
+      # 原因をJSON文字列にする
+      #
+      # @return [String] JSON文字列
+      #
+      def text
+        list = []
+        causes.each do |cause|
+          list.push(Tools::Stringifier.to_h(obj: cause, class_prefix: 'Zakuro'))
+        end
+
+        JSON.generate(list)
       end
     end
   end

data/lib/zakuro/gateway/locale/date.rb

@@ -51,7 +51,7 @@ module Zakuro
         # @return [False] 不正なし
         #
         def invalid_japan?
-          @japan_date.invalid?
+          japan_date.invalid?
         end
 
         #
@@ -71,7 +71,7 @@ module Zakuro
         # @return [False] 不正なし
         #
         def invalid_western?
-          @western_date.invalid?
+          western_date.invalid?
         end
 
         #

data/lib/zakuro/gateway/locale/range.rb

@@ -39,7 +39,7 @@ module Zakuro
         # @return [False] 無効
         #
         def valid_western?
-          @start_date.valid_western? && @last_date.valid_western?
+          start_date.valid_western? && last_date.valid_western?
         end
 
         #
@@ -49,7 +49,7 @@ module Zakuro
         # @return [False] 無効
         #
         def valid_japan?
-          @start_date.valid_japan? && @last_date.valid_japan?
+          start_date.valid_japan? && last_date.valid_japan?
         end
 
         #
@@ -59,7 +59,7 @@ module Zakuro
         # @return [False] 不正なし
         #
         def invalid?
-          @start_date.invalid? && @last_date.invalid?
+          start_date.invalid? && last_date.invalid?
         end
       end
     end

data/lib/zakuro/gateway/range.rb

@@ -15,7 +15,7 @@ module Zakuro
     # Range 範囲
     #
     class Range
-      # @return [Context] 暦コンテキスト
+      # @return [Context::Context] 暦コンテキスト
       attr_reader :context
       # @return [Locale::Range] 範囲
       attr_reader :range
@@ -23,7 +23,7 @@ module Zakuro
       #
       # 初期化
       #
-      # @param [Context] context 暦コンテキスト
+      # @param [Context::Context] context 暦コンテキスト
       # @param [Hash<Symbol, Object>] range 範囲
       #
       def initialize(context:, range:)
@@ -38,7 +38,7 @@ module Zakuro
       # @return [False] 不正なし
       #
       def invalid?
-        @range.invalid?
+        range.invalid?
       end
 
       #

data/lib/zakuro/gateway/single.rb

@@ -21,7 +21,7 @@ module Zakuro
       #
       # 初期化
       #
-      # @param [Context] context 暦コンテキスト
+      # @param [Context::Context] context 暦コンテキスト
       # @param [Date, String] date 日付
       #
       def initialize(context:, date:)
@@ -36,7 +36,7 @@ module Zakuro
       # @return [False] 不正なし
       #
       def invalid?
-        @date.invalid?
+        date.invalid?
       end
 
       #
@@ -57,7 +57,18 @@ module Zakuro
           )
         end
 
-        raise Exception.get(
+        raise invalid_date_error
+      end
+
+      private
+
+      #
+      # 日付不正エラーを取得する
+      #
+      # @return [ZakuroError] ライブラリエラー
+      #
+      def invalid_date_error
+        Exception.get(
           presets: [
             Exception::Case::Preset.new(
               template: Exception::Case::Pattern::INVALID_DATE