nrser 0.0.28 → 0.0.29

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 85d9f96689536eea53d1334428dc1a1b5ba14d63
-  data.tar.gz: 773bcdf4b40c0eca5b89e12a4e0a08f2da3de1e6
+  metadata.gz: 2273f6424356766a1849b35fc437b13942f15af1
+  data.tar.gz: 901f479555218cc42909235832f2271ca8f61579
 SHA512:
-  metadata.gz: e1bc880e2be168415407889bfe879580c4ac2e3434535c18e82d55a023cf8147f80edcc0beff71cfc148c12a0b5a10368180c2f27990626d55db7a79399d2b71
-  data.tar.gz: 84ab4489ab336f867075a34103a20fabb9f7d626bae7d2aea4139fb1582e6fc2ce322d86fbb7cb2667f76b317e8e3aee3a4ad9984c280f88026fef3cb3af52eb
+  metadata.gz: 87482595ba0e8a8fec1b3e7c3b3c368432a5edbef62a2704d721e61199177446a6d0e28ca4c2f1119db5d7adb8da8666ded661f3c79f20f44dbccee48b756e80
+  data.tar.gz: 412d7fdbe26337164955f5a52e6bc70370f2bd5c1282797e66c91b794fa2b8471e2dc9865e9210b822490799194a90102242466967e233a23630f773ac6cf33b

data/lib/nrser/hash/stringify_keys.rb

@@ -16,7 +16,7 @@ module NRSER
     transform_keys! hash, &:to_s
   end
   
-  singleton_class.send :alias_method, :str_keys!, :stringify_keys!
+  singleton_class.send :alias_method, :to_s_keys!, :stringify_keys!
   
   
   # Returns a new hash with all keys transformed to strings by calling `#to_s`
@@ -32,6 +32,22 @@ module NRSER
     transform_keys hash, &:to_s
   end
   
-  singleton_class.send :alias_method, :str_keys, :stringify_keys
+  singleton_class.send :alias_method, :to_s_keys, :stringify_keys
+  
+  
+  # @todo Document deep_stringify_keys method.
+  # 
+  # @param [type] arg_name
+  #   @todo Add name param description.
+  # 
+  # @return [return_type]
+  #   @todo Document return value.
+  # 
+  def self.deep_stringify_keys object
+    deep_transform_keys object, &:to_s
+  end # .deep_stringify_keys
+  
+  singleton_class.send :alias_method, :to_s_keys_r, :deep_stringify_keys
+  
 
 end # module NRSER

data/lib/nrser/hash/symbolize_keys.rb

@@ -17,7 +17,7 @@ module NRSER
     transform_keys!(hash) { |key| key.to_sym rescue key }
   end # .symbolize_keys!
   
-  singleton_class.send :alias_method, :sym_keys!, :symbolize_keys!
+  singleton_class.send :alias_method, :to_sym_keys!, :symbolize_keys!
   
   
   # Returns a new hash with all keys that respond to `#to_sym` converted to
@@ -36,6 +36,20 @@ module NRSER
     transform_keys(hash) { |key| key.to_sym rescue key }
   end
   
-  singleton_class.send :alias_method, :sym_keys, :symbolize_keys
+  singleton_class.send :alias_method, :to_sym_keys, :symbolize_keys  
+  
+  
+  # @todo Document deep_symbolize_keys method.
+  # 
+  # @param [type] arg_name
+  #   @todo Add name param description.
+  # 
+  # @return [return_type]
+  #   @todo Document return value.
+  # 
+  def self.deep_symbolize_keys object, &block
+    deep_transform_keys( object ) { key.to_sym rescue key }
+  end # .deep_symbolize_keys
+  
 
 end # module NRSER

data/lib/nrser/hash/transform_keys.rb

@@ -39,7 +39,100 @@ module NRSER
     result
   end
   
-  # My-style name
-  singleton_class.send :alias_method, :map_keys, :transform_keys
+  # My-style names
+  singleton_class.send :alias_method, :map_keys,  :transform_keys
+  singleton_class.send :alias_method, :rekey,     :transform_keys
+  
+  
+  # Deeply transform Hash keys that we can find by traversing Hash and Array
+  # instances that we can find from `object` and piping keys through `block`.
+  # 
+  # @example Hash top node
+  #   
+  #   NRSER.deep_transform_keys({
+  #     people: {
+  #       jane: {fav_color: 'red'},
+  #       joe:  {fav_color: 'blue'},
+  #     }
+  #   }) { |key| key.to_s.upcase }
+  #   # => {
+  #   # "PEOPLE" => {
+  #   #   "JANE" => {"FAV_COLOR" => 'red'},
+  #   #   "JOE"  => {"FAV_COLOR" => 'blue'},
+  #   # }
+  # 
+  # @example Array top node
+  #   
+  #   NRSER.deep_transform_keys(
+  #     [{x: 2}, {y: 'blue'}, 3]
+  #   ) { |key| key.to_s.upcase }
+  #   # => [{'X' => 2}, {'Y' => 'blue'}, 3]
+  # 
+  # 
+  # @example Non-array or hash value
+  #   
+  #   NRSER.deep_transform_keys 'blah'
+  #   # => 'blah'
+  # 
+  # From ActiveSupport.
+  # 
+  # @see http://www.rubydoc.info/gems/activesupport/5.1.3/Hash:deep_transform_keys
+  # 
+  # @todo Maybe this is a tree function?
+  # 
+  # @param [Object] object
+  #   Anything; see examples.
+  # 
+  # @param [Proc] &block
+  #   Proc that should accept each key as it's only argument and return the 
+  #   new key to replace it with.
+  # 
+  def self.deep_transform_keys object, &block
+    case object
+    when Hash
+      object.each_with_object( {} ) do |(key, value), result|
+        result[block.call( key )] = deep_transform_keys value, &block
+      end
+    when Array
+      object.map { |entry| deep_transform_keys entry, &block }
+    else
+      object
+    end
+  end
+  
+  singleton_class.send :alias_method, :deep_map_keys, :deep_transform_keys
+  singleton_class.send :alias_method, :map_keys_r,    :deep_transform_keys
+  singleton_class.send :alias_method, :deep_rekey,    :deep_transform_keys
+  singleton_class.send :alias_method, :rekey_r,       :deep_transform_keys
+  
+  
+  # Like {NRSER.deep_transform_keys} but mutates the objects (works in place).
+  # 
+  # @param object (see NRSER.deep_transform_keys)
+  # @param &block (see NRSER.deep_transform_keys)
+  # 
+  # @return [Object]
+  #   The `object` that was passed in, post mutations.
+  # 
+  def self.deep_transform_keys! object, &block
+    case object
+    when Hash
+      object.keys.each do |key|
+        value = object.delete key
+        object[block.call( key )] = deep_transform_keys! value, &block
+      end
+      object
+    when Array
+      object.map! {|e| deep_transform_keys!(e, &block)}
+    else
+      object
+    end
+  end
+  
+  singleton_class.send :alias_method, :deep_map_keys!, :deep_transform_keys!
+  singleton_class.send :alias_method, :map_keys_r!,    :deep_transform_keys!
+  singleton_class.send :alias_method, :deep_rekey!,    :deep_transform_keys!
+  singleton_class.send :alias_method, :rekey_r!,       :deep_transform_keys!
+  
 
 end # module NRSER

data/lib/nrser/refinements/hash.rb

@@ -46,13 +46,37 @@ module NRSER
     end
     
     
+    # See {NRSER.deep_transform_keys!}
+    def deep_transform_keys! &block
+      return enum_for(:deep_transform_keys!) { size } unless block_given?
+      NRSER.deep_transform_keys! self, &block
+    end
+    
+    alias_method :deep_map_keys!, :deep_transform_keys!
+    alias_method :map_keys_r!,    :deep_transform_keys!
+    alias_method :deep_rekey!,    :deep_transform_keys!
+    alias_method :rekey_r!,       :deep_transform_keys!
+    
+    
     # See {NRSER.transform_keys}
     def transform_keys &block
-      return hash.enum_for(:transform_keys) { size } unless block_given?
+      return enum_for(:transform_keys) { size } unless block_given?
       NRSER.transform_keys self, &block
     end
     
     
+    # See {NRSER.deep_transform_keys}
+    def deep_transform_keys &block
+      return enum_for(:deep_transform_keys) { size } unless block_given?
+      NRSER.deep_transform_keys self, &block
+    end
+    
+    alias_method :deep_map_keys, :deep_transform_keys
+    alias_method :map_keys_r,    :deep_transform_keys
+    alias_method :deep_rekey,    :deep_transform_keys
+    alias_method :rekey_r,       :deep_transform_keys
+    
+    
     # See {NRSER.symbolize_keys!}
     def symbolize_keys!
       NRSER.symbolize_keys! self

data/lib/nrser/rspex.rb

@@ -269,7 +269,7 @@ module NRSER::RSpex
       
       describe description, **metadata, type: type do
         subject( &subject_block ) if subject_block
-        instance_exec &body
+        module_exec &body
       end # description, 
       
     end # #describe_x
@@ -336,7 +336,7 @@ module NRSER::RSpex
       
       describe description, type: :message do
         subject { NRSER::Message.new symbol, *args }
-        instance_exec &body
+        module_exec &body
       end
     end
     
@@ -364,7 +364,7 @@ module NRSER::RSpex
       
       describe "sent to #{ receiver } (#{ mode })" do
         subject { super().send_to unwrap( receiver, context: self ) }
-        instance_exec &block
+        module_exec &block
       end
     end # #describe_sent_to
     
@@ -382,7 +382,7 @@ module NRSER::RSpex
       
       describe "return value from #{ msg }" do
         subject { msg.send_to super() }
-        instance_exec &body
+        module_exec &body
       end # "return value from #{ msg }"
     end
     
@@ -413,7 +413,7 @@ module NRSER::RSpex
         type: :section,
         **metadata
       ) do
-        instance_exec &block
+        module_exec &block
       end
     end # #describe_section
     
@@ -430,7 +430,7 @@ module NRSER::RSpex
         file: path,
         **metadata
       ) do
-        instance_exec &body
+        module_exec &body
       end
     end
     
@@ -441,7 +441,7 @@ module NRSER::RSpex
         type: :module,
         **metadata
       ) do
-        instance_exec &block
+        module_exec &block
       end
     end # #describe_module
     
@@ -459,7 +459,7 @@ module NRSER::RSpex
           subject { klass }
         end
         
-        instance_exec &block
+        module_exec &block
       end
     end # #describe_class
     
@@ -475,7 +475,7 @@ module NRSER::RSpex
         type: :group,
         **metadata
       ) do
-        instance_exec &block
+        module_exec &block
       end
     end # #describe_class
     
@@ -491,7 +491,7 @@ module NRSER::RSpex
           subject { super().method name }
         end
         
-        instance_exec &block
+        module_exec &block
       end
     end # #describe_method
     
@@ -503,7 +503,7 @@ module NRSER::RSpex
         **metadata
       ) do
         subject { super().public_send symbol }
-        instance_exec &block
+        module_exec &block
       end
     end # #describe_attribute
     
@@ -536,7 +536,7 @@ module NRSER::RSpex
           let( name ) { unwrap value, context: self }
         }
         
-        instance_exec &body
+        module_exec &body
       end
     end
     

data/lib/nrser/version.rb

@@ -1,5 +1,5 @@
 module NRSER
-  VERSION = "0.0.28"
+  VERSION = "0.0.29"
   
   module Version
     

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nrser
 version: !ruby/object:Gem::Version
-  version: 0.0.28
+  version: 0.0.29
 platform: ruby
 authors:
 - nrser
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-12-06 00:00:00.000000000 Z
+date: 2017-12-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -295,7 +295,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.11
+rubygems_version: 2.5.2
 signing_key: 
 specification_version: 4
 summary: basic ruby utils i use in a lot of stuff.