rom-mapper 0.1.0

data/.gitignore

@@ -0,0 +1,17 @@
+log
+*.rbx
+*.rbc
+Gemfile.lock
+tmp/
+doc/
+coverage/
+measurements/
+graphviz/
+.yardoc/
+.bundle/
+*.png
+Vagrantfile
+.vagrant
+
+# spiking area
+scratchpad.rb

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--profile
+--order random

data/.ruby-gemset

@@ -0,0 +1 @@
+rom

data/.ruby-version

@@ -0,0 +1 @@
+1.9.3

data/.travis.yml

@@ -0,0 +1,21 @@
+language: ruby
+bundler_args: --without yard guard benchmarks
+script: "bundle exec rake ci"
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - ruby-head
+  - rbx-19mode
+matrix:
+  allow_failures:
+    - rvm: jruby-19mode
+    - rvm: ruby-head
+notifications:
+  irc:
+    channels:
+      - "irc.freenode.org#rom-rb"
+    on_success: never
+    on_failure: change
+  email:
+    on_success: never
+    on_failure: change

data/Gemfile

@@ -0,0 +1,19 @@
+# encoding: utf-8
+
+source 'https://rubygems.org'
+
+gemspec
+
+gem 'rom-mapper', path: '.'
+
+group :test do
+  gem 'bogus', '~> 0.1'
+  gem 'axiom', '~> 0.1'
+end
+
+group :development do
+  gem 'devtools', git: 'https://github.com/rom-rb/devtools.git'
+end
+
+# Added by devtools
+eval_gemfile 'Gemfile.devtools'

data/Gemfile.devtools

@@ -0,0 +1,55 @@
+# encoding: utf-8
+
+group :development do
+  gem 'rake',  '~> 10.1.0'
+  gem 'rspec', '~> 2.14.1'
+  gem 'yard',  '~> 0.8.7'
+end
+
+group :yard do
+  gem 'kramdown', '~> 1.1.0'
+end
+
+group :guard do
+  gem 'guard',         '~> 1.8.1'
+  gem 'guard-bundler', '~> 1.0.0'
+  gem 'guard-rspec',   '~> 3.0.2'
+  gem 'guard-rubocop', '~> 0.2.0'
+  gem 'guard-mutant',  '~> 0.0.1'
+
+  # file system change event handling
+  gem 'listen',     '~> 1.2.2'
+  gem 'rb-fchange', '~> 0.0.6', require: false
+  gem 'rb-fsevent', '~> 0.9.3', require: false
+  gem 'rb-inotify', '~> 0.9.0', require: false
+
+  # notification handling
+  gem 'libnotify',               '~> 0.8.0', require: false
+  gem 'rb-notifu',               '~> 0.0.4', require: false
+  gem 'terminal-notifier-guard', '~> 1.5.3', require: false
+end
+
+group :metrics do
+  gem 'coveralls', '~> 0.6.7'
+  gem 'flay',      '~> 2.4.0'
+  gem 'flog',      '~> 4.1.1'
+  gem 'reek',      '~> 1.3.2'
+  gem 'rubocop',   '~> 0.11.0'
+  gem 'simplecov', '~> 0.7.1'
+  gem 'yardstick', '~> 0.9.7', git: 'https://github.com/dkubb/yardstick.git'
+
+  platforms :ruby_19, :ruby_20 do
+    gem 'mutant', git: 'https://github.com/mbj/mutant.git'
+    gem 'yard-spellcheck', '~> 0.1.5'
+  end
+end
+
+group :benchmarks do
+  gem 'rbench', '~> 0.2.3'
+end
+
+platform :jruby do
+  group :jruby do
+    gem 'jruby-openssl', '~> 0.8.5'
+  end
+end

data/Guardfile

@@ -0,0 +1,19 @@
+guard :rspec do
+  #run all specs if configuration is modified
+  watch('Guardfile')           { 'spec' }
+  watch('Gemfile.lock')        { 'spec' }
+  watch('spec/spec_helper.rb') { 'spec' }
+
+  # run all specs if supporting files files are modified
+  watch(%r{\Aspec/(?:lib|support|shared)/.+\.rb\z}) { 'spec' }
+
+  # run unit specs if associated lib code is modified
+  watch(%r{\Alib/(.+)\.rb\z})                                         { |m| Dir["spec/unit/#{m[1]}"]         }
+  watch(%r{\Alib/(.+)/support/(.+)\.rb\z})                            { |m| Dir["spec/unit/#{m[1]}/#{m[2]}"] }
+  watch("lib/#{File.basename(File.expand_path('../', __FILE__))}.rb") { 'spec'                               }
+
+  # run a spec if it is modified
+  watch(%r{\Aspec/(?:unit|integration)/.+_spec\.rb\z})
+
+  notification :tmux, :display_message => true
+end

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2013 Ruby Object Mapper Team
+
+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.md

@@ -0,0 +1,21 @@
+# rom-mapper
+
+[![Gem Version](https://badge.fury.io/rb/rom-mapper.png)][gem]
+[![Build Status](https://travis-ci.org/rom-rb/rom-mapper.png?branch=master)][travis]
+[![Dependency Status](https://gemnasium.com/rom-rb/rom-mapper.png)][gemnasium]
+[![Code Climate](https://codeclimate.com/github/rom-rb/rom-mapper.png)][codeclimate]
+[![Coverage Status](https://coveralls.io/repos/rom-rb/rom-mapper/badge.png?branch=master)][coveralls]
+
+[gem]: https://rubygems.org/gems/rom-mapper
+[travis]: https://travis-ci.org/rom-rb/rom-mapper
+[gemnasium]: https://gemnasium.com/rom-rb/rom-mapper
+[codeclimate]: https://codeclimate.com/github/rom-rb/rom-mapper
+[coveralls]: https://coveralls.io/r/rom-rb/rom-mapper
+
+Mappers for [Ruby Object Mapper](http://rom-rb.org).
+
+See ROM's [README](https://github.com/rom-rb/rom) for more information.
+
+## License
+
+See LICENSE file.

data/Rakefile

@@ -0,0 +1,7 @@
+# encoding: utf-8
+
+require 'devtools'
+
+Devtools.init_rake_tasks
+
+require 'rspec/core/rake_task'

data/config/devtools.yml

@@ -0,0 +1,2 @@
+---
+unit_test_timeout: 0.1

data/config/flay.yml

@@ -0,0 +1,3 @@
+---
+threshold: 7
+total_score: 55

data/config/flog.yml

@@ -0,0 +1,2 @@
+---
+threshold: 13.7

data/config/mutant.yml

@@ -0,0 +1,3 @@
+---
+name: rom-mapper
+namespace: ROM::Mapper

data/config/reek.yml

@@ -0,0 +1,105 @@
+---
+Attribute:
+  enabled: true
+  exclude: []
+BooleanParameter:
+  enabled: true
+  exclude: []
+ClassVariable:
+  enabled: true
+  exclude: []
+ControlParameter:
+  enabled: true
+  exclude: []
+DataClump:
+  enabled: true
+  exclude: []
+  max_copies: 2
+  min_clump_size: 2
+DuplicateMethodCall:
+  enabled: false
+FeatureEnvy:
+  enabled: true
+  exclude:
+    - ROM::Mapper::Loader::Allocator#call
+    - ROM::Mapper::Loader::AttributeWriter#call
+    - ROM::Mapper::Loader::ObjectBuilder#attributes
+    - ROM::Mapper::Header#mapping
+IrresponsibleModule:
+  enabled: true
+  exclude: []
+LongParameterList:
+  enabled: true
+  exclude:
+    - ROM::Mapper#self.build
+  max_params: 2
+LongYieldList:
+  enabled: true
+  exclude: []
+  max_params: 2
+NestedIterators:
+  enabled: true
+  max_allowed_nesting: 1
+  ignore_iterators: []
+  exclude:
+    - ROM::Mapper::Header#keys
+NilCheck:
+  enabled: true
+  exclude: []
+RepeatedConditional:
+  enabled: true
+  exclude: []
+  max_ifs: 1
+TooManyInstanceVariables:
+  enabled: true
+  exclude: []
+  max_instance_variables: 3
+TooManyMethods:
+  enabled: true
+  exclude: []
+  max_methods: 10
+TooManyStatements:
+  enabled: true
+  exclude:
+  - each
+  - ROM::Mapper#self.build
+  - ROM::Mapper::Header#self.build
+  max_statements: 4
+UncommunicativeMethodName:
+  enabled: true
+  exclude: []
+  reject:
+  - !ruby/regexp /^[a-z]$/
+  - !ruby/regexp /[0-9]$/
+  - !ruby/regexp /[A-Z]/
+  accept: []
+UncommunicativeModuleName:
+  enabled: true
+  exclude: []
+  reject:
+  - !ruby/regexp /^.$/
+  - !ruby/regexp /[0-9]$/
+  accept: []
+UncommunicativeParameterName:
+  enabled: true
+  exclude: []
+  reject:
+  - !ruby/regexp /^.$/
+  - !ruby/regexp /[0-9]$/
+  - !ruby/regexp /[A-Z]/
+  accept: []
+UncommunicativeVariableName:
+  enabled: true
+  exclude: []
+  reject:
+  - !ruby/regexp /^.$/
+  - !ruby/regexp /[0-9]$/
+  - !ruby/regexp /[A-Z]/
+  accept: []
+UnusedParameters:
+  enabled: true
+  exclude: []
+UtilityFunction:
+  enabled: true
+  exclude: []
+  max_helper_calls: 0

data/config/rubocop.yml

@@ -0,0 +1,45 @@
+AllCops:
+  Includes:
+    - '**/*.rake'
+    - 'Gemfile'
+    - 'Gemfile.devtools'
+  Excludes:
+    - '**/vendor/**'
+
+# Avoid parameter lists longer than five parameters.
+ParameterLists:
+  Max: 3
+  CountKeywordArgs: true
+
+# Avoid more than `Max` levels of nesting.
+BlockNesting:
+  Max: 3
+
+# Align with the style guide.
+CollectionMethods:
+  PreferredMethods:
+    collect:  'map'
+    inject:   'reduce'
+    find:     'detect'
+    find_all: 'select'
+
+# Do not force public/protected/private keyword to be indented at the same
+# level as the def keyword. My personal preference is to outdent these keywords
+# because I think when scanning code it makes it easier to identify the
+# sections of code and visually separate them. When the keyword is at the same
+# level I think it sort of blends in with the def keywords and makes it harder
+# to scan the code and see where the sections are.
+AccessControl:
+  Enabled: false
+
+LineLength:
+  Max: 108
+
+Blocks:
+  Enabled: false
+
+Documentation:
+  Enabled: false
+
+EmptyLineBetweenDefs:
+  Enabled: false # TODO: re-enable once SpecHelper.mock_model case is properly handled

data/lib/rom-mapper.rb

@@ -0,0 +1,17 @@
+# encoding: utf-8
+
+require 'concord'
+require 'adamantium'
+require 'equalizer'
+require 'abstract_type'
+
+require 'rom/mapper/attribute'
+require 'rom/mapper/header'
+
+require 'rom/mapper/loader'
+require 'rom/mapper/loader/allocator'
+require 'rom/mapper/loader/attribute_writer'
+require 'rom/mapper/loader/object_builder'
+
+require 'rom/mapper/dumper'
+require 'rom/mapper'

data/lib/rom/mapper.rb

@@ -0,0 +1,135 @@
+# encoding: utf-8
+
+module ROM
+
+  # Mappers load tuples into objects and dump objects back into tuples
+  #
+  class Mapper
+    include Concord::Public.new(:header, :loader, :dumper)
+
+    LOADERS = {
+      allocator:        Loader::Allocator,
+      object_builder:   Loader::ObjectBuilder,
+      attribute_writer: Loader::AttributeWriter
+    }
+
+    DUMPERS = {
+      default: Dumper
+    }
+
+    DEFAULT_LOADER = :allocator
+    DEFAULT_DUMPER = :default
+
+    # Build a mapper
+    #
+    # @example
+    #
+    #   header = Mapper::Header.build([[:user_name, String]], map: { user_name: :name })
+    #
+    #   mapper = Mapper.build(header, User)
+    #   mapper = Mapper.build(header, User, loader_class: Loader::ObjectBuilder)
+    #
+    # @param [Header]
+    # @param [Class]
+    # @param [Hash]
+    #
+    # @return [Mapper]
+    #
+    # @api public
+    def self.build(header, model, options = {})
+      loader_class = LOADERS[options.fetch(:loader, DEFAULT_LOADER)]
+      dumper_class = DUMPERS[options.fetch(:dumper, DEFAULT_DUMPER)]
+
+      header = Header.build(header, options)
+      loader = loader_class.new(header, model)
+      dumper = dumper_class.new(header)
+
+      new(header, loader, dumper)
+    end
+
+    # Project and rename given relation
+    #
+    # @example
+    #
+    #   mapper.call(relation)
+    #
+    # @param [Axiom::Relation]
+    #
+    # @return [Axiom::Relation]
+    #
+    # @api public
+    def call(relation)
+      mapping    = header.mapping
+      attributes = mapping.keys
+
+      relation.project(attributes).rename(mapping)
+    end
+
+    # Retrieve identity from the given object
+    #
+    # @example
+    #
+    #   mapper.identity(user) # => [1]
+    #
+    # @param [Object]
+    #
+    # @return [Array]
+    #
+    # @api public
+    def identity(object)
+      dumper.identity(object)
+    end
+
+    # Return identity from the given tuple
+    #
+    # @example
+    #
+    #   mapper.identity_from_tuple({id: 1}) # => [1]
+    #
+    # @param [Axiom::Tuple,Hash]
+    #
+    # @return [Array]
+    #
+    # @api public
+    def identity_from_tuple(tuple)
+      loader.identity(tuple)
+    end
+
+    # Build a new model instance
+    #
+    # @example
+    #
+    #   mapper = Mapper.build(header, User)
+    #   mapper.new_object(id: 1, name: 'Jane') # => #<User @id=1 @name="Jane">
+    #
+    # @api public
+    def new_object(*args, &block)
+      model.new(*args, &block)
+    end
+
+    # Return model used by this mapper
+    #
+    # @return [Class]
+    #
+    # @api public
+    def model
+      loader.model
+    end
+
+    # Load an object instance from the tuple
+    #
+    # @api private
+    def load(tuple)
+      loader.call(tuple)
+    end
+
+    # Dump an object into a tuple
+    #
+    # @api private
+    def dump(object)
+      dumper.call(object)
+    end
+
+  end # Mapper
+
+end # ROM