zakuro 0.9.2 → 0.9.4

data/lib/zakuro/era/japan/gengou/resource/yaml/set-003-modern.yaml

@@ -5,16 +5,24 @@ last_year:
   japan: 7981
   western: 9999
 last_date:
-  japan: 令和7981年12月31日
-  western: '9999-12-31'
+  calculation:
+    japan: ''
+    western: ''
+  operation:
+    japan: 令和7981年12月31日
+    western: '9999-12-31'
 list:
 - name: 明治
   start_year:
     japan: 1
     western: 1868
   start_date:
-    japan: 明治01年09月08日
-    western: '1868-10-23'
+    calculation:
+      japan: ''
+      western: ''
+    operation:
+      japan: 明治01年09月08日
+      western: '1868-10-23'
   disuse:
     new_year_date: '1868-1-25'
     note: ''
@@ -23,8 +31,12 @@ list:
     japan: 1
     western: 1912
   start_date:
-    japan: 大正01年07月30日
-    western: '1912-7-30'
+    calculation:
+      japan: ''
+      western: ''
+    operation:
+      japan: 大正01年07月30日
+      western: '1912-7-30'
   disuse:
     new_year_date: '1912-1-1'
     note: ''
@@ -33,8 +45,12 @@ list:
     japan: 1
     western: 1926
   start_date:
-    japan: 昭和01年12月25日
-    western: '1926-12-25'
+    calculation:
+      japan: ''
+      western: ''
+    operation:
+      japan: 昭和01年12月25日
+      western: '1926-12-25'
   disuse:
     new_year_date: '1926-1-1'
     note: ''
@@ -43,8 +59,12 @@ list:
     japan: 1
     western: 2019
   start_date:
-    japan: 令和01年05月01日
-    western: '2019-5-1'
+    calculation:
+      japan: ''
+      western: ''
+    operation:
+      japan: 令和01年05月01日
+      western: '2019-5-1'
   disuse:
     new_year_date: '2019-1-1'
     note: ''

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

@@ -27,6 +27,22 @@ module Zakuro
             __dir__
           ))
         ].freeze
+
+        # @return [Array<Set>] 元号セット情報リスト（運用値）
+        OPERATED_LIST = [
+          Parser.run(filepath: File.expand_path(
+            './resource/yaml/set-001-until-south.yaml',
+            __dir__
+          ), operated: true),
+          Parser.run(filepath: File.expand_path(
+            './resource/yaml/set-002-from-north.yaml',
+            __dir__
+          ), operated: true),
+          Parser.run(filepath: File.expand_path(
+            './resource/yaml/set-003-modern.yaml',
+            __dir__
+          ), operated: true)
+        ].freeze
       end
     end
   end

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

@@ -26,13 +26,17 @@ module Zakuro
         # @param [Integer] line 行番号
         # @param [Western::Calendar] start_date 開始日
         # @param [Western::Calendar] last_date 終了日
+        # @param [True, False] operated 運用値設定
+        # @param [True, False] restored 運用値から計算値に戻すか
         #
         # @return [Array<LinearGengou>] 該当行の元号
         #
         def line(line: FIRST_LINE,
-                 start_date: Western::Calendar.new, last_date: Western::Calendar.new)
+                 start_date: Western::Calendar.new, last_date: Western::Calendar.new,
+                 operated: false, restored: false)
           Alignment.get(
-            line: line, start_date: start_date, last_date: last_date
+            line: line, start_date: start_date, last_date: last_date, operated: operated,
+            restored: restored
           )
         end
 
@@ -40,13 +44,14 @@ module Zakuro
         # 該当行の元号を取得する（元号名）
         #
         # @param [Integer] line 行番号
-        # @param [Western::Calendar] start_date 開始日
-        # @param [Western::Calendar] last_date 終了日
+        # @param [String] name 元号名
+        # @param [True, False] operated 運用値設定
+        # @param [True, False] restored 運用値から計算値に戻すか
         #
         # @return [Array<LinearGengou>] 該当行の元号
         #
-        def line_by_name(line: FIRST_LINE, name:)
-          Alignment.get_by_name(line: line, name: name)
+        def line_by_name(line: FIRST_LINE, name:, operated: false, restored: false)
+          Alignment.get_by_name(line: line, name: name, operated: operated, restored: restored)
         end
       end
     end

data/lib/zakuro/operation/yaml/month.yaml

@@ -3091,7 +3091,7 @@
         dest: "-"
       days:
         src: 大
-        dest: 小
+        dest: 大
     solar_term:
       src:
         index: "-"
@@ -11294,7 +11294,7 @@
         zodiac_name: "-"
       dest:
         index: '0'
-        from: '1050-12-17'
+        from: '1050-11-17'
         zodiac_name: "-"
       days: "-"
     days: "-1"
@@ -13837,38 +13837,6 @@
         zodiac_name: "-"
       days: "-"
     days: "-1"
-- id: 318-1-a
-  relation_id: "-"
-  parent_id: 318-1-1
-  page: '318'
-  number: "-"
-  japan_date: 正平 12年 7 小 甲戌  10-1300
-  western_date: '1357-7-18'
-  description: "-"
-  note: "-"
-  modified: 'true'
-  diffs:
-    month:
-      number:
-        src: "-"
-        dest: "-"
-      leaped:
-        src: "-"
-        dest: "-"
-      days:
-        src: 大
-        dest: 小
-    solar_term:
-      src:
-        index: "-"
-        to: "-"
-        zodiac_name: "-"
-      dest:
-        index: "-"
-        from: "-"
-        zodiac_name: "-"
-      days: "-"
-    days: "-"
 - id: 318-1-0
   relation_id: 318-1-1
   parent_id: "-"
@@ -13888,7 +13856,7 @@
         src: 'false'
         dest: 'true'
       days:
-        src: 小
+        src: 大
         dest: 小
     solar_term:
       src:
@@ -13920,7 +13888,7 @@
         src: 'true'
         dest: 'false'
       days:
-        src: 大
+        src: 小
         dest: 大
     solar_term:
       src:

data/lib/zakuro/output/logger.rb

@@ -9,6 +9,7 @@ module Zakuro
     # @note 本番では使用しない
     #
     class Logger
+      # @return [Hash<Symbol, Integer>] ログレベル
       LEVELS = {
         none: -1,
         debug: 0,
@@ -17,6 +18,7 @@ module Zakuro
         error: 3
       }.freeze
 
+      # @return [Integer] 現在ログレベル
       LEVEL = LEVELS[:none]
 
       # @return [String] 呼び出し位置
@@ -32,7 +34,9 @@ module Zakuro
       # @param [String] messages メッセージ
       #
       def debug(*messages)
-        return if LEVEL < LEVELS[:debug]
+        return if none?
+
+        return if LEVEL >= LEVELS[:debug]
 
         output('DEBUG', *messages)
       end
@@ -43,7 +47,9 @@ module Zakuro
       # @param [String] messages メッセージ
       #
       def info(*messages)
-        return if LEVEL < LEVELS[:info]
+        return if none?
+
+        return if LEVEL >= LEVELS[:info]
 
         output('INFO', *messages)
       end
@@ -55,7 +61,9 @@ module Zakuro
       # @param [String] messages メッセージ
       #
       def error(error, *messages)
-        return if LEVEL < LEVELS[:error]
+        return if none?
+
+        return if LEVEL >= LEVELS[:error]
 
         output('ERROR', *messages)
         output('ERROR', error.message)
@@ -64,6 +72,16 @@ module Zakuro
 
       private
 
+      #
+      # 出力なしか
+      #
+      # @return [True] 出力なし
+      # @return [False] 出力あり
+      #
+      def none?
+        LEVEL < LEVELS[:debug]
+      end
+
       #
       # 標準出力を行う
       #

data/lib/zakuro/tools/gengou_range_comparer.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+require_relative '../output/logger'
+
+require_relative '../calculation/cycle/abstract_remainder'
+
+require_relative '../calculation/era/gengou/dated_scroll'
+
+# TODO: Tools -> Tool
+
+# :nodoc:
+module Zakuro
+  #
+  # Tools 汎用メソッド群
+  #
+  module Tools
+    #
+    # GengouRangeComparer 元号範囲比較
+    #
+    module GengouRangeComparer
+      # @return [Output::Logger] ロガー
+      LOGGER = Output::Logger.new(location: 'GengouRangeComparer')
+
+      class << self
+        #
+        # 元号範囲が計算値/運用値で同一か
+        #
+        # @param [Western::Calendar] start_date 開始西暦日
+        # @param [Western::Calendar] last_date 終了西暦日
+        #
+        # @return [True] 一致
+        # @return [False] 不一致
+        #
+        def same?(start_date: Western::Calendar.new, last_date: Western::Calendar.new)
+          calc_range = Calculation::Gengou::DatedScroll.new(
+            start_date: start_date, last_date: last_date
+          ).range
+
+          ope_range = Calculation::Gengou::DatedScroll.new(
+            start_date: start_date, last_date: last_date, operated: true
+          ).range
+
+          # 1行目元号
+          unless same_line?(calc_line: calc_range.first_list.list,
+                            ope_line: ope_range.first_list.list)
+            return false
+          end
+
+          # 2行目元号
+          unless same_line?(calc_line: calc_range.second_list.list,
+                            ope_line: ope_range.second_list.list)
+            return false
+          end
+
+          true
+        end
+
+        private
+
+        #
+        # 同じ予約元号一覧か
+        #
+        # @param [Array<Japan::Alignment::LinearGengou>] calc_line 予約元号一覧（計算値）
+        # @param [Array<Japan::Alignment::LinearGengou>] ope_line 予約元号一覧（運用値）
+        #
+        # @return [True] 一致
+        # @return [False] 不一致
+        #
+        def same_line?(calc_line: [], ope_line: [])
+          return false unless calc_line.size == ope_line.size
+
+          calc_line.each_with_index do |calc_gengou, index|
+            ope_gengou = ope_line[index]
+            return false unless calc_gengou.name == ope_gengou.name
+          end
+
+          true
+        end
+      end
+    end
+  end
+end

data/lib/zakuro/tools/remainder_comparer.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+require_relative '../output/logger'
+
+require_relative '../calculation/cycle/abstract_remainder'
+
+# TODO: Tools -> Tool
+
+# :nodoc:
+module Zakuro
+  #
+  # Tools 汎用メソッド群
+  #
+  module Tools
+    #
+    # RemainderComparer 大余小余比較
+    #
+    module RemainderComparer
+      # @return [Output::Logger] ロガー
+      LOGGER = Output::Logger.new(location: 'RemainderComparer')
+
+      class << self
+        #
+        # 大余を基準に範囲チェックをする
+        #
+        # 次のパターンで用いる
+        # 1. 月内（当月朔日から当月末日（来月朔日の前日）の間）に二十四節気があるか
+        #   * target: 二十四節気
+        #   * start: 当月朔日
+        #   * last: 次月朔日
+        # 2. ある二十四節気に対象の日があるか
+        #   * target: 対象の日
+        #   * start: 二十四節気
+        #   * last: 次の二十四節気
+        #
+        # @param [Calcuration::Cycle::AbstractRemainder] target 対象日
+        # @param [Calcuration::Cycle::AbstractRemainder] start 範囲開始
+        # @param [Calcuration::Cycle::AbstractRemainder] last 範囲終了
+        #
+        # @return [True] 対象日がある
+        # @return [False] 対象日がない
+        #
+        def in_range?(target:, start:, last:)
+          # 『日本暦日便覧』では下記5日を没日ありとしている
+          #  これは二十四節気の小余と秒が0の場合に限って、範囲を翌日にずらすことを指している
+          #
+          # * 貞観12年7月18日
+          # * 天喜5年3月11日
+          # * 寛元1年11月4日
+          # * 永享2年7月26日
+          # * 元和3年3月19日
+          #
+          last_day = last.only_day? ? last.day + 1 : last.day
+          in_range_day?(target: target.day, start: start.day, last: last_day)
+        end
+
+        #
+        # 大余を基準に範囲チェックをする
+        #
+        # @param [Calcuration::Cycle::AbstractRemainder] target 対象日
+        # @param [Calcuration::Cycle::AbstractRemainder] start 範囲開始
+        # @param [Integer] limit 大余上限
+        #
+        # @return [True] 対象日がある
+        # @return [False] 対象日がない
+        #
+        def in_limit?(target:, start:, limit:)
+          last_day = start.add_day(limit).day
+
+          in_range_day?(target: target.day, start: start.day, last: last_day)
+        end
+
+        private
+
+        #
+        # 大余を基準に範囲チェックをする
+        #
+        # @note 大余60で一巡するため 以下2パターンがある
+        #   * start <= last : (二十四節気) >= start && (二十四節気) < last
+        #   * start > last  : (二十四節気) >= start || (二十四節気) < last
+        #
+        # @param [Integer] target 対象日
+        # @param [Integer] start 範囲開始
+        # @param [Integer] last 範囲終了
+        #
+        # @return [True] 対象日がある
+        # @return [False] 対象日がない
+        #
+        def in_range_day?(target:, start:, last:)
+          start_over = (target >= start)
+          last_under = (target < last)
+
+          return start_over && last_under if start <= last
+
+          start_over || last_under
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: zakuro
 version: !ruby/object:Gem::Version
-  version: 0.9.2
+  version: 0.9.4
 platform: ruby
 authors:
 - pldb
-autorequire:
+autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-12-29 00:00:00.000000000 Z
+date: 2023-05-01 00:00:00.000000000 Z
 dependencies: []
 description: mainly lunar solar calendar
 email:
@@ -86,6 +86,9 @@ files:
 - lib/zakuro/calculation/monthly/const.rb
 - lib/zakuro/calculation/monthly/first_day.rb
 - lib/zakuro/calculation/monthly/initialized_month.rb
+- lib/zakuro/calculation/monthly/meta.rb
+- lib/zakuro/calculation/monthly/meta/all_solar_term.rb
+- lib/zakuro/calculation/monthly/meta/meta_collector.rb
 - lib/zakuro/calculation/monthly/month.rb
 - lib/zakuro/calculation/monthly/month_label.rb
 - lib/zakuro/calculation/monthly/operated_month.rb
@@ -181,6 +184,8 @@ files:
 - lib/zakuro/result/operation/month/annotation.rb
 - lib/zakuro/result/operation/month/history.rb
 - lib/zakuro/result/result.rb
+- lib/zakuro/tools/gengou_range_comparer.rb
+- lib/zakuro/tools/remainder_comparer.rb
 - lib/zakuro/tools/stringifier.rb
 - lib/zakuro/tools/typeconv.rb
 - lib/zakuro/tools/typeof.rb
@@ -273,7 +278,7 @@ metadata:
   homepage_uri: https://github.com/pldb/zakuro
   source_code_uri: https://github.com/pldb/zakuro
   changelog_uri: https://github.com/pldb/zakuro
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -288,8 +293,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
-signing_key:
+rubygems_version: 3.1.4
+signing_key: 
 specification_version: 4
 summary: japanese calendar library.
 test_files: []