zakuro 0.9.2 → 0.9.3

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,15 @@ module Zakuro
         # @param [Integer] line 行番号
         # @param [Western::Calendar] start_date 開始日
         # @param [Western::Calendar] last_date 終了日
+        # @param [True, False] operated 運用値設定
         #
         # @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)
           Alignment.get(
-            line: line, start_date: start_date, last_date: last_date
+            line: line, start_date: start_date, last_date: last_date, operated: operated
           )
         end
 
@@ -42,11 +44,12 @@ module Zakuro
         # @param [Integer] line 行番号
         # @param [Western::Calendar] start_date 開始日
         # @param [Western::Calendar] last_date 終了日
+        # @param [True, False] operated 運用値設定
         #
         # @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)
+          Alignment.get_by_name(line: line, name: name, operated: operated)
         end
       end
     end

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

@@ -3091,7 +3091,7 @@
         dest: "-"
       days:
         src: 大
-        dest: 小
+        dest: 大
     solar_term:
       src:
         index: "-"

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/remainder_comparer.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+require_relative '../output/logger'
+
+require_relative '../calculation/cycle/abstract_remainder'
+
+# :nodoc:
+module Zakuro
+  #
+  # Tools 汎用メソッド群
+  #
+  module Tools
+    #
+    # RemainderComparer 大余小余比較
+    #
+    module RemainderComparer
+      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.3
 platform: ruby
 authors:
 - pldb
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-12-29 00:00:00.000000000 Z
+date: 2023-03-25 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,7 @@ files:
 - lib/zakuro/result/operation/month/annotation.rb
 - lib/zakuro/result/operation/month/history.rb
 - lib/zakuro/result/result.rb
+- lib/zakuro/tools/remainder_comparer.rb
 - lib/zakuro/tools/stringifier.rb
 - lib/zakuro/tools/typeconv.rb
 - lib/zakuro/tools/typeof.rb