arstotzka 1.2.0 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3d37d619db8888a43c76400066d7657b53bbf94297e2be0f900fd7f1c391d080
-  data.tar.gz: 98d542ee52adac431bfe9acfcbc4a1bdd6cfdc002647b594b0f4fedfe371a208
+  metadata.gz: fcdfefb20e55716afccbdb1db14cb24c1b23f5c3609e0cdaccfb897e6f949c32
+  data.tar.gz: f374f9f717e7f3b867d40270bc531eb3c22e54b9060f232e5984157c4039e612
 SHA512:
-  metadata.gz: 94dcbbed1f5665dab68a52f82222016aad12c68aca3f6676bbf95727f2131bd94c48217e584a245342519ac7c3da887852f85ca3300bf9b5c2a12b2e9d6847e1
-  data.tar.gz: cc368f423651b046af8965f8ca5fc34efbfc8e026c5f894d615621d597360009f713a81554b57e5d8361559f4cf013909be0411ee47bce5a2259f25eef3a8851
+  metadata.gz: 9c2b0cce20c80bdfdc92bfd3dbb0eeff17585e7c2373daa5cfb960bf9356b54feb5d5c9ea66353a52f9b6400720e3fdcc2d27529f5456b9b2c6f0f50a066adc7
+  data.tar.gz: 2996ef066a6d98673f10961f82962e9d570fc23a34882d3a5d280efdb93677425eac4a52b0786551c324d04b296333b0c551603a5fd8923b99e61f81229ccf8e

data/.rubocop.yml

@@ -13,3 +13,7 @@ Metrics/LineLength:
 
 RSpec/AlignLeftLetBrace:
   Enabled: true
+
+Style/ClassAndModuleChildren:
+  Exclude:
+    - spec/integration/**/*.rb

data/README.md

@@ -38,7 +38,7 @@ gem 'arstotzka'
 
 Yard Documentation
 -------------------
-https://www.rubydoc.info/gems/arstotzka/1.2.0
+https://www.rubydoc.info/gems/arstotzka/1.2.1
 
 Getting Started
 ---------------
@@ -94,17 +94,18 @@ MyParser.new.name # returns nil
 
 Options
 -------
-- path: path where to find the sub hash that contains the key (empty by default)
-- json: method that contains the hash to be parsed (json by default)
-- full_path: full path to fetch the value (empty by default)
-- cached: indicator that once the value has been fetched, it should be cached (false by default)
-- klass: class to be used when wrapping the final value
-- compact: indicator telling to ignore nil values inside array (false by default)
-- flatten: indicator telling that to flattern the resulting array (false by default)
-- after: name of a method to be called after with the resulting value
-- case: case of the keys from the json (camel by default)
-- type: Type that the value must be cast into ([TypeCast](#typecast))
+- after: Name of a method to be called after on the values returned
+- after_each: Name of a method to be called after each result
+- cached: Indicator that, once the value has been fetched, it should be cached (false by default)
+- case: Case of the keys from the json (lower_camel by default)
+- compact: Indicator telling to ignore nil values inside array (false by default)
 - default: Default value (prior to casting and wrapping, see [Default](#default))
+- flatten: Indicator telling that to flattern the resulting array (false by default)
+- full_path: Full path to fetch the value (empty by default)
+- klass: Class to be used when wrapping the final value
+- json: Method that contains the hash to be parsed (json by default)
+- path: Path where to find the sub hash that contains the key (empty by default)
+- type: Type that the value must be cast into ([TypeCast](#typecast))
 
 ## TypeCast
 The type casting, when the option `type` is passed, is done through the `Arstotzka::TypeCast` which can

data/lib/arstotzka.rb

@@ -159,6 +159,8 @@ require 'sinclair'
 #                            #   Collector::Game.new(name: "Zelda", played: 90.0)
 #                            # ]
 #
+# @example (see Arstotzka::Options)
+#
 # @see Arstotzka::MethodBuilder
 # @see Arstotzka::ClassMethods
 module Arstotzka

data/lib/arstotzka/fetcher.rb

@@ -10,17 +10,13 @@ module Arstotzka
 
     # Creates an instance of Artotzka::Fetcher
     #
-    # @param instance [Object] object whose methods will be called after for processing
-    #
-    # @overload iniitalize(instance,  options_hash = {})
+    # @overload iniitalize(options_hash = {})
     #   @param options_hash [Hash] options for {Crawler}, {Wrapper} and {Reader}
     #
-    # @overload iniitalize(instance,  options)
+    # @overload iniitalize(options)
     #   @param options [Arstotzka::Options] options for {Crawler}, {Wrapper} and {Reader}
-    def initialize(instance, options_hash = {})
+    def initialize(options_hash = {})
       self.options = options_hash
-
-      @instance = instance
     end
 
     # Crawls the hash for the value
@@ -72,10 +68,11 @@ module Arstotzka
     #
     #   instance = Account.new
     #
-    #   fetcher = Arstotzka::Fetcher.new(instance,
-    #     path: 'transactions',
-    #     klass: Transaction,
-    #     after: :filter_income
+    #   fetcher = Arstotzka::Fetcher.new(
+    #     instance: instance,
+    #     path:     'transactions',
+    #     klass:    Transaction,
+    #     after:    :filter_income
     #   )
     #
     #   fetcher.fetch # retruns [
@@ -93,7 +90,7 @@ module Arstotzka
 
     # @private
     attr_reader :instance, :options
-    delegate :after, :flatten, to: :options
+    delegate :instance, :after, :flatten, to: :options
     delegate :wrap, to: :wrapper
 
     def hash
@@ -121,7 +118,7 @@ module Arstotzka
     #
     # @return [Arstotzka::Wrapper] the wrapper
     def wrapper
-      @wrapper ||= Wrapper.new(options)
+      @wrapper ||= Wrapper.new(options.merge(instance: instance))
     end
   end
 end

data/lib/arstotzka/fetcher_builder.rb

@@ -156,7 +156,7 @@ module Arstotzka
     #
     # @return Arstotzka::Fetcher
     def build(instance)
-      Fetcher.new(instance, options)
+      Fetcher.new(options.merge(instance: instance))
     end
 
     private

data/lib/arstotzka/options.rb

@@ -4,48 +4,295 @@ module Arstotzka
   # @api private
   #
   # Class responsible to hold the options
+  #
+  # Options is initialized and merged with {DEFAULT_OPTIONS}
+  # when using {ClassMethods#expose}
+  #
+  # @example Using options klass and after
+  #   class Customer
+  #     attr_reader :name, :age
+  #
+  #     def initialize(name:, age:)
+  #       @name = name
+  #       @age  = age
+  #     end
+  #
+  #     def adult?
+  #       age >= 18
+  #     end
+  #   end
+  #
+  #   class Store
+  #     include Arstotzka
+  #
+  #     expose :customers, klass: Customer, after: :filter_adults
+  #
+  #     def initialize(json)
+  #       @json = json
+  #     end
+  #
+  #     private
+  #
+  #     attr_reader :json
+  #
+  #     def filter_adults(values)
+  #       values.select(&:adult?)
+  #     end
+  #   end
+  #
+  #   hash = {
+  #     customers: [{
+  #       name: 'John', age: 21
+  #     }, {
+  #       name: 'Julia', age: 15
+  #     }, {
+  #       name: 'Carol', age: 22
+  #     }, {
+  #       name: 'Bobby', age: 12
+  #     }]
+  #   }
+  #
+  #   instance = Store.new(hash)
+  #
+  #   instance.customers # returns [
+  #                      #   Customer.new(name: 'John', age: 21),
+  #                      #   Customer.new(name: 'Carol', age: 22)
+  #                      # ]
+  #
+  # @example Using type with klass and after_each
+  #   module Arstotzka::TypeCast
+  #     def to_symbolized_hash(value)
+  #       value.symbolize_keys
+  #     end
+  #   end
+  #
+  #   class Drink
+  #     attr_reader :name, :price
+  #
+  #     def initialize(name:, price:)
+  #       @name  = name
+  #       @price = price
+  #     end
+  #
+  #     def inflate(inflation)
+  #       @price = (price * (1 + inflation)).round(2)
+  #     end
+  #   end
+  #
+  #   class Bar
+  #     include Arstotzka
+  #
+  #     expose :drinks, type: :symbolized_hash,
+  #       klass: Drink, after_each: :add_inflation
+  #
+  #     def initialize(json)
+  #       @json = json
+  #     end
+  #
+  #     private
+  #
+  #     attr_reader :json
+  #
+  #     def add_inflation(drink)
+  #       drink.inflate(0.1)
+  #       drink
+  #     end
+  #   end
+  #
+  #   json = '{"drinks":[{"name":"tequila","price":7.50},{ "name":"vodka","price":5.50}]}'
+  #
+  #   hash = JSON.parse(hash)
+  #
+  #   instance = Bar.new(hash)
+  #
+  #   instance.drinks # returns [
+  #                   #   Drink.new(name: 'tequila', price: 8.25),
+  #                   #   Drink.new(name: 'vodka', price: 6.05)
+  #                   # ]
+  #
+  # @example Using cached, compact, after and full_path
+  #   class Person
+  #     attr_reader :name
+  #
+  #     def initialize(name)
+  #       @name = name
+  #     end
+  #   end
+  #
+  #   class Application
+  #     include Arstotzka
+  #
+  #     expose :users, full_path: 'users.first_name',
+  #                    compact: true, cached: true,
+  #                    after: :create_person
+  #
+  #     def initialize(json)
+  #       @json = json
+  #     end
+  #
+  #     private
+  #
+  #     attr_reader :json
+  #
+  #     def create_person(names)
+  #       names.map do |name|
+  #         warn "Creating person #{name}"
+  #         Person.new(name)
+  #       end
+  #     end
+  #   end
+  #
+  #   # Keys are on camel case (lower camel case)
+  #   hash = {
+  #     users: [
+  #       { firstName: 'Lucy',  email: 'lucy@gmail.com' },
+  #       { firstName: 'Bobby', email: 'bobby@hotmail.com' },
+  #       { email: 'richard@tracy.com' },
+  #       { firstName: 'Arthur', email: 'arthur@kamelot.uk' }
+  #     ]
+  #   }
+  #
+  #   instance = Application.new(hash)
+  #
+  #   instance.users # trigers the warn "Creating person <name>" 3 times
+  #                  # returns [
+  #                  #   Person.new('Lucy'),
+  #                  #   Person.new('Bobby'),
+  #                  #   Person.new('Arthur')
+  #                  # ]
+  #   instance.users # returns the same value, without triggering warn
+  #
+  # @example Working with snake case hash
+  #   class JobSeeker
+  #     include Arstotzka
+  #
+  #     expose :applicants, case: :snake, default: 'John Doe',
+  #                         full_path: 'applicants.full_name',
+  #                         compact: true, json: :@hash
+  #
+  #     def initialize(hash)
+  #       @hash = hash
+  #     end
+  #   end
+  #
+  #   hash = {
+  #     'applicants' => [
+  #       {
+  #         'full_name' => 'Robert Hatz',
+  #         'email' => 'robert.hatz@gmail.com'
+  #       }, {
+  #         'full_name' => 'Marina Wantz',
+  #         'email' => 'marina.wantz@gmail.com'
+  #       }, {
+  #         'email' => 'albert.witz@gmail.com'
+  #       }
+  #     ]
+  #   }
+  #
+  #   instance = JobSeeker.new(hash)
+  #
+  #   instance.applicants # returns [
+  #                       #   'Robert Hatz',
+  #                       #   'Marina Wantz',
+  #                       #   'John Doe'
+  #                       # ]
+  #
+  # @example Deep path with flatten option
+  #   class ShoppingMall
+  #     include Arstotzka
+  #
+  #     expose :customers, path: 'floors.stores',
+  #                        flatten: true, json: :hash
+  #
+  #     def initialize(hash)
+  #       @hash = hash
+  #     end
+  #
+  #     private
+  #
+  #     attr_reader :hash
+  #   end
+  #
+  #   hash = {
+  #     floors: [{
+  #       name: 'ground', stores: [{
+  #         name: 'Starbucks', customers: %w[
+  #           John Bobby Maria
+  #         ]
+  #       }, {
+  #         name: 'Pizza Hut', customers: %w[
+  #           Danny LJ
+  #         ]
+  #       }]
+  #     }, {
+  #       name: 'first', stores: [{
+  #         name: 'Disney', customers: %w[
+  #           Robert Richard
+  #         ]
+  #       }, {
+  #         name: 'Comix', customers: %w[
+  #           Linda Ariel
+  #         ]
+  #       }]
+  #     }]
+  #   }
+  #
+  #   instance = ShoppingMall.new(hash)
+  #
+  #   instance.customers # returns %w[
+  #                      #   John Bobby Maria
+  #                      #   Danny LJ Robert Richard
+  #                      #   Linda Ariel
+  #                      # ]
   class Options < ::OpenStruct
     DEFAULT_OPTIONS = {
-      json:      :json,
-      path:      nil,
-      full_path: nil,
-      cached:    false,
-      after:     false,
-      case:      :lower_camel,
-      klass:     nil,
-      compact:   false,
-      default:   nil,
-      flatten:   false,
-      type:      :none
+      after:      false,
+      after_each: nil,
+      cached:     false,
+      case:       :lower_camel,
+      compact:    false,
+      default:    nil,
+      flatten:    false,
+      full_path:  nil,
+      json:       :json,
+      klass:      nil,
+      path:       nil,
+      type:       :none
     }.freeze
 
     # Creates a new instance of Options
     #
     # @param options [Hash] options hash
-    #   Options hash will be merged with {DEFAULT_OPTIONS}
-    # @option options [Class] klass class to receive the methods
-    # @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] full_path: path of hash attributes to find exacttly where the
-    #   value live (ignoring the attribute name)
-    # @option options [String,Symbol] json: name of the method containing the hash to be crawled
+    #
+    #   Options hash are initialized and merged with {DEFAULT_OPTIONS}
+    #   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 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
+    # @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
+    # @option options [Boolean] compact: {Crawler} flag to apply Array#compact thus
     #   removing nil results
-    # @option options [Class] klass:  {Fetcher} option thatwhen passed, wraps the result in an
-    #   instance of the given class
-    # @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 options [Boolean] flatten:  {Fetcher} flag to aplly Array#flatten thus
+    # @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)
+    #   value (to use casting) (see {TypeCast})
     #   - integer
     #   - string
     #   - float

data/lib/arstotzka/version.rb

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

data/lib/arstotzka/wrapper.rb

@@ -74,10 +74,12 @@ module Arstotzka
     #
     # @return [Object]
     def wrap_element(value)
-      value = cast(value) if type? && !value.nil?
+      value = cast(value)
       return if value.nil?
 
-      klass ? klass.new(value) : value
+      value = wrap_in_class(value)
+
+      after(value)
     end
 
     # @private
@@ -108,7 +110,31 @@ module Arstotzka
     #
     # @return [Object]
     def cast(value)
+      return if value.nil?
+      return value unless type?
+
       public_send("to_#{type}", value)
     end
+
+    # @private
+    #
+    # Wrap resulting value in class
+    #
+    # @return [Object] instance of +options.klass+
+    def wrap_in_class(value)
+      return value unless klass
+      klass.new(value)
+    end
+
+    # @private
+    #
+    # Process and wrap value trhough a method call
+    #
+    # @return [Object] result of method call
+    def after(value)
+      return value unless options.after_each
+
+      options.instance.send(options.after_each, value)
+    end
   end
 end

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

@@ -5,14 +5,15 @@ require 'spec_helper'
 describe Arstotzka::Fetcher do
   describe 'yard' do
     describe '#fetch' do
-      subject(:fetcher) { described_class.new(instance, **options) }
+      subject(:fetcher) { described_class.new(**options) }
 
       let(:instance) { Account.new(hash) }
       let(:options) do
         {
-          path:  'transactions',
-          klass: Transaction,
-          after: :filter_income
+          path:     'transactions',
+          klass:    Transaction,
+          after:    :filter_income,
+          instance: instance
         }
       end
       let(:hash) do

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

@@ -0,0 +1,175 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe Arstotzka::Options do
+  subject(:instance) { clazz.new(hash) }
+
+  describe 'yard' do
+    describe 'Using options klass and after' do
+      let(:hash) do
+        {
+          customers: [{
+            name: 'John', age: 21
+          }, {
+            name: 'Julia', age: 15
+          }, {
+            name: 'Carol', age: 22
+          }, {
+            name: 'Bobby', age: 12
+          }]
+        }
+      end
+
+      let(:clazz) { Store }
+      let(:expected) do
+        [
+          Customer.new(name: 'John',  age: 21),
+          Customer.new(name: 'Carol', age: 22)
+        ]
+      end
+
+      it 'returns only the adults' do
+        expect(instance.customers).to eq(expected)
+      end
+    end
+
+    describe 'type with klass and after_each' do
+      let(:clazz) { Bar }
+      let(:hash)  { JSON.parse(json) }
+
+      let(:json) do
+        '{"drinks":[{"name":"tequila","price":7.50},{ "name":"vodka","price":5.50}]}'
+      end
+
+      let(:expected) do
+        [
+          Drink.new(name: 'tequila', price: 8.25),
+          Drink.new(name: 'vodka',   price: 6.05)
+        ]
+      end
+
+      before do
+        module Arstotzka::TypeCast
+          def to_symbolized_hash(value)
+            value.symbolize_keys
+          end
+        end
+      end
+
+      it 'returns inflated drinks' do
+        expect(instance.drinks).to eq(expected)
+      end
+    end
+
+    describe 'Using cached, compact, after and full_path' do
+      let(:clazz) { Application }
+
+      let(:hash) do
+        {
+          users: [
+            { firstName: 'Lucy',   email: 'lucy@gmail.com' },
+            { firstName: 'Bobby',  email: 'bobby@hotmail.com' },
+            { email: 'richard@tracy.com' },
+            { firstName: 'Arthur', email: 'arthur@kamelot.uk' }
+          ]
+        }
+      end
+
+      let(:expected) do
+        [
+          Person.new('Lucy'),
+          Person.new('Bobby'),
+          Person.new('Arthur')
+        ]
+      end
+
+      before do
+        # rubocop:disable RSpec/SubjectStub
+        allow(instance).to receive(:warn)
+        # rubocop:enable RSpec/SubjectStub
+      end
+
+      it 'Returns created users' do
+        expect(instance.users).to eq(expected)
+      end
+
+      it 'Triggers warn 3 times' do
+        instance.users
+        instance.users
+        expect(instance).to have_received(:warn).exactly(3).times
+      end
+    end
+
+    describe 'working with snake case hash' do
+      let(:clazz) { JobSeeker }
+
+      let(:hash) do
+        {
+          'applicants' => [
+            {
+              'full_name' => 'Robert Hatz',
+              'email' => 'robert.hatz@gmail.com'
+            }, {
+              'full_name' => 'Marina Wantz',
+              'email' => 'marina.wantz@gmail.com'
+            }, {
+              'email' => 'albert.witz@gmail.com'
+            }
+          ]
+        }
+      end
+
+      let(:expected) do
+        ['Robert Hatz', 'Marina Wantz', 'John Doe']
+      end
+
+      it 'treats keys as snake case keys' do
+        expect(instance.applicants).to eq(expected)
+      end
+    end
+
+    describe 'Deep path with flatten' do
+      let(:clazz) { ShoppingMall }
+
+      let(:hash) do
+        {
+          floors: [{
+            name: 'ground', stores: [{
+              name: 'Starbucks', customers: %w[
+                John Bobby Maria
+              ]
+            }, {
+              name: 'Pizza Hut', customers: %w[
+                Danny LJ
+              ]
+            }]
+          }, {
+            name: 'first', stores: [{
+              name: 'Disney', customers: %w[
+                Robert Richard
+              ]
+            }, {
+              name: 'Comix', customers: %w[
+                Linda Ariel
+              ]
+            }]
+          }]
+        }
+      end
+
+      let(:expected) do
+        %w[
+          John Bobby Maria
+          Danny LJ
+          Robert Richard
+          Linda Ariel
+        ]
+      end
+
+      it 'returns all the customers in one array' do
+        expect(instance.customers).to eq(expected)
+      end
+    end
+  end
+end

data/spec/lib/arstotzka/fetcher_spec.rb

@@ -4,16 +4,17 @@ require 'spec_helper'
 
 describe Arstotzka::Fetcher do
   subject(:fetcher) do
-    described_class.new instance, options
+    described_class.new options
   end
 
+  let(:options)  { Arstotzka::Options.new(options_hash) }
   let(:instance) { Arstotzka::Fetcher::Dummy.new(json) }
   let(:json)     { load_json_fixture_file('arstotzka.json') }
   let(:value)    { fetcher.fetch }
 
   context 'when fetching with no options' do
-    let(:options) { { key: key } }
-    let(:key) { 'id' }
+    let(:options_hash) { { instance: instance, key: key } }
+    let(:key)          { 'id' }
 
     it 'retrieves attribute from base json' do
       expect(value).to eq(json['id'])
@@ -48,7 +49,9 @@ describe Arstotzka::Fetcher do
     let(:value) { [[[1, 2], [3, 4]], [[5, 6], [7, 8]]] }
 
     context 'when flatten option is true' do
-      let(:options) { { flatten: true, key: :value } }
+      let(:options_hash) do
+        { instance: instance, flatten: true, key: :value }
+      end
 
       it 'returns the fetched value flattened' do
         expect(fetcher.fetch).to eq((1..8).to_a)
@@ -64,7 +67,9 @@ describe Arstotzka::Fetcher do
     end
 
     context 'when flatten option is false' do
-      let(:options) { { flatten: false, key: :value } }
+      let(:options_hash) do
+        { instance: instance, flatten: false, key: :value }
+      end
 
       it 'returns the fetched value non flattened' do
         expect(fetcher.fetch).to eq(value)
@@ -75,7 +80,10 @@ describe Arstotzka::Fetcher do
   describe 'after option' do
     let(:instance) { MyParser.new(json) }
     let(:json)     { { value: [100, 250, -25] } }
-    let(:options)  { { after: :sum, key: :value } }
+
+    let(:options_hash) do
+      { instance: instance, after: :sum, key: :value }
+    end
 
     it 'applies after call ' do
       expect(fetcher.fetch).to eq(325)
@@ -83,12 +91,15 @@ describe Arstotzka::Fetcher do
   end
 
   describe 'klass options' do
-    let(:path) { 'name' }
+    let(:path)    { 'name' }
     let(:name)    { 'Robert' }
     let(:json)    { { name: name } }
-    let(:options) { { klass: wrapper, path: path } }
     let(:wrapper) { Person }
 
+    let(:options_hash) do
+      { instance: instance, klass: wrapper, path: path }
+    end
+
     it 'wraps the result in an object' do
       expect(fetcher.fetch).to be_a(wrapper)
     end
@@ -97,4 +108,38 @@ describe Arstotzka::Fetcher do
       expect(fetcher.fetch.name).to eq(name)
     end
   end
+
+  describe 'after_each options' do
+    let(:full_path) { 'people.name' }
+    let(:instance)  { Group.new(json) }
+
+    let(:options_hash) do
+      {
+        instance:   instance,
+        full_path:  full_path,
+        after_each: :create_person,
+        json:       :@hash,
+        compact:    true
+      }
+    end
+
+    let(:json) do
+      {
+        people: [
+          { name: 'Robert', age: 20 },
+          { name: 'John',   age: 25 },
+          { name: 'Leeloo', age: 3570 },
+          { age: 10 }
+        ]
+      }
+    end
+
+    it do
+      expect(fetcher.fetch).to be_a(Array)
+    end
+
+    it 'calls the given method on each value' do
+      expect(fetcher.fetch).to all(be_a(Person))
+    end
+  end
 end

data/spec/support/models/application.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+class Application
+  include Arstotzka
+
+  expose :users, full_path: 'users.first_name',
+                 compact: true, cached: true,
+                 after: :create_person
+
+  def initialize(json)
+    @json = json
+  end
+
+  private
+
+  attr_reader :json
+
+  def create_person(names)
+    names.map do |name|
+      warn "Creating person #{name}"
+      Person.new(name)
+    end
+  end
+end

data/spec/support/models/bar.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+class Bar
+  include Arstotzka
+
+  expose :drinks, type: :symbolized_hash,
+                  klass: Drink, after_each: :add_inflation
+
+  def initialize(json)
+    @json = json
+  end
+
+  private
+
+  attr_reader :json
+
+  def add_inflation(drink)
+    drink.inflate(0.1)
+    drink
+  end
+end

data/spec/support/models/customer.rb

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

data/spec/support/models/drink.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+class Drink
+  attr_reader :name, :price
+
+  def initialize(name:, price:)
+    @name  = name
+    @price = price
+  end
+
+  def inflate(inflation)
+    @price = (price * (1 + inflation)).round(2)
+  end
+
+  def ==(other)
+    return false unless other.class == self.class
+    other.name == name &&
+      other.price == price
+  end
+end

data/spec/support/models/group.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+class Group
+  def initialize(hash)
+    @hash = hash
+  end
+
+  private
+
+  def create_person(name)
+    Person.new(name)
+  end
+end

data/spec/support/models/job_seeker.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+class JobSeeker
+  include Arstotzka
+
+  expose :applicants, case: :snake, default: 'John Doe',
+                      full_path: 'applicants.full_name',
+                      compact: true, json: :@hash
+
+  def initialize(hash)
+    @hash = hash
+  end
+end

data/spec/support/models/shopping_mall.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+class ShoppingMall
+  include Arstotzka
+
+  expose :customers, path: 'floors.stores',
+                     flatten: true, json: :hash
+
+  def initialize(hash)
+    @hash = hash
+  end
+
+  private
+
+  attr_reader :hash
+end

data/spec/support/models/store.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+class Store
+  include Arstotzka
+
+  expose :customers, klass: Customer, after: :filter_adults
+
+  def initialize(json)
+    @json = json
+  end
+
+  private
+
+  attr_reader :json
+
+  def filter_adults(values)
+    values.select(&:adult?)
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: arstotzka
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.2.1
 platform: ruby
 authors:
 - Darthjee
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-03-18 00:00:00.000000000 Z
+date: 2019-03-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -228,6 +228,7 @@ files:
 - spec/integration/yard/arstotzka/fetcher_builder_spec.rb
 - spec/integration/yard/arstotzka/fetcher_spec.rb
 - spec/integration/yard/arstotzka/method_builder_spec.rb
+- spec/integration/yard/arstotzka/options_spec.rb
 - spec/integration/yard/arstotzka/reader_spec.rb
 - spec/integration/yard/arstotzka/type_cast_spec.rb
 - spec/integration/yard/arstotzka/wrapper_spec.rb
@@ -244,22 +245,30 @@ files:
 - spec/support/fixture_helpers.rb
 - spec/support/models.rb
 - spec/support/models/account.rb
+- spec/support/models/application.rb
 - spec/support/models/arstotzka/dummy.rb
 - spec/support/models/arstotzka/fetcher/dummy.rb
 - spec/support/models/arstotzka/type_cast.rb
 - spec/support/models/arstotzka/wrapper/dummy.rb
+- spec/support/models/bar.rb
 - spec/support/models/car.rb
 - spec/support/models/car_collector.rb
 - spec/support/models/collector.rb
 - spec/support/models/collector/game.rb
+- spec/support/models/customer.rb
+- spec/support/models/drink.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/person.rb
 - spec/support/models/request.rb
+- spec/support/models/shopping_mall.rb
 - spec/support/models/star.rb
 - spec/support/models/star_gazer.rb
+- spec/support/models/store.rb
 - spec/support/models/transaction.rb
 - spec/support/models/type_caster.rb
 - spec/support/shared_examples/wrapper.rb
@@ -299,6 +308,7 @@ test_files:
 - spec/integration/yard/arstotzka/fetcher_builder_spec.rb
 - spec/integration/yard/arstotzka/fetcher_spec.rb
 - spec/integration/yard/arstotzka/method_builder_spec.rb
+- spec/integration/yard/arstotzka/options_spec.rb
 - spec/integration/yard/arstotzka/reader_spec.rb
 - spec/integration/yard/arstotzka/type_cast_spec.rb
 - spec/integration/yard/arstotzka/wrapper_spec.rb
@@ -315,22 +325,30 @@ test_files:
 - spec/support/fixture_helpers.rb
 - spec/support/models.rb
 - spec/support/models/account.rb
+- spec/support/models/application.rb
 - spec/support/models/arstotzka/dummy.rb
 - spec/support/models/arstotzka/fetcher/dummy.rb
 - spec/support/models/arstotzka/type_cast.rb
 - spec/support/models/arstotzka/wrapper/dummy.rb
+- spec/support/models/bar.rb
 - spec/support/models/car.rb
 - spec/support/models/car_collector.rb
 - spec/support/models/collector.rb
 - spec/support/models/collector/game.rb
+- spec/support/models/customer.rb
+- spec/support/models/drink.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/person.rb
 - spec/support/models/request.rb
+- spec/support/models/shopping_mall.rb
 - spec/support/models/star.rb
 - spec/support/models/star_gazer.rb
+- spec/support/models/store.rb
 - spec/support/models/transaction.rb
 - spec/support/models/type_caster.rb
 - spec/support/shared_examples/wrapper.rb