verified_holidays 0.1.0

data/lib/verified_holidays/cabinet_office.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require 'net/http'
+require 'uri'
+require 'csv'
+require 'date'
+
+module VerifiedHolidays
+  class CabinetOffice
+    CSV_URL = 'https://www8.cao.go.jp/chosei/shukujitsu/syukujitsu.csv'
+
+    def self.fetch
+      uri = URI.parse(CSV_URL)
+      response = Net::HTTP.get(uri)
+
+      # Remove UTF-8 BOM bytes if present (before encoding conversion)
+      raw = response.b
+      raw = raw.byteslice(3..) if raw.byteslice(0, 3) == "\xEF\xBB\xBF".b
+
+      # Convert from CP932 (Shift_JIS) to UTF-8
+      utf8 = raw.force_encoding('CP932').encode('UTF-8')
+
+      parse(utf8)
+    end
+
+    def self.parse(csv_string)
+      holidays = {}
+      CSV.parse(csv_string, headers: true) do |row|
+        date_str = row[0]&.strip
+        name = row[1]&.strip
+        next if date_str.nil? || name.nil?
+
+        holidays[parse_date(date_str)] = name
+      end
+      holidays
+    end
+
+    def self.parse_date(date_str)
+      parts = date_str.split('/')
+      Date.new(parts[0].to_i, parts[1].to_i, parts[2].to_i)
+    end
+    private_class_method :parse_date
+  end
+end

data/lib/verified_holidays/dataset.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require 'singleton'
+require 'yaml'
+require 'date'
+
+module VerifiedHolidays
+  class Dataset
+    include Singleton
+
+    def initialize
+      @holidays = load_yaml
+    end
+
+    def all
+      @holidays
+    end
+
+    def between(start_date, last_date)
+      start_date = to_date(start_date)
+      last_date = to_date(last_date)
+      @holidays.each_with_object([]) do |(date, holiday), result|
+        result << holiday if date.between?(start_date, last_date)
+      end
+    end
+
+    def holiday?(date)
+      @holidays.key?(to_date(date))
+    end
+
+    def name(date)
+      holiday = @holidays[to_date(date)]
+      holiday&.name
+    end
+
+    def year(year)
+      @holidays.each_with_object([]) do |(date, holiday), result|
+        result << holiday if date.year == year
+      end
+    end
+
+    private
+
+    def to_date(value)
+      # DateTime は Date のサブクラスだが、明示的に .to_date で Date に変換
+      return value.to_date if value.is_a?(DateTime) || value.is_a?(Time)
+      return value if value.is_a?(Date)
+
+      raise ArgumentError, "expected Date, DateTime, or Time, got #{value.class}"
+    end
+
+    def load_yaml
+      path = File.expand_path('../../data/holidays.yml', __dir__)
+      data = YAML.safe_load_file(path, permitted_classes: [Date])
+      result = {}
+      data.each do |date, name|
+        date = Date.parse(date.to_s) unless date.is_a?(Date)
+        result[date] = Holiday.new(date, name)
+      end
+      result
+    end
+  end
+end

data/lib/verified_holidays/holiday.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module VerifiedHolidays
+  class Holiday
+    WDAY_NAMES = %w[日 月 火 水 木 金 土].freeze
+
+    EN_HOLIDAY_NAMES = {
+      '元日' => "New Year's Day",
+      '成人の日' => 'Coming of Age Day',
+      '建国記念の日' => 'National Foundation Day',
+      '天皇誕生日' => "Emperor's Birthday",
+      '春分の日' => 'Vernal Equinox Day',
+      '昭和の日' => 'Showa Day',
+      '憲法記念日' => 'Constitution Memorial Day',
+      'みどりの日' => 'Greenery Day',
+      'こどもの日' => "Children's Day",
+      '海の日' => 'Marine Day',
+      '山の日' => 'Mountain Day',
+      '敬老の日' => 'Respect for the Aged Day',
+      '秋分の日' => 'Autumnal Equinox Day',
+      'スポーツの日' => 'Sports Day',
+      '文化の日' => 'Culture Day',
+      '勤労感謝の日' => 'Labor Thanksgiving Day',
+      '振替休日' => 'Substitute Holiday',
+      '休日' => "Citizens' Holiday",
+      '体育の日' => 'Health and Sports Day',
+      '国民の休日' => "Citizens' Holiday",
+      '即位礼正殿の儀の行われる日' => 'Enthronement Ceremony',
+      '即位の日' => 'Enthronement Day',
+      '天皇の即位の日及び即位礼正殿の儀の行われる日を休日とする法律' => 'Holiday by Law',
+      'みどりの日（国民の休日）' => "Greenery Day (Citizens' Holiday)",
+    }.freeze
+
+    attr_reader :date, :name
+
+    def initialize(date, name)
+      @date = date
+      @name = name
+    end
+
+    def name_en
+      EN_HOLIDAY_NAMES[name]
+    end
+
+    def wday_name
+      WDAY_NAMES[date.wday]
+    end
+
+    alias week wday_name
+  end
+end

data/lib/verified_holidays/holiday_jp_compat.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require 'verified_holidays'
+
+# Drop-in replacement for holiday_jp gem.
+# Simply replace:
+#   require 'holiday_jp'
+# with:
+#   require 'verified_holidays/holiday_jp_compat'
+HolidayJp = VerifiedHolidays unless defined?(HolidayJp)

data/lib/verified_holidays/verifier.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module VerifiedHolidays
+  class Verifier
+    class Result
+      attr_reader :missing, :extra, :mismatched
+
+      def initialize(missing:, extra:, mismatched:)
+        @missing = missing
+        @extra = extra
+        @mismatched = mismatched
+      end
+
+      def valid?
+        missing.empty? && extra.empty? && mismatched.empty?
+      end
+    end
+
+    def self.verify!
+      cabinet_data = CabinetOffice.fetch
+      local_in_range = filter_local_data(cabinet_data)
+
+      missing, mismatched = compare_local_to_cabinet(local_in_range, cabinet_data)
+      extra = find_extra(cabinet_data, local_in_range)
+
+      Result.new(missing: missing, extra: extra, mismatched: mismatched)
+    end
+
+    def self.filter_local_data(cabinet_data)
+      cabinet_dates = cabinet_data.keys
+      min_date = cabinet_dates.min
+      max_date = cabinet_dates.max
+
+      Dataset.instance.all.select { |date, _| date.between?(min_date, max_date) }
+    end
+    private_class_method :filter_local_data
+
+    def self.compare_local_to_cabinet(local_in_range, cabinet_data)
+      missing = []
+      mismatched = []
+
+      local_in_range.each do |date, holiday|
+        unless cabinet_data.key?(date)
+          missing << { date: date, name: holiday.name }
+          next
+        end
+
+        cabinet_name = cabinet_data[date]
+        mismatched << { date: date, expected: holiday.name, actual: cabinet_name } if holiday.name != cabinet_name
+      end
+
+      [missing, mismatched]
+    end
+    private_class_method :compare_local_to_cabinet
+
+    def self.find_extra(cabinet_data, local_in_range)
+      cabinet_data.each_with_object([]) do |(date, name), extra|
+        extra << { date: date, name: name } unless local_in_range.key?(date)
+      end
+    end
+    private_class_method :find_extra
+  end
+end

data/lib/verified_holidays/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module VerifiedHolidays
+  VERSION = '0.1.0'
+end

data/lib/verified_holidays.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require_relative 'verified_holidays/version'
+require_relative 'verified_holidays/holiday'
+require_relative 'verified_holidays/dataset'
+require_relative 'verified_holidays/cabinet_office'
+require_relative 'verified_holidays/verifier'
+
+module VerifiedHolidays
+  def self.holiday?(date)
+    Dataset.instance.holiday?(date)
+  end
+
+  def self.between(start_date, last_date)
+    Dataset.instance.between(start_date, last_date)
+  end
+
+  def self.name(date)
+    Dataset.instance.name(date)
+  end
+
+  def self.year(year)
+    Dataset.instance.year(year)
+  end
+
+  def self.verify!
+    Verifier.verify!
+  end
+end

metadata

@@ -0,0 +1,72 @@
+--- !ruby/object:Gem::Specification
+name: verified_holidays
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Kenta Ishizaki
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: csv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A Japanese national holiday gem that verifies its built-in data against
+  the Cabinet Office official CSV every week. Provides holiday?, between, name, and
+  year methods with English name support.
+email:
+- kentaishizaki@55728.jp
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- data/holidays.yml
+- lib/verified_holidays.rb
+- lib/verified_holidays/cabinet_office.rb
+- lib/verified_holidays/dataset.rb
+- lib/verified_holidays/holiday.rb
+- lib/verified_holidays/holiday_jp_compat.rb
+- lib/verified_holidays/verifier.rb
+- lib/verified_holidays/version.rb
+homepage: https://github.com/55728/verified_holidays
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/55728/verified_holidays
+  source_code_uri: https://github.com/55728/verified_holidays
+  changelog_uri: https://github.com/55728/verified_holidays/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.6
+specification_version: 4
+summary: Japanese national holidays with weekly verification against Cabinet Office
+  data
+test_files: []