nrser 0.2.2 → 0.3.0

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nrser
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.3.0
 platform: ruby
 authors:
 - nrser
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-03-22 00:00:00.000000000 Z
+date: 2018-05-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: hamster
@@ -80,6 +80,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.17.7
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.1'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -218,46 +232,50 @@ files:
 - lib/nrser/char/alpha_numeric_sub.rb
 - lib/nrser/char/special.rb
 - lib/nrser/collection.rb
-- lib/nrser/env.rb
-- lib/nrser/env/path.rb
+- lib/nrser/core_ext.rb
+- lib/nrser/core_ext/array.rb
+- lib/nrser/core_ext/binding.rb
+- lib/nrser/core_ext/enumerable.rb
+- lib/nrser/core_ext/enumerable/find_map.rb
+- lib/nrser/core_ext/exception.rb
+- lib/nrser/core_ext/hash.rb
+- lib/nrser/core_ext/hash/extract_values_at.rb
+- lib/nrser/core_ext/hash/transform_values_with_keys.rb
+- lib/nrser/core_ext/module.rb
+- lib/nrser/core_ext/module/method_objects.rb
+- lib/nrser/core_ext/module/names.rb
+- lib/nrser/core_ext/module/source_locations.rb
+- lib/nrser/core_ext/object.rb
+- lib/nrser/core_ext/object/lazy_var.rb
+- lib/nrser/core_ext/open_struct.rb
+- lib/nrser/core_ext/pathname.rb
+- lib/nrser/core_ext/string.rb
+- lib/nrser/core_ext/symbol.rb
+- lib/nrser/core_ext/time.rb
 - lib/nrser/errors.rb
+- lib/nrser/errors/abstract_method_error.rb
+- lib/nrser/errors/argument_error.rb
 - lib/nrser/errors/attr_error.rb
 - lib/nrser/errors/count_error.rb
 - lib/nrser/errors/nicer_error.rb
+- lib/nrser/errors/type_error.rb
 - lib/nrser/errors/value_error.rb
-- lib/nrser/ext.rb
-- lib/nrser/ext/binding.rb
-- lib/nrser/ext/enumerable.rb
-- lib/nrser/ext/module.rb
-- lib/nrser/ext/pathname.rb
-- lib/nrser/ext/string.rb
 - lib/nrser/ext/tree.rb
 - lib/nrser/functions.rb
 - lib/nrser/functions/array.rb
-- lib/nrser/functions/binding.rb
 - lib/nrser/functions/enumerable.rb
 - lib/nrser/functions/enumerable/associate.rb
 - lib/nrser/functions/enumerable/find_all_map.rb
-- lib/nrser/functions/enumerable/find_map.rb
 - lib/nrser/functions/enumerable/include_slice.rb
 - lib/nrser/functions/enumerable/include_slice/array_include_slice.rb
-- lib/nrser/functions/enumerable/map_keys.rb
-- lib/nrser/functions/enumerable/map_values.rb
 - lib/nrser/functions/exception.rb
 - lib/nrser/functions/git.rb
 - lib/nrser/functions/hash.rb
 - lib/nrser/functions/hash/bury.rb
-- lib/nrser/functions/hash/deep_merge.rb
-- lib/nrser/functions/hash/except_keys.rb
 - lib/nrser/functions/hash/guess_label_key_type.rb
-- lib/nrser/functions/hash/slice_keys.rb
-- lib/nrser/functions/hash/stringify_keys.rb
-- lib/nrser/functions/hash/symbolize_keys.rb
-- lib/nrser/functions/hash/transform_keys.rb
 - lib/nrser/functions/merge_by.rb
 - lib/nrser/functions/module.rb
-- lib/nrser/functions/module/methods.rb
-- lib/nrser/functions/module/source_locations.rb
+- lib/nrser/functions/module/method_objects.rb
 - lib/nrser/functions/object.rb
 - lib/nrser/functions/object/as_array.rb
 - lib/nrser/functions/object/as_hash.rb
@@ -280,60 +298,82 @@ files:
 - lib/nrser/functions/tree/map_leaves.rb
 - lib/nrser/functions/tree/map_tree.rb
 - lib/nrser/functions/tree/transform.rb
+- lib/nrser/graph/tsorter.rb
 - lib/nrser/labs.rb
+- lib/nrser/labs/core_ext/binding.rb
 - lib/nrser/labs/globlin.rb
 - lib/nrser/labs/index.rb
-- lib/nrser/logging.rb
-- lib/nrser/logging/appender.rb
-- lib/nrser/logging/appender/sync.rb
-- lib/nrser/logging/formatters.rb
-- lib/nrser/logging/formatters/color.rb
+- lib/nrser/labs/stash.rb
+- lib/nrser/log.rb
+- lib/nrser/log/appender.rb
+- lib/nrser/log/appender/sync.rb
+- lib/nrser/log/formatters.rb
+- lib/nrser/log/formatters/color.rb
+- lib/nrser/log/formatters/mixin.rb
+- lib/nrser/log/logger.rb
+- lib/nrser/log/mixin.rb
 - lib/nrser/mean_streak.rb
 - lib/nrser/mean_streak/document.rb
 - lib/nrser/message.rb
 - lib/nrser/meta.rb
 - lib/nrser/meta/class_attrs.rb
-- lib/nrser/meta/props.rb
-- lib/nrser/meta/props/base.rb
-- lib/nrser/meta/props/prop.rb
+- lib/nrser/meta/source/location.rb
 - lib/nrser/no_arg.rb
+- lib/nrser/props.rb
+- lib/nrser/props/class_methods.rb
+- lib/nrser/props/immutable/hash.rb
+- lib/nrser/props/immutable/hash_variable.rb
+- lib/nrser/props/immutable/instance_variables.rb
+- lib/nrser/props/immutable/vector.rb
+- lib/nrser/props/instance_methods.rb
+- lib/nrser/props/metadata.rb
+- lib/nrser/props/mutable/instance_variables.rb
+- lib/nrser/props/mutable/stash.rb
+- lib/nrser/props/prop.rb
+- lib/nrser/props/storage/instance_variable.rb
+- lib/nrser/props/storage/instance_variables.rb
+- lib/nrser/props/storage/key.rb
 - lib/nrser/refinements.rb
-- lib/nrser/refinements/array.rb
-- lib/nrser/refinements/binding.rb
-- lib/nrser/refinements/enumerator.rb
-- lib/nrser/refinements/exception.rb
-- lib/nrser/refinements/hash.rb
-- lib/nrser/refinements/module.rb
-- lib/nrser/refinements/object.rb
-- lib/nrser/refinements/open_struct.rb
-- lib/nrser/refinements/pathname.rb
-- lib/nrser/refinements/set.rb
-- lib/nrser/refinements/string.rb
-- lib/nrser/refinements/symbol.rb
+- lib/nrser/refinements/sugar.rb
 - lib/nrser/refinements/types.rb
 - lib/nrser/rspex.rb
-- lib/nrser/rspex/described.rb
 - lib/nrser/rspex/example.rb
 - lib/nrser/rspex/example_group.rb
+- lib/nrser/rspex/example_group/describe_attribute.rb
 - lib/nrser/rspex/example_group/describe_called_with.rb
+- lib/nrser/rspex/example_group/describe_case.rb
 - lib/nrser/rspex/example_group/describe_class.rb
+- lib/nrser/rspex/example_group/describe_group.rb
 - lib/nrser/rspex/example_group/describe_instance.rb
 - lib/nrser/rspex/example_group/describe_instance_method.rb
+- lib/nrser/rspex/example_group/describe_message.rb
 - lib/nrser/rspex/example_group/describe_method.rb
+- lib/nrser/rspex/example_group/describe_module.rb
+- lib/nrser/rspex/example_group/describe_response_to.rb
+- lib/nrser/rspex/example_group/describe_section.rb
+- lib/nrser/rspex/example_group/describe_sent_to.rb
 - lib/nrser/rspex/example_group/describe_setup.rb
+- lib/nrser/rspex/example_group/describe_source_file.rb
 - lib/nrser/rspex/example_group/describe_spec_file.rb
-- lib/nrser/rspex/example_group/describe_use_case.rb
 - lib/nrser/rspex/example_group/describe_when.rb
 - lib/nrser/rspex/example_group/describe_x.rb
+- lib/nrser/rspex/example_group/overrides.rb
 - lib/nrser/rspex/format.rb
 - lib/nrser/rspex/shared_examples.rb
+- lib/nrser/sugar/method_missing_forwarder.rb
+- lib/nrser/sys.rb
+- lib/nrser/sys/env.rb
+- lib/nrser/sys/env/path.rb
 - lib/nrser/types.rb
 - lib/nrser/types/any.rb
-- lib/nrser/types/array.rb
+- lib/nrser/types/arrays.rb
 - lib/nrser/types/attrs.rb
 - lib/nrser/types/booleans.rb
 - lib/nrser/types/bounded.rb
 - lib/nrser/types/combinators.rb
+- lib/nrser/types/errors/check_error.rb
+- lib/nrser/types/errors/from_string_error.rb
+- lib/nrser/types/factory.rb
 - lib/nrser/types/hashes.rb
 - lib/nrser/types/in.rb
 - lib/nrser/types/is.rb
@@ -355,29 +395,25 @@ files:
 - lib/nrser/types/when.rb
 - lib/nrser/types/where.rb
 - lib/nrser/version.rb
-- spec/design/mapping_spec.rb
 - spec/lib/nrser/collection/each_spec.rb
 - spec/lib/nrser/collection/map_spec.rb
-- spec/lib/nrser/env/path/insert_spec.rb
-- spec/lib/nrser/env/path_spec.rb
+- spec/lib/nrser/core_ext/binding/erb_spec.rb
+- spec/lib/nrser/core_ext/enumerable/find_map_spec.rb
+- spec/lib/nrser/core_ext/hash_spec.rb
 - spec/lib/nrser/errors/abstract_method_error_spec.rb
-- spec/lib/nrser/functions/binding/template_spec.rb
+- spec/lib/nrser/functions/enumerable/associate_spec.rb
 - spec/lib/nrser/functions/enumerable/find_all_map_spec.rb
 - spec/lib/nrser/functions/enumerable/find_bounded_spec.rb
-- spec/lib/nrser/functions/enumerable/find_map_spec.rb
 - spec/lib/nrser/functions/enumerable/find_only_spec.rb
 - spec/lib/nrser/functions/enumerable/include_slice_spec.rb
-- spec/lib/nrser/functions/enumerable/to_h_by_spec.rb
 - spec/lib/nrser/functions/exception/format_exception_spec.rb
 - spec/lib/nrser/functions/hash/bury_spec.rb
 - spec/lib/nrser/functions/hash/guess_label_key_type_spec.rb
-- spec/lib/nrser/functions/hash_spec.rb
 - spec/lib/nrser/functions/merge_by_spec.rb
 - spec/lib/nrser/functions/object/truthy_spec.rb
 - spec/lib/nrser/functions/open_struct_spec.rb
 - spec/lib/nrser/functions/string/common_prefix_spec.rb
 - spec/lib/nrser/functions/string/looks_like_spec.rb
-- spec/lib/nrser/functions/string/truncate_spec.rb
 - spec/lib/nrser/functions/text/dedent/gotchas_spec.rb
 - spec/lib/nrser/functions/text/dedent_spec.rb
 - spec/lib/nrser/functions/text/indent_spec.rb
@@ -388,23 +424,27 @@ files:
 - spec/lib/nrser/functions/tree/map_tree_spec.rb
 - spec/lib/nrser/functions/tree/transform_spec.rb
 - spec/lib/nrser/functions/tree/transformer_spec.rb
+- spec/lib/nrser/gem_ext/hamster/json_spec.rb
 - spec/lib/nrser/labs/globlin_spec.rb
 - spec/lib/nrser/labs/index_spec.rb
 - spec/lib/nrser/mean_streak/design_spec.rb
 - spec/lib/nrser/mean_streak/identity_instance_spec.rb
 - spec/lib/nrser/meta/class_attrs_spec.rb
-- spec/lib/nrser/meta/props/to_and_from_data_spec.rb
-- spec/lib/nrser/meta/props_spec.rb
+- spec/lib/nrser/meta/source/location_spec.rb
 - spec/lib/nrser/op/message_spec.rb
+- spec/lib/nrser/props/immutable/hash_spec.rb
+- spec/lib/nrser/props/immutable/vector_spec.rb
+- spec/lib/nrser/props/original_props_spec.rb
+- spec/lib/nrser/props/to_and_from_data_spec.rb
 - spec/lib/nrser/refinements/array_spec.rb
 - spec/lib/nrser/refinements/erb_spec.rb
 - spec/lib/nrser/refinements/format_exception_spec.rb
-- spec/lib/nrser/refinements/hash_spec.rb
 - spec/lib/nrser/refinements/indent_spec.rb
 - spec/lib/nrser/refinements/object_spec.rb
 - spec/lib/nrser/refinements/pathname_spec.rb
 - spec/lib/nrser/refinements/set_spec.rb
-- spec/lib/nrser/refinements/truncate_spec.rb
+- spec/lib/nrser/sys/env/path/insert_spec.rb
+- spec/lib/nrser/sys/env/path_spec.rb
 - spec/lib/nrser/types/array_spec.rb
 - spec/lib/nrser/types/attrs_spec.rb
 - spec/lib/nrser/types/combinators_spec.rb
@@ -444,29 +484,25 @@ signing_key:
 specification_version: 4
 summary: basic ruby utils i use in a lot of stuff.
 test_files:
-- spec/design/mapping_spec.rb
 - spec/lib/nrser/collection/each_spec.rb
 - spec/lib/nrser/collection/map_spec.rb
-- spec/lib/nrser/env/path/insert_spec.rb
-- spec/lib/nrser/env/path_spec.rb
+- spec/lib/nrser/core_ext/binding/erb_spec.rb
+- spec/lib/nrser/core_ext/enumerable/find_map_spec.rb
+- spec/lib/nrser/core_ext/hash_spec.rb
 - spec/lib/nrser/errors/abstract_method_error_spec.rb
-- spec/lib/nrser/functions/binding/template_spec.rb
+- spec/lib/nrser/functions/enumerable/associate_spec.rb
 - spec/lib/nrser/functions/enumerable/find_all_map_spec.rb
 - spec/lib/nrser/functions/enumerable/find_bounded_spec.rb
-- spec/lib/nrser/functions/enumerable/find_map_spec.rb
 - spec/lib/nrser/functions/enumerable/find_only_spec.rb
 - spec/lib/nrser/functions/enumerable/include_slice_spec.rb
-- spec/lib/nrser/functions/enumerable/to_h_by_spec.rb
 - spec/lib/nrser/functions/exception/format_exception_spec.rb
 - spec/lib/nrser/functions/hash/bury_spec.rb
 - spec/lib/nrser/functions/hash/guess_label_key_type_spec.rb
-- spec/lib/nrser/functions/hash_spec.rb
 - spec/lib/nrser/functions/merge_by_spec.rb
 - spec/lib/nrser/functions/object/truthy_spec.rb
 - spec/lib/nrser/functions/open_struct_spec.rb
 - spec/lib/nrser/functions/string/common_prefix_spec.rb
 - spec/lib/nrser/functions/string/looks_like_spec.rb
-- spec/lib/nrser/functions/string/truncate_spec.rb
 - spec/lib/nrser/functions/text/dedent/gotchas_spec.rb
 - spec/lib/nrser/functions/text/dedent_spec.rb
 - spec/lib/nrser/functions/text/indent_spec.rb
@@ -477,23 +513,27 @@ test_files:
 - spec/lib/nrser/functions/tree/map_tree_spec.rb
 - spec/lib/nrser/functions/tree/transform_spec.rb
 - spec/lib/nrser/functions/tree/transformer_spec.rb
+- spec/lib/nrser/gem_ext/hamster/json_spec.rb
 - spec/lib/nrser/labs/globlin_spec.rb
 - spec/lib/nrser/labs/index_spec.rb
 - spec/lib/nrser/mean_streak/design_spec.rb
 - spec/lib/nrser/mean_streak/identity_instance_spec.rb
 - spec/lib/nrser/meta/class_attrs_spec.rb
-- spec/lib/nrser/meta/props/to_and_from_data_spec.rb
-- spec/lib/nrser/meta/props_spec.rb
+- spec/lib/nrser/meta/source/location_spec.rb
 - spec/lib/nrser/op/message_spec.rb
+- spec/lib/nrser/props/immutable/hash_spec.rb
+- spec/lib/nrser/props/immutable/vector_spec.rb
+- spec/lib/nrser/props/original_props_spec.rb
+- spec/lib/nrser/props/to_and_from_data_spec.rb
 - spec/lib/nrser/refinements/array_spec.rb
 - spec/lib/nrser/refinements/erb_spec.rb
 - spec/lib/nrser/refinements/format_exception_spec.rb
-- spec/lib/nrser/refinements/hash_spec.rb
 - spec/lib/nrser/refinements/indent_spec.rb
 - spec/lib/nrser/refinements/object_spec.rb
 - spec/lib/nrser/refinements/pathname_spec.rb
 - spec/lib/nrser/refinements/set_spec.rb
-- spec/lib/nrser/refinements/truncate_spec.rb
+- spec/lib/nrser/sys/env/path/insert_spec.rb
+- spec/lib/nrser/sys/env/path_spec.rb
 - spec/lib/nrser/types/array_spec.rb
 - spec/lib/nrser/types/attrs_spec.rb
 - spec/lib/nrser/types/combinators_spec.rb

data/lib/nrser/ext/binding.rb

@@ -1,36 +0,0 @@
-# Extension methods for {Binding}
-# 
-module NRSER::Ext::Binding
-  
-  # Calls {NRSER.template} with `self` prepended to `*args`
-  # 
-  # @param (see NRSER.erb)
-  # @return (see NRSER.erb)
-  # 
-  def template *args
-    NRSER.template self, *args
-  end
-  
-  alias_method :erb, :template
-  
-  
-  # Calls {NRSER.locals} with `self` prepended to `*args`
-  # 
-  # @param (see NRSER.locals)
-  # @return (see NRSER.locals)
-  # 
-  def locals *args
-    NRSER.locals self, *args
-  end
-  
-  
-  # Calls {NRSER.local_values} with `self` prepended to `*args`
-  # 
-  # @param (see NRSER.local_values)
-  # @return (see NRSER.local_values)
-  # 
-  def local_values *args
-    NRSER.local_values self, *args
-  end
-  
-end # module NRSER::Ext::Binding

data/lib/nrser/ext/module.rb

@@ -1,62 +0,0 @@
-# Extension methods for {Module}
-# 
-# @note
-#   These **must not** conflict with function names, which are of course
-#   also module methods on the {NRSER} module, because they will override
-#   them and prevent access to the functions.
-#   
-#   Hence the target functions have been prefixed with `f_`.
-# 
-module NRSER::Ext::Module
-
-  # @!group Module Methods
-  # ==========================================================================
-  
-  # Calls {NRSER.class_method_objects_for} with `self` as first arg.
-  def class_method_objects *args
-    NRSER.class_method_objects_for self, *args
-  end
-  
-  alias_method :class_Methods, :class_method_objects
-  
-  
-  # Calls {NRSER.own_class_method_objects_for} with `self` as first arg.
-  def own_class_method_objects *args
-    NRSER.own_class_method_objects_for self, *args
-  end
-  
-  alias_method :own_class_Methods, :own_class_method_objects
-  
-  
-  # Calls {NRSER.instance_method_objects_for} with `self` as first arg.
-  def instance_method_objects *args
-    NRSER.instance_method_objects_for self, *args
-  end
-  
-  alias_method :instance_Methods, :instance_method_objects
-  
-  
-  # Calls {NRSER.own_instance_method_objects_for} with `self` as first arg.
-  def own_instance_method_objects *args
-    NRSER.own_instance_method_objects_for self, *args
-  end
-  
-  alias_method :own_instance_Methods, :own_instance_method_objects
-  
-  
-  # Calls {NRSER.class_method_source_locations_for} with `self` as the
-  # first arg.
-  def class_method_source_locations *args
-    NRSER.class_method_source_locations_for self, *args
-  end
-  
-  
-  # Calls {NRSER.class_method_source_locations_for} with `self` as the
-  # first arg.
-  def own_class_method_source_locations *args
-    NRSER.own_class_method_source_locations_for self, *args
-  end
-  
-  # @!endgroup Module Methods
-  
-end # module NRSER::Ext::String

data/lib/nrser/ext.rb

@@ -1,8 +0,0 @@
-module NRSER::Ext; end
-
-require_relative './ext/enumerable'
-require_relative './ext/tree'
-require_relative './ext/pathname'
-require_relative './ext/string'
-require_relative './ext/binding'
-require_relative './ext/module'

data/lib/nrser/functions/binding.rb

@@ -1,76 +0,0 @@
-module NRSER
-  def self.erb bnd, str
-    require 'erb'
-    
-    filter_repeated_blank_lines(
-      with_indent_tagged( dedent( str ) ) { |tagged_str|
-        ERB.new( tagged_str ).result( bnd )
-      },
-      remove_leading: true
-    )
-  end # erb
-  
-  singleton_class.send :alias_method, :template, :erb
-  
-  
-  # Get a {Hash} of all local variable names (as {Symbol}) to values.
-  # 
-  # @param [Binding] bnd
-  #   Binding to get locals from.
-  # 
-  # @return [Hash<Symbol, Object>]
-  # 
-  def self.locals bnd
-    NRSER.map_values( bnd.local_variables ) { |symbol, _|
-      bnd.local_variable_get symbol
-    }
-  end # .locals
-  
-  
-  # Get a {Array} of all local variable values.
-  # 
-  # Written to facilitate checks like "all argument values are not `nil`".
-  # 
-  # @param [Binding] bnd
-  #   Binding to get locals from.
-  # 
-  # @return [Array<Object>]
-  # 
-  def self.local_values bnd
-    bnd.local_variables.map { |symbol| bnd.local_variable_get symbol }
-  end # .locals
-  
-  
-  def self.call_block bnd, *args, &block
-    arg_count = 0
-    arg_rest = false
-    call_kwds = {}
-    block.parameters.each do |type, name|
-      logger.debug "Processing", type: type, name: name
-      
-      case type
-      when :req, :opt
-        arg_count += 1
-      when :keyreq, :key
-        if bnd.local_variable_defined? name
-          call_kwds[name] = bnd.local_variable_get name
-        end
-      when :rest
-        arg_rest = true
-      end
-    end
-    
-    call_args = if arg_rest
-      args
-    else
-      args[0...arg_count]
-    end
-    
-    logger.debug "CALLING WITH",
-      args: call_args,
-      kwds: call_kwds
-    
-    block.call *call_args, **call_kwds
-  end
-  
-end # module NRSER

data/lib/nrser/functions/enumerable/map_values.rb

@@ -1,94 +0,0 @@
-module NRSER
-
-  # Maps an enumerable object to a *new* hash with the same keys and values
-  # obtained by calling `block` with the current key and value.
-  # 
-  # If `enumerable` *does not* respond to `#to_pairs` then it's
-  # treated as a hash where the elements iterated by `#each` are it's keys
-  # and all it's values are `nil`.
-  # 
-  # In this way, {NRSER.map_values} handles Hash, Array, Set, OpenStruct,
-  # and probably pretty much anything else reasonable you may throw at it.
-  # 
-  # @param [#each_pair, #each] enum
-  # 
-  # @yieldparam [Object] key
-  #   The key that will be used for whatever value the block returns in the
-  #   new hash.
-  # 
-  # @yieldparam [nil, Object] value
-  #   If `enumerable` responds to `#each_pair`, the second parameter it yielded
-  #   along with `key`. Otherwise `nil`.
-  # 
-  # @yieldreturn [Object]
-  #   Value for the new hash.
-  # 
-  # @return [Hash]
-  # 
-  # @raise [ArgumentError]
-  #   If `enumerable` does not respond to `#each_pair` or `#each`.
-  # 
-  
-  # Kind-of a Swiss Army knife for "I have the keys right, but I need to do
-  # some work to get the values I want".
-  # 
-  # @overload map_values hash, &block
-  #   
-  #   Maps `hash` (which doesn't need to be a {Hash}, just support
-  #   `#each_pair` in the same way) to a new {Hash} with the same keys and
-  #   values created by calling `&block`.
-  #   
-  #   The arguments yielded to `&block` depend it's `#arity`:
-  #   
-  #   1.  If `&block` has more than one required argument
-  #       (`block.arity > 1 || block.arity < -2`) then `key` and `value`
-  #       will be yielded, so this works:
-  #       
-  #           NRSER.map_values( hash ) { |key, value| ... }
-  #       
-  #   2.  If `&block` has one required argument or less
-  #       (`-2 <= block.arity <= 1`) then just `value` is yielded, so this
-  #       also works:
-  #       
-  #           NRSER.map_values( hash ) { |value| ... }
-  # 
-  # @overload map_values enumerable, &block
-  # 
-  def self.map_values enum, &block
-    result = {}
-    
-    arity = block.arity
-    
-    if enum.respond_to? :each_pair
-      enum.each_pair { |key, value|
-        result[key] = if arity > 1 ||  arity < -2
-          block.call key, value
-        else
-          block.call value
-        end
-      }
-    elsif enum.respond_to? :each
-      value = nil
-      enum.each_with_index { |key, index|
-        result[key] = if arity > 1 || arity < -2
-          block.call key, nil
-        else
-          block.call key
-        end
-      }
-    else
-      raise ArgumentError.new erb binding, <<-END
-        First argument to {NRSER.map_values} must respond to #each_pair or #each
-        
-        Received
-            
-            <%= enum.pretty_inspect %>
-        
-        of class <%= enum.class %>
-      END
-    end
-    
-    result
-  end # .map_values
-  
-end # module NRSER

data/lib/nrser/functions/hash/deep_merge.rb

@@ -1,57 +0,0 @@
-# Definitions
-# =======================================================================
-
-module NRSER
-  
-  # @!group Hash Functions
-  
-  # Returns a new hash created by recursively merging `other_hash` on top of
-  # `base_hash`.
-  # 
-  # Adapted from ActiveSupport.
-  # 
-  # @see https://github.com/rails/rails/blob/23c8f6918d4e6b9a823aa7a91377c6e3b5d60e13/activesupport/lib/active_support/core_ext/hash/deep_merge.rb
-  # 
-  # @param [Hash] base_hash
-  #   Base hash - it's values will be overwritten by any key paths shared with
-  #   the other hash.
-  # 
-  # @param [Hash] other_hash
-  #   "Update" hash - it's values will overwrite values at the same key path
-  #   in the base hash.
-  #   
-  #   I don't love the name; just went with what ActiveSupport used.
-  # 
-  # @return [Hash]
-  #   New merged hash.
-  # 
-  def self.deep_merge base_hash, other_hash, &block
-    deep_merge! base_hash.dup, other_hash, &block
-  end # .deep_merge
-  
-  
-  # Same as {.deep_merge}, but modifies `base_hash`.
-  # 
-  # @return [Hash]
-  #   The mutated base hash.
-  # 
-  def self.deep_merge! base_hash, other_hash, &block
-    other_hash.each_pair do |current_key, other_value|
-      this_value = base_hash[current_key]
-
-      base_hash[current_key] = if this_value.is_a?(Hash) &&
-                                  other_value.is_a?(Hash)
-        deep_merge this_value, other_value, &block
-      else
-        if block_given? && base_hash.key?( current_key )
-          block.call(current_key, this_value, other_value)
-        else
-          other_value
-        end
-      end
-    end
-
-    base_hash
-  end
-    
-end # module NRSER