mug 1.3.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c6a1368f80be0c11d5fc8614b1e9548dddef502fffd929bd6e01b6bc705737c8
-  data.tar.gz: 9a1bb6550a0ac33d484c2fd52fad34a82035ec6af4df4446ecfa099dd92b78d8
+  metadata.gz: b8aae970fd7b2f0d4ce63d9acd53ada600a0b9d946782d3fd099090cb885088a
+  data.tar.gz: 74abd8b7ca7cb86780d5739ec2c0bbc7fc2b0a12777f73ef5d84a1e1dc42f6b1
 SHA512:
-  metadata.gz: bbf884f4d7b2e3dac6e0a4623d27a831430e9446be804cb99d0cb44fadd6d9de4eb7dc0bcc8f99c930d33b24702ea955d6c1be599f78baacd626f1b9eb829a88
-  data.tar.gz: 06dc7216fac287a0838c9efa7a477a9d83fc9957141c7da4f566ffa2e3a42c3a7b2c50abfe2eeb8e1433afa072caac832f46d963370ce95cb145a71fdc2216a2
+  metadata.gz: b0975b92d3a4e818eb6c0449bffc631d8d7f508884e481a9af9c377cbb0954fad9d4e845bd4e430459672154badc374179e365f786c4f8f8cb36b38f0d1aac88
+  data.tar.gz: 6a14bb22a3018b6ef8ef7e79baf65bcba07485c78e9d7cfc39be3ad6d9cfd59cb3097e0a97e12e5b8c0dc2c979a7c0700a5401fe5737dfedf4809fba49516423

data/lib/mug.rb

@@ -11,6 +11,7 @@ require_relative 'mug/array/to_proc'
 require_relative 'mug/bool'
 require_relative 'mug/bittest'
 require_relative 'mug/clamp'
+require_relative 'mug/diggable'
 require_relative 'mug/enumerable/any-and-all'
 require_relative 'mug/enumerable/chain'
 require_relative 'mug/enumerable/counts'

data/lib/mug/diggable.rb

@@ -0,0 +1,34 @@
+
+#
+# Extend any class or object that implements a #[] method, to
+# also have #dig
+#
+module Diggable
+  #
+  # Extracts the nested value specified by the sequence of +idx+ objects by
+  # calling +dig+ at each step, returning +nil+ if any intermediate step is
+  # +nil+.
+  #
+  def dig *idx
+    inner = self[idx.shift]
+    return inner if idx.empty? or inner.nil?
+    inner.dig *idx
+  end
+end
+
+=begin
+Copyright (c) 2020, Matthew Kerwin <matthew@kerwin.net.au>
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+=end
+

data/test/test-diggable.rb

@@ -0,0 +1,42 @@
+require 'test/unit'
+$VERBOSE = true
+
+require_relative '../lib/mug/diggable'
+class Test_digabble < Test::Unit::TestCase
+
+  class DiggyClass
+    include Diggable
+
+    def initialize *args
+      @array = args
+    end
+
+    def [] idx
+      @array[idx]
+    end
+  end
+
+  def test_diggable_mid
+    z = [99]
+    y = DiggyClass.new 0, z
+    x = [nil, nil, y]
+
+    path = [2, 1, 0]
+    assert_equal( 99, x.dig(*path) )
+  end
+  def test_diggable_end
+    z = [99]
+    y = DiggyClass.new 0, z
+    x = [nil, nil, y]
+
+    path = [2, 1]
+    assert_equal( z, x.dig(*path) )
+  end
+  def test_diggable_nil
+    y = DiggyClass.new 0, nil
+    x = [nil, nil, y]
+
+    path = [2, 1, 0]
+    assert_equal( nil, x.dig(*path) )
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mug
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.4.0
 platform: ruby
 authors:
 - Matthew Kerwin
@@ -38,6 +38,7 @@ files:
 - lib/mug/bool.rb
 - lib/mug/clamp.rb
 - lib/mug/counts.rb
+- lib/mug/diggable.rb
 - lib/mug/enumerable.rb
 - lib/mug/enumerable/any-and-all.rb
 - lib/mug/enumerable/chain.rb
@@ -86,6 +87,7 @@ files:
 - test/test-bool.rb
 - test/test-clamp.rb
 - test/test-counts.rb
+- test/test-diggable.rb
 - test/test-enumerable-chain.rb
 - test/test-enumerable-hash-like.rb
 - test/test-fragile-method-chain.rb
@@ -144,6 +146,7 @@ test_files:
 - test/test-iterator.rb
 - test/test-hashwhen.rb
 - test/test-matchdata_hash.rb
+- test/test-diggable.rb
 - test/test-not.rb
 - test/test-array-extend.rb
 - test/test-iterator-for.rb