verified_holidays 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8bf224234d064575a5e2d60e74f9aac823e62e71fd28389ea0b1be39e380fa6c
+  data.tar.gz: 1e3f31e88cbec4989403d3078541e272f18a0da9f3ade17268ffc4ab748f099a
+SHA512:
+  metadata.gz: f2a5466e749d0bb1b4a53cfe37750a6769eb8aa7aafa81f3849c6fdad67bde357f11ea6a83a4bdcbf8dd314dd065e5993680419c0b708e50c43e17cdae1ec066
+  data.tar.gz: 0e914bc27a8658f5e545faec361560fda9326c8bbedfcd90555ab324137b3f5886e37e7a3c35782f6a8edbdc3006e559dbc420dfc4daf83b372e4f571fc6dbb2

data/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+## [0.1.0] - 2026-03-20
+
+- Initial release as `verified_holidays` (previously developed as `shukujitsu`)
+- `VerifiedHolidays.holiday?` — check if a date is a Japanese national holiday
+- `VerifiedHolidays.between` — list holidays in a date range
+- `VerifiedHolidays.name` — get the holiday name for a date
+- `VerifiedHolidays.year` — list all holidays for a given year
+- `VerifiedHolidays.verify!` — verify built-in data against Cabinet Office CSV
+- `VerifiedHolidays::Holiday` — holiday data class with `name_en`, `wday_name`
+- holiday_jp drop-in compatibility via `require 'verified_holidays/holiday_jp_compat'`
+- Weekly CI verification against Cabinet Office official data
+- Holiday data from 1955 to 2027 (sourced from Cabinet Office CSV)

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kenta Ishizaki
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,110 @@
+# VerifiedHolidays
+
+[![Test](https://github.com/55728/verified_holidays/actions/workflows/test.yml/badge.svg)](https://github.com/55728/verified_holidays/actions/workflows/test.yml)
+[![Weekly Verification](https://github.com/55728/verified_holidays/actions/workflows/verify.yml/badge.svg)](https://github.com/55728/verified_holidays/actions/workflows/verify.yml)
+[![Gem Version](https://badge.fury.io/rb/verified_holidays.svg)](https://badge.fury.io/rb/verified_holidays)
+
+Japanese national holiday gem with **weekly verification against the Cabinet Office official data**.
+
+If the verification badge is green, the holiday data is correct.
+
+## Why "verified_holidays"?
+
+Because the data is **verified**. Every week, GitHub Actions checks our built-in
+holiday data against the Cabinet Office official CSV. If it matches, the badge
+stays green.
+
+## Installation
+
+```ruby
+gem "verified_holidays"
+```
+
+## Usage
+
+```ruby
+require "verified_holidays"
+
+# Check if a date is a holiday
+VerifiedHolidays.holiday?(Date.new(2026, 1, 1))  # => true
+VerifiedHolidays.holiday?(Date.new(2026, 3, 19)) # => false
+
+# Date, DateTime, Time are all accepted
+VerifiedHolidays.holiday?(Time.new(2026, 1, 1))  # => true
+
+# Get holidays in a date range
+holidays = VerifiedHolidays.between(Date.new(2026, 1, 1), Date.new(2026, 12, 31))
+holidays.each do |h|
+  puts "#{h.date} #{h.name} (#{h.name_en})"
+end
+
+# Get the holiday name
+VerifiedHolidays.name(Date.new(2026, 1, 1))  # => "元日"
+VerifiedHolidays.name(Date.new(2026, 3, 19)) # => nil
+
+# Get all holidays for a year
+VerifiedHolidays.year(2026)
+# => [#<VerifiedHolidays::Holiday>, ...]
+```
+
+### Holiday object
+
+```ruby
+holiday = VerifiedHolidays.between(Date.new(2026, 1, 1), Date.new(2026, 1, 1)).first
+holiday.date     # => #<Date: 2026-01-01>
+holiday.name     # => "元日"
+holiday.name_en  # => "New Year's Day"
+holiday.wday_name # => "Thursday"
+holiday.week     # => "Thursday" (alias for wday_name)
+```
+
+## Migration from holiday_jp
+
+Replace:
+
+```ruby
+require "holiday_jp"
+```
+
+with:
+
+```ruby
+require "verified_holidays/holiday_jp_compat"
+```
+
+That's it. `HolidayJp.holiday?`, `HolidayJp.between`, and `HolidayJp::Holiday` all work as before.
+
+## Verification
+
+This gem verifies its built-in data against the [Cabinet Office CSV](https://www8.cao.go.jp/chosei/shukujitsu/syukujitsu.csv) every week via GitHub Actions.
+
+You can also run the verification yourself:
+
+```ruby
+result = VerifiedHolidays.verify!
+result.valid?      # => true
+result.missing     # => entries in local data but not in Cabinet Office CSV
+result.extra       # => entries in Cabinet Office CSV but not in local data
+result.mismatched  # => entries with different names
+```
+
+Or via Rake:
+
+```sh
+bundle exec rake verified_holidays:verify
+```
+
+## Data Source
+
+Holiday data is sourced from the Cabinet Office of Japan (内閣府):
+https://www8.cao.go.jp/chosei/shukujitsu/gaiyou.html
+
+The data is provided under the terms of the [Government of Japan Standard Terms of Use](https://www.kantei.go.jp/jp/singi/it2/densi/kettei/gl2_betten_1.pdf) (CC BY compatible).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/55728/verified_holidays.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).