materialist 3.5.0 → 3.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ad5a7f5ef0961f9e8cf3317baaf07cbb53d8e021
-  data.tar.gz: 394077c4817dd29106c78f02124f6c145ab6dafd
+  metadata.gz: dc140c911742867585c275c7b87a08cce340b165
+  data.tar.gz: dd08e90c55127a4b8375f859613ec73cda95970d
 SHA512:
-  metadata.gz: 1fc7dd6e7563ec9205631a5f8520c6928b8ca10c269c3c8f74cb2093080e500878b8a5220ae5fabab1a985090d8f66ffcd55dac2fdaed4253a6de679601ade13
-  data.tar.gz: 4d293933436137b9daf41d3de5117eeb707653d0ce73f7865356d5fe1bfad6b8354a4073ae1ecfeec3adae7ad1c4b7ad38a2713f6668ca7a7b9d77e956e1fcfa
+  metadata.gz: 4bcb195f30deff05ab9c83de55475473f8efee6a599cb694f47fdb55438b5374988a6f12872d5078af57c76c978d45208f0829a962b1d41d79f9ef1c824740eb
+  data.tar.gz: 0d15e15c152b85765a3dca6c96dbe28787e780a15b68c505cf4dfd6d0c4e1b732c17c64275794733a096790999e3a0d59be32ba9e48a8c7d374c5fd1b4c6e33b

data/README.md

@@ -25,6 +25,20 @@ Then do
 bundle
 ```
 
+### Release
+
+After merging all of your PRs:
+
+1. Bump the version in `lib/materialist/version.rb` -- let's say `x.y.z`
+1. Build the gem: `gem build materialist.gemspec`
+1. Push the gem: `gem push materialist-x.y.z.gem`
+1. Commit changes: `git commit -am "Bump version"`
+1. Create a tag: `git tag -a vx.y.z`
+1. Push changes: `git push origin master`
+1. Push the new: `git push origin --tags`
+
+## Usage
+
 ### Entity
 
 Your materialised entity need to have a **unique** `source_url` column, alongside any other field you wish to materialise.
@@ -183,6 +197,12 @@ Passing an optional block allows you to extract an identifier from the URL.
 #### `capture <key>, as: <column> (default: key)`
 describes mapping a resource key to a database column.
 
+You can optionally provide a block for parsing the value:
+
+```ruby
+capture(:location, as: :latitude) { |location| location[:latitude] }
+```
+
 #### `capture_link_href <key>, as: <column>`
 describes mapping a link href (as it appears on the hateous response) to a database column.
 

data/RELEASE_NOTES.md

@@ -1,6 +1,10 @@
 ## Next
 
-_description of next release_
+_list pending release notes here..._
+
+## 3.6.0
+
+- Add support for parsing value when using `capture`
 
 ## 3.5.0
 

data/lib/materialist/materializer/internals/dsl.rb

@@ -6,8 +6,12 @@ module Materialist
           __materialist_options[:links_to_materialize][key] = { topic: topic }
         end
 
-        def capture(key, as: key)
-          __materialist_dsl_mapping_stack.last << FieldMapping.new(key: key, as: as)
+        def capture(key, as: key, &value_parser_block)
+          __materialist_dsl_mapping_stack.last << FieldMapping.new(
+            key: key,
+            as: as,
+            value_parser: value_parser_block
+          )
         end
 
         def capture_link_href(key, as:, &url_parser_block)

data/lib/materialist/materializer/internals/field_mapping.rb

@@ -2,13 +2,14 @@ module Materialist
   module Materializer
     module Internals
       class FieldMapping
-        def initialize(key:, as: key)
+        def initialize(key:, as: key, value_parser: nil)
           @key = key
           @as = as
+          @value_parser = value_parser || ->value { value }
         end
 
         def map(resource)
-          { @as => resource.dig(@key) }
+          { @as => @value_parser.call(resource.dig(@key)) }
         end
       end
     end

data/lib/materialist/version.rb

@@ -1,3 +1,3 @@
 module Materialist
-  VERSION = '3.5.0'
+  VERSION = '3.6.0'
 end

data/spec/materialist/materializer/internals/field_mapping_spec.rb

@@ -0,0 +1,36 @@
+require 'spec_helper'
+require 'materialist/materializer/internals'
+
+include Materialist::Materializer::Internals
+
+RSpec.describe Materialist::Materializer::Internals::FieldMapping, type: :internals do
+  let(:instance) { described_class.new(key: key, as: as, value_parser: value_parser_block) }
+
+  describe '#map' do
+    let(:key) { :b }
+    let(:as) { :z }
+    let(:value_parser_block) { nil }
+    let(:resource) do
+      {
+        a: 1,
+        b: {
+          c: 2
+        }
+      }
+    end
+    let(:map) { instance.map(resource) }
+
+    context 'when no parse block is passed' do
+      let(:expected_result) { { z: { c: 2 } } }
+
+      it { expect(map).to eq(expected_result) }
+    end
+
+    context 'when a value parse block is passed' do
+      let(:value_parser_block) { ->value { value[:c] } }
+      let(:expected_result) { { z: 2 } }
+
+      it { expect(map).to eq(expected_result) }
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: materialist
 version: !ruby/object:Gem::Version
-  version: 3.5.0
+  version: 3.6.0
 platform: ruby
 authors:
 - Mo Valipour
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-10-18 00:00:00.000000000 Z
+date: 2019-06-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sidekiq
@@ -219,6 +219,7 @@ files:
 - materialist.gemspec
 - spec/materialist/event_handler_spec.rb
 - spec/materialist/materialized_record_spec.rb
+- spec/materialist/materializer/internals/field_mapping_spec.rb
 - spec/materialist/materializer/internals/link_mapping_spec.rb
 - spec/materialist/materializer_factory_spec.rb
 - spec/materialist/materializer_spec.rb
@@ -254,6 +255,7 @@ summary: Utilities to materialize routemaster topics
 test_files:
 - spec/materialist/event_handler_spec.rb
 - spec/materialist/materialized_record_spec.rb
+- spec/materialist/materializer/internals/field_mapping_spec.rb
 - spec/materialist/materializer/internals/link_mapping_spec.rb
 - spec/materialist/materializer_factory_spec.rb
 - spec/materialist/materializer_spec.rb