zakuro 0.0.3 → 0.1.0

data/lib/zakuro/era/japan/gengou/validator.rb

@@ -0,0 +1,234 @@
+# frozen_string_literal: true
+
+require_relative '../../western'
+require_relative './type'
+require 'yaml'
+
+# :nodoc:
+module Zakuro
+  #
+  # Japan 和暦
+  #
+  module Japan
+    #
+    # Validator yaml解析
+    #
+    module Validator
+      # :reek:TooManyInstanceVariables { max_instance_variables: 5 }
+
+      #
+      # Set 元号セット情報の検証/展開
+      #
+      class Set
+        # @return [String] 元号セットID
+        attr_reader :id
+        # @return [String] 元号セット名
+        attr_reader :name
+        # @return [String] 終了日
+        attr_reader :end_date
+        # @return [Array<Hash<String, String>>] 元号情報
+        attr_reader :list
+
+        #
+        # 初期化
+        #
+        # @param [Hash<String, Object>] hash 元号セット情報
+        #
+        def initialize(hash:)
+          @id = hash['id']
+          @name = hash['name']
+          @end_date = hash['end_date']
+          @list = hash['list']
+        end
+
+        # :reek:TooManyStatements { max_statements: 6 }
+
+        #
+        # 検証する
+        #
+        # @return [Array<String>] 不正メッセージ
+        #
+        def validate
+          failed = []
+          failed.push("invalid id. #{id}") unless id?
+
+          failed.push("invalid name. #{name}") unless name?
+
+          failed.push("invalid end_date. #{end_date}") unless western_date?
+
+          failed |= validate_list
+          failed
+        end
+
+        # :reek:NilCheck
+
+        #
+        # IDを検証する
+        #
+        # @return [True] 正しい
+        # @return [False] 正しくない
+        #
+        def id?
+          !(@id.nil? || !@id.is_a?(Integer))
+        end
+
+        #
+        # 元号セット名を検証する
+        #
+        # @return [True] 正しい
+        # @return [False] 正しくない
+        #
+        def name?
+          !(@name.nil? || !@name.is_a?(String))
+        end
+
+        #
+        # 日付文字列を検証する
+        #
+        # @return [True] 正しい
+        # @return [False] 正しくない
+        #
+        def western_date?
+          Western::Calendar.valid_date_string(str: @end_date)
+        end
+
+        # :reek:NilCheck
+
+        #
+        # 元号情報を検証する
+        #
+        # @return [True] 正しい
+        # @return [False] 正しくない
+        #
+        def list?
+          (!@list.nil? || @list.is_a?(Array))
+        end
+
+        #
+        # 元号情報を検証する
+        #
+        # @return [True] 正しい
+        # @return [False] 正しくない
+        #
+        def validate_list
+          return ["invalid list. #{@list.class}"] unless list?
+
+          failed = []
+          list.each_with_index do |li, index|
+            failed |= Gengou.new(hash: li, index: index).validate
+          end
+          failed
+        end
+      end
+
+      #
+      # Gengou 元号情報
+      #
+      class Gengou
+        # @return [Integer] 要素位置
+        attr_reader :index
+        # @return [String] 元号名
+        attr_reader :name
+        # @return [String] 開始日
+        attr_reader :start_date
+        # @return [String] 元旦
+        attr_reader :new_year_date
+        # @return [String] 開始年
+        attr_reader :start_year
+
+        #
+        # 初期化
+        #
+        # @param [Hash<String, Strin>] hash 元号情報
+        # @param [Integer] index （元号セット内での）元号の要素位置
+        #
+        def initialize(hash:, index:)
+          @index = index
+          @name = hash['name']
+          @start_date = hash['start_date']
+          @new_year_date = hash['new_year_date']
+          @start_year = hash['start_year']
+        end
+
+        # :reek:TooManyStatements { max_statements: 7 }
+
+        #
+        # 検証する
+        #
+        # @return [Array<String>] 不正メッセージ
+        #
+        def validate
+          prefix = "list[#{index}]. "
+          failed = []
+
+          failed.push(prefix + "invalid name. #{@name}") unless name?
+
+          failed.push(prefix + "invalid start_date. #{@start_date}") unless start_date?
+
+          failed.push(prefix + "invalid start_year. #{@start_year}") unless year?
+
+          failed.push(prefix + "invalid new_year_date. #{@new_year_date}") unless new_year_date?
+
+          failed
+        end
+
+        # :reek:NilCheck
+
+        #
+        # 元号名を検証する
+        #
+        # @return [True] 正しい
+        # @return [False] 正しくない
+        #
+        def name?
+          (!@name.nil? || @name.is_a?(String))
+        end
+
+        #
+        # 開始日文字列を検証する
+        #
+        # @return [True] 正しい
+        # @return [False] 正しくない
+        #
+        def start_date?
+          Western::Calendar.valid_date_string(str: @start_date)
+        end
+
+        #
+        # 元旦文字列を検証する
+        #
+        # @return [True] 正しい
+        # @return [False] 正しくない
+        #
+        def new_year_date?
+          Western::Calendar.valid_date_string(str: @new_year_date)
+        end
+
+        # :reek:NilCheck
+
+        #
+        # 元号年を検証する
+        #
+        # @return [True] 正しい
+        # @return [False] 正しくない
+        #
+        def year?
+          return true if @start_year.nil?
+
+          @start_year.is_a?(Integer)
+        end
+      end
+
+      #
+      # 検証する
+      #
+      # @param [Hash<String, Object>] yaml_hash yaml取得結果
+      #
+      # @return [Array<String>] 不正メッセージ
+      #
+      def self.run(yaml_hash:)
+        Set.new(hash: yaml_hash).validate
+      end
+    end
+  end
+end

data/lib/zakuro/era/japan/reki.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+require_relative '../western'
+
+# :nodoc:
+module Zakuro
+  #
+  # Japan 和暦
+  #
+  module Japan
+    #
+    # Reki 暦
+    #
+    module Reki
+      #
+      # Range 暦（範囲）
+      #
+      class Range
+        # @return [String] 暦のクラス名
+        #   version 以下を参照
+        attr_reader :class_name
+        # @return [Western::Calendar] 暦の開始日
+        attr_reader :start_date
+
+        #
+        # 初期化
+        #
+        # @param [String] class_name 暦のクラス名
+        # @param [Western::Calendar] start_date 暦の開始日
+        #
+        def initialize(class_name:, start_date:)
+          @class_name = class_name
+          @start_date = start_date
+        end
+      end
+
+      LIST = [
+        Range.new(
+          class_name: 'Zakuro::Genka::Gateway',
+          start_date: Western::Calendar.new(year: 445, month: 1, day: 24)
+        ),
+        Range.new(
+          class_name: 'Zakuro::Gihou::Gateway',
+          start_date: Western::Calendar.new(year: 698, month: 2, day: 16)
+        ),
+        Range.new(
+          class_name: 'Zakuro::Taien::Gateway',
+          start_date: Western::Calendar.new(year: 764, month: 2, day: 7)
+        ),
+        Range.new(
+          class_name: 'Zakuro::Senmyou::Gateway',
+          start_date: Western::Calendar.new(year: 862, month: 2, day: 3)
+        ),
+        Range.new(
+          class_name: 'Zakuro::Joukyou::Gateway',
+          start_date: Western::Calendar.new(year: 1685, month: 2, day: 4)
+        ),
+        Range.new(
+          class_name: 'Zakuro::Houryaku::Gateway',
+          start_date: Western::Calendar.new(year: 1755, month: 2, day: 11)
+        ),
+        Range.new(
+          class_name: 'Zakuro::Kansei::Gateway',
+          start_date: Western::Calendar.new(year: 1798, month: 2, day: 16)
+        ),
+        Range.new(
+          class_name: 'Zakuro::Tenpou::Gateway',
+          start_date: Western::Calendar.new(year: 1844, month: 2, day: 18)
+        ),
+        Range.new(
+          class_name: 'Zakuro::Gregorio::Gateway',
+          start_date: Western::Calendar.new(year: 1872, month: 12, day: 9)
+        )
+      ].freeze
+
+      #
+      # 指定した日付から対象の暦を引き当てる
+      #
+      # @param [Western::Calendar] date 日付
+      #
+      # @return [String] 暦のクラス名
+      #
+      def self.class_name(date: Western::Calendar.new)
+        LIST.reverse_each do |range|
+          return range.class_name if date >= range.start_date
+        end
+        raise ArgumentError, "invalid date: #{date.format}"
+      end
+    end
+  end
+end

data/lib/zakuro/era/western.rb

@@ -109,7 +109,7 @@ module Zakuro
       end
     end
 
-    # :reek:TooManyMethods { max_methods: 17 }
+    # :reek:TooManyMethods { max_methods: 18 }
 
     #
     # Calendar 年月日情報（西暦）

data/lib/zakuro/operation/month/parser.rb

@@ -0,0 +1,277 @@
+# frozen_string_literal: true
+
+require 'yaml'
+require_relative '../../era/western'
+require_relative './validator'
+require_relative './type'
+
+# :nodoc:
+module Zakuro
+  #
+  # Operation 運用
+  #
+  module Operation
+    #
+    # TypeParser 型ごと変換
+    #
+    module TypeParser
+      #
+      # 無効値かを判定する
+      #
+      # @param [String] str 文字列
+      #
+      # @return [True] 無効値
+      # @return [False] 有効値
+      #
+      def self.invalid?(str:)
+        str == '-'
+      end
+
+      def self.text(str:)
+        return '' if invalid?(str: str)
+
+        str
+      end
+
+      #
+      # 有効行を変換する
+      #
+      # @param [String] str 文字列
+      #
+      # @return [True] 有効
+      # @return [False] 無効
+      #
+      def self.modified?(str:)
+        str == 'true'
+      end
+
+      #
+      # 月を変換する
+      #
+      # @param [String] str 文字列
+      #
+      # @return [Integer] 月
+      #
+      def self.month_number(str:)
+        return -1 if invalid?(str: str)
+
+        str.to_i
+      end
+
+      #
+      # 閏有無を変換する
+      #
+      # @param [String] str 文字列
+      #
+      # @return [True] 閏あり
+      # @return [True] 閏なし/閏設定なし
+      #
+      def self.month_leaped(str:)
+        str == 'true'
+      end
+
+      #
+      # 西暦日を変換する
+      #
+      # @param [String] str 文字列
+      #
+      # @return [Western::Calendar] 西暦日
+      #
+      def self.western_date(str:)
+        return Western::Calendar.new if invalid?(str: str)
+
+        Western::Calendar.parse(str: str)
+      end
+
+      #
+      # 日（差分）を変換する
+      #
+      # @param [String] str 文字列
+      #
+      # @return [Integer] 日（差分）
+      #
+      def self.days(str:)
+        return INVALID_DAY_VALUE if invalid?(str: str)
+
+        str.to_i
+      end
+
+      def self.solar_term_index(str:)
+        return -1 if invalid?(str: str)
+
+        str.to_i
+      end
+    end
+
+    #
+    # MonthParser 月情報解析（yaml）
+    #
+    module MonthParser
+      #
+      # 実行する
+      #
+      # @return [Array<MonthHistory>] 変更履歴
+      #
+      def self.run(filepath:)
+        hash = YAML.load_file(filepath)
+
+        failed = Validator.run(yaml_hash: hash)
+
+        raise ArgumentError, failed.join("\n") unless failed.empty?
+
+        load(yaml_hash: hash)
+      end
+
+      #
+      # 設定ファイルを読み込む
+      #
+      # @param [Hash] yaml_hash 設定ファイルテキスト
+      #
+      # @return [Array<MonthHistory>] 変更履歴
+      #
+      def self.load(yaml_hash: {})
+        annotations = {}
+        relations = {}
+        histories = create_histories(yaml_hash: yaml_hash, annotations: annotations,
+                                     relations: relations)
+
+        add_annotations(histories: histories, annotations: annotations, relations: relations)
+      end
+
+      #
+      # 変更履歴を読み込む
+      #
+      # @param [Hash] yaml_hash 設定ファイルテキスト
+      # @param [Hash] annotations 注釈（空）
+      # @param [Hash] relations 関連ID設定（空）
+      #
+      # @return [Array<MonthHistory>] 変更履歴
+      #
+      def self.create_histories(yaml_hash: {}, annotations: {}, relations: {})
+        result = []
+        yaml_hash.each do |month|
+          id = month['id']
+          annotations[id] = Annotation.new(
+            id: id,
+            description: Operation::TypeParser.text(str: month['description']),
+            note: Operation::TypeParser.text(str: month['note'])
+          )
+          relation_id = month['relation_id']
+
+          relations[id] = relation_id unless Operation::TypeParser.invalid?(str: relation_id)
+
+          next unless Operation::TypeParser.modified?(str: month['modified'])
+
+          history = create_history(yaml_hash: month)
+          result.push(history)
+        end
+
+        result
+      end
+      private_class_method :create_histories
+
+      def self.create_history(yaml_hash: {})
+        diffs = MonthDiffsParser.create(yaml_hash: yaml_hash['diffs'])
+
+        western_date = Operation::TypeParser.western_date(str: yaml_hash['western_date'])
+        reference = Reference.new(page: yaml_hash['page'].to_i, number: yaml_hash['number'].to_i,
+                                  japan_date: yaml_hash['japan_date'])
+        MonthHistory.new(id: yaml_hash['id'],
+                         parent_id: yaml_hash['parent_id'],
+                         reference: reference,
+                         western_date: western_date,
+                         diffs: diffs)
+      end
+      private_class_method :create_history
+
+      def self.add_annotations(histories: [], annotations: {}, relations: {})
+        result = []
+        histories.each do |history|
+          result.push(
+            MonthHistory.new(
+              id: history.id, reference: history.reference, western_date: history.western_date,
+              annotations: create_history_annnotations(history: history, annotations: annotations,
+                                                       relations: relations),
+              diffs: history.diffs
+            )
+          )
+        end
+
+        result
+      end
+      private_class_method :add_annotations
+
+      def self.create_history_annnotations(history:, annotations: {}, relations: {})
+        history_id = history.id
+        history_annotations = []
+        [history_id, relations.fetch(history_id, '')].each do |id|
+          add_annotation(history_annotations: history_annotations,
+                         annotations: annotations, id: id)
+        end
+
+        history_annotations
+      end
+
+      def self.add_annotation(history_annotations: [], annotations: {}, id: '')
+        annotation = annotations.fetch(id, Annotation.new)
+        history_annotations.push(annotation) unless annotation.invalid?
+      end
+      private_class_method :add_annotation
+    end
+
+    #
+    # MonthDiffsParser 月情報（差分）解析
+    #
+    module MonthDiffsParser
+      def self.create(yaml_hash: {})
+        Diffs.new(
+          month: create_month(yaml_hash: yaml_hash['month']),
+          solar_term: create_solar_term(yaml_hash: yaml_hash['solar_term']),
+          days: Operation::TypeParser.days(str: yaml_hash['days'])
+        )
+      end
+
+      def self.create_solar_term(yaml_hash: {})
+        SolarTerm::Direction.new(
+          source: create_source_solar_term(yaml_hash: yaml_hash['calc']),
+          destination: create_destination_solar_term(yaml_hash: yaml_hash['actual']),
+          days: Operation::TypeParser.days(str: yaml_hash['days'])
+        )
+      end
+      private_class_method :create_solar_term
+
+      def self.create_source_solar_term(yaml_hash: {})
+        SolarTerm::Source.new(
+          index: Operation::TypeParser.solar_term_index(str: yaml_hash['index']),
+          to: Operation::TypeParser.western_date(str: yaml_hash['to']),
+          zodiac_name: Operation::TypeParser.text(str: yaml_hash['zodiac_name'])
+        )
+      end
+      private_class_method :create_source_solar_term
+
+      def self.create_destination_solar_term(yaml_hash: {})
+        SolarTerm::Destination.new(
+          index: Operation::TypeParser.solar_term_index(str: yaml_hash['index']),
+          from: Operation::TypeParser.western_date(str: yaml_hash['from']),
+          zodiac_name: Operation::TypeParser.text(str: yaml_hash['zodiac_name'])
+        )
+      end
+      private_class_method :create_destination_solar_term
+
+      def self.create_month(yaml_hash: {})
+        number = yaml_hash['number']
+        leaped = yaml_hash['leaped']
+        days = yaml_hash['days']
+
+        Month.new(
+          number: Number.new(calc: Operation::TypeParser.month_number(str: number['calc']),
+                             actual: Operation::TypeParser.month_number(str: number['actual'])),
+          leaped: Leaped.new(calc: Operation::TypeParser.month_leaped(str: leaped['calc']),
+                             actual: Operation::TypeParser.month_leaped(str: leaped['actual'])),
+          days: Days.new(calc: days['calc'], actual: days['actual'])
+        )
+      end
+      private_class_method :create_month
+    end
+  end
+end