arstotzka 1.4.0 → 1.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3343d391090a1c5e806d56c9eb97790a79a04fbc24b707384a71024c3f894879
-  data.tar.gz: da14356086e54f211d32a0725de04bd8ba01a2bb7c767ced8e17519f47f6fb37
+  metadata.gz: 2f85777523a289161b592aa87351fa89b9e255ff4af446b365699aa23f208f72
+  data.tar.gz: c9a7e10955ec91d3a1c356c1a0da69082e36f1c5b89abb76964cbdd92ba7a28f
 SHA512:
-  metadata.gz: 4dabdf1acd44e98e8884a0106d84bd6e1f6e3cd33940b0a777049f66d58529757223dbf28e50ff6717764fe025905bf3d3b5d5a38ee710357fc891b3e6c6de61
-  data.tar.gz: ed2fcefdd16da6ac23e8439a84f8158ad271da23385e6560f97197eafc1ba15b6d3a6150be56493767a4f06a19b82b6790386343a409f9b51d76afb3987fc966
+  metadata.gz: ae4b737d7c698ec03482a30b7ca5a715c413aa08bccd4863f2cdf081dc984f242171028deaa5256156b6b6b62555a23239327ba808523d5df1f0f756d57c5c5d
+  data.tar.gz: bd2e82f32e3cbdbc09178d8ae9224a9432b90c2d0ec2edef2148c99279a8617dc688f969d2b47d0510f2ff42c4b605cd5ab2c5e562fa54feee8cbc9c6a24a008

data/README.md

@@ -19,7 +19,7 @@ JSON keys)
 
 Yard Documentation
 -------------------
-https://www.rubydoc.info/gems/arstotzka/1.4.0
+https://www.rubydoc.info/gems/arstotzka/1.4.1
 
 Instalation
 ---------------

data/arstotzka.gemspec

@@ -20,7 +20,7 @@ Gem::Specification.new do |gem|
   gem.require_paths = ['lib']
 
   gem.add_runtime_dependency 'activesupport', '~> 5.x'
-  gem.add_runtime_dependency 'sinclair',      '>= 1.4.0'
+  gem.add_runtime_dependency 'sinclair',      '>= 1.4.1'
 
   gem.add_development_dependency 'bundler',       '~> 1.16.1'
   gem.add_development_dependency 'pry-nav',       '~> 0.2.4'

data/config/yardstick.yml

@@ -27,6 +27,8 @@ rules:
       - Arstotzka::Fetcher::Cache#block
       - Arstotzka::Fetcher::Cache#options
       - Arstotzka::FetcherBuilder#options
+      - Arstotzka::KeyChanger#base_key
+      - Arstotzka::KeyChanger#options
       - Arstotzka::KeyReader#base_key
       - Arstotzka::KeyReader#hash
       - Arstotzka::KeyReader#options
@@ -35,6 +37,7 @@ rules:
       - Arstotzka::MethodBuilder#options
       - Arstotzka::Reader#keys
       - Arstotzka::Reader#options
+      - Arstotzka::PostProcessor#options
       - Arstotzka::Wrapper#options
   Summary::Presence:
     enabled: true
@@ -48,6 +51,9 @@ rules:
       - Arstotzka::Fetcher::Cache#options
       - Arstotzka::Fetcher::Cache#initialize
       - Arstotzka::FetcherBuilder#options
+      - Arstotzka::KeyChanger#initialize
+      - Arstotzka::KeyChanger#base_key
+      - Arstotzka::KeyChanger#options
       - Arstotzka::KeyReader#base_key
       - Arstotzka::KeyReader#hash
       - Arstotzka::KeyReader#options
@@ -56,6 +62,8 @@ rules:
       - Arstotzka::MethodBuilder#options
       - Arstotzka::Reader#keys
       - Arstotzka::Reader#options
+      - Arstotzka::PostProcessor#initialize
+      - Arstotzka::PostProcessor#options
       - Arstotzka::Wrapper#options
   Summary::Length:
     enabled: true

data/lib/arstotzka/class_methods.rb

@@ -69,6 +69,64 @@ module Arstotzka
     #
     # Expose a field from the json/hash as a method
     #
+    # @param attr_names [Array<String,Symbol>] attributes being exposed
+    # @param options_hash [Hash] exposing options
+    #
+    # @option options_hash after [String,Symbol] instance method to be called on the
+    #   returning value returned by {Crawler} before being returned by {Fetcher}.
+    #   The result of the method call will be the actual value
+    #   (used by {PostProcessor})
+    #
+    # @option options_hash after_each [String,Symbol] instance method to be
+    #   called on each element found when crawling the hash.
+    #   If an array should be returned, after_each will be called on each individual
+    #   elements (even nil elements) while +after+ is only called on the
+    #   collection. (used by {Wrapper})
+    #
+    # @option options_hash cached [Boolean,Symbol] Flag to ensure
+    #   there value is cached after first fetching.
+    #   (used by {Fetcher::Cache})
+    #   - +false+/+nil+ : no cache, fetcher will always look in the hash
+    #     for the value
+    #   - +true+ : Simple cache, nil values are always considered
+    #     not cached
+    #   - +:full+ : cache even nil values
+    #
+    # @option options_hash case [Symbol] case type of the keys in the hash
+    #   (used by {KeyChanger})
+    #   - +:snake+ : snake_cased keys
+    #   - +:lower_camel+ : lowerCamelCased keys
+    #   - +:upper_camel+ : UperCamelCased keys
+    #
+    # @option options_hash compact [Boolean] flag signallying if nil values should be
+    #   removed of array (applying +Array#compact+) (used by {Crawler})
+    #
+    # @option options_hash default [Object] default value to be returned when failing
+    #   to fetch a value (used by {Crawler})
+    #
+    # @option options_hash flatten [Boolean] flag signallying if multi levels
+    #   arrays should be flattened to one level array (applying +Array#flatten+)
+    #   (used by {PostProcessor})
+    #
+    # @option options_hash full_path [String] full path of keys to be used in when
+    #   not wanting to have the attribute defined as key. (eg. +'person.name'+)
+    #   (used by {Crawler})
+    #
+    # @option options_hash klass [Class] class to wrap the value (used by {Wrapper})
+    #
+    # @option options_hash json [String,Symbol] name of the method or variable
+    #   used to fetch the hash to be crawled (eg. +:hash+, +:@hash+, +"@@config"+)
+    #   (used by {HashReader})
+    #
+    # @option options_hash path [String,Symbol] base path to be crawled.
+    #   (used by {Crawler})
+    #
+    # @option options_hash type [String,Symbol] type to cast the value. The
+    #   possible type_cast is defined by {TypeCast} (used by {Wrapper})
+    #   - +integer+
+    #   - +string+
+    #   - +float+
+    #
     # @example
     #   class MyModel
     #     include Arstotzka
@@ -95,6 +153,7 @@ module Arstotzka
     #
     # @return [Array<Sinclair::MethodDefinition>]
     #
+    # @see Config
     # @see MethodBuilder Arstotzka::MethodBuilder
     # @see
     #   https://www.rubydoc.info/gems/activesupport/5.2.2/ActiveSupport/Concern

data/lib/arstotzka/config.rb

@@ -5,12 +5,48 @@ module Arstotzka
   #
   # Arstotzka configuration
   #
-  # Configuration is
+  # Configuration of Arstotzka is done through
+  # +Arstotzka.configure+ which configures using
+  # {Arstotzka::Config} by +Sinclar::Configurable+
   #
-  # @see https://www.rubydoc.info/gems/sinclair/1.4.0/Sinclair/Config Sinclair::Config
+  # @see https://www.rubydoc.info/gems/sinclair/1.4.1/Sinclair/Config
+  #   Sinclair::Config
+  #
+  # @example Redefining json method and case type
+  #   class Office
+  #     include Arstotzka
+  #
+  #     expose :employes, full_path: 'employes.first_name',
+  #                       compact: true
+  #
+  #     def initialize(hash)
+  #       @hash = hash
+  #     end
+  #   end
+  #
+  #   hash = {
+  #     employes: [{
+  #       first_name: 'Rob'
+  #     }, {
+  #       first_name: 'Klara'
+  #     }]
+  #   }
+  #
+  #   office = Office.new(hash)
+  #
+  #   office.employes # raises NoMethodError as json is not a method
+  #
+  #   Arstotzka.configure { json :@hash }
+  #
+  #   office.employes # returns []
+  #
+  #   Arstotzka.configure { |c| c.case :snake }
+  #
+  #   office.employes # returns %w[Rob Klara]
   #
   # @example (see #options)
   class Config < Sinclair::Config
+    # Default values for {ClassMethods#expose}
     DEFAULT_CONFIGS = {
       after:      false,
       after_each: nil,

data/lib/arstotzka/fetcher.rb

@@ -96,8 +96,7 @@ module Arstotzka
     # @return [TrueClass,FalseClass]
     def ==(other)
       return false unless other.class == self.class
-      options == other.options &&
-        instance == other.instance
+      options == other.options
     end
 
     protected
@@ -107,7 +106,6 @@ module Arstotzka
     private
 
     # @private
-    delegate :instance, :after, :flatten, to: :options
     delegate :wrap, to: :wrapper
     delegate :hash, to: :hash_reader
 
@@ -120,9 +118,16 @@ module Arstotzka
     #
     # @return [Object]
     def fetch_value
-      value = crawler.value(hash)
-      value.flatten! if flatten && value.is_a?(Array)
-      after ? instance.send(after, value) : value
+      post_processor.process crawler.value(hash)
+    end
+
+    # @private
+    #
+    # post processor for wrapping and filtering collection before return
+    #
+    # @return [PostProcessor]
+    def post_processor
+      @post_processor ||= PostProcessor.new(options)
     end
 
     # @private
@@ -134,10 +139,9 @@ module Arstotzka
     #
     # @return [Arstotzka::Crawler] the crawler object
     def crawler
-      @crawler ||=
-        Crawler.new(options) do |value|
-          wrap(value)
-        end
+      @crawler ||= Crawler.new(options) do |value|
+        wrap(value)
+      end
     end
 
     # @private

data/lib/arstotzka/key_changer.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Arstotzka
+  # @api private
+  #
+  # Class responsible for changing a key
+  class KeyChanger
+    include Base
+
+    # @param [String] base_key The key to be checked
+    #   (before case change)
+    #
+    # @overload initialize(base_key, options_hash)
+    #   @param options_hash [Hash] options passed on expose
+    #   @option options_hash case [Symbol] case type for key
+    #     transformation
+    #     - +:snake+ : snake_cased keys
+    #     - +:lower_camel+ : lowerCamelCased keys
+    #     - +:upper_camel+ : UperCamelCased keys
+    # @overload initialize(base_key, options)
+    #   @param options [Option] options passed on expose
+    #
+    # @example
+    #   changer = Arstotzka::KeyChanger.new('the_key', case: :upper_camel)
+    #   changer.key # returns 'TheKey'
+    def initialize(base_key, options_hash = {})
+      self.options = options_hash
+      @base_key = base_key
+    end
+
+    # Transforms the key to have the correct case
+    #
+    # the possible cases (instance attribute) are
+    # - lower_camel: for cammel case with first letter lowercase
+    # - upper_camel: for cammel case with first letter uppercase
+    # - snake: for snake case
+    #
+    # @return [String] the string transformed
+    def key
+      @key ||= case options.case
+               when :lower_camel
+                 base_key.camelize(:lower)
+               when :upper_camel
+                 base_key.camelize(:upper)
+               when :snake
+                 base_key.underscore
+               end
+    end
+
+    private
+
+    attr_reader :base_key, :options
+  end
+end

data/lib/arstotzka/key_reader.rb

@@ -48,6 +48,7 @@ module Arstotzka
     private
 
     attr_reader :hash, :base_key, :options
+    delegate :key, to: :key_changer
 
     # @private
     #
@@ -66,23 +67,11 @@ module Arstotzka
 
     # @private
     #
-    # Transforms the key to have the correct case
+    # Returns key changer for getting the correct key
     #
-    # the possible cases (instance attribute) are
-    # - lower_camel: for cammel case with first letter lowercase
-    # - upper_camel: for cammel case with first letter uppercase
-    # - snake: for snake case
-    #
-    # @return [String] the string transformed
-    def key
-      @key ||= case options.case
-               when :lower_camel
-                 base_key.camelize(:lower)
-               when :upper_camel
-                 base_key.camelize(:upper)
-               when :snake
-                 base_key.underscore
-               end
+    # @return [KeyChanger]
+    def key_changer
+      @key_changer ||= KeyChanger.new(base_key, options)
     end
   end
 end

data/lib/arstotzka/options.rb

@@ -246,47 +246,26 @@ module Arstotzka
   class Options < ::OpenStruct
     # Creates a new instance of Options
     #
-    # @param options [Hash] options hash
+    # @param options_hash [Hash] options hash
     #   Options hash are initialized when using {ClassMethods#expose}
     #
-    # @option options [String,Symbol] after: {Fetcher} option with the name of the method to be
-    #   called once the value is fetched for mapping the value
+    # @option (see ClassMethods#expose)
     #
-    # @option options [String,Symbol] after_each: {Wrapper} option with method that will be called
-    #   on each individual result (while after is called on the whole collection)
-    # @option options [Boolean] cached: flag if the result should be memorized instead of repeating
-    #   the crawling
-    # @option options [String,Symbol] case: {Reader} flag definining on which case will
-    #   the keys be defined
-    #   - lower_camel: keys in the hash are lowerCamelCase
-    #   - upper_camel: keys in the hash are UpperCamelCase
-    #   - snake: keys in the hash are snake_case
-    # @option options [Boolean] compact: {Crawler} flag to apply Array#compact thus
-    #   removing nil results
-    # @option options [Boolean] default: {Crawler} option to return default value instead of nil
-    # @option options [Boolean] flatten: {Fetcher} flag to aplly Array#flatten thus
-    #   avoing nested arrays
-    # @option options [String,Symbol] full_path: path of hash attributes to find exacttly where the
-    #   value live (ignoring the attribute name)
-    # @option options [Class] klass: {Fetcher} option that, when passed, wraps the individual
-    #   results in an instance of the given class
-    # @option options [String,Symbol] json: name of the method containing the hash to be crawled
-    # @option options [String,Symbol] path path of hash attributes to find the root
-    #   where the attribute live (then fetching it using the attribute name)
-    # @option options [String,Symbol] type:  {Fetcher} option declaring the type of the returned
-    #   value (to use casting) (see {TypeCast})
-    #   - integer
-    #   - string
-    #   - float
+    # @option options_hash instance [Object] instance whose method
+    #   was called
+    #
+    # @option options_hash key [Symbol,String] name of method called.
+    #   This will be used as instance variable when caching results
     #
-    # @see Arstotzka::Options::DEFAULT_OPTIONS
     # @return [Arstotzka::Options]
-    def initialize(options)
-      klass = options.delete(:class)
+    #
+    # @see Config
+    def initialize(options_hash)
+      klass = options_hash.delete(:class)
       warn ":class has been deprecated, prefer 'expose klass: #{klass}'" if klass
-      options[:klass] ||= klass
+      options_hash[:klass] ||= klass
 
-      super(options)
+      super(options_hash)
     end
 
     # @private

data/lib/arstotzka/post_processor.rb

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+module Arstotzka
+  # @api private
+  #
+  # Class reponsible for processing the result of {Crawler#crawl}.
+  #
+  # PostProcessor proccess the whole collection and not
+  # individual results
+  #
+  # @example Simple Usage
+  #   class Employe
+  #     attr_reader :name, :age, :company
+  #
+  #     def initialize(name:, age:, company:)
+  #       @name    = name
+  #       @age     = age
+  #       @company = company
+  #     end
+  #
+  #     def adult?
+  #       age >= 18
+  #     end
+  #
+  #     def ==(other)
+  #       return unless other.class == self.class
+  #       other.name == name &&
+  #         other.age == age &&
+  #         other.company == company
+  #     end
+  #   end
+  #
+  #   class Company
+  #     def create_employes(people)
+  #       people.map do |person|
+  #         Employe.new(company: self, **person)
+  #       end.select(&:adult?)
+  #     end
+  #   end
+  #
+  #   company = Company.new
+  #
+  #   options = {
+  #     after: :create_employes,
+  #     flatten: true,
+  #     instance: company
+  #   }
+  #
+  #   processor = Arstotzka::PostProcessor.new(options)
+  #
+  #   value = [
+  #     [
+  #       { name: 'Bob',   age: 21 },
+  #       { name: 'Rose',  age: 19 }
+  #     ], [
+  #       { name: 'Klara', age: 18 },
+  #       { name: 'Al',    age: 15 }
+  #     ]
+  #   ]
+  #
+  #   processor.process(value)
+  #
+  #   # returns [
+  #   #   Employe.new(name: 'Bob',   age: 21, company: company),
+  #   #   Employe.new(name: 'Rose',  age: 19, company: company),
+  #   #   Employe.new(name: 'Klara', age: 18, company: company)
+  #   # ]
+  class PostProcessor
+    include Base
+
+    # @overload initialize(options_hash)
+    #   @param options_hash [Hash] options passed by
+    #     {ClassMethods#expose}
+    #   @option options_hash instance [Objct]
+    #   @option options_hash after [String,Symbol] instance method to be called on the
+    #     returning value returned by {Crawler} before being returned by {Fetcher}.
+    #   @option options_hash flatten [Boolean] flag signallying if multi levels
+    #     arrays should be flattened to one level array (applying +Array#flatten+)
+    # @overload initialize(options)
+    #   @param options [Hash] options passed by {ClassMethods#expose}
+    def initialize(options_hash = {})
+      self.options = options_hash
+    end
+
+    # Apply transformation and filters on the result
+    #
+    # @param value [Object] value is returned from crawler
+    #   being a single object, or an array.
+    #
+    # @return [Object]
+    def process(value)
+      value.flatten! if flatten && value.is_a?(Array)
+
+      return value unless after
+
+      instance.send(after, value)
+    end
+
+    private
+
+    attr_reader :options
+
+    delegate :instance, :after, :flatten, to: :options
+  end
+end

data/lib/arstotzka/reader.rb

@@ -22,8 +22,6 @@ module Arstotzka
     # @return [Arstotzka::Reader]
     def initialize(options_hash = {})
       self.options = options_hash
-
-      @keys = options.keys
     end
 
     # Reads the value of one key in the hash
@@ -81,6 +79,7 @@ module Arstotzka
     private
 
     # @private
-    attr_reader :keys, :options
+    attr_reader :options
+    delegate :keys, to: :options
   end
 end

data/lib/arstotzka/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Arstotzka
-  VERSION = '1.4.0'
+  VERSION = '1.4.1'
 end

data/lib/arstotzka.rb

@@ -175,10 +175,12 @@ module Arstotzka
   autoload :Exception,      'arstotzka/exception'
   autoload :Fetcher,        'arstotzka/fetcher'
   autoload :FetcherBuilder, 'arstotzka/fetcher_builder'
+  autoload :KeyChanger,     'arstotzka/key_changer'
   autoload :KeyReader,      'arstotzka/key_reader'
   autoload :HashReader,     'arstotzka/hash_reader'
   autoload :MethodBuilder,  'arstotzka/method_builder'
   autoload :Options,        'arstotzka/options'
+  autoload :PostProcessor,  'arstotzka/post_processor'
   autoload :Reader,         'arstotzka/reader'
   autoload :TypeCast,       'arstotzka/type_cast'
   autoload :Wrapper,        'arstotzka/wrapper'

data/spec/integration/yard/arstotzka/config_spec.rb

@@ -6,6 +6,41 @@ describe Arstotzka::Config do
   describe 'yard' do
     subject(:config) { Arstotzka.config }
 
+    after { Arstotzka.reset_config }
+
+    describe 'Redefining json method and case type' do
+      let(:office) { Office.new(hash) }
+
+      let(:hash) do
+        {
+          employes: [{
+            first_name: 'Rob'
+          }, {
+            first_name: 'Klara'
+          }]
+        }
+      end
+
+      let(:error_message) do
+        "undefined method `json' for #{office}\nDid you mean?  JSON"
+      end
+
+      it do
+        expect { office.employes }
+          .to raise_error(NoMethodError, error_message)
+      end
+
+      context 'when json option is defined' do
+        before { Arstotzka.configure { json :@hash } }
+
+        it do
+          expect { Arstotzka.configure { |c| c.case :snake } }
+            .to change(office, :employes)
+            .from([]).to(%w[Rob Klara])
+        end
+      end
+    end
+
     describe '#options' do
       let(:overrides) { { klass: Person } }
 
@@ -30,8 +65,6 @@ describe Arstotzka::Config do
         end
       end
 
-      after { Arstotzka.reset_config }
-
       it 'configure options to use snake case' do
         expect(config.options(overrides).to_h).to eq(expected)
       end

data/spec/integration/yard/arstotzka/key_changer_spec.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe Arstotzka::KeyChanger do
+  describe '#yard' do
+    subject(:key_changer) do
+      described_class.new('the_key', case: :upper_camel)
+    end
+
+    it 'converts key case' do
+      expect(key_changer.key).to eq('TheKey')
+    end
+  end
+end

data/spec/integration/yard/arstotzka/post_processor_spec.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe Arstotzka::PostProcessor do
+  describe 'yard' do
+    subject(:processor) { described_class.new(options) }
+
+    let(:company) { Company.new }
+
+    let(:options) do
+      {
+        after: :create_employes,
+        flatten: true,
+        instance: company
+      }
+    end
+
+    let(:value) do
+      [
+        [
+          { name: 'Bob',   age: 21 },
+          { name: 'Rose',  age: 19 }
+        ], [
+          { name: 'Klara', age: 18 },
+          { name: 'Al',    age: 15 }
+        ]
+      ]
+    end
+
+    let(:expected) do
+      [
+        Employe.new(name: 'Bob',   age: 21, company: company),
+        Employe.new(name: 'Rose',  age: 19, company: company),
+        Employe.new(name: 'Klara', age: 18, company: company)
+      ]
+    end
+
+    describe 'Simple usage' do
+      it 'maps and filter' do
+        expect(processor.process(value)).to eq(expected)
+      end
+    end
+  end
+end

data/spec/lib/arstotzka/key_changer_spec.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe Arstotzka::KeyChanger do
+  subject(:key_changer) { described_class.new(base_key, options) }
+
+  describe '#key' do
+    let(:base_key) { 'the_key' }
+
+    context 'when no options are given' do
+      let(:options) { {} }
+
+      it 'returns lower camelized key' do
+        expect(key_changer.key).to eq('theKey')
+      end
+    end
+
+    context 'when setting upper camel' do
+      let(:options) { { case: :upper_camel } }
+
+      it 'returns upper camelized key' do
+        expect(key_changer.key).to eq('TheKey')
+      end
+    end
+
+    context 'when setting snake' do
+      let(:options)  { { case: :snake } }
+      let(:base_key) { 'TheKey' }
+
+      it 'returns lower snakecased key' do
+        expect(key_changer.key).to eq('the_key')
+      end
+    end
+  end
+end

data/spec/lib/arstotzka/post_processor_spec.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe Arstotzka::PostProcessor do
+  subject(:processor) { described_class.new(options) }
+
+  let(:options) { {} }
+  let(:value)   { [%w[Bob Klara], %w[Rose Aria]] }
+
+  describe '#process' do
+    context 'when no options are given' do
+      it 'returns the value with no change' do
+        expect(processor.process(value)).to eq(value)
+      end
+    end
+
+    context 'when passing flatten option' do
+      let(:options) { { flatten: true } }
+
+      it 'flattens the array' do
+        expect(processor.process(value))
+          .to eq(%w[Bob Klara Rose Aria])
+      end
+    end
+
+    context 'when passing after' do
+      let(:company) { Company.new }
+
+      let(:options) do
+        { after: :create_employes, instance: company }
+      end
+
+      let(:value) do
+        [
+          { name: 'Bob',   age: 21 },
+          { name: 'Klara', age: 18 },
+          { name: 'Rose',  age: 16 },
+          { name: 'Al',    age: 15 }
+        ]
+      end
+
+      let(:expected) do
+        [
+          Employe.new(name: 'Bob',   age: 21, company: company),
+          Employe.new(name: 'Klara', age: 18, company: company)
+        ]
+      end
+
+      it 'maps and filtes by method' do
+        expect(processor.process(value)).to eq(expected)
+      end
+    end
+  end
+end

data/spec/support/models/company.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+class Company
+  def create_employes(people)
+    people.map do |person|
+      Employe.new(company: self, **person)
+    end.select(&:adult?)
+  end
+end

data/spec/support/models/employe.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+class Employe
+  attr_reader :name, :age, :company
+
+  def initialize(name:, age:, company:)
+    @name    = name
+    @age     = age
+    @company = company
+  end
+
+  def adult?
+    age >= 18
+  end
+
+  def ==(other)
+    return unless other.class == self.class
+    other.name == name &&
+      other.age == age &&
+      other.company == company
+  end
+end

data/spec/support/models/office.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+class Office
+  include Arstotzka
+
+  expose :employes, full_path: 'employes.first_name',
+                    compact: true
+
+  def initialize(hash)
+    @hash = hash
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: arstotzka
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.4.1
 platform: ruby
 authors:
 - Darthjee
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-07-09 00:00:00.000000000 Z
+date: 2019-07-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.4.0
+        version: 1.4.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.4.0
+        version: 1.4.1
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -227,9 +227,11 @@ files:
 - lib/arstotzka/fetcher/cache.rb
 - lib/arstotzka/fetcher_builder.rb
 - lib/arstotzka/hash_reader.rb
+- lib/arstotzka/key_changer.rb
 - lib/arstotzka/key_reader.rb
 - lib/arstotzka/method_builder.rb
 - lib/arstotzka/options.rb
+- lib/arstotzka/post_processor.rb
 - lib/arstotzka/reader.rb
 - lib/arstotzka/type_cast.rb
 - lib/arstotzka/version.rb
@@ -251,9 +253,11 @@ files:
 - spec/integration/yard/arstotzka/fetcher_builder_spec.rb
 - spec/integration/yard/arstotzka/fetcher_spec.rb
 - spec/integration/yard/arstotzka/hash_reader_spec.rb
+- spec/integration/yard/arstotzka/key_changer_spec.rb
 - spec/integration/yard/arstotzka/key_reader_spec.rb
 - spec/integration/yard/arstotzka/method_builder_spec.rb
 - spec/integration/yard/arstotzka/options_spec.rb
+- spec/integration/yard/arstotzka/post_processor_spec.rb
 - spec/integration/yard/arstotzka/reader_spec.rb
 - spec/integration/yard/arstotzka/type_cast_spec.rb
 - spec/integration/yard/arstotzka/wrapper_spec.rb
@@ -264,9 +268,11 @@ files:
 - spec/lib/arstotzka/fetcher_builder_spec.rb
 - spec/lib/arstotzka/fetcher_spec.rb
 - spec/lib/arstotzka/hash_reader_spec.rb
+- spec/lib/arstotzka/key_changer_spec.rb
 - spec/lib/arstotzka/key_reader_spec.rb
 - spec/lib/arstotzka/method_builder_spec.rb
 - spec/lib/arstotzka/options_spec.rb
+- spec/lib/arstotzka/post_processor_spec.rb
 - spec/lib/arstotzka/reader_spec.rb
 - spec/lib/arstotzka/wrapper_spec.rb
 - spec/lib/arstotzka_spec.rb
@@ -287,14 +293,17 @@ files:
 - spec/support/models/car_collector.rb
 - spec/support/models/collector.rb
 - spec/support/models/collector/game.rb
+- spec/support/models/company.rb
 - spec/support/models/customer.rb
 - spec/support/models/drink.rb
+- spec/support/models/employe.rb
 - spec/support/models/game.rb
 - spec/support/models/group.rb
 - spec/support/models/house.rb
 - spec/support/models/job_seeker.rb
 - spec/support/models/my_model.rb
 - spec/support/models/my_parser.rb
+- spec/support/models/office.rb
 - spec/support/models/person.rb
 - spec/support/models/request.rb
 - spec/support/models/restaurant.rb
@@ -344,9 +353,11 @@ test_files:
 - spec/integration/yard/arstotzka/fetcher_builder_spec.rb
 - spec/integration/yard/arstotzka/fetcher_spec.rb
 - spec/integration/yard/arstotzka/hash_reader_spec.rb
+- spec/integration/yard/arstotzka/key_changer_spec.rb
 - spec/integration/yard/arstotzka/key_reader_spec.rb
 - spec/integration/yard/arstotzka/method_builder_spec.rb
 - spec/integration/yard/arstotzka/options_spec.rb
+- spec/integration/yard/arstotzka/post_processor_spec.rb
 - spec/integration/yard/arstotzka/reader_spec.rb
 - spec/integration/yard/arstotzka/type_cast_spec.rb
 - spec/integration/yard/arstotzka/wrapper_spec.rb
@@ -357,9 +368,11 @@ test_files:
 - spec/lib/arstotzka/fetcher_builder_spec.rb
 - spec/lib/arstotzka/fetcher_spec.rb
 - spec/lib/arstotzka/hash_reader_spec.rb
+- spec/lib/arstotzka/key_changer_spec.rb
 - spec/lib/arstotzka/key_reader_spec.rb
 - spec/lib/arstotzka/method_builder_spec.rb
 - spec/lib/arstotzka/options_spec.rb
+- spec/lib/arstotzka/post_processor_spec.rb
 - spec/lib/arstotzka/reader_spec.rb
 - spec/lib/arstotzka/wrapper_spec.rb
 - spec/lib/arstotzka_spec.rb
@@ -380,14 +393,17 @@ test_files:
 - spec/support/models/car_collector.rb
 - spec/support/models/collector.rb
 - spec/support/models/collector/game.rb
+- spec/support/models/company.rb
 - spec/support/models/customer.rb
 - spec/support/models/drink.rb
+- spec/support/models/employe.rb
 - spec/support/models/game.rb
 - spec/support/models/group.rb
 - spec/support/models/house.rb
 - spec/support/models/job_seeker.rb
 - spec/support/models/my_model.rb
 - spec/support/models/my_parser.rb
+- spec/support/models/office.rb
 - spec/support/models/person.rb
 - spec/support/models/request.rb
 - spec/support/models/restaurant.rb