nepdate 1.0.0.rc.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6c86b1e5b783d2dc84cc9da674aceffb71920bd19e2f2b8111e8d6751e09b6d9
+  data.tar.gz: 211ce28cd66a3ccf82c0a4da54db92c6660f5331081336e2bb721fa4b0891ef7
+SHA512:
+  metadata.gz: 49e3d014c8ea39df2caff0cab1836a4efe9ec3050cf8cc715ea14ef9aa6d0ac9fb9657d36c29b651ab2f5820ae0e4559d2105b90a558ea1a1021c414c856421d
+  data.tar.gz: aaad43083101faf2356e5ce17b6a800b6a5dc76aa11aee44d0e079348cc715f2e6f78f6e784a0452aea9fcf8e0485f1bd5129f979b6042b7330995878ae9d0cb

data/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+See the repository's [CHANGELOG.md](https://github.com/sanamhub/nepdate-ruby/blob/main/CHANGELOG.md).
+
+## [Unreleased]
+
+### Added
+
+- The `nepdate` gem, version 1.0.0-rc.1, with Bikram Sambat dates, conversion, arithmetic,
+  formatting, parsing, ranges and fiscal years.

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NepDate contributors
+
+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/NOTICE

@@ -0,0 +1,31 @@
+NepDate for Ruby
+
+This repository ports NepDate, the C# library by Raju Prasai and contributors
+(https://github.com/RajuPrasai/NepDate), to Ruby. The calendar and patro data, the golden test
+vectors and the behaviour this port follows all come from that library.
+
+The calendar data in shared/data (data/calendar/, data/patro/) was extracted from
+NepDate (https://github.com/RajuPrasai/NepDate, commit c6fff4f2f60ac01e31c086568320649627422ba1)
+and is used under the MIT License:
+
+MIT License
+
+Copyright (c) 2023 NepDate and contributors
+
+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,20 @@
+# nepdate
+
+Bikram Sambat (Nepali calendar) dates for Ruby: conversion to and from Gregorian, arithmetic with
+clamp and spill, formatting and parsing in English and Nepali, inclusive ranges and fiscal years.
+Pure Ruby, Ruby 3.4 or newer, no runtime dependency.
+
+```ruby
+require "nepdate"
+
+date = NepDate::Date.from_bs(2081, 4, 15)
+puts date                   # 2081/04/15
+puts date.to_date           # 2024-07-30
+puts date.to_long_string(weekday: true)
+```
+
+`nepdate-patro` adds tithi, public holidays and events. The full API is in the repository's
+[docs/API.md](https://github.com/sanamhub/nepdate-ruby/blob/main/docs/API.md). Part of the NepDate
+family; the data and behaviour come from the hub
+[`sanamhub/nepdate`](https://github.com/sanamhub/nepdate) and the C# original
+[NepDate](https://github.com/RajuPrasai/NepDate).

data/lib/nepdate/calendar.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+module NepDate
+  # BS serial arithmetic and the proleptic Gregorian conversion of ALGORITHM.md sections 3 to 6.
+  # @api private
+  module Calendar
+    GREGORIAN_MONTH_LENGTHS = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31].freeze
+
+    module_function
+
+    def month_length(year, month)
+      index = year - CalendarTable::MIN_YEAR
+      unless index >= 0 && index < CalendarTable::YEARS
+        raise OutOfRangeError, "year #{year} is outside #{CalendarTable::MIN_YEAR}..#{CalendarTable::MAX_YEAR}"
+      end
+      unless month.between?(1, 12)
+        raise InvalidMonthError, "month #{month} is outside 1..12"
+      end
+
+      packed = CalendarTable::PACKED.fetch(index)
+      29 + ((packed >> (2 * (month - 1))) & 0b11)
+    end
+
+    def to_serial(year, month, day)
+      CalendarTable::MONTH_START.fetch((year - CalendarTable::MIN_YEAR) * 12 + month - 1) + day - 1
+    end
+
+    def validate(year, month, day)
+      unless year.between?(CalendarTable::MIN_YEAR, CalendarTable::MAX_YEAR)
+        raise OutOfRangeError, "year #{year} is outside #{CalendarTable::MIN_YEAR}..#{CalendarTable::MAX_YEAR}"
+      end
+      unless month.between?(1, 12)
+        raise InvalidMonthError, "month #{month} is outside 1..12"
+      end
+
+      length = month_length(year, month)
+      unless day.between?(1, length)
+        raise InvalidDayError, "day #{day} is outside 1..#{length}"
+      end
+
+      true
+    end
+
+    # Proleptic Gregorian civil date to days since 1970-01-01, by Howard Hinnant's algorithm.
+    def days_from_civil(year, month, day)
+      year -= 1 if month <= 2
+      era = year.div(400)
+      year_of_era = year - era * 400
+      month_prime = (month + 9) % 12
+      day_of_year = (153 * month_prime + 2) / 5 + day - 1
+      day_of_era = year_of_era * 365 + year_of_era / 4 - year_of_era / 100 + day_of_year
+      era * 146097 + day_of_era - 719_468
+    end
+
+    def civil_from_days(days)
+      days += 719_468
+      era = days.div(146_097)
+      day_of_era = days - era * 146_097
+      year_of_era = (day_of_era - day_of_era / 1460 + day_of_era / 36_524 - day_of_era / 146_096) / 365
+      year = year_of_era + era * 400
+      day_of_year = day_of_era - (365 * year_of_era + year_of_era / 4 - year_of_era / 100)
+      month_prime = (5 * day_of_year + 2) / 153
+      day = day_of_year - (153 * month_prime + 2) / 5 + 1
+      month = (month_prime < 10) ? month_prime + 3 : month_prime - 9
+      year += 1 if month <= 2
+      [year, month, day]
+    end
+
+    def gregorian_month_length(year, month)
+      return 29 if month == 2 && gregorian_leap_year?(year)
+
+      GREGORIAN_MONTH_LENGTHS.fetch(month - 1)
+    end
+
+    def gregorian_leap_year?(year)
+      (year % 4).zero? && !(year % 100).zero? || (year % 400).zero?
+    end
+
+    def valid_gregorian?(year, month, day)
+      return false unless (1..12).cover?(month)
+
+      (1..gregorian_month_length(year, month)).cover?(day)
+    end
+  end
+end