nxt_support 0.1.6 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 683364c398008994e7e9efb8007e03bf7056dd816dec3e396a4482ede9e546d9
-  data.tar.gz: 4e8cee47fa7c145b01ae07b5e8c8ded7da56211ba1272794823e2f8b3a8be5ce
+  metadata.gz: b9cd2e7ab48d6e58c2b05de88fecef08c69df0bf8bc5e9de3b1955b86d900187
+  data.tar.gz: 155c904d6bdcc15d03ebae72b688f06bcf32cf497b3ac4728e447c23fa512727
 SHA512:
-  metadata.gz: de2c12071f41de18b97e49d1516faa54d01b343ab68ff0949004713c8e2345b443cdd60f2f051394e41e966480aca79451b9327d189a60915261814b297620a5
-  data.tar.gz: 8b3a6e21cedd45c22ca925099c02a2e62fe1c7f3f25dae05770e09952c754cf433c0737746f699da42fb6caddb966673daafe20795f1618bcdb5411a1db9ac31
+  metadata.gz: 452a21d24a142cd56a027b5cfb835c37b4ecc16e2966dd27e3c41be364ecef75ff225bf23c06506e6b1a984aff42b27e09082a0be2360d27a92c8abfd036620e
+  data.tar.gz: 9c6afc5fe2aa482f9cb3e76e158f681db66fd6c996d2f3dd831cb620489bbc96ec1a4540d892d1980c71bc59ba5039bfd671217efb7ed230f514855846c65d25

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+# v0.1.7 2020-08-20
+
+- Added `NxtSupport::Crystalizer`
+
 # v0.1.6 2020-06-18
 
 - Added `NxtSupport::PreprocessAttributes`

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    nxt_support (0.1.6)
+    nxt_support (0.1.7)
       nxt_init
       nxt_registry
       rails
@@ -66,13 +66,13 @@ GEM
       zeitwerk (~> 2.2, >= 2.2.2)
     builder (3.2.4)
     coderay (1.1.2)
-    concurrent-ruby (1.1.6)
+    concurrent-ruby (1.1.7)
     crass (1.0.6)
     diff-lcs (1.3)
     erubi (1.9.0)
     globalid (0.4.2)
       activesupport (>= 4.2.0)
-    i18n (1.8.3)
+    i18n (1.8.5)
       concurrent-ruby (~> 1.0)
     loofah (2.6.0)
       crass (~> 1.0.2)
@@ -87,11 +87,11 @@ GEM
     mini_portile2 (2.4.0)
     minitest (5.14.1)
     nio4r (2.5.2)
-    nokogiri (1.10.9)
+    nokogiri (1.10.10)
       mini_portile2 (~> 2.4.0)
     nxt_init (0.1.5)
       activesupport
-    nxt_registry (0.1.5)
+    nxt_registry (0.2.1)
       activesupport
     pry (0.13.1)
       coderay (~> 1.1)
@@ -153,10 +153,10 @@ GEM
     thread_safe (0.3.6)
     tzinfo (1.2.7)
       thread_safe (~> 0.1)
-    websocket-driver (0.7.2)
+    websocket-driver (0.7.3)
       websocket-extensions (>= 0.1.0)
     websocket-extensions (0.1.5)
-    zeitwerk (2.3.0)
+    zeitwerk (2.4.0)
 
 PLATFORMS
   ruby

data/README.md

@@ -247,6 +247,20 @@ TestClass.translate_hash(hash, tuple)
 => { 'first_name' => 'John', 'last_name' => 'Doe', 'maiden_name' => 'Doe' }
 ```
 
+#### NxtSupport::Crystalizer
+
+`NxtSupport::Crystalizer` crystallizes a shared value from an array of elements and screams in case the value is not  
+the same across the collection. This is useful in a scenario where you want to guarantee that certain objects share the same 
+attribute. Let's say you want to ensure that all users in your collection reference the same department, then the idea 
+is that you can crystallize the department from your collection. 
+
+```ruby
+NxtSupport::Crystalizer.new(collection: ['andy', 'andy']).call # => 'andy'
+NxtSupport::Crystalizer.new(collection: []).call # NxtSupport::Crystalizer::Error
+NxtSupport::Crystalizer.new(collection: ['andy', 'scotty']).call # NxtSupport::Crystalizer::Error  
+NxtSupport::Crystalizer.new(collection: insurances, attribute: :effective_at).call # => shared effective_at or error in case of different effective_ats  
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/nxt_support/util.rb

@@ -1,2 +1,3 @@
 require_relative 'util/enum_hash'
 require_relative 'util/hash_translator'
+require_relative 'util/crystalizer'

data/lib/nxt_support/util/crystalizer.rb

@@ -0,0 +1,34 @@
+module NxtSupport
+  class Crystalizer
+    Error = Class.new(StandardError)
+
+    include NxtInit
+
+    attr_init :collection, on_ambiguity: -> { default_ambiguity_handler }, with: :itself
+
+    def call
+      ensure_unanimity
+      unique_values.first
+    end
+
+    private
+
+    def unique_values
+      @unique_values ||= resolved_collection.uniq
+    end
+
+    def resolved_collection
+      @resolved_collection ||= collection.map { |value| with.is_a?(Proc) ? with.call(value) : value.send(with) }
+    end
+
+    def default_ambiguity_handler
+      ->(collection) { raise Error, "Values in collection are not unanimous: #{collection}" }
+    end
+
+    def ensure_unanimity
+      return if unique_values.size == 1
+
+      on_ambiguity.arity == 1 ? on_ambiguity.call(collection) : on_ambiguity.call
+    end
+  end
+end

data/lib/nxt_support/version.rb

@@ -1,3 +1,3 @@
 module NxtSupport
-  VERSION = "0.1.6".freeze
+  VERSION = "0.1.7".freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nxt_support
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.1.7
 platform: ruby
 authors:
 - Nils Sommer
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-07-29 00:00:00.000000000 Z
+date: 2020-08-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -159,6 +159,7 @@ files:
 - lib/nxt_support/serializers.rb
 - lib/nxt_support/serializers/has_time_attributes.rb
 - lib/nxt_support/util.rb
+- lib/nxt_support/util/crystalizer.rb
 - lib/nxt_support/util/enum_hash.rb
 - lib/nxt_support/util/hash_translator.rb
 - lib/nxt_support/version.rb
@@ -186,7 +187,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.8
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: Support through reusable Mixins and Helpers for Ruby on Rails Applications