date_values 0.1.4 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3ed7149400551e703761bd9ea324f55decb43cfe14e11d36d8e6e22f1fcb21a3
-  data.tar.gz: d809fce0b0215b62891a453b4e7e4278ad7a600ffea25cc045662f4a4ae1425b
+  metadata.gz: f294856b7f5149ded52770b4d43d003b5cac6e8ee533f81ec003ac04caf9988b
+  data.tar.gz: 8c1f6046926d15cda1a01e55f89e2975b92e6cf515bbc21cb0b6892d816bf93b
 SHA512:
-  metadata.gz: 821ca618c27d3b17583c8420697ad11cbb3b9ee34dc44d7ea4d938ffd4500a4795b8aacd6b41df9864c982877d201c0dc616fecbca6342945c671b8b1f410679
-  data.tar.gz: f69de80391b67de78fafca31368c4f54683299c94740eba4047d0dff800ecb0647bcf208039473911fbf0fb60cbbb5595ef3c322d79154b72bc39e47056361a5
+  metadata.gz: 05e23c3cd91ddda9dcdf5ae63e81dd89c7a6bfd5150dab2893231ebe63c12bc64023cae0667c296e4e88db2dd5869ebdab39245370291cb29cbb9b2d906ad3e3
+  data.tar.gz: 28e82e5dc12f33c6e8af8b546338636ef2f6cda3273a2957bf7f86dcb4bb4a6074a4e2376c1c0ed0600f19e98b2783661710c8882b066eb05d3d9c1aa359aea8

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [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

data/README.md

@@ -26,6 +26,7 @@ ym.to_date                       # => #<Date: 2026-03-01>
 
 YearMonth.from(Date.today)       # => #<DateValues::YearMonth 2026-03>
 YearMonth.parse('2026-03')       # => #<DateValues::YearMonth 2026-03>
+YearMonth.parse('2026/3')        # also works
 
 ym + 1                           # => #<DateValues::YearMonth 2026-04>
 ym - 1                           # => #<DateValues::YearMonth 2026-02>
@@ -47,6 +48,7 @@ md.to_date(2026)                 # => #<Date: 2026-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)
@@ -92,95 +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'
-```
-
-### 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"
-```
+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)

data/lib/date_values/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DateValues
-  VERSION = '0.1.4'
+  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)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: date_values
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.2.0
 platform: ruby
 authors:
 - Keita Urashima
@@ -21,17 +21,10 @@ files:
 - Rakefile
 - lib/date_values.rb
 - lib/date_values/month_day.rb
-- 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/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/date_value_validator.rb

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

@@ -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,31 +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
-        end
-      rescue ArgumentError
-        nil
-      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,34 +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
-        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
-    end
-  end
-end

data/lib/date_values/rails/year_month_type.rb

@@ -1,31 +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
-        end
-      rescue ArgumentError
-        nil
-      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,22 +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'
-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

@@ -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