realize 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d5725ecd097c45ce632cd82af3b5c03cd7f54dec0503c007ee28498a2ebe2f0e
-  data.tar.gz: c6731e9b7f14b3c7109e7a680ba107702dc2c65336e5cea75194f6f61501e796
+  metadata.gz: 0f1004b6b97c8ebd485bac4fb9859ffd28511240f4a9943c73875664be35722c
+  data.tar.gz: 979d68bb86ecc8ba32251c2346a0183158686bf04fb9949f04646e7e16a6a03b
 SHA512:
-  metadata.gz: 1dc9995383fa3a27c3414cd1549871724583c19a1dccbda403b6dc6224927711a4d3309a894ddb9ed0c94587a2d7d37ac870a1fbe9fcc45a017073db39570ce0
-  data.tar.gz: 2cc2a27d5faa2aa2cd188c94051beaa1cf92acc2e499b1cf3762f667a0e4e27c2f9a750cfd687990cbdfcf52d86ee494278b4062af0ab091aa117b1ab7db035f
+  metadata.gz: f2398a44d581a5e8685ef9c29acbb140fbc2488cb7ffc6411317254325154e30b72b3828b96df5aa7e17f299a79c802f4ece1a50486c0ec62d20bdcb9bd5f073
+  data.tar.gz: 9b87926382b38afda00be7ab8055ab26eea572228489f0d0efd341dd0b709d11d1becafa3e925d79baa5c30bccd0fab30130c8792e646891c902fc6cb7a23aa9

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+# 1.1.0 (June 24th, 2020)
+
+Addition of r/collection/at_index, r/collection/first, and r/collection/last
+
 # 1.0.0 (June 9th, 2020)
 
 Initial Release, includes 15 initial transformers.

data/README.md

@@ -62,6 +62,9 @@ Here is a list of each built-in transformer, their options, and what their funct
 
 #### Collection-oriented Transformers
 
+* **r/collection/at_index** [index]:  Takes an array (or coerces value to an array) and returns the value at the given index position.
+* **r/collection/first** []:  Takes an array (or coerces value to an array) and returns the value at the first index position.
+* **r/collection/last** []:  Takes an array (or coerces value to an array) and returns the value at the last index position.
 * **r/collection/sort** [key, direction]:  Takes an array (or coerces value to an array) and sort it either ascending or descending by some defined key's value.
 
 #### Filtering Transformers
@@ -83,12 +86,12 @@ Here is a list of each built-in transformer, their options, and what their funct
 
 #### Value-oriented Transformers
 
-* **r/logical/blank** []: Always return a blank string.
-* **r/logical/map** [values]: Do a lookup on the value using the `values` hash.  If a value is found, then its corresponding value is returned.  If it isn't then the input is returned.
-* **r/logical/null** []: Always returns null.
-* **r/logical/resolve** [key]: Dynamically resolves a value based on the record's key.  It uses the [Objectable](https://github.com/bluemarblepayroll/objectable) library by default, which provides some goodies like dot-notation for nested objects and type-insensitivity (works for Ruby objects, hashes, structs, etc.)
-* **r/logical/static** [value]: Always returns a hard-coded value.
-* **r/logical/verbatim** []: Default transformer, simply echos back the input.
+* **r/value/blank** []: Always return a blank string.
+* **r/value/map** [values]: Do a lookup on the value using the `values` hash.  If a value is found, then its corresponding value is returned.  If it isn't then the input is returned.
+* **r/value/null** []: Always returns null.
+* **r/value/resolve** [key]: Dynamically resolves a value based on the record's key.  It uses the [Objectable](https://github.com/bluemarblepayroll/objectable) library by default, which provides some goodies like dot-notation for nested objects and type-insensitivity (works for Ruby objects, hashes, structs, etc.)
+* **r/value/static** [value]: Always returns a hard-coded value.
+* **r/value/verbatim** []: Default transformer, simply echos back the input.
 
 ### Plugging in Transformers
 

data/lib/realize/collection/at_index.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Realize
+  class Collection
+    # Transformer to get an item of a collection
+    class AtIndex
+      acts_as_hashable
+
+      attr_reader :index
+
+      def initialize(index:)
+        raise ArgumentError, 'index is required' if index.to_s.empty?
+
+        @index = index.to_i
+
+        freeze
+      end
+
+      def transform(_resolver, value, _time, _record)
+        value.is_a?(Array) ? value[index] : value
+      end
+    end
+  end
+end

data/lib/realize/collection/first.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Realize
+  class Collection
+    # Transformer to get the first item of a collection
+    class First
+      acts_as_hashable
+
+      def transform(resolver, value, time, record)
+        AtIndex.new(index: 0).transform(resolver, value, time, record)
+      end
+    end
+  end
+end

data/lib/realize/collection/last.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Realize
+  class Collection
+    # Transformer to get the last item of a collection
+    class Last
+      acts_as_hashable
+
+      def transform(resolver, value, time, record)
+        AtIndex.new(index: -1).transform(resolver, value, time, record)
+      end
+    end
+  end
+end

data/lib/realize/transformers.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require_relative 'collection/at_index'
+require_relative 'collection/first'
+require_relative 'collection/last'
 require_relative 'collection/sort'
 require_relative 'filter/by_key_record_value'
 require_relative 'filter/by_key_value'
@@ -25,6 +28,9 @@ module Realize
     acts_as_hashable_factory
 
     register '',                               Value::Verbatim
+    register 'r/collection/at_index',          Collection::AtIndex
+    register 'r/collection/first',             Collection::First
+    register 'r/collection/last',              Collection::Last
     register 'r/collection/sort',              Collection::Sort
     register 'r/filter/by_key_record_value',   Filter::ByKeyRecordValue
     register 'r/filter/by_key_value',          Filter::ByKeyValue

data/lib/realize/version.rb

@@ -8,5 +8,5 @@
 #
 
 module Realize
-  VERSION = '1.0.0'
+  VERSION = '1.1.0'
 end

data/realize.gemspec

@@ -11,8 +11,8 @@ Gem::Specification.new do |s|
     Derive and transform a value using a configuration-first pipeline.
   DESCRIPTION
 
-  s.authors     = ['Matthew Ruggio']
-  s.email       = ['mruggio@bluemarblepayroll.com']
+  s.authors     = ['Matthew Ruggio', 'Dan Dewar']
+  s.email       = ['mruggio@bluemarblepayroll.com', 'ddewar@bluemarblepayroll.com']
   s.files       = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   s.bindir      = 'exe'
   s.executables = []

metadata

@@ -1,14 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: realize
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Matthew Ruggio
+- Dan Dewar
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-06-09 00:00:00.000000000 Z
+date: 2020-06-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: acts_as_hashable
@@ -145,6 +146,7 @@ dependencies:
 description: "    Derive and transform a value using a configuration-first pipeline.\n"
 email:
 - mruggio@bluemarblepayroll.com
+- ddewar@bluemarblepayroll.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -165,6 +167,9 @@ files:
 - exe/.gitkeep
 - lib/realize.rb
 - lib/realize/arrays.rb
+- lib/realize/collection/at_index.rb
+- lib/realize/collection/first.rb
+- lib/realize/collection/last.rb
 - lib/realize/collection/sort.rb
 - lib/realize/collection/sort/direction.rb
 - lib/realize/filter/by_key_record_value.rb