foolabs-delocalize 0.2.1

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Clemens Kofler
+
+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

@@ -0,0 +1,117 @@
+delocalize
+==========
+
+delocalize provides localized date/time and number parsing functionality for Rails.
+
+Installation
+============
+
+You can use delocalize either as a gem (preferred) or as a Rails plugin.
+
+To use the gem version, put the following gem requirement in your environment.rb:
+
+  config.gem "delocalize", :source => 'http://gemcutter.org'
+
+To install it as a plugin, fire up your terminal, go to your Rails app and type:
+
+  $ ruby script/plugin install git://github.com/clemens/delocalize.git
+
+
+What does it do? And how do I use it?
+=====================================
+
+Delocalize, just as the name suggest, does pretty much the opposite of localize.
+
+In the grey past, ff you want your users to be able to input localized data, such as dates and numbers, you had to manually override attribute accessors:
+
+  def price=(price)
+    write_attribute(:price, price.gsub(',', '.'))
+  end
+
+delocalize does this under the covers - all you need is your regular translation data (as YAML or Ruby file) where you need Rails' standard translations:
+
+  de:
+    number:
+      format:
+        separator: ','
+        delimiter: '.'
+    date:
+      input:
+        formats: [:default, :long, :short] # <- this and ...
+
+      formats:
+        default: "%d.%m.%Y"
+        short: "%e. %b"
+        long: "%e. %B %Y"
+        only_day: "%e"
+
+      day_names: [Sonntag, Montag, Dienstag, Mittwoch, Donnerstag, Freitag, Samstag]
+      abbr_day_names: [So, Mo, Di, Mi, Do, Fr, Sa]
+      month_names: [~, Januar, Februar, März, April, Mai, Juni, Juli, August, September, Oktober, November, Dezember]
+      abbr_month_names: [~, Jan, Feb, Mär, Apr, Mai, Jun, Jul, Aug, Sep, Okt, Nov, Dez]
+      order: [ :day, :month, :year ]
+
+    time:
+      input:
+        formats: [:long, :medium, :short, :default, :time] # <- ... this are the only non-standard keys
+      formats:
+        default: "%A, %e. %B %Y, %H:%M Uhr"
+        short: "%e. %B, %H:%M Uhr"
+        long: "%A, %e. %B %Y, %H:%M Uhr"
+        time: "%H:%M"
+
+      am: "vormittags"
+      pm: "nachmittags"
+
+For dates and times, you have to define input formats which are taken from the actual formats. The important thing here is to define input formats sorted by descending complexity - in other words: The format which contains the most (preferably non-numeric) information should be first in the list because it can produce the most reliable match. Exception: If you think there most complex format is not the one that most users will input, you can put the most-used in front so you save unnecessary iterations.
+
+Careful with formats containing only numbers: It's very hard to produce reliable matches if you provide multiple strictly numeric formats!
+
+delocalize then overrides to_input_field_tag in ActionView's InstanceTag so you can use localized text fields:
+
+  <% form_for @product do |f| %>
+    <%= f.text_field :name %>
+    <%= f.text_field :released_on %>
+    <%= f.text_field :price %>
+  <% end %>
+  
+In this example, a user can enter the release date and the price just like he's used to in his language, for example:
+
+  Name: "Couch"
+  Released on: "12. Oktober 2009"
+  Price: "2.999,90"
+
+When saved, ActiveRecord automatically converts these to a regular Ruby date and number.
+
+Edit forms then also show localized dates/numbers. By default, dates and times are localized using the format named :default in your locale file. So with the above locale file, dates would use "%d.%m.%Y" and times would use "%A, %e. %B %Y, %H:%M Uhr". Numbers are also formatted using your locale's thousands delimiter and decimal separator.
+
+You can also customize the output using some options:
+
+  The price should always show two decimal digits and we don't need the delimiter:
+    <%= f.text_field :price, :precision => 2, :delimiter => '' %>
+  
+  The released_on date should be shown in the :full format:
+    <%= f.text_field :released_on, :format => :full %>
+  
+  Since I18n.localize supportes localizing strftime strings, we can also do this:
+    <%= f.text_field :released_on, :format => "%B %Y" %>
+
+Note
+====
+
+delocalize is most definitely not enterprise-ready! ;-)
+Or as Yaroslav says: Contains small pieces. Not good for children of age 3 and less. Not enterprise-ready.
+
+TODO
+====
+
+* Improve test coverage
+* Separate Ruby/Rails stuff to make it usable outside Rails
+* Verify correct behavior with time zones
+* Decide on other ActionView hacks (e.g. text_field_tag)
+* Implement AM/PM support
+* Cleanup, cleanup, cleanup ...
+
+Copyright (c) 2009 Clemens Kofler <clemens@railway.at>
+www.railway.at
+Released under the MIT license

data/Rakefile

@@ -0,0 +1,10 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+require 'tasks/distribution'
+require 'tasks/documentation'
+require 'tasks/testing'
+
+desc 'Default: run unit tests.'
+task :default => :test

data/VERSION

@@ -0,0 +1 @@
+0.2.1

data/init.rb

@@ -0,0 +1 @@
+require 'delocalize'

data/lib/delocalize.rb

@@ -0,0 +1,4 @@
+require 'delocalize/ruby_ext'
+require 'delocalize/i18n_ext'
+require 'delocalize/rails_ext'
+require 'delocalize/localized_date_time_parser'

data/lib/delocalize/i18n_ext.rb

@@ -0,0 +1,28 @@
+module I18n
+  mattr_accessor :enable_delocalization
+  I18n.enable_delocalization = true
+
+  class << self
+    def delocalization_enabled?
+      !!I18n.enable_delocalization
+    end
+
+    def delocalization_disabled?
+      !delocalization_enabled?
+    end
+
+    def with_delocalization_disabled(&block)
+      old_value = I18n.enable_delocalization
+      I18n.enable_delocalization = false
+      yield
+      I18n.enable_delocalization = old_value
+    end
+
+    def with_delocalization_enabled(&block)
+      old_value = I18n.enable_delocalization
+      I18n.enable_delocalization = true
+      yield
+      I18n.enable_delocalization = old_value
+    end
+  end
+end

data/lib/delocalize/localized_date_time_parser.rb

@@ -0,0 +1,101 @@
+# TODO:
+#   * AM/PM calculation
+#   * proper documentation (comments)
+module Delocalize
+  class LocalizedDateTimeParser
+    class << self
+      def parse(raw_datetime, type)
+        return unless raw_datetime
+        return raw_datetime if raw_datetime.respond_to?(:strftime) # already a Date/Time object -> no need to parse it
+
+        input_formats(type).each do |original_format, regex_format|
+          next unless raw_datetime =~ /^#{regex_format}$/
+
+          begin
+            translated = translate_month_and_day_names(raw_datetime)
+            datetime = DateTime.strptime(translated, original_format)
+          rescue ArgumentError => e
+            return default_parse(raw_datetime, type)
+          end
+
+          if Date == type
+            return datetime.to_date
+          else
+            return Time.local(
+              datetime.year, datetime.mon, datetime.mday,
+              datetime.hour, datetime.min, datetime.sec
+            )
+          end
+        end
+
+        default_parse(raw_datetime, type)
+      end
+
+      def valid_format?(raw_datetime, type)
+        return false unless raw_datetime
+        return true if raw_datetime.respond_to?(:strftime) # already a Date/Time object -> no need to parse it
+
+        return input_formats(type).any? do |original_format, regex_format|
+          begin
+            next unless raw_datetime =~ /^#{regex_format}$/
+            translated = translate_month_and_day_names(raw_datetime)
+            
+            DateTime.strptime(translated, original_format)
+          rescue ArgumentError => e
+            next
+          end
+        end
+      end
+
+      private
+      def default_parse(datetime, type)
+        return if datetime.blank?
+        begin
+          today = Date.current
+          parsed = Date._parse(datetime)
+          return if parsed.empty? # the datetime value is invalid
+          # set default year, month and day if not found
+          parsed.reverse_merge!(:year => today.year, :mon => today.mon, :mday => today.mday)
+          datetime = Time.local(*parsed.values_at(:year, :mon, :mday, :hour, :min, :sec))
+          Date == type ? datetime.to_date : datetime
+        rescue
+          datetime
+        end
+      end
+
+      def input_formats(type)
+        # Date uses date formats, all others use time formats
+        type = (type == Date) ? :date : :time
+        @input_formats ||= {}
+        @input_formats[I18n.locale] ||= {}
+        @input_formats[I18n.locale][type] ||= I18n.t(:"#{type}.formats").values.compact.map { |f| [f, apply_regex(f)] }
+      end
+
+      def translate_month_and_day_names(datetime)
+        translated = I18n.t([:month_names, :abbr_month_names, :day_names, :abbr_day_names], :scope => :date).flatten.compact
+        original = (Date::MONTHNAMES + Date::ABBR_MONTHNAMES + Date::DAYNAMES + Date::ABBR_DAYNAMES).compact
+        word_map = {}
+        translated.each_with_index{ |k,i| word_map[k] = original[i] }
+        datetime.gsub(/[^_\W]+/u){|x| word_map[x] || x}
+      end
+
+
+      def apply_regex(format)
+        format.gsub('%B', "(#{I18n.t('date.month_names').compact.join('|')})"). # long month name
+        gsub('%b', "(#{I18n.t('date.abbr_month_names').compact.join('|')})"). # short month name
+        gsub('%m', "(\\d{1,2})").                                   # numeric month
+        gsub('%A', "(#{I18n.t('date.day_names').compact.join('|')})").                # full day name
+        gsub('%a', "(#{I18n.t('date.abbr_day_names').compact.join('|')})").           # short day name
+        gsub('%Y', "(\\d{4})").                                     # long year
+        gsub('%y', "(\\d{2})").                                     # short year
+        gsub('%e', "(\\w?\\d{1,2})").                               # short day
+        gsub('%d', "(\\d{1,2})").                                   # full day
+        gsub('%H', "(\\d{1,2})").                                   # hour (24)
+        gsub('%d', "(\\d{1,2})").                                   # full day
+        gsub('%H', "(\\d{1,2})").                                   # hour (24)
+        gsub('%M', "(\\d{1,2})").                                   # minute
+        gsub('%S', "(\\d{1,2})")                                    # second
+      end
+    end
+  end
+end

data/lib/delocalize/localized_numeric_parser.rb

@@ -0,0 +1,25 @@
+# TODO:
+#   * proper documentation (comments)
+module Delocalize
+  class LocalizedNumericParser
+    class << self
+      # Parse numbers replacing locale specific delimeters and separators with
+      # standard ruby _ and .
+      def parse(value)
+        if value == false
+          0
+        elsif value == true
+          1
+        elsif value.is_a?(String) && value.blank?
+          nil
+        elsif value.is_a?(String)
+          separator = I18n.t(:'number.format.separator')
+          delimeter = I18n.t(:'number.format.delimiter')
+          value.strip.tr("#{separator}#{delimeter}", "._")
+        else
+          value
+        end
+      end
+    end
+  end
+end

data/lib/delocalize/rails_ext.rb

@@ -0,0 +1,4 @@
+require 'delocalize/rails_ext/active_record'
+require 'delocalize/rails_ext/action_view'
+require 'delocalize/rails_ext/time_zone'
+require 'delocalize/rails_ext/validation'

data/lib/delocalize/rails_ext/action_view.rb

@@ -0,0 +1,50 @@
+# TODO: also override other methods like to_check_box_tag since they might contain numeric values?
+# ActionView needs some patching too
+
+ActionView::Helpers::InstanceTag.class_eval do
+  include ActionView::Helpers::NumberHelper
+
+  alias original_to_input_field_tag to_input_field_tag
+  def to_input_field_tag(field_type, options = {})
+    options.symbolize_keys!
+    # numbers and dates/times should be localized unless value is already defined
+    if object && options[:value].blank? && object.respond_to?(:column_for_attribute) && column = object.column_for_attribute(method_name)
+      # a little verbose
+      if column.number? || column.date? || column.time?
+        value = object.send(method_name)
+
+        if column.number?
+          # formats the number only if it has errors
+          if object.respond_to?(:errors) && !object.errors.invalid?(method_name)
+            number_options = I18n.t(:'number.format')
+            separator = options.delete(:separator) || number_options[:separator]
+            delimiter = options.delete(:delimiter) || number_options[:delimiter]
+            precision = options.delete(:precision) || number_options[:precision]
+            opts = { :separator => separator, :delimiter => delimiter, :precision => precision }
+            # integers don't need a precision
+            opts.merge!(:precision => 0) if column.type == :integer
+            options[:value] = number_with_precision(value, opts)
+          end
+        elsif column.date? || column.time?
+          options[:value] = value ? I18n.l(value, :format => options.delete(:format)) : nil
+        end
+      end
+    end
+
+    original_to_input_field_tag(field_type, options)
+  end
+end
+
+# TODO: does it make sense to also override FormTagHelper methods?
+# ActionView::Helpers::FormTagHelper.class_eval do
+#   include ActionView::Helpers::NumberHelper
+# 
+#   alias original_text_field_tag text_field_tag
+#   def text_field_tag(name, value = nil, options = {})
+#     value = options.delete(:value) if options.key?(:value)
+#     if value.is_a?(Numeric)
+#       value = number_with_delimiter(value)
+#     end
+#     original_text_field_tag(name, value, options)
+#   end
+# end

data/lib/delocalize/rails_ext/active_record.rb

@@ -0,0 +1,55 @@
+# let's hack into ActiveRecord a bit - everything at the lowest possible level,
+# of course, so we minimalize side effects
+ActiveRecord::ConnectionAdapters::Column.class_eval do
+  def date?
+    klass == Date
+  end
+
+  def time?
+    klass == Time
+  end
+end
+
+ActiveRecord::Base.class_eval do
+  def convert_number_column_value_with_localization(value)
+    if I18n.delocalization_enabled?
+      Numeric.parse_localized(value)
+    else
+      convert_number_column_value_without_localization(value)
+    end
+  end
+  alias_method_chain :convert_number_column_value, :localization
+end
+
+ActiveRecord::Dirty.module_eval do
+  # overriding to convert numbers with localization
+  # this method belongs to Dirty module
+  def field_changed?(attr, old, value)
+    if column = column_for_attribute(attr)
+      if column.number?
+        if column.null && (old.nil? || old == 0) && value.blank?
+          # For nullable numeric columns, NULL gets stored in database for blank (i.e. '') values.
+          # Hence we don't record it as a change if the value changes from nil to ''.
+          # If an old value of 0 is set to '' we want this to get changed to nil as otherwise it'll
+          # be typecast back to 0 (''.to_i => 0)
+          value = nil
+        else
+          value = Numeric.parse_localized(value)
+        end
+      else
+        value = column.type_cast(value)
+      end
+    end
+
+    old != value
+  end
+end
+
+column_class = ActiveRecord::ConnectionAdapters::Column
+def column_class.string_to_date(value)
+  Date.parse_localized(value)
+end
+
+def column_class.string_to_time(value)
+  Time.parse_localized(value)
+end

data/lib/delocalize/rails_ext/time_zone.rb

@@ -0,0 +1,7 @@
+require 'delocalize/localized_date_time_parser'
+
+ActiveSupport::TimeZone.class_eval do
+  def parse_localized(time_with_zone)
+    Delocalize::LocalizedDateTimeParser.parse(time_with_zone, self.class)
+  end
+end

data/lib/delocalize/rails_ext/validation.rb

@@ -0,0 +1,91 @@
+module ActiveRecord::Validations::ClassMethods
+  # Validates whether the value of the specified attribute is numeric by trying to convert it to
+  # a float with Kernel.Float (if <tt>only_integer</tt> is false) or applying it to the regular expression
+  # <tt>/\A[\+\-]?\d+\Z/</tt> (if <tt>only_integer</tt> is set to true).
+  #
+  #   class Person < ActiveRecord::Base
+  #     validates_numericality_of :value, :on => :create
+  #   end
+  #
+  # Configuration options:
+  # * <tt>:message</tt> - A custom error message (default is: "is not a number").
+  # * <tt>:on</tt> - Specifies when this validation is active (default is <tt>:save</tt>, other options <tt>:create</tt>, <tt>:update</tt>).
+  # * <tt>:only_integer</tt> - Specifies whether the value has to be an integer, e.g. an integral value (default is +false+).
+  # * <tt>:allow_nil</tt> - Skip validation if attribute is +nil+ (default is +false+). Notice that for fixnum and float columns empty strings are converted to +nil+.
+  # * <tt>:greater_than</tt> - Specifies the value must be greater than the supplied value.
+  # * <tt>:greater_than_or_equal_to</tt> - Specifies the value must be greater than or equal the supplied value.
+  # * <tt>:equal_to</tt> - Specifies the value must be equal to the supplied value.
+  # * <tt>:less_than</tt> - Specifies the value must be less than the supplied value.
+  # * <tt>:less_than_or_equal_to</tt> - Specifies the value must be less than or equal the supplied value.
+  # * <tt>:odd</tt> - Specifies the value must be an odd number.
+  # * <tt>:even</tt> - Specifies the value must be an even number.
+  # * <tt>:if</tt> - Specifies a method, proc or string to call to determine if the validation should
+  #   occur (e.g. <tt>:if => :allow_validation</tt>, or <tt>:if => Proc.new { |user| user.signup_step > 2 }</tt>).  The
+  #   method, proc or string should return or evaluate to a true or false value.
+  # * <tt>:unless</tt> - Specifies a method, proc or string to call to determine if the validation should
+  #   not occur (e.g. <tt>:unless => :skip_validation</tt>, or <tt>:unless => Proc.new { |user| user.signup_step <= 2 }</tt>).  The
+  #   method, proc or string should return or evaluate to a true or false value.
+  def validates_numericality_of(*attr_names)
+    configuration = { :on => :save, :only_integer => false, :allow_nil => false }
+    configuration.update(attr_names.extract_options!)
+
+
+    numericality_options = ALL_NUMERICALITY_CHECKS.keys & configuration.keys
+
+    (numericality_options - [ :odd, :even ]).each do |option|
+      raise ArgumentError, ":#{option} must be a number" unless configuration[option].is_a?(Numeric)
+    end
+
+    validates_each(attr_names,configuration) do |record, attr_name, value|
+      raw_value = record.send("#{attr_name}_before_type_cast") || value
+
+      next if configuration[:allow_nil] and raw_value.nil?
+
+      unless raw_value.is_a?(Numeric)
+        if configuration[:only_integer]
+          matcher = /^[-+]?\d+([_]\d{3})*$/
+        else
+          matcher = /^[-+]?\d+([_]\d{3})*[.]?\d*$/
+        end
+
+        unless matcher.match(raw_value.to_s.strip)
+          record.errors.add(attr_name, :not_a_number, :value => raw_value, :default => configuration[:message])
+          next
+        end
+
+        raw_value = configuration[:only_integer] ? raw_value.to_i : raw_value.to_f
+      end
+
+      numericality_options.each do |option|
+        case option
+        when :odd, :even
+          unless raw_value.to_i.method(ALL_NUMERICALITY_CHECKS[option])[]
+            record.errors.add(attr_name, option, :value => raw_value, :default => configuration[:message])
+          end
+        else
+          record.errors.add(attr_name, option, :default => configuration[:message], :value => raw_value, :count => configuration[option]) unless raw_value.method(ALL_NUMERICALITY_CHECKS[option])[configuration[option]]
+        end
+      end
+    end
+  end
+
+  def validates_date_format_of(*attr_names)
+    configuration = { :on => :save, :allow_nil => false }
+    configuration.update(attr_names.extract_options!)
+
+    validates_each(attr_names,configuration) do |record, attr_name, value|
+      raw_value = record.send("#{attr_name}_before_type_cast") || value
+      Delocalize::LocalizedDateTimeParser.valid_format?(raw_value, Date)
+    end
+  end
+
+  def validates_time_format_of(*attr_names)
+    configuration = { :on => :save, :allow_nil => false }
+    configuration.update(attr_names.extract_options!)
+
+    validates_each(attr_names,configuration) do |record, attr_name, value|
+      raw_value = record.send("#{attr_name}_before_type_cast") || value
+      Delocalize::LocalizedDateTimeParser.valid_format?(raw_value, Time)
+    end
+  end
+end

data/lib/delocalize/ruby_ext.rb

@@ -0,0 +1,4 @@
+require 'delocalize/ruby_ext/date'
+require 'delocalize/ruby_ext/datetime'
+require 'delocalize/ruby_ext/time'
+require 'delocalize/ruby_ext/numeric'

data/lib/delocalize/ruby_ext/date.rb

@@ -0,0 +1,9 @@
+require 'delocalize/localized_date_time_parser'
+
+Date.class_eval do
+  class << self
+    def parse_localized(date)
+      Delocalize::LocalizedDateTimeParser.parse(date, self)
+    end
+  end
+end

data/lib/delocalize/ruby_ext/datetime.rb

@@ -0,0 +1,9 @@
+require 'delocalize/localized_date_time_parser'
+
+DateTime.class_eval do
+  class << self
+    def parse_localized(datetime)
+      Delocalize::LocalizedDateTimeParser.parse(datetime, self)
+    end
+  end
+end

data/lib/delocalize/ruby_ext/numeric.rb

@@ -0,0 +1,9 @@
+require 'delocalize/localized_numeric_parser'
+
+Numeric.class_eval do
+  class << self
+    def parse_localized(value)
+      Delocalize::LocalizedNumericParser.parse(value)
+    end
+  end
+end

data/lib/delocalize/ruby_ext/time.rb

@@ -0,0 +1,9 @@
+require 'delocalize/localized_date_time_parser'
+
+Time.class_eval do
+  class << self
+    def parse_localized(time)
+      Delocalize::LocalizedDateTimeParser.parse(time, self)
+    end
+  end
+end

data/tasks/distribution.rb

@@ -0,0 +1,21 @@
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |s|
+    s.name        = "foolabs-delocalize"
+    s.summary     = "Localized date/time and number parsing"
+    s.email       = ["clemens@railway.at", "marcin.raczkowski@gmail.com", "fernandoluizao@gmail.com"]
+    s.homepage    = "http://github.com/clemens/delocalize"
+    s.description = "Delocalize is a tool for parsing localized dates/times and numbers."
+    s.authors     = ["Clemens Kofler", "Marcin Raczkowski", "Fernando Migliorini Luizão"]
+    s.files       =  FileList["init.rb",
+                              "lib/**/*.rb",
+                              "MIT-LICENSE",
+                              "Rakefile",
+                              "README",
+                              "tasks/**/*.rb",
+                              "VERSION"]
+    s.test_files  = FileList["test/**/*.rb"]
+  end
+rescue LoadError
+  puts "Jeweler, or one of its dependencies, is not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+end

data/tasks/documentation.rb

@@ -0,0 +1,8 @@
+desc 'Generate documentation for the delocalize plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Delocalize'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/tasks/testing.rb

@@ -0,0 +1,7 @@
+desc 'Test the delocalize plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end

data/test/delocalize_test.rb

@@ -0,0 +1,257 @@
+require File.dirname(__FILE__) + '/test_helper'
+
+class DelocalizeActiveRecordTest < ActiveRecord::TestCase
+  def setup
+    Time.zone = 'Berlin' # make sure everything works as expected with TimeWithZone
+    @product = Product.new
+  end
+
+  test "delocalizes localized number" do
+    @product.price = '1.299,99'
+    assert_equal 1299.99, @product.price
+
+    @product.price = '-1.299,99'
+    assert_equal -1299.99, @product.price
+  end
+
+  test "delocalizes localized date with year" do
+    date = Date.civil(2009, 3, 19)
+
+    @product.released_on = '19. März 2009'
+    assert_equal date, @product.released_on
+
+    @product.released_on = '19.3.2009'
+    assert_equal date, @product.released_on
+  end
+
+  test "delocalizes localized date without year" do
+    date = Date.civil(Date.today.year, 10, 19)
+
+    @product.released_on = '19. Okt'
+    assert_equal date, @product.released_on
+  end
+
+  test "delocalizes localized datetime with year" do
+    time = Time.zone.local(2009, 3, 1, 12, 0, 0)
+
+    @product.published_at = 'Sonntag, 1. März 2009, 12:00 Uhr'
+    assert_equal time, @product.published_at
+
+    @product.published_at = '1. März 2009, 12:00 Uhr'
+    assert_equal time, @product.published_at
+  end
+
+  test "delocalizes localized datetime without year" do
+    time = Time.zone.local(Date.today.year, 3, 1, 12, 0, 0)
+
+    @product.published_at = '1. März, 12:00 Uhr'
+    assert_equal time, @product.published_at
+  end
+
+  test "delocalizes localized time" do
+    time = Time.zone.local(2000, 1, 1, 9, 0, 0)
+    @product.cant_think_of_a_sensible_time_field = '09:00 Uhr'
+    assert_equal time, @product.cant_think_of_a_sensible_time_field
+  end
+
+  test "uses default parse if format isn't found" do
+    date = Date.civil(2009, 10, 19)
+
+    @product.released_on = '2009/10/19'
+    assert_equal date, @product.released_on
+
+    time = Time.zone.local(2009, 3, 1, 12, 0, 0)
+    @product.published_at = '2009/03/01 12:00'
+    assert_equal time, @product.published_at
+
+    now = Time.current
+    time = Time.zone.local(2000, 1, 1, 9, 0, 0)
+    @product.cant_think_of_a_sensible_time_field = '09:00'
+    assert_equal time, @product.cant_think_of_a_sensible_time_field
+  end
+
+  test "should return nil if the input is empty or invalid" do
+    @product.released_on = ""
+    assert_nil @product.released_on
+
+    @product.released_on = "aa"
+    assert_nil @product.released_on
+  end
+
+  test "doesn't raise when attribute is nil" do
+    assert_nothing_raised {
+      @product.price = nil
+      @product.released_on = nil
+      @product.published_at = nil
+      @product.cant_think_of_a_sensible_time_field = nil
+    }
+  end
+
+  test "uses default formats if enable_delocalization is false" do
+    I18n.enable_delocalization = false
+
+    @product.price = '1299.99'
+    assert_equal 1299.99, @product.price
+
+    @product.price = '-1299.99'
+    assert_equal -1299.99, @product.price
+  end
+
+  test "uses default formats if called with with_delocalization_disabled" do
+    I18n.with_delocalization_disabled do
+      @product.price = '1299.99'
+      assert_equal 1299.99, @product.price
+
+      @product.price = '-1299.99'
+      assert_equal -1299.99, @product.price
+    end
+  end
+
+  test "uses localized parsing if called with with_delocalization_enabled" do
+    I18n.with_delocalization_enabled do
+      @product.price = '1.299,99'
+      assert_equal 1299.99, @product.price
+
+      @product.price = '-1.299,99'
+      assert_equal -1299.99, @product.price
+    end
+  end
+
+  test "dirty attributes must detect changes in decimal columns" do
+    @product.price = 10
+    @product.save
+    @product.price = "10,34"
+    assert_equal("10.34", @product.price_before_type_cast)
+    assert_equal BigDecimal("10.34"), @product.price
+    assert @product.price_changed?
+  end
+
+  test "dirty attributes must detect changes in float columns" do
+    @product.weight = 10
+    @product.save
+    @product.weight = "10,34"
+    assert_equal 10.34, @product.weight
+    assert @product.weight_changed?
+  end
+
+  test "serialization and deserialization of 'timestamp' should be symetric" do
+    @product.the_timestamp = 1.day.from_now.to_s(:db)  # date
+    @product.save
+    @product.reload
+    assert_equal(1.day.from_now.to_i, @product.the_timestamp.to_i)
+  end
+
+  test "before type casting of timestamp" do
+    @product.the_timestamp = 1.day.from_now.to_s(:db)  # date
+    assert_equal(1.day.from_now.to_s(:db), @product.the_timestamp_before_type_cast)
+  end
+
+  test "before type casting of date" do
+    @product.released_on = 1.day.from_now.to_s(:db)  # date
+    assert_equal(1.day.from_now.to_s(:db), @product.released_on_before_type_cast)
+    assert @product.released_on_before_type_cast.is_a?(String)
+  end
+end
+
+class DelocalizeActionViewTest < ActionView::TestCase
+  include ActionView::Helpers::FormHelper
+
+  def setup
+    Time.zone = 'Berlin' # make sure everything works as expected with TimeWithZone
+    @product = Product.new
+  end
+
+  test "shows text field using formatted number" do
+    @product.price = 1299.9
+    assert_dom_equal '<input id="product_price" name="product[price]" size="30" type="text" value="1.299,90" />',
+      text_field(:product, :price)
+  end
+
+  test "shows text field using formatted number with options" do
+    @product.price = 1299.995
+    assert_dom_equal '<input id="product_price" name="product[price]" size="30" type="text" value="1,299.995" />',
+      text_field(:product, :price, :precision => 3, :delimiter => ',', :separator => '.')
+  end
+
+  test "shows text field using formatted number without precision if column is an integer" do
+    @product.times_sold = 20
+    assert_dom_equal '<input id="product_times_sold" name="product[times_sold]" size="30" type="text" value="20" />',
+      text_field(:product, :times_sold)
+
+    @product.times_sold = 2000
+    assert_dom_equal '<input id="product_times_sold" name="product[times_sold]" size="30" type="text" value="2.000" />',
+      text_field(:product, :times_sold)
+  end
+
+  test "shows text field using formatted date" do
+    @product.released_on = Date.civil(2009, 10, 19)
+    assert_dom_equal '<input id="product_released_on" name="product[released_on]" size="30" type="text" value="19.10.2009" />',
+      text_field(:product, :released_on)
+  end
+
+  test "shows text field using formatted date and time" do
+    @product.published_at = Time.zone.local(2009, 3, 1, 12, 0, 0)
+    # careful - leading whitespace with %e
+    assert_dom_equal '<input id="product_published_at" name="product[published_at]" size="30" type="text" value="Sonntag,  1. März 2009, 12:00 Uhr" />',
+      text_field(:product, :published_at)
+  end
+
+  test "shows text field using formatted date with format" do
+    @product.released_on = Date.civil(2009, 10, 19)
+    assert_dom_equal '<input id="product_released_on" name="product[released_on]" size="30" type="text" value="19. Oktober 2009" />',
+      text_field(:product, :released_on, :format => :long)
+  end
+
+  test "shows text field using formatted date and time with format" do
+    @product.published_at = Time.zone.local(2009, 3, 1, 12, 0, 0)
+    # careful - leading whitespace with %e
+    assert_dom_equal '<input id="product_published_at" name="product[published_at]" size="30" type="text" value=" 1. März, 12:00 Uhr" />',
+      text_field(:product, :published_at, :format => :short)
+  end
+
+  test "shows text field using formatted time with format" do
+    @product.cant_think_of_a_sensible_time_field = Time.zone.local(2009, 3, 1, 9, 0, 0)
+    assert_dom_equal '<input id="product_cant_think_of_a_sensible_time_field" name="product[cant_think_of_a_sensible_time_field]" size="30" type="text" value="09:00 Uhr" />',
+      text_field(:product, :cant_think_of_a_sensible_time_field, :format => :time)
+  end
+
+  test "doesn't raise an exception when object is nil" do
+    assert_nothing_raised {
+      text_field(:not_here, :a_text_field)
+    }
+  end
+
+  test "doesn't raise for nil Date/Time" do
+    @product.published_at, @product.released_on, @product.cant_think_of_a_sensible_time_field = nil
+    assert_nothing_raised {
+      text_field(:product, :published_at)
+      text_field(:product, :released_on)
+      text_field(:product, :cant_think_of_a_sensible_time_field)
+    }
+  end
+
+  test "doesn't override given :value" do
+    @product.price = 1299.9
+    assert_dom_equal '<input id="product_price" name="product[price]" size="30" type="text" value="1.499,90" />',
+      text_field(:product, :price, :value => "1.499,90")
+  end
+
+  test "don't convert type if field has errors" do
+    @product = ProductWithValidation.new(:price => 'this is not a number')
+    @product.valid?
+    assert_dom_equal '<div class="fieldWithErrors"><input id="product_price" name="product[price]" size="30" type="text" value="this is not a number" /></div>',
+      text_field(:product, :price)
+  end
+
+  test "doesn't raise an exception when object isn't an ActiveReccord" do
+    @product = NonArProduct.new
+    assert_nothing_raised {
+      text_field(:product, :name)
+      text_field(:product, :times_sold)
+      text_field(:product, :published_at)
+      text_field(:product, :released_on)
+      text_field(:product, :cant_think_of_a_sensible_time_field)
+      text_field(:product, :price, :value => "1.499,90")
+    }
+  end
+end

data/test/rails_app/app/controllers/application_controller.rb

@@ -0,0 +1,10 @@
+# Filters added to this controller apply to all controllers in the application.
+# Likewise, all the methods added will be available for all controllers.
+
+class ApplicationController < ActionController::Base
+  helper :all # include all helpers, all the time
+  protect_from_forgery # See ActionController::RequestForgeryProtection for details
+
+  # Scrub sensitive parameters from your log
+  filter_parameter_logging :password
+end

data/test/rails_app/config/boot.rb

@@ -0,0 +1,110 @@
+# Don't change this file!
+# Configure your app in config/environment.rb and config/environments/*.rb
+
+RAILS_ROOT = "#{File.dirname(__FILE__)}/.." unless defined?(RAILS_ROOT)
+
+module Rails
+  class << self
+    def boot!
+      unless booted?
+        preinitialize
+        pick_boot.run
+      end
+    end
+
+    def booted?
+      defined? Rails::Initializer
+    end
+
+    def pick_boot
+      (vendor_rails? ? VendorBoot : GemBoot).new
+    end
+
+    def vendor_rails?
+      File.exist?("#{RAILS_ROOT}/vendor/rails")
+    end
+
+    def preinitialize
+      load(preinitializer_path) if File.exist?(preinitializer_path)
+    end
+
+    def preinitializer_path
+      "#{RAILS_ROOT}/config/preinitializer.rb"
+    end
+  end
+
+  class Boot
+    def run
+      load_initializer
+      Rails::Initializer.run(:set_load_path)
+    end
+  end
+
+  class VendorBoot < Boot
+    def load_initializer
+      require "#{RAILS_ROOT}/vendor/rails/railties/lib/initializer"
+      Rails::Initializer.run(:install_gem_spec_stubs)
+      Rails::GemDependency.add_frozen_gem_path
+    end
+  end
+
+  class GemBoot < Boot
+    def load_initializer
+      self.class.load_rubygems
+      load_rails_gem
+      require 'initializer'
+    end
+
+    def load_rails_gem
+      if version = self.class.gem_version
+        gem 'rails', version
+      else
+        gem 'rails'
+      end
+    rescue Gem::LoadError => load_error
+      $stderr.puts %(Missing the Rails #{version} gem. Please `gem install -v=#{version} rails`, update your RAILS_GEM_VERSION setting in config/environment.rb for the Rails version you do have installed, or comment out RAILS_GEM_VERSION to use the latest version installed.)
+      exit 1
+    end
+
+    class << self
+      def rubygems_version
+        Gem::RubyGemsVersion rescue nil
+      end
+
+      def gem_version
+        if defined? RAILS_GEM_VERSION
+          RAILS_GEM_VERSION
+        elsif ENV.include?('RAILS_GEM_VERSION')
+          ENV['RAILS_GEM_VERSION']
+        else
+          parse_gem_version(read_environment_rb)
+        end
+      end
+
+      def load_rubygems
+        min_version = '1.3.2'
+        require 'rubygems'
+        unless rubygems_version >= min_version
+          $stderr.puts %Q(Rails requires RubyGems >= #{min_version} (you have #{rubygems_version}). Please `gem update --system` and try again.)
+          exit 1
+        end
+
+      rescue LoadError
+        $stderr.puts %Q(Rails requires RubyGems >= #{min_version}. Please install RubyGems and try again: http://rubygems.rubyforge.org)
+        exit 1
+      end
+
+      def parse_gem_version(text)
+        $1 if text =~ /^[^#]*RAILS_GEM_VERSION\s*=\s*["']([!~<>=]*\s*[\d.]+)["']/
+      end
+
+      private
+        def read_environment_rb
+          File.read("#{RAILS_ROOT}/config/environment.rb")
+        end
+    end
+  end
+end
+
+# All that for this:
+Rails.boot!

data/test/rails_app/config/environment.rb

@@ -0,0 +1,17 @@
+# Be sure to restart your server when you modify this file
+
+# Specifies gem version of Rails to use when vendor/rails is not present
+RAILS_GEM_VERSION = '2.3.5' unless defined? RAILS_GEM_VERSION
+
+# Bootstrap the Rails environment, frameworks, and default configuration
+require File.join(File.dirname(__FILE__), 'boot')
+
+Rails::Initializer.run do |config|
+  # Set Time.zone default to the specified zone and make Active Record auto-convert to this zone.
+  # Run "rake -D time" for a list of tasks for finding time zone names.
+  # config.time_zone = 'UTC'
+
+  # The default locale is :en and all translations from config/locales/*.rb,yml are auto loaded.
+  # config.i18n.load_path += Dir[Rails.root.join('my', 'locales', '*.{rb,yml}')]
+  # config.i18n.default_locale = :en
+end

data/test/rails_app/config/environments/test.rb

@@ -0,0 +1,28 @@
+# Settings specified here will take precedence over those in config/environment.rb
+
+# The test environment is used exclusively to run your application's
+# test suite.  You never need to work with it otherwise.  Remember that
+# your test database is "scratch space" for the test suite and is wiped
+# and recreated between test runs.  Don't rely on the data there!
+config.cache_classes = true
+
+# Log error messages when you accidentally call methods on nil.
+config.whiny_nils = true
+
+# Show full error reports and disable caching
+config.action_controller.consider_all_requests_local = true
+config.action_controller.perform_caching             = false
+config.action_view.cache_template_loading            = true
+
+# Disable request forgery protection in test environment
+config.action_controller.allow_forgery_protection    = false
+
+# Tell Action Mailer not to deliver emails to the real world.
+# The :test delivery method accumulates sent emails in the
+# ActionMailer::Base.deliveries array.
+config.action_mailer.delivery_method = :test
+
+# Use SQL instead of Active Record's schema dumper when creating the test database.
+# This is necessary if your schema can't be completely dumped by the schema dumper,
+# like if you have constraints or database-specific column types
+# config.active_record.schema_format = :sql

data/test/rails_app/config/initializers/new_rails_defaults.rb

@@ -0,0 +1,21 @@
+# Be sure to restart your server when you modify this file.
+
+# These settings change the behavior of Rails 2 apps and will be defaults
+# for Rails 3. You can remove this initializer when Rails 3 is released.
+
+if defined?(ActiveRecord)
+  # Include Active Record class name as root for JSON serialized output.
+  ActiveRecord::Base.include_root_in_json = true
+
+  # Store the full class name (including module namespace) in STI type column.
+  ActiveRecord::Base.store_full_sti_class = true
+end
+
+ActionController::Routing.generate_best_match = false
+
+# Use ISO 8601 format for JSON serialized times and dates.
+ActiveSupport.use_standard_json_time_format = true
+
+# Don't escape HTML entities in JSON, leave that for the #json_escape helper.
+# if you're including raw json in an HTML page.
+ActiveSupport.escape_html_entities_in_json = false

data/test/rails_app/config/initializers/session_store.rb

@@ -0,0 +1,15 @@
+# Be sure to restart your server when you modify this file.
+
+# Your secret key for verifying cookie session data integrity.
+# If you change this key, all old sessions will become invalid!
+# Make sure the secret is at least 30 characters and all random, 
+# no regular words or you'll be exposed to dictionary attacks.
+ActionController::Base.session = {
+  :key         => '_rails_app_session',
+  :secret      => '89e8147901a0d7c221ac130e0ded3eeab6dab4a97127255909f08fedaae371918b41dec9d4d75c5b27a55c3772d43c2b6a3cbac232c5cc2ce4b8ec22242f5e60'
+}
+
+# Use the database for sessions instead of the cookie-based default,
+# which shouldn't be used to store highly confidential information
+# (create the session table with "rake db:sessions:create")
+# ActionController::Base.session_store = :active_record_store

data/test/rails_app/config/routes.rb

@@ -0,0 +1,4 @@
+ActionController::Routing::Routes.draw do |map|
+  map.connect ':controller/:action/:id'
+  map.connect ':controller/:action/:id.:format'
+end

data/test/test_helper.rb

@@ -0,0 +1,78 @@
+ENV["RAILS_ENV"] = "test"
+require File.expand_path(File.dirname(__FILE__) + "/rails_app/config/environment")
+require 'test_help'
+
+require 'rubygems'
+require 'active_record'
+require 'active_record/test_case'
+require 'action_view'
+require 'action_view/test_case'
+
+I18n.backend.store_translations :de, {
+  :date => {
+    :input => {
+      :formats => [:long, :short, :default]
+    },
+    :formats => {
+      :default => "%d.%m.%Y",
+      :short => "%e. %b",
+      :long => "%e. %B %Y",
+      :only_day => "%e"
+    },
+    :day_names => %w(Sonntag Montag Dienstag Mittwoch Donnerstag Freitag Samstag),
+    :abbr_day_names => %w(So Mo Di Mi Do Fr Sa),
+    :month_names => [nil] + %w(Januar Februar März April Mai Juni Juli August September Oktober November Dezember),
+    :abbr_month_names => [nil] + %w(Jan Feb Mär Apr Mai Jun Jul Aug Sep Okt Nov Dez)
+  },
+  :time => {
+    :input => {
+      :formats => [:long, :medium, :short, :default, :time]
+    },
+    :formats => {
+      :default => "%A, %e. %B %Y, %H:%M Uhr",
+      :short => "%e. %B, %H:%M Uhr",
+      :medium => "%e. %B %Y, %H:%M Uhr",
+      :long => "%A, %e. %B %Y, %H:%M Uhr",
+      :time => "%H:%M Uhr"
+    },
+    :am => 'vormittags',
+    :pm => 'nachmittags'
+  },
+  :number => {
+    :format => {
+      :precision => 2,
+      :separator => ',',
+      :delimiter => '.'
+    }
+  }
+}
+
+I18n.locale = :de
+
+class NonArProduct
+  attr_accessor :name, :price, :times_sold,
+    :cant_think_of_a_sensible_time_field,
+    :released_on, :published_at
+end
+
+class Product < ActiveRecord::Base
+end
+
+class ProductWithValidation < Product
+  validates_numericality_of :price
+  validates_presence_of :price
+end
+
+config = YAML.load_file(File.dirname(__FILE__) + '/database.yml')
+ActiveRecord::Base.establish_connection(config['test'])
+
+ActiveRecord::Base.connection.create_table :products do |t|
+  t.string :name
+  t.date :released_on
+  t.datetime :published_at
+  t.time :cant_think_of_a_sensible_time_field
+  t.timestamp :the_timestamp
+  t.decimal :price
+  t.float :weight
+  t.integer :times_sold
+end

metadata

@@ -0,0 +1,96 @@
+--- !ruby/object:Gem::Specification 
+name: foolabs-delocalize
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 2
+  - 1
+  version: 0.2.1
+platform: ruby
+authors: 
+- Clemens Kofler
+- Marcin Raczkowski
+- "Fernando Migliorini Luiz\xC3\xA3o"
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-04-09 00:00:00 +02:00
+default_executable: 
+dependencies: []
+
+description: Delocalize is a tool for parsing localized dates/times and numbers.
+email: 
+- clemens@railway.at
+- marcin.raczkowski@gmail.com
+- fernandoluizao@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+files: 
+- MIT-LICENSE
+- README
+- Rakefile
+- VERSION
+- init.rb
+- lib/delocalize.rb
+- lib/delocalize/i18n_ext.rb
+- lib/delocalize/localized_date_time_parser.rb
+- lib/delocalize/localized_numeric_parser.rb
+- lib/delocalize/rails_ext.rb
+- lib/delocalize/rails_ext/action_view.rb
+- lib/delocalize/rails_ext/active_record.rb
+- lib/delocalize/rails_ext/time_zone.rb
+- lib/delocalize/rails_ext/validation.rb
+- lib/delocalize/ruby_ext.rb
+- lib/delocalize/ruby_ext/date.rb
+- lib/delocalize/ruby_ext/datetime.rb
+- lib/delocalize/ruby_ext/numeric.rb
+- lib/delocalize/ruby_ext/time.rb
+- tasks/distribution.rb
+- tasks/documentation.rb
+- tasks/testing.rb
+has_rdoc: true
+homepage: http://github.com/clemens/delocalize
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Localized date/time and number parsing
+test_files: 
+- test/delocalize_test.rb
+- test/rails_app/app/controllers/application_controller.rb
+- test/rails_app/config/boot.rb
+- test/rails_app/config/environment.rb
+- test/rails_app/config/environments/test.rb
+- test/rails_app/config/initializers/new_rails_defaults.rb
+- test/rails_app/config/initializers/session_store.rb
+- test/rails_app/config/routes.rb
+- test/test_helper.rb