spine-mappings 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: db444936faae00c79848292520913fe94090e6bb
+  data.tar.gz: 77202967f3bb1c391c7ed948ddcc10072efc5242
+SHA512:
+  metadata.gz: 8a0d0e05558ec4e7df7f4ab725186f99b5e2d05e88a703471853e88a47630de7497fb80af14f34eea275863b6f82fe1675583e23e1e319653532cb36349d599a
+  data.tar.gz: 094f222f822677d16b0499ea781c7f662c07b2c72ceb7a9e024ab2b718b93a1e28f6e900dc47158673e834ae3aafe5cf2c00fc914d0f6d7e2aa7482e588a5055

data/.gitignore

@@ -0,0 +1,36 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/bin/
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--format documentation
+--require config/default

data/CHANGELOG.md

@@ -0,0 +1,6 @@
+Changelog
+=========
+
+0.1.0
+-----
+-   First public release

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in spine-mappings.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,42 @@
+PATH
+  remote: .
+  specs:
+    spine-mappings (0.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    codeclimate-test-reporter (0.4.7)
+      simplecov (>= 0.7.1, < 1.0.0)
+    diff-lcs (1.2.5)
+    docile (1.1.5)
+    json (1.8.2)
+    rake (10.4.2)
+    rspec (3.2.0)
+      rspec-core (~> 3.2.0)
+      rspec-expectations (~> 3.2.0)
+      rspec-mocks (~> 3.2.0)
+    rspec-core (3.2.3)
+      rspec-support (~> 3.2.0)
+    rspec-expectations (3.2.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.2.0)
+    rspec-mocks (3.2.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.2.0)
+    rspec-support (3.2.2)
+    simplecov (0.10.0)
+      docile (~> 1.1.0)
+      json (~> 1.8)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.7)
+  codeclimate-test-reporter (~> 0.4)
+  rake (~> 10.0)
+  rspec (~> 3.2)
+  spine-mappings!

data/LICENSE

@@ -0,0 +1,12 @@
+Copyright (c) 2015, TOGGL LLC
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+3. Neither the name of the TOGGL LLC nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,56 @@
+# Spine::Mappings
+
+[![Gem Version](https://badge.fury.io/rb/spine-mappings.svg)](http://badge.fury.io/rb/spine-mappings)
+[![Dependency Status](https://gemnasium.com/rspine/mappings.svg)](https://gemnasium.com/rspine/mappings)
+[![Test Coverage](https://codeclimate.com/github/rspine/mappings/badges/coverage.svg)](https://codeclimate.com/github/rspine/mappings/coverage)
+[![Code Climate](https://codeclimate.com/github/rspine/mappings/badges/gpa.svg)](https://codeclimate.com/github/rspine/mappings)
+[![Codeship Status for rspine/mappings](https://codeship.com/projects/90a03900-e41c-0132-2cdb-16773c71d38d/status?branch=master)](https://codeship.com/projects/81788)
+
+Maps object to hashes using DSL. You can give different namespaces for mappings
+by extending module or class with `Spine::Mappings::Repository`.
+
+## Installation
+
+To install it, add the gem to your Gemfile:
+
+```ruby
+gem 'spine-mappings'
+```
+
+Then run `bundle`. If you're not using Bundler, just `gem install spine-mappings`.
+
+## Usage
+
+```ruby
+Spine::Mappings.define :tag do
+  integer :id, from: identity
+  string :name
+end
+
+Spine::Mappings.define :product do
+  integer :id, from: :identity
+  string :name
+  decimal :price
+  boolean :is_available, { |source| source.available? }
+  date :available_from
+  date :available_until
+  tag :tags, nullable: true
+end
+
+Spine::Mapings.define :timestamps do
+  timestamp :created_at
+  timestamp :updated_at
+end
+
+Spine::Mappings.find(:product, :timestamps).map(product)
+
+Spine::Mappings.find(:product, :timestamps).map_all(products)
+```
+
+You can provide also `comapct` or `strict` strategy for mapping. First adds
+value only when it is not nil, second adds everything what was defined. Default
+is `strict`.
+
+```ruby
+Spine::Mappings.find(:product, :timestamps).map(product, strategy: :compact)
+```

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/spine/mappings.rb

@@ -0,0 +1,30 @@
+module Spine
+  module Mappings
+    autoload :Repository, 'spine/mappings/repository'
+    autoload :Mapper, 'spine/mappings/mapper'
+    autoload :Strategies, 'spine/mappings/strategies'
+    autoload :Mapping, 'spine/mappings/mapping'
+
+    module Syntax
+      autoload :Any, 'spine/mappings/syntax/any'
+      autoload :String, 'spine/mappings/syntax/string'
+      autoload :Integer, 'spine/mappings/syntax/integer'
+      autoload :Decimal, 'spine/mappings/syntax/decimal'
+      autoload :Boolean, 'spine/mappings/syntax/boolean'
+      autoload :Date, 'spine/mappings/syntax/date'
+      autoload :DateTime, 'spine/mappings/syntax/datetime'
+      autoload :Timestamp, 'spine/mappings/syntax/timestamp'
+      autoload :Nested, 'spine/mappings/syntax/nested'
+      autoload :Collection, 'spine/mappings/syntax/collection'
+      autoload :RegisteredMapper, 'spine/mappings/syntax/registered_mapper'
+    end
+
+    module Commands
+      autoload :ActionFetch, 'spine/mappings/commands/action_fetch'
+      autoload :Fetch, 'spine/mappings/commands/fetch'
+      autoload :Intercept, 'spine/mappings/commands/intercept'
+    end
+
+    extend Repository
+  end
+end

data/lib/spine/mappings/commands/action_fetch.rb

@@ -0,0 +1,17 @@
+module Spine
+  module Mappings
+    module Commands
+      class ActionFetch
+        attr_reader :action
+
+        def initialize(action)
+          @action = action
+        end
+
+        def execute(source)
+          action.call(source)
+        end
+      end
+    end
+  end
+end

data/lib/spine/mappings/commands/fetch.rb

@@ -0,0 +1,23 @@
+module Spine
+  module Mappings
+    module Commands
+      class Fetch
+        attr_reader :method_name
+
+        def initialize(method_name)
+          @method_name = method_name
+        end
+
+        def execute(source)
+          if source.respond_to?(method_name)
+            source.public_send(method_name)
+          elsif source.respond_to?('[]')
+            source[method_name]
+          else
+            raise "Source object don't have #{ method_name } method defined."
+          end
+        end
+      end
+    end
+  end
+end

data/lib/spine/mappings/commands/intercept.rb

@@ -0,0 +1,24 @@
+module Spine
+  module Mappings
+    module Commands
+      class Intercept
+        attr_reader :command, :action, :options
+
+        def initialize(command, action, options = {})
+          @command = command
+          @options = options
+          @action = action
+        end
+
+        def execute(source)
+          value = command.execute(source) || options[:default]
+          if value || !options.fetch(:nullable, false)
+            action.call(value)
+          else
+            value
+          end
+        end
+      end
+    end
+  end
+end

data/lib/spine/mappings/mapper.rb

@@ -0,0 +1,26 @@
+module Spine
+  module Mappings
+    class Mapper
+      attr_reader :mappings
+
+      def initialize(mappings)
+        @mappings = mappings
+      end
+
+      def map(source, options = {})
+        return nil unless source
+
+        strategy = Strategies.find(options[:strategy])
+        mappings.reduce({}) do |mapped, mapping|
+          strategy.run(mapping.commands, source, mapped)
+        end
+      end
+
+      def map_all(sources, options = {})
+        return nil unless sources || sources.empty?
+
+        sources.map { |source| map(source, options) }
+      end
+    end
+  end
+end

data/lib/spine/mappings/mapping.rb

@@ -0,0 +1,40 @@
+module Spine
+  module Mappings
+    class Mapping
+      include Syntax::Any
+      include Syntax::String
+      include Syntax::Integer
+      include Syntax::Decimal
+      include Syntax::Boolean
+      include Syntax::Date
+      include Syntax::DateTime
+      include Syntax::Timestamp
+      include Syntax::Nested
+      include Syntax::Collection
+      include Syntax::RegisteredMapper
+
+      attr_reader :commands, :repository
+
+      def initialize(repository)
+        @repository = repository
+        @commands = {}
+      end
+
+      private
+
+      def register(destination, command)
+        @commands[destination] = command
+      end
+
+      def intercept(command, options, &block)
+        Commands::Intercept.new(command, block, options)
+      end
+
+      def build(destination, options, &block)
+        return Commands::ActionFetch.new(block) if block_given?
+
+        Commands::Fetch.new(options.fetch(:from, destination))
+      end
+    end
+  end
+end

data/lib/spine/mappings/repository.rb

@@ -0,0 +1,72 @@
+module Spine
+  module Mappings
+    # Maps objects to hash.
+    #
+    # == Types
+    # * any - Value as is.
+    # * integer - Integer, default value is 0.
+    # * string - String, default value is ''.
+    # * decimal - Floating point number, default value is 0.0.
+    # * date - Date in ISO 8601 format (YYYY-MM-DD).
+    # * datetime - Date and time in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ).
+    # * timestamp - Date and time with milliseconds in ISO 8601 format
+    #   (YYYY-MM-DDTHH:MM:SS.000Z).
+    # * boolean - Boolean.
+    #
+    # Also you can use other serializers by name. They must be registered
+    # before usage.
+    #
+    # == Options
+    # * from - Method name for source object. Also you can use closure to fetch
+    #   value
+    # * nullable - Allows value to be nil.
+    # * default - Default value.
+    #
+    # == Examples
+    #
+    #   Serialization.define :tag do
+    #     integer :id, from: identity
+    #     string :name
+    #   end
+    #
+    #   Serialization.define :product do
+    #     integer :id, from: identity
+    #     string :name
+    #     decimal :price
+    #     boolean :is_available, { |source| source.available? }
+    #     date :available_from
+    #     date :avaialable_until
+    #     tag :tags, nullable: true
+    #     timestamp :created_at
+    #     timestamp :updated_at
+    #   end
+    #
+    #   serialized_product = Serialization.serialize(:product, product)
+    #   serialized_products = Serialization.serialize_all(:product, products)
+    module Repository
+      def define(name, &block)
+        mappings[name] = parse(block)
+      end
+
+      def find(*names)
+        found_mappings = names.map { |name| mappings.fetch(name) }
+
+        if found_mappings.empty?
+          nil
+        else
+          Mapper.new(found_mappings)
+        end
+      end
+
+      def mappings
+        @mappings ||= {}
+      end
+
+      def parse(dsl)
+        mapping = Mapping.new(self)
+        mapping.instance_eval(&dsl)
+        mapping
+      end
+    end
+  end
+end

data/lib/spine/mappings/strategies.rb

@@ -0,0 +1,28 @@
+module Spine
+  module Mappings
+    module Strategies
+      extend self
+
+      autoload :Strict, 'spine/mappings/strategies/strict'
+      autoload :Compact, 'spine/mappings/strategies/compact'
+
+      def collection
+        @collection ||= default_collection
+      end
+
+      def find(identifier)
+        collection[identifier] || collection[default_identifier]
+      end
+
+      private
+
+      def default_identifier
+        :strict
+      end
+
+      def default_collection
+        { strict: Strict, compact: Compact }
+      end
+    end
+  end
+end

data/lib/spine/mappings/strategies/compact.rb

@@ -0,0 +1,17 @@
+module Spine
+  module Mappings
+    module Strategies
+      module Compact
+        extend self
+
+        def run(commands, source, destination = {})
+          commands.reduce(destination) do |result, (key, command)|
+            value = command.execute(source)
+            result[key] = value if value
+            result
+          end
+        end
+      end
+    end
+  end
+end

data/lib/spine/mappings/strategies/strict.rb

@@ -0,0 +1,16 @@
+module Spine
+  module Mappings
+    module Strategies
+      module Strict
+        extend self
+
+        def run(commands, source, destination = {})
+          commands.reduce(destination) do |result, (key, command)|
+            result[key] = command.execute(source)
+            result
+          end
+        end
+      end
+    end
+  end
+end

data/lib/spine/mappings/syntax/any.rb

@@ -0,0 +1,11 @@
+module Spine
+  module Mappings
+    module Syntax
+      module Any
+        def any(destination, options = {}, &block)
+          register(destination, build(destination, options, &block))
+        end
+      end
+    end
+  end
+end

data/lib/spine/mappings/syntax/boolean.rb

@@ -0,0 +1,15 @@
+module Spine
+  module Mappings
+    module Syntax
+      module Boolean
+        def boolean(destination, options = {}, &block)
+          command = build(destination, options, &block)
+          register(
+            destination,
+            intercept(command, options) { |value| !!value }
+          )
+        end
+      end
+    end
+  end
+end

data/lib/spine/mappings/syntax/collection.rb

@@ -0,0 +1,17 @@
+module Spine
+  module Mappings
+    module Syntax
+      module Collection
+        def collection(type, destination, options = {}, &block)
+          command = build(destination, options, &block)
+          register(
+            destination,
+            intercept(command, options) {
+              |value| repository.find(type).map_all(value)
+            }
+          )
+        end
+      end
+    end
+  end
+end

data/lib/spine/mappings/syntax/date.rb

@@ -0,0 +1,17 @@
+module Spine
+  module Mappings
+    module Syntax
+      module Date
+        def date(destination, options = {}, &block)
+          command = build(destination, options, &block)
+          register(
+            destination,
+            intercept(command, options) {
+              |value| value.to_date.iso8601
+            }
+          )
+        end
+      end
+    end
+  end
+end

data/lib/spine/mappings/syntax/datetime.rb

@@ -0,0 +1,17 @@
+module Spine
+  module Mappings
+    module Syntax
+      module DateTime
+        def datetime(destination, options = {}, &block)
+          command = build(destination, options, &block)
+          register(
+            destination,
+            intercept(command, options) { |value|
+              value.to_datetime.iso8601
+            }
+          )
+        end
+      end
+    end
+  end
+end

data/lib/spine/mappings/syntax/decimal.rb

@@ -0,0 +1,15 @@
+module Spine
+  module Mappings
+    module Syntax
+      module Decimal
+        def decimal(destination, options = {}, &block)
+          command = build(destination, options, &block)
+          register(
+            destination,
+            intercept(command, options) { |value| value.to_f }
+          )
+        end
+      end
+    end
+  end
+end

data/lib/spine/mappings/syntax/integer.rb

@@ -0,0 +1,15 @@
+module Spine
+  module Mappings
+    module Syntax
+      module Integer
+        def integer(destination, options = {}, &block)
+          command = build(destination, options, &block)
+          register(
+            destination,
+            intercept(command, options) { |value| value.to_i }
+          )
+        end
+      end
+    end
+  end
+end

data/lib/spine/mappings/syntax/nested.rb

@@ -0,0 +1,17 @@
+module Spine
+  module Mappings
+    module Syntax
+      module Nested
+        def nested(destination, options = {}, &block)
+          mapping = repository.parse(block)
+          mapper = Mapper.new([mapping])
+          command = build(destination, options)
+          register(
+            destination,
+            intercept(command, options) { |value| mapper.map(value, options) }
+          )
+        end
+      end
+    end
+  end
+end

data/lib/spine/mappings/syntax/registered_mapper.rb

@@ -0,0 +1,20 @@
+module Spine
+  module Mappings
+    module Syntax
+      module RegisteredMapper
+        def method_missing(name, *arguments, &block)
+          mapper = repository.find(name.to_sym)
+          super and return unless mapper
+
+          destination = arguments.shift
+          options = arguments.shift || {}
+          command = build(destination, options, &block)
+          register(
+            destination,
+            intercept(command, options) { |value| mapper.map(value) }
+          )
+        end
+      end
+    end
+  end
+end

data/lib/spine/mappings/syntax/string.rb

@@ -0,0 +1,15 @@
+module Spine
+  module Mappings
+    module Syntax
+      module String
+        def string(destination, options = {}, &block)
+          command = build(destination, options, &block)
+          register(
+            destination,
+            intercept(command, options) { |value| value.to_s }
+          )
+        end
+      end
+    end
+  end
+end

data/lib/spine/mappings/syntax/timestamp.rb

@@ -0,0 +1,17 @@
+module Spine
+  module Mappings
+    module Syntax
+      module Timestamp
+        def timestamp(destination, options = {}, &block)
+          command = build(destination, options, &block)
+          register(
+            destination,
+            intercept(command, options) { |value|
+              value.to_datetime.iso8601(3)
+            }
+          )
+        end
+      end
+    end
+  end
+end

data/lib/spine/mappings/version.rb

@@ -0,0 +1,5 @@
+module Spine
+  module Mappings
+    VERSION = '0.1.0'
+  end
+end

data/spec/config/coverage.rb

@@ -0,0 +1,4 @@
+require './spec/config/default'
+
+require 'codeclimate-test-reporter'
+CodeClimate::TestReporter.start

data/spec/config/default.rb

@@ -0,0 +1,20 @@
+RSpec.configure do |config|
+  config.filter_run :focus
+  config.run_all_when_everything_filtered = true
+
+  if config.files_to_run.one?
+    config.default_formatter = 'doc'
+  end
+
+  config.order = :random
+
+  Kernel.srand config.seed
+
+  config.expect_with :rspec do |expectations|
+    expectations.syntax = :expect
+  end
+
+  config.mock_with :rspec do |mocks|
+    mocks.syntax = :expect
+  end
+end

data/spec/spine/mappings/mappings_spec.rb

@@ -0,0 +1,263 @@
+require 'ostruct'
+require 'date'
+require 'spine/mappings'
+
+module Spine
+  module Mappings
+    describe Mappings do
+      subject { Mappings }
+
+      it 'defines empty mapper' do
+        subject.define(:test) {}
+        expect(subject.find(:test)).to be
+      end
+
+      it 'maps data by coping attribute with same name' do
+        subject.define :test do
+          any :id
+        end
+
+        data = OpenStruct.new(id: 1)
+        mapped = subject.find(:test).map(data)
+
+        expect(mapped[:id]).to eq(1)
+      end
+
+      it 'maps data by coping attribute with different name' do
+        subject.define :test do
+          any :value, from: :test_value
+        end
+
+        data = OpenStruct.new(test_value: 1)
+        mapped = subject.find(:test).map(data)
+
+        expect(mapped[:value]).to eq(1)
+      end
+
+      it 'maps data by coping attribute from closure' do
+        subject.define :test do
+          any(:value) { |source| source.test_value }
+        end
+
+        data = OpenStruct.new(test_value: 1)
+        mapped = subject.find(:test).map(data)
+
+        expect(mapped[:value]).to eq(1)
+      end
+
+      it 'maps empty data as nil' do
+        subject.define(:test) do
+          any :value
+        end
+
+        data = OpenStruct.new(value: nil)
+        mapped = subject.find(:test).map(data)
+
+        expect(mapped[:value]).to eq(nil)
+      end
+
+      it 'maps data with empty mapper' do
+        subject.define(:test) {}
+        expect(subject.find(:test).map(Object.new)).to eq({})
+      end
+
+      it 'maps hash to hash' do
+        subject.define(:test) do
+          any :x, from: :y
+        end
+
+        expect(subject.find(:test).map(y: 1)).to eq(x: 1)
+      end
+
+      describe 'when using interceptors' do
+        it 'maps data by converting it to string' do
+          subject.define :test do
+            string :value
+          end
+
+          data = OpenStruct.new(value: 1)
+          mapped = subject.find(:test).map(data)
+
+          expect(mapped[:value]).to eq('1')
+        end
+
+        it 'maps data by converting it to integer' do
+          subject.define :test do
+            integer :value
+          end
+
+          data = OpenStruct.new(value: "1")
+          mapped = subject.find(:test).map(data)
+
+          expect(mapped[:value]).to eq(1)
+        end
+
+        it 'maps nil data when nullable' do
+          subject.define :test do
+            integer :value, nullable: true
+          end
+
+          data = OpenStruct.new(value: nil)
+          mapped = subject.find(:test).map(data)
+
+          expect(mapped[:value]).to eq(nil)
+        end
+
+        it 'maps nil data to default' do
+          subject.define :test do
+            integer :value, default: 1
+          end
+
+          data = OpenStruct.new(value: nil)
+          mapped = subject.find(:test).map(data)
+
+          expect(mapped[:value]).to eq(1)
+        end
+
+        it 'maps data by converting it to decimal' do
+          subject.define :test do
+            decimal :value
+          end
+
+          data = OpenStruct.new(value: "1.5")
+          mapped = subject.find(:test).map(data)
+
+          expect(mapped[:value]).to eq(1.5)
+        end
+
+        it 'maps data by converting it to boolean' do
+          subject.define :test do
+            boolean :value
+          end
+
+          data = OpenStruct.new(value: '1')
+          mapped = subject.find(:test).map(data)
+
+          expect(mapped[:value]).to eq(true)
+        end
+
+        it 'maps data by converting it to date' do
+          subject.define :test do
+            date :value
+          end
+
+          value = Time.now
+          data = OpenStruct.new(value: value)
+          mapped = subject.find(:test).map(data)
+
+          expect(mapped[:value]).to eq(value.to_date.iso8601)
+        end
+
+        it 'maps data by converting it to date time' do
+          subject.define :test do
+            datetime :value
+          end
+
+          value = Time.now
+          data = OpenStruct.new(value: value)
+          mapped = subject.find(:test).map(data)
+
+          expect(mapped[:value]).to eq(value.to_datetime.iso8601)
+        end
+
+        it 'maps data by converting it to timestamp' do
+          subject.define :test do
+            timestamp :value
+          end
+
+          value = Time.now
+          data = OpenStruct.new(value: value)
+          mapped = subject.find(:test).map(data)
+
+          expect(mapped[:value]).to eq(value.to_datetime.iso8601(3))
+        end
+      end
+
+      describe 'when using other mappings' do
+        it 'maps data by converting it by other mapper' do
+          subject.define :nested_object do
+            any :nested_value
+          end
+          subject.define(:test) do
+            nested_object :value
+          end
+
+          data = double(value: double(nested_value: 1))
+          mapped = subject.find(:test).map(data)
+
+          expect(mapped[:value][:nested_value])
+            .to eq(data.value.nested_value)
+        end
+
+        it 'maps data by converting it by other complex mapper' do
+          subject.define :nested_object do
+            any :nested_value, from: :test_value
+          end
+          subject.define :test do
+            nested_object :value
+          end
+
+          data = double(value: double(test_value: 1))
+          mapped = subject.find(:test).map(data)
+
+          expect(mapped[:value][:nested_value])
+            .to eq(data.value.test_value)
+        end
+
+        it 'raises error when nested mapper is not defined' do
+          expect {
+            subject.define :test do
+              not_defined_nested_object :value
+            end
+            }.to raise_error(KeyError)
+        end
+      end
+
+      describe 'when using mapping strategies' do
+        it 'maps using strict strategy' do
+          subject.define(:test) do
+            any :x
+          end
+
+          expect(subject.find(:test).map(y: 1).keys).to include(:x)
+        end
+
+        it 'maps using compact strategy' do
+          subject.define(:test) do
+            any :x
+          end
+
+          source = { y: 1 }
+          mapped = subject.find(:test).map(source, strategy: :compact)
+          expect(mapped.keys).not_to include(:x)
+        end
+      end
+
+      describe 'when mapping nested objects' do
+        it 'maps nested hash' do
+          subject.define(:test) do
+            nested :x do
+              any :y
+            end
+          end
+
+          source = OpenStruct.new(x: OpenStruct.new(y: 1))
+          mapped = subject.find(:test).map(source)
+          expect(mapped[:x][:y]).to eq(source.x.y)
+        end
+
+        it 'maps nested object' do
+          subject.define(:test) do
+            nested :x do
+              any :y
+            end
+          end
+
+          source = { x: { y: 1 } }
+          mapped = subject.find(:test).map(source)
+          expect(mapped[:x][:y]).to eq(source[:x][:y])
+        end
+      end
+    end
+  end
+end

data/spine-mappings.gemspec

@@ -0,0 +1,24 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'spine/mappings/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "spine-mappings"
+  spec.version       = Spine::Mappings::VERSION
+  spec.authors       = ["TOGGL LLC"]
+  spec.email         = ["support@toggl.com"]
+  spec.summary       = ''
+  spec.description   = ''
+  spec.homepage      = 'https://github.com/rspine/mappings'
+  spec.license       = 'BSD-3-Clause'
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency 'bundler', "~> 1.7"
+  spec.add_development_dependency 'rake', "~> 10.0"
+  spec.add_development_dependency 'rspec', "~> 3.2"
+  spec.add_development_dependency 'codeclimate-test-reporter', "~> 0.4"
+end

metadata

@@ -0,0 +1,137 @@
+--- !ruby/object:Gem::Specification
+name: spine-mappings
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- TOGGL LLC
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-05-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: codeclimate-test-reporter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+description: ''
+email:
+- support@toggl.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- lib/spine/mappings.rb
+- lib/spine/mappings/commands/action_fetch.rb
+- lib/spine/mappings/commands/fetch.rb
+- lib/spine/mappings/commands/intercept.rb
+- lib/spine/mappings/mapper.rb
+- lib/spine/mappings/mapping.rb
+- lib/spine/mappings/repository.rb
+- lib/spine/mappings/strategies.rb
+- lib/spine/mappings/strategies/compact.rb
+- lib/spine/mappings/strategies/strict.rb
+- lib/spine/mappings/syntax/any.rb
+- lib/spine/mappings/syntax/boolean.rb
+- lib/spine/mappings/syntax/collection.rb
+- lib/spine/mappings/syntax/date.rb
+- lib/spine/mappings/syntax/datetime.rb
+- lib/spine/mappings/syntax/decimal.rb
+- lib/spine/mappings/syntax/integer.rb
+- lib/spine/mappings/syntax/nested.rb
+- lib/spine/mappings/syntax/registered_mapper.rb
+- lib/spine/mappings/syntax/string.rb
+- lib/spine/mappings/syntax/timestamp.rb
+- lib/spine/mappings/version.rb
+- spec/config/coverage.rb
+- spec/config/default.rb
+- spec/spine/mappings/mappings_spec.rb
+- spine-mappings.gemspec
+homepage: https://github.com/rspine/mappings
+licenses:
+- BSD-3-Clause
+metadata: {}
+post_install_message: 
+rdoc_options: []
+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:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: ''
+test_files:
+- spec/config/coverage.rb
+- spec/config/default.rb
+- spec/spine/mappings/mappings_spec.rb