date_values 0.1.3 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 18c625b8766c99ee4e063b2d2b756f68702d7468301cf0e14cb61c29647bc97e
-  data.tar.gz: cc21e80e920a5590109a62894d362b541f5f7362835f7d5113980b20bc28842f
+  metadata.gz: f294856b7f5149ded52770b4d43d003b5cac6e8ee533f81ec003ac04caf9988b
+  data.tar.gz: 8c1f6046926d15cda1a01e55f89e2975b92e6cf515bbc21cb0b6892d816bf93b
 SHA512:
-  metadata.gz: 3ea359a67138a64040d1fc62a9288c3862665f636db9e1651697ec6527390e1e53cb002f87745df2189b8eba8944f104e127b620af032be0e92d5a5d707f77a2
-  data.tar.gz: f5a8b524c53566ee986a3eea6bf28d08e889a428d15b7ae48f04443d46108ee7b882391adc82bc597af10338ef071ec9ecb83dc6812718d67ef332c5065432eb
+  metadata.gz: 05e23c3cd91ddda9dcdf5ae63e81dd89c7a6bfd5150dab2893231ebe63c12bc64023cae0667c296e4e88db2dd5869ebdab39245370291cb29cbb9b2d906ad3e3
+  data.tar.gz: 28e82e5dc12f33c6e8af8b546338636ef2f6cda3273a2957bf7f86dcb4bb4a6074a4e2376c1c0ed0600f19e98b2783661710c8882b066eb05d3d9c1aa359aea8

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 ## [Unreleased]
 
+## [0.2.0] - 2026-03-20
+
+- **Breaking**: Rails integration extracted to [date_values-rails](https://github.com/ursm/date_values-rails). `require 'date_values/rails'` now requires installing `date_values-rails` gem.
+
+## [0.1.4] - 2026-03-20
+
+- Cast returns `nil` for invalid input instead of raising, following Rails convention
+- Add `date_value` validator to distinguish "invalid input" from "no input"
+- `#inspect` now uses `#<ClassName value>` format following Ruby convention
+- Works with Rails standard validators (`comparison`, `inclusion`, `exclusion`)
+
 ## [0.1.3] - 2026-03-20
 
 - Fix ActiveRecord type registration — use `ActiveSupport.on_load(:active_record)` to register types regardless of load order

data/README.md

@@ -24,27 +24,31 @@ ym = YearMonth.new(2026, 3)
 ym.to_s                          # => "2026-03"
 ym.to_date                       # => #<Date: 2026-03-01>
 
-YearMonth.from(Date.today)       # => YearMonth[2026-03]
-YearMonth.parse('2026-03')       # => YearMonth[2026-03]
+YearMonth.from(Date.today)       # => #<DateValues::YearMonth 2026-03>
+YearMonth.parse('2026-03')       # => #<DateValues::YearMonth 2026-03>
+YearMonth.parse('2026/3')        # also works
 
-ym + 1                           # => YearMonth[2026-04]
-ym - 1                           # => YearMonth[2026-02]
+ym + 1                           # => #<DateValues::YearMonth 2026-04>
+ym - 1                           # => #<DateValues::YearMonth 2026-02>
 YearMonth.new(2026, 3) - YearMonth.new(2025, 1)  # => 14
 
 # Range support
 (YearMonth.new(2026, 1)..YearMonth.new(2026, 3)).to_a
-# => [YearMonth[2026-01], YearMonth[2026-02], YearMonth[2026-03]]
+# => [#<DateValues::YearMonth 2026-01>, #<DateValues::YearMonth 2026-02>, #<DateValues::YearMonth 2026-03>]
 ```
 
 ### MonthDay
 
+String representation uses ISO 8601 `--MM-DD` format (year omitted):
+
 ```ruby
 md = MonthDay.new(3, 19)
 md.to_s                          # => "--03-19"
 md.to_date(2026)                 # => #<Date: 2026-03-19>
 
-MonthDay.from(Date.today)        # => MonthDay[--03-20]
-MonthDay.parse('--03-19')        # => MonthDay[--03-19]
+MonthDay.from(Date.today)        # => #<DateValues::MonthDay --03-20>
+MonthDay.parse('--03-19')        # => #<DateValues::MonthDay --03-19>
+MonthDay.parse('3/19')           # also works
 
 # Range membership
 summer = MonthDay.new(6, 1)..MonthDay.new(8, 31)
@@ -59,8 +63,8 @@ tod.to_s                         # => "14:30"
 
 TimeOfDay.new(14, 30, 45).to_s  # => "14:30:45"
 
-TimeOfDay.from(Time.now)         # => TimeOfDay[14:30]
-TimeOfDay.parse('14:30')         # => TimeOfDay[14:30]
+TimeOfDay.from(Time.now)         # => #<DateValues::TimeOfDay 14:30>
+TimeOfDay.parse('14:30')         # => #<DateValues::TimeOfDay 14:30>
 
 # Range membership
 business_hours = TimeOfDay.new(9, 0)..TimeOfDay.new(17, 0)
@@ -90,61 +94,7 @@ end
 
 ## Rails Integration
 
-Opt-in ActiveModel type casting for ActiveRecord attributes:
-
-```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
-```
-
-Values are automatically serialized in queries:
-
-```ruby
-Shop.where(billing_month: YearMonth.new(2026, 3))
-# SELECT * FROM shops WHERE billing_month = '2026-03'
-```
-
-### 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'
-```
-
-```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分'
-```
-
-```ruby
-I18n.l YearMonth.new(2026, 3), locale: :en  # => "March 2026"
-I18n.l YearMonth.new(2026, 3), locale: :ja  # => "2026年3月"
-```
+See [date_values-rails](https://github.com/ursm/date_values-rails) for ActiveModel/ActiveRecord type casting, validation, and I18n support.
 
 ## License
 

data/lib/date_values/month_day.rb

@@ -18,10 +18,11 @@ module DateValues
     end
 
     def self.parse(str)
-      raise ArgumentError, "invalid MonthDay: #{str}" unless str.match?(/\A--\d{2}-\d{2}\z/)
-
-      month, day = str[2..].split('-').map(&:to_i)
-      new(month, day)
+      case str
+      when /\A--(\d{1,2})-(\d{1,2})\z/ then new($1.to_i, $2.to_i)
+      when /\A(\d{1,2})[\/\-](\d{1,2})\z/ then new($1.to_i, $2.to_i)
+      else raise ArgumentError, "invalid MonthDay: #{str}"
+      end
     end
 
     def <=>(other)
@@ -44,7 +45,7 @@ module DateValues
     end
 
     def inspect
-      "MonthDay[#{self}]"
+      "#<DateValues::MonthDay #{self}>"
     end
 
     private

data/lib/date_values/time_of_day.rb

@@ -42,7 +42,7 @@ module DateValues
     end
 
     def inspect
-      "TimeOfDay[#{self}]"
+      "#<DateValues::TimeOfDay #{self}>"
     end
   end
 end

data/lib/date_values/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DateValues
-  VERSION = '0.1.3'
+  VERSION = '0.2.0'
 end

data/lib/date_values/year_month.rb

@@ -17,10 +17,10 @@ module DateValues
     end
 
     def self.parse(str)
-      raise ArgumentError, "invalid YearMonth: #{str}" unless str.match?(/\A\d{4}-\d{2}\z/)
-
-      year, month = str.split('-').map(&:to_i)
-      new(year, month)
+      case str
+      when /\A(\d{4})[\/\-](\d{1,2})\z/ then new($1.to_i, $2.to_i)
+      else raise ArgumentError, "invalid YearMonth: #{str}"
+      end
     end
 
     def <=>(other)
@@ -62,7 +62,7 @@ module DateValues
     end
 
     def inspect
-      "YearMonth[#{self}]"
+      "#<DateValues::YearMonth #{self}>"
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: date_values
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.2.0
 platform: ruby
 authors:
 - Keita Urashima
@@ -21,16 +21,10 @@ files:
 - Rakefile
 - lib/date_values.rb
 - lib/date_values/month_day.rb
-- lib/date_values/rails.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/year_month_type.rb
 - lib/date_values/time_of_day.rb
 - lib/date_values/version.rb
 - lib/date_values/year_month.rb
 - sig/date_values.rbs
-- sig/date_values/rails.rbs
 homepage: https://github.com/ursm/date_values
 licenses:
 - MIT

data/lib/date_values/rails/i18n_backend.rb

@@ -1,29 +0,0 @@
-# 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

@@ -1,30 +0,0 @@
-# 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 String   then MonthDay.parse(value)
-        when nil      then nil
-        else raise ArgumentError, "can't cast #{value.class} to MonthDay"
-        end
-      end
-
-      def serialize(value)
-        value&.to_s
-      end
-
-      def deserialize(value)
-        return nil if value.nil?
-
-        MonthDay.parse(value)
-      end
-    end
-  end
-end

data/lib/date_values/rails/time_of_day_type.rb

@@ -1,33 +0,0 @@
-# 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 Time      then TimeOfDay.new(value.hour, value.min, value.sec)
-        when String    then TimeOfDay.parse(value)
-        when nil       then nil
-        else raise ArgumentError, "can't cast #{value.class} to TimeOfDay"
-        end
-      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
-    end
-  end
-end

data/lib/date_values/rails/year_month_type.rb

@@ -1,30 +0,0 @@
-# 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 String    then YearMonth.parse(value)
-        when nil       then nil
-        else raise ArgumentError, "can't cast #{value.class} to YearMonth"
-        end
-      end
-
-      def serialize(value)
-        value&.to_s
-      end
-
-      def deserialize(value)
-        return nil if value.nil?
-
-        YearMonth.parse(value)
-      end
-    end
-  end
-end

data/lib/date_values/rails.rb

@@ -1,21 +0,0 @@
-# frozen_string_literal: true
-
-require 'date_values'
-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'
-
-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

@@ -1,44 +0,0 @@
-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