xkeys 2.1.0 → 2.2.0

data/HISTORY.txt

@@ -1,3 +1,8 @@
+2014-05-07 Version 2.2.0
+
+	Added support for the #xkeys_on_final callback when setting the
+	value in the final (leaf) node.
+
 2014-05-06 Version 2.1.0
 
 	Now works with underlying types that support #[] but not #fetch.

data/lib/xkeys.rb

@@ -20,17 +20,14 @@
 #  root[1, 0, {}] # => 'value 1'
 #  root[1, 4, {}] # => nil
 #
-# As of version 2.0.0, other types with array- or hash-like behavior are
-# supported as well.
-#
-# As of version 2.0.0, underlying types must implement #[], #[]=, and
-# #fetch to be supported (see the Array or Hash class documentation).
-# They must also implement #push if you want to use push mode (index ":[]").
+# As of version 2.0.0, any underlying type implementing #[], #[]= (if
+# setting), #fetch, and #push (if using push mode) is supported. (See the
+# Array documentation.)
 #
 # As of version 2.1.0, #[] is used if #fetch is not supported. Missing-key
 # detection (still) depends on KeyError or IndexError being raised.
 #
-# Version 2.1.0 2014-05-06
+# Version 2.2.0 2014-05-07
 #
 # @author Brian Katzung <briank@kappacs.com>, Kappa Computer Solutions, LLC
 # @copyright 2013-2014 Brian Katzung and Kappa Computer Solutions, LLC
@@ -141,6 +138,11 @@ module XKeys::Set_
     # push mode has not been disabled (see below), a new node will be
     # pushed onto the end of the current node.
     #
+    # If the root of the tree responds to the #xkeys_on_final method, it
+    # will be called as follows before the (final leaf) assignment:
+    #
+    #  xkeys_on_final(leaf_node, key, value, option_hash)
+    #
     # Options:
     #
     #  :[] => false
@@ -153,6 +155,8 @@ module XKeys::Set_
 	push_mode = options[:[]] != false
 
 	if args.count + last == 0
+	    xkeys_on_final self, args[0], args[-1], options if
+	      respond_to? :xkeys_on_final
 	    if args[0] == :[] && push_mode && respond_to?(:push)
 		push args[-1]		# array[:[]] = value
 		true			# done--don't caller-super
@@ -180,6 +184,8 @@ module XKeys::Set_
 	    end
 
 	    # Assign (or push) according to the final key.
+	    xkeys_on_final node, args[0], args[-1], options if
+	      respond_to? :xkeys_on_final
 	    if key == :[] && push_mode && node.respond_to?(:push)
 		node.push args[-1]
 	    else

data/xkeys.gemspec

@@ -1,7 +1,7 @@
 Gem::Specification.new do |s|
   s.name         = "xkeys"
-  s.version      = "2.1.0"
-  s.date         = "2014-05-06"
+  s.version      = "2.2.0"
+  s.date         = "2014-05-07"
   s.authors      = ["Brian Katzung"]
   s.email        = ["briank@kappacs.com"]
   s.homepage     = "http://rubygems.org/gems/xkeys"

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 2
-  - 1
+  - 2
   - 0
-  version: 2.1.0
+  version: 2.2.0
 platform: ruby
 authors: 
 - Brian Katzung
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2014-05-06 00:00:00 -05:00
+date: 2014-05-07 00:00:00 -05:00
 default_executable: 
 dependencies: []