lab42_diggy_methods 0.1.6 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3052880cc5f39b51c1ee8264afb99d24ddf2dc6625a8a50131c22a3511a3f6f4
-  data.tar.gz: 466ec786a0722d71c35d7bda70525c0f277c008e4b6d86d23fa1e666ec3953a3
+  metadata.gz: cd7c9c8c8932a3b06dd8d5cbaae76cc8983d90ffef39df1baca0bfed35eb2020
+  data.tar.gz: de17d940d1e5adffd415efc59ff3aba510da695db0f372135db2fa675f625215
 SHA512:
-  metadata.gz: caef67120413bd91d84630ab0414e0c598d2d00908579b4050a6f15b4833baaf5ca81bdec5c11c6f6ecdb4f70a7ce1b97619262e1b26028315130499b0e33534
-  data.tar.gz: e795c99a9d373a9effe7a41554d0c0e796f2c823a94bad7c97d436f5ee5c3c8144fcb011b8c1d22dec1488a4b9299a6f9f3226440f24ae9d0dccf5c2f74cbabd
+  metadata.gz: 9e049dd334f90743481c9e3ce898586171149e4de1f8733654fc63e9ee85555ceb8d09e49f64b656096534e042bc0ca5b8e64851d856c80cd290eeb478a8119c
+  data.tar.gz: 834efe604015307a109e8ac2d0790c5c44187144aae1c5740819952c3c8aa671d1edea0a9e5348b7c1d4324801df4b88956f044e19d0a8afa6afbbe8096d7253

data/README.md

@@ -33,7 +33,7 @@ Well let us [speculate about](https://github.com/RobertDober/speculate_about) it
 
 ### Context: `Diggy` function
 
-An extension to the Kernel as an alias to `Lab42::DiggyMethods.new`
+An extension to the Kernel as an alias for `Lab42::DiggyMethods.new`
 
 Given
 ```ruby
@@ -48,7 +48,7 @@ Then we can access its fields as follows
   expect(diggy.b.d.e).to eq(3)
 ```
 
-And we can use a shortcut for `key.__data__` by using `key!`A
+And we can use a shortcut for `key.__data__` by using `key!`
 ```ruby
     expect(diggy.b.d!).to eq(e: 3)
 ```
@@ -76,7 +76,7 @@ But if we pass an array
     expect{ Diggy([:a]) }.to raise_error(ArgumentError)
 ```
 
-### Context: Using in ERB
+### Context: Using in ERB with `__binding__`
 
 In order to take advantage of this syntax we want to pass the binding of a `Diggy` object to `ERB`
 
@@ -96,6 +96,30 @@ Then we can pass the binding to the template
     expect(ERB.new(template_text).result(data.__binding__)).to eq("YHS")
 ```
 
+#### Context: Merging bindings
+
+In some cases `Diggy` will not be the only useful _binding_ in an `ERB` Template
+we can work around this as follows
+
+Given a diggy and a module
+```ruby
+    let(:diggy) { Diggy(a: 1) }
+    let :mod  do
+      Module.new do
+        def b; 42 end
+      end
+    end
+```
+And we extend the `diggy` with the module
+```ruby
+    before { diggy.extend(mod) }
+```
+
+Then the module's methods become accessible in the binding
+```ruby
+    expect(diggy.__binding__.eval("b")).to eq(42)
+```
+
 ### Context: Iteration
 
 If an element in a diggy object is an array we descend
@@ -105,12 +129,12 @@ Given yet another diggy™
     let(:diggy) { Diggy(a: [b: 1, c: 2]) }
 ```
 
-Then we get an enumerator
+Then we get an array
 ```ruby
     expect(diggy.a).to be_an(Array)
 ```
 
-And we can use it to iterate
+And it contains diggy instances
 ```ruby
     expect(diggy.a.first.b).to eq(1)
 ```

data/lib/lab42/diggy_methods/version.rb

@@ -2,7 +2,7 @@
 
 module Lab42
   class DiggyMethods
-    VERSION = "0.1.6"
+    VERSION = "0.1.7"
   end
 end
 #  SPDX-License-Identifier: Apache-2.0

data/lib/lab42/diggy_methods.rb

@@ -46,27 +46,30 @@ module Lab42
       end
     end
 
-    def _make_diggy_array(found)
-      found.map { self.class.new(_1, __key_chain__: @key_chain) }
+    def _make_diggy_array(found, key)
+      found.map { self.class.new(_1, __key_chain__: _new_key_chain(key)) }
     end
 
-    def _maybe_make_diggy(found)
+    def _maybe_make_diggy(found, key)
       if found.respond_to?(:to_h)
-        self.class.new(**found, __key_chain__: @key_chain)
+        self.class.new(**found, __key_chain__: _new_key_chain(key))
       else
         found
       end
     end
 
     def _method_missing_try_descend(name)
-      @key_chain << name
-      found = @data.fetch(name) { raise KeyError, "key not found: #{@key_chain.join(".")}" }
+      found = @data.fetch(name) { raise KeyError, "key not found: #{_new_key_chain(name).join(".")}" }
       if Array === found
-        _make_diggy_array(found)
+        _make_diggy_array(found, name)
       else
-        _maybe_make_diggy(found)
+        _maybe_make_diggy(found, name)
       end
     end
+
+    def _new_key_chain(key)
+      @key_chain + [key]
+    end
   end
 end
 #  SPDX-License-Identifier: Apache-2.0

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lab42_diggy_methods
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.1.7
 platform: ruby
 authors:
 - Robert Dober
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-02-02 00:00:00.000000000 Z
+date: 2022-02-04 00:00:00.000000000 Z
 dependencies: []
 description: |
   Create an instance of me with a Hash and access the (nested) values