foraneus 0.0.13 → 0.0.14

checksums.yaml

@@ -1,7 +1,7 @@
----
-SHA1:
-  metadata.gz: f3f668a304ebd112cf2651006dc871679cac85db
-  data.tar.gz: 607492a6bd176a001eca2f2f0971e2f6f6dca73f
-SHA512:
-  metadata.gz: 1954c53b5f18b2099d55a2e4c0d92dc09cb6cfca491e0db191b220a997cb8abedd580392edcb70c8ab3d80363d97b938fee4d6e99531d2fe13436b0074eb1f8c
-  data.tar.gz: 8689562a31c5c06aade9b290f663539f0e8f042bddb1a71638b92a70f24944f853ee48fa3458b7310cfac8dc304b0d09db019023bded19bb9d6fd694b8d415f3
+--- 
+SHA1: 
+  metadata.gz: 6a1af4481bfbdeb0cc0aa78900c6b7f4512d7a21
+  data.tar.gz: 58cd1c7f084558def0575754919263b6763ba17a
+SHA512: 
+  metadata.gz: 093a3fdc5eecea2934cd2ef01c88191bcf62fe317f61ed73519d8a77b4afcadd2ff96b5af17d4e5337e43da96bdd325861b6f94ca53d0a6642db6ffaf0aa5a03
+  data.tar.gz: cbf2a485c1df7a4da036256ea27f6a8097f7433cb8b4bcd3e5c922e1ef985b2003ed6a5e442f3755af1f89a66da393efd6c80f314787f54c6d9767223304fd1f

data/README.md

@@ -251,12 +251,24 @@ Tests are written in MiniTest. To run them all just execute the following from y
   ruby spec/runner.rb
   ```
 
+Execute the following when ruby 1.8.7:
+
+  ``` shell
+  ruby -rubygems spec/runner.rb
+  ```
+
 To run a specific test case:
 
   ``` shell
     ruby -Ispec -Ilib spec/lib/foraneus_spec.rb
   ```
 
+When running under ruby 1.8.7:
+
+  ``` shell
+    ruby -rubygems -Ispec -Ilib spec/lib/foraneus_spec.rb
+  ```
+
 ## Code documentation
 
 Documentation is written in Yard. To see it in a browser, execute this command:

data/lib/foraneus.rb

@@ -1,16 +1,19 @@
-require_relative 'foraneus/converters/boolean'
-require_relative 'foraneus/converters/date'
-require_relative 'foraneus/converters/decimal'
-require_relative 'foraneus/converters/float'
-require_relative 'foraneus/converters/integer'
-require_relative 'foraneus/converters/noop'
-require_relative 'foraneus/converters/string'
-require_relative 'foraneus/errors'
+if RUBY_VERSION == '1.8.7'
+  require 'foraneus/compatibility/ruby-1.8.7'
+end
+
+require 'foraneus/converters/boolean'
+require 'foraneus/converters/date'
+require 'foraneus/converters/decimal'
+require 'foraneus/converters/float'
+require 'foraneus/converters/integer'
+require 'foraneus/converters/noop'
+require 'foraneus/converters/string'
+require 'foraneus/errors'
 
 # Foraneus base class used to declare a data set, aka 'form'.
 class Foraneus
 
-
   # @api private
   def initialize
     @_ = {}
@@ -105,18 +108,9 @@ class Foraneus
 
   def self.create_instance
     instance = self.new
-    spec = self
-
-    instance.singleton_class.send(:attr_reader, self.accessors[:data])
 
-    instance.instance_exec do
-      instance.instance_variable_set(:"@#{spec.accessors[:data]}", {})
-    end
-
-    instance.singleton_class.send(:attr_reader, self.accessors[:errors])
-    instance.instance_exec do
-      instance.instance_variable_set(:"@#{spec.accessors[:errors]}", {})
-    end
+    __singleton_attr_reader(instance, :data, {})
+    __singleton_attr_reader(instance, :errors, {})
 
     instance
   end
@@ -167,20 +161,7 @@ class Foraneus
         data.fetch(given_key, nil)
       end
 
-      instance.send("#{field}=", v)
-
-      if v.nil?
-        v = converter.opts[:default]
-      end
-
-      s = if v.nil?
-        nil
-      else
-        converter.raw(v)
-      end
-
-      instance[given_key] = s
-      instance.send(self.accessors[:data])[given_key] = v
+      __raw_datum(given_key, v, instance, converter)
     end
 
     instance
@@ -232,6 +213,29 @@ class Foraneus
 
     foraneus[k] = v
 
+    v = __parse(k, v, converter)
+
+    foraneus.send("#{field}=", v)
+    foraneus.send(self.accessors[:data])[k] = v
+
+  rescue
+    error = Foraneus::Error.new($!.class.name, $!.message)
+    foraneus.send(self.accessors[:errors])[k] = error
+  end
+  private_class_method :__parse_raw_datum
+
+  # @api private
+  #
+  # Parses a raw value.
+  #
+  # @param [String, Symbol] field
+  # @param [String] v Raw value.
+  # @param converter
+  #
+  # @raise [KeyError] if converter requires a value but no one is given.
+  #
+  # @return [Object]
+  def self.__parse(field, v, converter)
     if v == '' && converter.opts.fetch(:blanks_as_nil, true)
       v = nil
     end
@@ -239,18 +243,55 @@ class Foraneus
     if v.nil? && converter.opts[:required]
       raise KeyError, "required parameter not found: #{field.inspect}"
     elsif v.nil?
-      v = converter.opts[:default]
+      converter.opts[:default]
     else
-      v = converter.parse(v)
+      converter.parse(v)
     end
+  end
+  private_class_method :__parse
 
-    foraneus.send("#{field}=", v)
+  # @api private
+  #
+  # Obtains a raw representation of a value and assigns it to the corresponding field.
+  #
+  # It also registers errors if the conversion fails.
+  #
+  # @param [String, Symbol] k
+  # @param [String] v
+  # @param [Foraneus] foraneus
+  # @param [Converter] converter
+  def self.__raw_datum(k, v, foraneus, converter)
+    foraneus.send("#{k}=", v)
+
+    if v.nil?
+      v = converter.opts[:default]
+    end
+
+    s = unless v.nil?
+      converter.raw(v)
+    end
+
+    foraneus[k] = s
     foraneus.send(self.accessors[:data])[k] = v
+  end
+  private_class_method :__raw_datum
 
-  rescue
-    error = Foraneus::Error.new($!.class.name, $!.message)
-    foraneus.send(self.accessors[:errors])[k] = error
+  # @api private
+  #
+  # Creates a singleton attribute reader on an instance.
+  #
+  # @param [Foraneus] instance
+  # @param [Symbol] attribute
+  # @param initial_value
+  def self.__singleton_attr_reader(instance, attribute, initial_value = nil)
+    spec = instance.class
+
+    instance.singleton_class.send(:attr_reader, spec.accessors[attribute])
+
+    instance.instance_exec do
+      instance.instance_variable_set(:"@#{spec.accessors[attribute]}", initial_value)
+    end
   end
-  private_class_method :__parse_raw_datum
+  private_class_method :__singleton_attr_reader
 
 end

data/lib/foraneus/compatibility/ruby-1.8.7.rb

@@ -0,0 +1,12 @@
+unless defined?(KeyError)
+  class KeyError < IndexError
+  end
+end
+
+if (Object.instance_methods & ['singleton_class', :singleton_class]).empty?
+  class Object
+    def singleton_class
+      class << self; self; end
+    end
+  end
+end

data/lib/foraneus/converters/integer.rb

@@ -13,10 +13,12 @@ class Foraneus
         @delimiter = opts[:delimiter]
       end
 
-      # @raise [ArgumentError] with message 'invalid value for Integer(): ...'
+      # @raise [TypeError] with message 'invalid value for Integer(): ...'
       #
       # @return [Integer]
       def parse(s)
+        raise TypeError, "can't convert nil into Integer" if s.nil?
+
         s = s.gsub(@delimiter, '') if @delimiter
 
         Kernel.Integer(s)

data/spec/lib/foraneus/converters/float_converter_spec.rb

@@ -22,7 +22,7 @@ describe Foraneus::Converters::Float do
       end
 
       describe 'with big ones' do
-        let(:big_number) { (11 ** 20) + 0.33 }
+        let(:big_number) { (11 ** 11) + 0.33 }
         let(:raw_big_number) { big_number.to_s }
 
         it 'also returns a float number' do

data/spec/lib/foraneus_spec.rb

@@ -197,7 +197,7 @@ describe Foraneus do
         end
       end
 
-      an_absent_parameters_value_handler = ->(missing_value) do
+      an_absent_parameters_value_handler = lambda do |missing_value|
         subject { form_spec.parse(:delay => missing_value) }
 
         it 'parses' do

data/spec/runner.rb

@@ -1,6 +1,4 @@
-require 'minitest/autorun'
-
-add_to_load_path = ->(path) {
+add_to_load_path = lambda { |path|
   unless $LOAD_PATH.include?(path)
     $LOAD_PATH << path
   end

data/spec/spec_helper.rb

@@ -1,3 +1,5 @@
+#require 'rubygems'
+
 require 'minitest/autorun'
 require 'minitest/spec'
 require 'minitest/unit'

metadata

@@ -1,53 +1,57 @@
---- !ruby/object:Gem::Specification
+--- !ruby/object:Gem::Specification 
 name: foraneus
-version: !ruby/object:Gem::Version
-  version: 0.0.13
+version: !ruby/object:Gem::Version 
+  version: 0.0.14
 platform: ruby
-authors:
+authors: 
 - Gianfranco Zas
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-11-28 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: yard-kramdown
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
+
+date: 2014-12-04 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: minitest
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - &id002 
+      - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
   name: yard
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - *id002
   type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: kramdown
   prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    requirements: 
+    - *id002
+  type: :development
+  version_requirements: *id004
 description: Provides two way transformation mechanisms to external data.
 email: snmgian@gmail.com
 executables: []
+
 extensions: []
+
 extra_rdoc_files: []
-files:
+
+files: 
 - COPYING
 - COPYING.LESSER
 - README.md
 - lib/foraneus.rb
+- lib/foraneus/compatibility/ruby-1.8.7.rb
 - lib/foraneus/converters/boolean.rb
 - lib/foraneus/converters/date.rb
 - lib/foraneus/converters/decimal.rb
@@ -68,30 +72,31 @@ files:
 - spec/spec_helper.rb
 - spec/spec_helper_its.rb
 homepage: https://github.com/snmgian/foraneus
-licenses:
+licenses: 
 - LGPL
 metadata: {}
+
 post_install_message: 
 rdoc_options: []
-require_paths:
+
+require_paths: 
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement
-  requirements:
-  - - ">="
-    - !ruby/object:Gem::Version
-      version: '0'
-required_rubygems_version: !ruby/object:Gem::Requirement
-  requirements:
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
   - - ">="
-    - !ruby/object:Gem::Version
-      version: '0'
+    - !ruby/object:Gem::Version 
+      version: 1.8.7
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - *id002
 requirements: []
+
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 2.4.5
 signing_key: 
 specification_version: 4
 summary: Transforms external data.
-test_files:
+test_files: 
 - spec/lib/foraneus_spec.rb
 - spec/lib/foraneus/converters/noop_converter_spec.rb
 - spec/lib/foraneus/converters/decimal_converter_spec.rb
@@ -103,3 +108,4 @@ test_files:
 - spec/spec_helper.rb
 - spec/spec_helper_its.rb
 - spec/runner.rb
+has_rdoc: