date_values-rails 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 5c1bf3a457deec7273dfaa168ac05e53502775d7877d6c02159ec25639c7fdd8
+  data.tar.gz: 7c17fd631f2035b8e68899e4d1b9ae5393e578c77db2429ad69222e8532a525f
+SHA512:
+  metadata.gz: 3fb2a359513982c11b69c290af20f23d1b651069474879525153387b96a97921165da07078e493f84634929ea31fec8c1c2b6eb796a13b865ffb6b4a0d52e6fb
+  data.tar.gz: 7bfdab0ce9089d8ab4fd7d121765255c2ccc9e7cfe2eabd4ab736714fbf6714d76dbce638f4e6eecbad05abd6b77ea3244b1de72aa2957dbc3b3271d9cf8c543

data/CHANGELOG.md

@@ -0,0 +1,10 @@
+## [Unreleased]
+
+## [0.1.0] - 2026-03-20
+
+- Extracted from [date_values](https://github.com/ursm/date_values) gem
+- ActiveModel types: `:year_month`, `:month_day`, `:time_of_day`
+- ActiveRecord type registration via `ActiveSupport.on_load`
+- I18n backend extension for Rails `l` helper
+- `date_value` validator for invalid input detection
+- Cast accepts Hash params from forms and lenient string formats

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Keita Urashima
+
+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,117 @@
+# DateValues::Rails
+
+Rails integration for [date_values](https://github.com/ursm/date_values) — ActiveModel type casting, validation, and I18n support for `YearMonth`, `MonthDay`, and `TimeOfDay`.
+
+## Installation
+
+```bash
+bundle add date_values-rails
+```
+
+This will also install `date_values` as a dependency.
+
+## Usage
+
+```ruby
+require 'date_values/rails'
+
+class Shop < ApplicationRecord
+  attribute :billing_month, :year_month   # string column "2026-03"
+  attribute :anniversary,   :month_day    # string column "--03-19"
+  attribute :opens_at,      :time_of_day  # string or time column
+end
+```
+
+### Form Input
+
+Cast accepts Hash params from forms, so select-based inputs work naturally:
+
+```ruby
+# params[:shop][:anniversary] => {"month" => "3", "day" => "19"}
+shop.anniversary  # => #<DateValues::MonthDay --03-19>
+```
+
+String input is lenient — `"3/19"`, `"03-19"`, and `"--03-19"` are all accepted.
+
+### Queries
+
+Values are automatically serialized in queries:
+
+```ruby
+Shop.where(billing_month: YearMonth.new(2026, 3))
+# SELECT * FROM shops WHERE billing_month = '2026-03'
+```
+
+### Validation
+
+All classes are `Comparable` and value-equal, so standard Rails validators work as-is:
+
+```ruby
+class Contract < ApplicationRecord
+  attribute :start_month, :year_month
+  attribute :opens_at,    :time_of_day
+
+  validates :start_month, comparison: {greater_than: -> { YearMonth.from(Date.current) }}
+  validates :opens_at,    comparison: {
+    greater_than_or_equal_to: TimeOfDay.new(9, 0),
+    less_than_or_equal_to:    TimeOfDay.new(17, 0)
+  }
+end
+```
+
+Invalid input (e.g. `"25:00"`) is cast to `nil` rather than raising, following the same convention as Rails' built-in types. The `date_value` validator detects this and gives a meaningful error message:
+
+```ruby
+class Shop < ApplicationRecord
+  attribute :opens_at, :time_of_day
+
+  validates :opens_at, presence: true, date_value: true
+end
+
+Shop.new(opens_at: '25:00').errors[:opens_at]  # => ["is invalid"]
+Shop.new(opens_at: '').errors[:opens_at]       # => ["can't be blank"]
+```
+
+### I18n / `l` Helper
+
+All classes implement `#strftime`, and the Rails integration extends `I18n.l` to support them. Define formats in your locale files:
+
+```yaml
+# config/locales/en.yml
+en:
+  year_month:
+    formats:
+      default: '%B %Y'
+  month_day:
+    formats:
+      default: '%B %-d'
+  time_of_day:
+    formats:
+      default: '%-I:%M %p'
+      long: '%-I:%M:%S %p'
+```
+
+```yaml
+# config/locales/ja.yml
+ja:
+  year_month:
+    formats:
+      default: '%Y年%-m月'
+  month_day:
+    formats:
+      default: '%-m月%-d日'
+  time_of_day:
+    formats:
+      default: '%-H時%-M分'
+      long: '%-H時%-M分%-S秒'
+```
+
+```ruby
+I18n.l YearMonth.new(2026, 3), locale: :en   # => "March 2026"
+I18n.l YearMonth.new(2026, 3), locale: :ja   # => "2026年3月"
+I18n.l TimeOfDay.new(14, 30), format: :long  # => "2:30:00 PM"
+```
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'minitest/test_task'
+
+Minitest::TestTask.create
+
+task default: :test

data/lib/date_values/rails/date_value_validator.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require 'active_model/validator'
+
+class DateValueValidator < ActiveModel::EachValidator
+  def validate_each(record, attribute, value)
+    raw = record.read_attribute_before_type_cast(attribute)
+    return if raw.blank?
+    return unless value.nil?
+
+    record.errors.add(attribute, :invalid, **options)
+  end
+end

data/lib/date_values/rails/i18n_backend.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module DateValues
+  module Rails
+    module I18nBackend
+      TYPES = {
+        DateValues::YearMonth  => :year_month,
+        DateValues::MonthDay   => :month_day,
+        DateValues::TimeOfDay  => :time_of_day
+      }.freeze
+
+      def localize(locale, object, format = :default, options = EMPTY_HASH)
+        type = TYPES[object.class]
+        return super unless type
+
+        format_key = format.is_a?(Symbol) ? format : nil
+
+        if format_key
+          entry = I18n.t("#{type}.formats.#{format_key}", locale: locale, default: nil)
+          raise I18n::MissingTranslationData.new(locale, "#{type}.formats.#{format_key}") unless entry
+
+          format = entry
+        end
+
+        object.strftime(format)
+      end
+    end
+  end
+end

data/lib/date_values/rails/month_day_type.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module DateValues
+  module Rails
+    class MonthDayType < ActiveModel::Type::Value
+      def type
+        :month_day
+      end
+
+      def cast(value)
+        case value
+        when MonthDay then value
+        when Hash     then cast_hash(value)
+        when String   then MonthDay.parse(value)
+        when nil      then nil
+        end
+      rescue ArgumentError
+        nil
+      end
+
+      def serialize(value)
+        value&.to_s
+      end
+
+      def deserialize(value)
+        return nil if value.nil?
+
+        MonthDay.parse(value)
+      end
+
+      private
+
+      def cast_hash(hash)
+        hash  = hash.transform_keys(&:to_sym)
+        month = hash[:month]&.to_i
+        day   = hash[:day]&.to_i
+        return nil unless month && day
+
+        MonthDay.new(month, day)
+      end
+    end
+  end
+end

data/lib/date_values/rails/time_of_day_type.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module DateValues
+  module Rails
+    class TimeOfDayType < ActiveModel::Type::Value
+      def type
+        :time_of_day
+      end
+
+      def cast(value)
+        case value
+        when TimeOfDay then value
+        when Hash      then cast_hash(value)
+        when Time      then TimeOfDay.new(value.hour, value.min, value.sec)
+        when String    then TimeOfDay.parse(value)
+        when nil       then nil
+        end
+      rescue ArgumentError
+        nil
+      end
+
+      def serialize(value)
+        value&.to_s
+      end
+
+      def deserialize(value)
+        case value
+        when nil       then nil
+        when Time      then TimeOfDay.new(value.hour, value.min, value.sec)
+        when String    then TimeOfDay.parse(value)
+        end
+      end
+
+      private
+
+      def cast_hash(hash)
+        hash   = hash.transform_keys(&:to_sym)
+        hour   = hash[:hour]&.to_i
+        minute = hash[:minute]&.to_i
+        second = hash[:second]&.to_i
+        return nil unless hour && minute
+
+        TimeOfDay.new(hour, minute, second || 0)
+      end
+    end
+  end
+end

data/lib/date_values/rails/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module DateValues
+  module Rails
+    VERSION = '0.1.0'
+  end
+end

data/lib/date_values/rails/year_month_type.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module DateValues
+  module Rails
+    class YearMonthType < ActiveModel::Type::Value
+      def type
+        :year_month
+      end
+
+      def cast(value)
+        case value
+        when YearMonth then value
+        when Hash      then cast_hash(value)
+        when String    then YearMonth.parse(value)
+        when nil       then nil
+        end
+      rescue ArgumentError
+        nil
+      end
+
+      def serialize(value)
+        value&.to_s
+      end
+
+      def deserialize(value)
+        return nil if value.nil?
+
+        YearMonth.parse(value)
+      end
+
+      private
+
+      def cast_hash(hash)
+        hash = hash.transform_keys(&:to_sym)
+        year  = hash[:year]&.to_i
+        month = hash[:month]&.to_i
+        return nil unless year && month
+
+        YearMonth.new(year, month)
+      end
+    end
+  end
+end

data/lib/date_values/rails.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require 'date_values'
+require_relative 'rails/version'
+require 'active_support'
+require 'active_model/type'
+require_relative 'rails/year_month_type'
+require_relative 'rails/month_day_type'
+require_relative 'rails/time_of_day_type'
+require_relative 'rails/i18n_backend'
+require_relative 'rails/date_value_validator'
+
+ActiveModel::Type.register(:year_month, DateValues::Rails::YearMonthType)
+ActiveModel::Type.register(:month_day, DateValues::Rails::MonthDayType)
+ActiveModel::Type.register(:time_of_day, DateValues::Rails::TimeOfDayType)
+
+ActiveSupport.on_load(:active_record) do
+  ActiveRecord::Type.register(:year_month, DateValues::Rails::YearMonthType)
+  ActiveRecord::Type.register(:month_day, DateValues::Rails::MonthDayType)
+  ActiveRecord::Type.register(:time_of_day, DateValues::Rails::TimeOfDayType)
+end
+
+I18n::Backend::Base.prepend(DateValues::Rails::I18nBackend)

data/sig/date_values/rails.rbs

@@ -0,0 +1,44 @@
+module DateValues
+  module Rails
+    class YearMonthType < ActiveModel::Type::Value
+      def type: () -> :year_month
+
+      def cast: (YearMonth value) -> YearMonth
+              | (String value) -> YearMonth
+              | (nil value) -> nil
+
+      def serialize: (YearMonth? value) -> String?
+
+      def deserialize: (String value) -> YearMonth
+                     | (nil value) -> nil
+    end
+
+    class MonthDayType < ActiveModel::Type::Value
+      def type: () -> :month_day
+
+      def cast: (MonthDay value) -> MonthDay
+              | (String value) -> MonthDay
+              | (nil value) -> nil
+
+      def serialize: (MonthDay? value) -> String?
+
+      def deserialize: (String value) -> MonthDay
+                     | (nil value) -> nil
+    end
+
+    class TimeOfDayType < ActiveModel::Type::Value
+      def type: () -> :time_of_day
+
+      def cast: (TimeOfDay value) -> TimeOfDay
+              | (Time value) -> TimeOfDay
+              | (String value) -> TimeOfDay
+              | (nil value) -> nil
+
+      def serialize: (TimeOfDay? value) -> String?
+
+      def deserialize: (Time value) -> TimeOfDay
+                     | (String value) -> TimeOfDay
+                     | (nil value) -> nil
+    end
+  end
+end

metadata

@@ -0,0 +1,82 @@
+--- !ruby/object:Gem::Specification
+name: date_values-rails
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Keita Urashima
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: date_values
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+- !ruby/object:Gem::Dependency
+  name: activemodel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+email:
+- ursm@ursm.jp
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/date_values/rails.rb
+- lib/date_values/rails/date_value_validator.rb
+- lib/date_values/rails/i18n_backend.rb
+- lib/date_values/rails/month_day_type.rb
+- lib/date_values/rails/time_of_day_type.rb
+- lib/date_values/rails/version.rb
+- lib/date_values/rails/year_month_type.rb
+- sig/date_values/rails.rbs
+homepage: https://github.com/ursm/date_values-rails
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/ursm/date_values-rails
+  source_code_uri: https://github.com/ursm/date_values-rails
+  changelog_uri: https://github.com/ursm/date_values-rails/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.6
+specification_version: 4
+summary: Rails integration for date_values
+test_files: []