hashformer 0.2.2 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: cfc27e5ad9d2e3e9869c1f0095821e63553fefdf
-  data.tar.gz: 51b608ef72f5494b086d0e1853f73b0044ed0462
+  metadata.gz: 05a8926c5ecb538a6ddf72a14f118d655a18852a
+  data.tar.gz: 967d6cd3decd71173baafa6dd21745a0ebfa1542
 SHA512:
-  metadata.gz: f493351b32ba8a4c35db7d6b027300e475846181a6a6187a19a3b2c66205d773a4033729c4328a15b8d67965834268ea9abd6158008dae45eb23239c4b78e1df
-  data.tar.gz: b580f15b4ef7056065904841b8ed57656b1447c9c0ee39d0334d1aa51079e212747e45f1049590ef9143e1eeacedb2b7d02c36579b1c026881be45ce29301df2
+  metadata.gz: e4f0f3d3b1161500ca05fafd4c3949ee3e5660be691a3051c0f3823b74d2c3d713c76e212db9116dc73ee68e192cb9caec61a1a52cfc50a1b7f92eb1f3a99844
+  data.tar.gz: 15d32b0a42af0a007028793131e7fc69493c5228eedc4b468ac5e0831a678859d9e0c780f44aa0bc56bb9d5b26715d906a4d360b29fa82241501f7f60b58e562

data/.rspec

@@ -1 +1,2 @@
 --color
+--require 'spec_helper'

data/.travis.yml

@@ -0,0 +1,11 @@
+language: ruby
+sudo: false
+rvm:
+  - '2.0'
+  - '2.1'
+  - '2.2'
+  - '2.3.1'
+  - jruby-19mode
+script: bundle exec rspec
+before_install:
+  - 'gem install bundler'

data/Gemfile

@@ -1,19 +1,3 @@
 source 'https://rubygems.org'
 
-group :test do
-  # RSpec for tests
-  gem 'rspec'
-
-  # SimpleCov for test coverage
-  gem 'simplecov', '~> 0.7.1', require: false
-
-  # Code Climate test coverage
-  gem "codeclimate-test-reporter", require: nil
-end
-
-group :development do
-  gem 'debugger', platforms: [:ruby_19]
-  gem 'byebug', platforms: [:ruby_20, :ruby_21]
-end
-
 gemspec

data/README.md

@@ -1,6 +1,6 @@
 Hashformer
 =========
-[![Gem Version](https://badge.fury.io/rb/hashformer.svg)](http://badge.fury.io/rb/hashformer) [![Code Climate](https://codeclimate.com/github/deseretbook/hashformer.png)](https://codeclimate.com/github/deseretbook/hashformer) [![Test Coverage](https://codeclimate.com/github/deseretbook/hashformer/coverage.png)](https://codeclimate.com/github/deseretbook/hashformer) [![Codeship Status for deseretbook/hashformer](https://www.codeship.io/projects/dd988da0-dee7-0131-9e92-7e1ff0bec112/status?branch=master)](https://www.codeship.io/projects/24888)
+[![Gem Version](https://badge.fury.io/rb/hashformer.svg)](http://badge.fury.io/rb/hashformer) [![Code Climate](https://codeclimate.com/github/deseretbook/hashformer.png)](https://codeclimate.com/github/deseretbook/hashformer) [![Test Coverage](https://codeclimate.com/github/deseretbook/hashformer/coverage.png)](https://codeclimate.com/github/deseretbook/hashformer) [![Build Status](https://travis-ci.org/deseretbook/hashformer.svg)](https://travis-ci.org/deseretbook/hashformer)
 
 ### Transform any Ruby Hash with a declarative DSL
 
@@ -14,9 +14,17 @@ keys, input keys, and transformations, and Hashformer will convert your data
 into the format you specify.  It can also help verify your transformations by
 validating input and output data using [Classy Hash](https://github.com/deseretbook/classy_hash).
 
+Note that Hashformer is not for everyone.  If your data transformation needs
+don't involve massive changes to the data structure or values, and/or you don't
+need multiple people to be able to work on the transformations separately from
+other code, you might be better off doing your transformations in plain Ruby.
+
 
 ### Examples
 
+Examples of each feature are provided here, but complete documentation for each
+method lives in the code.
+
 #### Basic renaming
 
 If you just need to move/copy/rename keys, you specify the source key as the
@@ -147,7 +155,8 @@ This is the most useful and powerful aspect of Hashformer.  You can use
 lookups:
 
 _**Note:** Method chaining may not work as expected if entered in `irb`, because
-`irb` might try to call `#to_s` or `#inspect` on the method chain!_
+`irb` might try to call `#to_s` or `#inspect` on the method chain!  See `.__end`
+and `.enable_debugging` for possible solutions_
 
 ```ruby
 data = {
@@ -210,6 +219,56 @@ Hashformer.transform({x: -12}, xform)
 # => {x: 29}
 ```
 
+##### `__as`
+
+The special `__as` method on a method chain, added in version 0.3.0, allows you
+to work with the chain's current value in a block like `Object#tap`, but the
+return value of the block is passed to the next step of the chain.  This is
+useful if you need to pass the chain value to an outside function.
+
+```ruby
+def func(x)
+  "something to do with #{x}"
+end
+
+xform = {
+  out: HF[:in].__as{|v| 'test ' + func(v) }
+}
+
+Hashformer.transform({ in: 'code' }, xform)
+# => { out: 'something to do with test code' }
+```
+
+##### `__end`
+
+The `__end` method on a method chain will disable further modification of the
+chain.  This is not normally needed unless your transformation Hashes might be
+`#inspect`ed by other code (e.g. IRB or Pry).  Using `__end` might prevent you
+from needing to enable chain debugging.
+
+```ruby
+xform = {
+  # Everything after __end will be ignored, including __as
+  out: HF[:in].to_s.__end.to_i.no.more.methods
+}
+
+Hashformer.transform({ in: 100 })
+# => { out: '100' }
+```
+
+##### Debugging chains
+
+If `__end` isn't enough to make your method chains work with whatever debugging
+or instrumentation you have, you can enable chain debugging.  *When chain
+debugging is enabled, any standard `Object` methods cannot be added to chains
+(this includes commonly chained methods like `#to_s`).*  Each method added to a
+chain will also be printed to `$stdout`.
+
+```ruby
+HF::G::Chain.enable_debugging
+HF::G::Chain.disable_debugging
+```
+
 
 #### Mapping one or more values
 
@@ -232,7 +291,8 @@ Hashformer.transform(data, xform)
 ```
 
 You can also mix and match paths and method chains in the `HF::G.map`
-parameters:
+parameters.  The result of the method chain transformation or path retrieval
+will be used in the map, instead of looking up a key in the original hash:
 
 ```ruby
 data = {
@@ -347,6 +407,29 @@ Hashformer.transform(data, xform)
 # => {b: { n: 1, o: 2, p: 5 }}
 ```
 
+#### Dates and times
+
+We found ourselves writing a lot of identical date transformation `Proc`s in our
+transformations, so version 0.3.0 adds some helpers for transforming dates to
+and from numeric values.  If you use Hashformer in a project that also uses
+ActiveSupport, you can transform time zones as well.
+
+```ruby
+xform = {
+  int: HF::Date.to_i(:time),
+  float: HF::Date.to_f(:time),
+  date: HF::Date.to_date(:numeric),
+}
+
+data = {
+  time: Time.at(10.75),
+  numeric: 10.75
+}
+
+Hashformer.transform(data, xform)
+# => { int: 10, float: 10.75, date: #<DateTime 1970-01-01...}
+```
+
 
 #### Practical example with validation
 

data/hashformer.gemspec

@@ -21,8 +21,14 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
-  spec.required_ruby_version = '>= 1.9.3'
+  spec.required_ruby_version = '>= 2.0'
 
-  spec.add_development_dependency "bundler", "~> 1.5"
   spec.add_runtime_dependency "classy_hash", "~> 0.1", ">= 0.1.1"
+
+  spec.add_development_dependency "bundler", "~> 1.11"
+  spec.add_development_dependency "rspec", "~> 3.5"
+  spec.add_development_dependency "simplecov", "~> 0.12.0"
+  spec.add_development_dependency "codeclimate-test-reporter"
+  spec.add_development_dependency "byebug", "~> 9.0" unless RUBY_PLATFORM == 'java'
+  spec.add_development_dependency "activesupport", "~> 4.2"
 end

data/lib/hashformer/date.rb

@@ -0,0 +1,93 @@
+# Hashformer date and time transformation generators.
+# Created July 2016 by Mike Bourgeous, DeseretBook.com
+# Copyright (C)2016 Deseret Book
+# See LICENSE and README.md for details.
+
+require 'date'
+require 'time'
+
+module Hashformer
+  module Date
+    # Generates a Proc to convert a Date, Time, or DateTime to an Integer UNIX
+    # timestamp.  Passes nil through unmodified.  Useful for transforming to
+    # serialization formats that don't support dates directly.
+    #
+    # Returns a method chain that can be further modified.
+    #
+    # Raises an error during transformation if the input value is not nil and
+    # is a different class.
+    #
+    # Example:
+    #   data = { time: Time.at(0.75), no_time: nil }
+    #   xform = { ts: HF::Date.to_i(:time), ts2: HF::Date.to_i(:no_time) }
+    #   HF.transform(data, xform)
+    #   # => { ts: 0, ts2: nil }
+    def self.to_i(key)
+      HF[key].__as{|d|
+        d = d.to_time if d.is_a?(::Date)
+        raise "Invalid date/time class #{d.class}" unless d.nil? || d.is_a?(Time) || d.is_a?(DateTime)
+
+        d && d.to_i
+      }
+    end
+
+    # Generates a Proc to convert a Date, Time, or DateTime to a floating point
+    # UNIX timestamp.  Passes nil through unmodified.  Useful for transforming
+    # to serialization formats that don't support dates directly.
+    #
+    # Returns a method chain that can be further modified.
+    #
+    # Raises an error during transformation if the input value is not nil and
+    # is a different class.
+    #
+    # Example:
+    #   data = { time: Time.at(0.75), no_time: nil }
+    #   xform = { ts: HF::Date.to_f(:time), ts2: HF::Date.to_f(:no_time) }
+    #   HF.transform(data, xform)
+    #   # => { ts: 0.75, ts2: nil }
+    def self.to_f(key)
+      HF[key].__as{|d|
+        d = d.to_time if d.is_a?(::Date)
+        raise "Invalid date/time class #{d.class}" unless d.nil? || d.is_a?(Time) || d.is_a?(DateTime)
+
+        d && d.to_f
+      }
+    end
+
+    # Generates a Proc to convert an Integer or Numeric UNIX timestamp to a
+    # DateTime.  Passes nil through unmodified.  Useful for transforming from
+    # serialization formats that don't support dates directly to database
+    # interfaces that might expect DateTime rather than Time.
+    #
+    # If +tz_name+ is the default special value of :utc, then the resulting
+    # DateTime will be in UTC time.  If +tz_name+ is nil, the default zone will
+    # be used.  Otherwise, if +tz_name+ is given and the Time class responds to
+    # #in_time_zone (requires ActiveSupport::TimeWithZone, which is not loaded
+    # by Hashformer), then the date will be converted to the given named
+    # timezone.
+    #
+    # Returns a method chain that can be further modified.
+    #
+    # Raises an error during transformation if the input value is not a type
+    # supported by Time.at().
+    #
+    # Example:
+    def self.to_date(key, tz_name = :utc)
+      if tz_name == :utc
+        HF[key].__as{|d|
+          d && Time.at(d).utc.to_datetime
+        }
+      elsif tz_name
+        raise 'ActiveSupport time helpers are required for tz_name' unless Time.instance_methods.include?(:in_time_zone)
+
+        HF[key].__as{|d|
+          d && Time.at(d).in_time_zone(tz_name).to_datetime
+        }
+      else
+        HF[key].__as{|d|
+          d && Time.at(d).to_datetime
+        }
+      end
+    end
+  end
+end

data/lib/hashformer/generate.rb

@@ -62,22 +62,53 @@ module Hashformer
     # Internal representation of a method call and array lookup chainer.  Do
     # not use this directly; instead use HF::G.chain().
     class Chain
-      # Receiver for chaining calls that has no methods of its own except
-      # initialize.  This allows methods like :call to be chained.
-      #
-      # IMPORTANT: No methods other than .__chain can be called on this object,
-      # because they will be chained!  Instead, use === to detect the object's
-      # type, for example.
-      class Receiver < BasicObject
+      # Base module that defines methods included by BasicReceiver and
+      # DebuggableReceiver.
+      module ReceiverMethods
         # An oddly named accessor is used instead of #initialize to avoid
         # conflicts with any methods that might be chained.
         attr_accessor :__chain
 
-        # Adds a method call or array dereference to the list of calls to apply.
+        # Adds a method call or array dereference to the list of calls to
+        # apply.  Does nothing if #__end has been called.  Returns self for
+        # more chaining.
         def method_missing(name, *args, &block)
-          @__chain << {name: name, args: args, block: block}
+          @__ended ||= false
+          @__chain << {name: name, args: args, block: block} unless @__ended
+          self
+        end
+
+        # Adds a call to the given +block+ to the chain like Object#tap, but
+        # returns the result of the block instead of the original object.  Any
+        # arguments given will be passed to the +block+ after the current
+        # value.  Does nothing if #__end has been called.  Returns self for
+        # more chaining.
+        #
+        # This is similar in spirit (but not implementation) to
+        # http://stackoverflow.com/a/12849214
+        def __as(*args, &block)
+          ::Kernel.raise 'No block given to #__as' unless ::Kernel.block_given?
+          @__ended ||= false
+          @__chain << {args: args, block: block} unless @__ended
+          self
+        end
+
+        # Disables further chaining.  Any future method calls will just return
+        # the existing chain without modifying it.
+        def __end
+          @__ended = true
           self
         end
+      end
+
+      # Receiver for chaining calls that has no methods of its own except
+      # initialize.  This allows methods like :call to be chained.
+      #
+      # IMPORTANT: No methods other than #__chain, #__as, or #__end should be
+      # called on this object, because they will be chained!  Instead, use ===
+      # to detect the object's type, for example.
+      class BasicReceiver < BasicObject
+        include ReceiverMethods
 
         undef !=
         undef ==
@@ -90,12 +121,73 @@ module Hashformer
         undef singleton_method_undefined
       end
 
-      # Returns the call chaining receiver.
+      # Debuggable chain receiver that inherits from Object.  This will break a
+      # lot of chains (e.g. any chain using #to_s or #inspect), but will allow
+      # some debugging tools to operate without crashing.  See
+      # Hashformer::Generate::Chain.enable_debugging.
+      class DebuggableReceiver
+        include ReceiverMethods
+
+        # Overrides ReceiverMethods#method_missing to print out methods as they
+        # are added to the chain.
+        def method_missing(name, *args, &block)
+          __dbg_msg(name, args, block)
+          super
+        end
+
+        # Overrides ReceiverMethods#__as to print out blocks as they are added
+        # to the chain.
+        def __as(*args, &block)
+          __dbg_msg('__as', args, block)
+          super
+        end
+
+        # Overrides ReceiverMethods#__end to print a message when a chain is
+        # ended.
+        def __end
+          $stdout.puts "Ending chain #{__id__}"
+          super
+        end
+
+        private
+
+        # Prints a debugging message for the addition of the given method
+        # +name+, +args+, and +block+.  Prints "Adding..." for active chains,
+        # "Ignoring..." for ended chains.
+        def __dbg_msg(name, args, block)
+          $stdout.puts "#{@__ended ? 'Ignoring' : 'Adding'} " \
+            "#{name.inspect}(#{args.map(&:inspect).join(', ')}){#{block}} " \
+            "to chain #{__id__}"
+        end
+      end
+
+      class << self
+        # The chaining receiver class that will be used by newly created chains
+        # (must include ReceiverMethods).
+        def receiver_class
+          @receiver_class ||= BasicReceiver
+        end
+
+        # Switches Receiver to an Object (DebuggableReceiver) for debugging.
+        # debugging tools to introspect Receiver without crashing.
+        def enable_debugging
+          @receiver_class = DebuggableReceiver
+        end
+
+        # Switches Receiver back to a BasicObject (BasicReceiver).
+        def disable_debugging
+          @receiver_class = BasicReceiver
+        end
+      end
+
+
+      # Returns the call chaining receiver for this chain.
       attr_reader :receiver
 
+      # Initializes an empty chain.
       def initialize
         @calls = []
-        @receiver = Receiver.new
+        @receiver = self.class.receiver_class.new
         @receiver.__chain = self
       end
 
@@ -103,12 +195,17 @@ module Hashformer
       def call(input_hash)
         value = input_hash
         @calls.each do |c|
-          value = value.send(c[:name], *c[:args], &c[:block])
+          if c[:name]
+            value = value.send(c[:name], *c[:args], &c[:block])
+          else
+            # Support #__as
+            value = c[:block].call(value, *c[:args])
+          end
         end
         value
       end
 
-      # Adds the given call info (used by Receiver).
+      # Adds the given call info (used by ReceiverMethods).
       def <<(info)
         @calls << info
         self
@@ -179,6 +276,8 @@ module Hashformer
     # transformation.  This allows path references (as with HF::G.path) and
     # method calls to be stored and applied later.
     #
+    # See Hashformer::Generate::Chain.enable_debugging if you run into issues.
+    #
     # Example:
     #   data = { in1: { in2: [1, 2, 3, [4, 5, 6, 7]] } }
     #   xform = { out1: HF::G.chain[:in1][:in2][3].reduce(&:+) }

data/lib/hashformer/version.rb

@@ -1,3 +1,3 @@
 module Hashformer
-  VERSION = "0.2.2"
+  VERSION = "0.3.0"
 end

data/lib/hashformer.rb

@@ -1,12 +1,13 @@
 # Hashformer: A declarative data transformation DSL for Ruby
 # Created June 2014 by Mike Bourgeous, DeseretBook.com
-# Copyright (C)2014 Deseret Book
+# Copyright (C)2016 Deseret Book
 # See LICENSE and README.md for details.
 
 require 'classy_hash'
 
 require 'hashformer/version'
 require 'hashformer/generate'
+require 'hashformer/date'
 
 
 # This module contains the Hashformer methods for transforming Ruby Hash
@@ -47,7 +48,7 @@ module Hashformer
       next if key == :__in_schema || key == :__out_schema
 
       key = key.call(value, data) if key.respond_to?(:call)
-      out[key] = self.get_value(data, value, xform)
+      out[key] = self.get_value(data, value)
     end
 
     validate(out, xform[:__out_schema], 'output') if validate
@@ -56,10 +57,10 @@ module Hashformer
   end
 
   # Returns a value for the given +key+, method chain, or callable on the given
-  # +input_hash+.  If +xform+ is not nil, then Hashe keys will be processed
-  # with Hashformer.transform.
-  def self.get_value(input_hash, key, xform = nil)
-    if Hashformer::Generate::Chain::Receiver === key
+  # +input_hash+.  Hash keys will be processed with Hashformer.transform for
+  # supporting nested transformations.
+  def self.get_value(input_hash, key)
+    if Hashformer::Generate::Chain::ReceiverMethods === key
       # Had to special case chains to allow chaining .call
       key.__chain.call(input_hash)
     elsif Hashformer::Generate::Constant === key

data/spec/lib/hashformer/date_spec.rb

@@ -0,0 +1,96 @@
+# Hashformer date helper tests
+# Created July 2016 by Mike Bourgeous, DeseretBook.com
+# Copyright (C)2016 Deseret Book
+# See LICENSE and README.md for details.
+
+require 'rational'
+require 'active_support/time'
+
+describe Hashformer::Date do
+  let(:data) {
+    {
+      one_time: Time.at(1),
+      little_time: Time.at(0.25),
+      no_time: nil,
+
+      one_stamp: 1,
+      little_stamp: 0.25,
+      rational_stamp: Rational(3, 4),
+      no_stamp: nil,
+    }
+  }
+
+  describe '.to_i' do
+    let(:xform) {
+      {
+        one: HF::Date.to_i(:one_time),
+        zero: HF::Date.to_i(:little_time),
+        none: HF::Date.to_i(:no_time),
+      }
+    }
+
+    it 'converts dates to integer timestamps' do
+      expect(HF.transform(data, xform)).to eq({ one: 1, zero: 0, none: nil })
+    end
+
+    it 'raises an error for invalid types' do
+      expect{HF.transform({ one_time: 'Bogus' }, xform)}.to raise_error(/Invalid/)
+    end
+  end
+
+  describe '.to_f' do
+    let(:xform) {
+      {
+        one: HF::Date.to_f(:one_time),
+        some: HF::Date.to_f(:little_time),
+        none: HF::Date.to_f(:no_time),
+      }
+    }
+
+    it 'converts dates to float timestamps' do
+      expect(HF.transform(data, xform)).to eq({ one: 1.0, some: 0.25, none: nil })
+    end
+
+    it 'raises an error for invalid types' do
+      expect{HF.transform({ one_time: 'Bogus' }, xform)}.to raise_error(/Invalid/)
+    end
+  end
+
+  describe '.to_date' do
+    let(:xform) {
+      {
+        one_utc: HF::Date.to_date(:one_stamp),
+        little_utc: HF::Date.to_date(:little_stamp),
+        rational_utc: HF::Date.to_date(:rational_stamp),
+
+        one_local: HF::Date.to_date(:one_stamp, nil),
+        little_local: HF::Date.to_date(:little_stamp, nil),
+        rational_local: HF::Date.to_date(:rational_stamp, nil),
+
+        one_zone: HF::Date.to_date(:one_stamp, 'MST'),
+        little_zone: HF::Date.to_date(:little_stamp, 'MST'),
+        rational_zone: HF::Date.to_date(:rational_stamp, 'MST'),
+      }
+    }
+
+    let(:expected) {
+      {
+        one_utc: Time.at(1).utc.to_datetime,
+        little_utc: Time.at(0.25).utc.to_datetime,
+        rational_utc: Time.at(Rational(3, 4)).utc.to_datetime,
+
+        one_local: Time.at(1).to_datetime,
+        little_local: Time.at(0.25).to_datetime,
+        rational_local: Time.at(Rational(3, 4)).to_datetime,
+
+        one_zone: Time.at(1).in_time_zone('MST').to_datetime,
+        little_zone: Time.at(0.25).in_time_zone('MST').to_datetime,
+        rational_zone: Time.at(Rational(3, 4)).in_time_zone('MST').to_datetime,
+      }
+    }
+
+    it 'converts timestamps to expected dates' do
+      expect(HF.transform(data, xform)).to eq(expected)
+    end
+  end
+end

data/spec/lib/hashformer/generate_spec.rb

@@ -1,18 +1,10 @@
 # Hashformer transformation generator tests
 # Created July 2014 by Mike Bourgeous, DeseretBook.com
-# Copyright (C)2014 Deseret Book
+# Copyright (C)2016 Deseret Book
 # See LICENSE and README.md for details.
 
-require 'spec_helper'
-
-require 'hashformer'
-
-RSpec.describe Hashformer::Generate do
+describe Hashformer::Generate do
   describe '.const' do
-    let(:data) {
-      {}
-    }
-
     it 'returns the original integer when given an integer' do
       expect(Hashformer.transform({}, { a: HF::G.const(5) })).to eq({a: 5})
     end
@@ -228,6 +220,65 @@ RSpec.describe Hashformer::Generate do
       expect(Hashformer.transform(data, xform)).to eq({out1: 22, out2: 'd', out3: 1})
     end
 
+    it 'does not add more chained methods when Chain#inspect is called' do
+      chain = HF[:test].one(1).two(2).three(3).four(4).five(5).__chain
+      inspect = chain.inspect
+      expect(inspect).to match(/one.*two.*three.*four.*five/)
+      expect(chain.inspect).to eq(inspect)
+      expect(chain.inspect).to eq(inspect)
+    end
+
+    describe '.__as' do
+      it 'returns the value from the block' do
+        xf = { out1: HF[:in1][:in1][0].__as{|v| "H#{v}shformer" } }
+        expect(Hashformer.transform(data, xf)).to eq({ out1: 'Hashformer' })
+      end
+
+      it 'raises an error if no block is given' do
+        expect{ HF[].__as() }.to raise_error(/No block given/)
+      end
+    end
+
+    describe '.__end' do
+      it 'prevents further method calls or __as blocks from being added' do
+        xf = { out1: HF[:in1][:in1].count.__end.odd?.__as{nil}.__end.no.more.calls.added }
+        expect(Hashformer.transform(data, xf)).to eq({ out1: 4 })
+      end
+    end
+
+    context 'debugging methods' do
+      it 'can enable and disable debugging' do
+        begin
+          HF::G::Chain.enable_debugging
+
+          chain = HF[]
+
+          expect($stdout).to receive(:puts).with(/Adding.*__as/)
+          chain.__as{}
+
+          expect($stdout).to receive(:puts).with(/Adding.*info/)
+          chain.info
+
+          expect($stdout).to receive(:puts).with(/Ending/)
+          chain.__end
+
+          expect($stdout).to receive(:puts).with(/Ignoring.*__as/)
+          chain.__as{}
+
+          expect($stdout).to receive(:puts).with(/Ignoring.*info/)
+          chain.info
+
+
+          HF::G::Chain.disable_debugging
+
+          expect($stdout).not_to receive(:puts)
+          HF[].add.__as{}.and.some.methods.then.__end.the.chain
+        ensure
+          HF::G::Chain.disable_debugging
+        end
+      end
+    end
+
     context 'using normally reserved methods' do
       it 'calls a proc with .call' do
         calldata = {

data/spec/lib/hashformer_spec.rb

@@ -3,11 +3,7 @@
 # Copyright (C)2014 Deseret Book
 # See LICENSE and README.md for details.
 
-require 'spec_helper'
-
-require 'hashformer'
-
-RSpec.describe Hashformer do
+describe Hashformer do
   describe '.validate' do
     let(:in_schema) {
       # ClassyHash schema - https://github.com/deseretbook/classy_hash

data/spec/spec_helper.rb

@@ -3,3 +3,5 @@ require 'simplecov'
 require 'codeclimate-test-reporter'
 SimpleCov.start
 CodeClimate::TestReporter.start
+
+require 'hashformer'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hashformer
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.3.0
 platform: ruby
 authors:
 - Deseret Book
@@ -9,42 +9,112 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-08-30 00:00:00.000000000 Z
+date: 2016-07-27 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: classy_hash
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.1
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.5'
+        version: '1.11'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.5'
+        version: '1.11'
 - !ruby/object:Gem::Dependency
-  name: classy_hash
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
-    - - ">="
+        version: '3.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.1
-  type: :runtime
+        version: '3.5'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.12.0
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: 0.12.0
+- !ruby/object:Gem::Dependency
+  name: codeclimate-test-reporter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.1
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
 description: |2
       Hashformer provides a simple, Ruby Hash-based way of transforming data from
       one format to another.  It's vaguely like XSLT, but way less complicated
@@ -57,14 +127,17 @@ extra_rdoc_files: []
 files:
 - ".gitignore"
 - ".rspec"
+- ".travis.yml"
 - Gemfile
 - LICENSE
 - README.md
 - Rakefile
 - hashformer.gemspec
 - lib/hashformer.rb
+- lib/hashformer/date.rb
 - lib/hashformer/generate.rb
 - lib/hashformer/version.rb
+- spec/lib/hashformer/date_spec.rb
 - spec/lib/hashformer/generate_spec.rb
 - spec/lib/hashformer_spec.rb
 - spec/spec_helper.rb
@@ -79,7 +152,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 1.9.3
+      version: '2.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -87,11 +160,12 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 2.5.1
 signing_key: 
 specification_version: 4
 summary: Transform any Hash with a declarative data transformation DSL for Ruby
 test_files:
+- spec/lib/hashformer/date_spec.rb
 - spec/lib/hashformer/generate_spec.rb
 - spec/lib/hashformer_spec.rb
 - spec/spec_helper.rb