footing 0.1.8 → 0.1.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3f04e649ba636544080c07a1ad7761f5c651c8ea
-  data.tar.gz: 297c0852ba8345a9ae906717b96ee43c03d2f9a6
+  metadata.gz: 31c11d069e01d431aa95a5648e2b5fc9bc3f071e
+  data.tar.gz: 21c75a976572f1c31ea4ea762f5702ab616ed947
 SHA512:
-  metadata.gz: f82d06e716fae130a33167feb967bbadf2d918039bf17e67e1430a87ff37ad5cf1b84302717a36cc9dc2b0009e855cc58d83fedda5ae824ed6c72b03c6e25e5b
-  data.tar.gz: 2bea338d92a93f6bace21ef5bb018eb3d2ceab3ecdcac6c5af170b1fc97fb7ded7423232a55a62cb07b14bc31258180efd8da1bbb13cbc99a8352607fd442e7a
+  metadata.gz: 7ad5e918d36cfc0e311af12524deec6f01ad01ed3eff33249312ee75fb7af165b65694d145ce017fe13f73debbf25902b764a2e5a10fc4b2cf194f752f19908f
+  data.tar.gz: 04f48adb18e68f95c258e1c386cb66ff386648cbc68780c7f75957f6d2f41913b9ed52e67dc1b660968a652cb2639666012a8819adef3e31f0324f068083402f

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    footing (0.1.7)
+    footing (0.1.9)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -9,8 +9,6 @@ Footing provides some sanity for monkey patching practices.
 It's also a utility lib that contains additional functionality for core objects that you might find useful.
 Think of it as a lightweight version of ActiveSupport that doesn't implicitly change native behavior.
 
-#### NOTE: this lib is experimental at the moment
-
 ## No implicit monkey patching
 
 You must explicitly apply monkey patches.
@@ -55,14 +53,6 @@ s.respond_to? :escape     # => true
 "foo".respond_to? :escape # => false
 ```
 
-## Shotgun patching
-
-For the lazy and brave, you can also patch everything at once.
-
-```ruby
-Footing.patch_all!
-```
-
 ## Patch free
 
 Dont like monkey patches? Run patch free by setting up utility methods instead.

data/lib/footing.rb

@@ -1,78 +1,55 @@
 require "delegate"
-require File.join(File.dirname(__FILE__), "footing", "version")
+require File.expand_path("../footing/version", __FILE__)
 
 module Footing
-
-  def self.modules
-    [
-      "Kernel",
-      "Object",
-      "String",
-      "Numeric",
-      "Array",
-      "Hash"
-    ]
-  end
-
-  # Applies all Footing patches.
-  def self.patch_all!
-    modules.each do |name|
-      context = Object.const_get(name)
-      footing = Footing.const_get(name)
-      patch! context, footing
+  class << self
+
+    # Patches a Module or instance with the given extension.
+    # @param [Module, Object] obj The Module or instance to patch.
+    # @param [Module] extension The Module that contains the patches.
+    def patch!(obj, extension)
+      context = patch_context(obj)
+      raise "#{obj.class.name} doesn't support patching!" unless context
+      context.send :include, extension
     end
-  end
 
-  # Patches a Module or instance with the given extension.
-  # @param [Module, Object] obj The Module or instance to patch.
-  # @param [Module] extension The Module that contains the patches.
-  def self.patch!(obj, extension)
-    context = obj if obj.is_a? Module
-    if context.nil?
-      begin
-        context = class << obj
-          self
+    # Creates class methods for all instance methods in the module.
+    # This allows users to invoke utility methods rather than monkey patching if they so desire.
+    # @param [Module] mod The Module to setup util methods for.
+    def util!(mod)
+      proxy = Class.new(SimpleDelegator)
+      Footing.patch! proxy, mod
+
+      mod.instance_methods(false).each do |method_name|
+        mod.define_singleton_method(method_name) do |target, *args|
+          method = proxy.instance_method(method_name)
+          target = proxy.new(target)
+          if method.parameters.empty?
+            method.bind(target).call
+          else
+            method.bind(target).call(*args)
+          end
         end
-      rescue Exception
       end
     end
 
-    raise "#{obj.class.name} doesn't support patching!" unless context
-    context.send :include, extension
-  end
+    private
 
-  # Creates util methods for all Footing patches.
-  def self.util_all!
-    modules.each { |mod| util! Footing.const_get(mod) }
-  end
-
-  # Creates class methods for all instance methods in the module.
-  # This allows users to invoke utility methods rather than monkey patching if they so desire.
-  # @param [Module] mod The Module to setup util methods for.
-  def self.util!(mod)
-    proxy = Class.new(SimpleDelegator)
-    Footing.patch! proxy, mod
-
-    mod.instance_methods(false).each do |method_name|
-      mod.define_singleton_method(method_name) do |target, *args|
-        method = proxy.instance_method(method_name)
-        target = proxy.new(target)
-        if method.parameters.empty?
-          method.bind(target).call
-        else
-          method.bind(target).call(*args)
+    def patch_context(obj)
+      context = obj if obj.is_a? Module
+      begin
+        context ||= class << obj
+          self
         end
+      rescue Exception
       end
+      context
     end
-  end
 
+  end
 end
 
-Dir[File.expand_path(File.join(File.dirname(__FILE__), "**/*.rb"))].each do |file|
-  next if file =~ /#{__FILE__.gsub(".", "\.")}$/
-  if ENV["FOOTING_DEV"]
-    load file
-  else
-    require file
-  end
+Dir[File.expand_path("../**/*.rb", __FILE__)].each do |file|
+  next if file =~ /(lib\/footing\.rb|version\.rb)\z/
+  ENV["FOOTING_DEV"] ? load(file) : require(file)
 end

data/lib/footing/extensions/hash.rb

@@ -14,7 +14,7 @@ module Footing
     # @return [Hash] A new Hash that has been re-keyed.
     def rekey(method_name)
       inject({}) do |new_hash, (key, value)|
-        new_hash[key.send(method_name)] = value
+        new_hash[key.public_send(method_name)] = value
         new_hash
       end
     end
@@ -37,7 +37,7 @@ module Footing
       end
     end
 
-    # Adjusts the values of the Hash in place.
+    # Recursively adjusts the values of the Hash in place.
     #
     # @example
     #   dict = {:a => 1, :b => 2, :c => 3}
@@ -46,8 +46,15 @@ module Footing
     #
     # @yield [value] Yields the current value to the block.
     #                The result of the block is then assigned to the corresponding key.
-    def adjust_values!
-      each { |k, v| self[k] = yield(v) }
+    def adjust_values!(&block)
+      each do |key, value|
+        if value.respond_to?(:adjust_values!)
+          value.adjust_values!(&block)
+        else
+          self[key] = yield(value)
+        end
+      end
+      self
     end
 
     # Recursively casts all string values in this Hash.

data/lib/footing/extensions/nil_class.rb

@@ -1,13 +1,12 @@
 module Footing
   module NilClass
 
-    # Similar to ActiveSupport's #try added to NilClass.
-    # Calling [] on nil always returns nil.
-    # It becomes especially helpful when navigating through deeply nested Hashes.
+    # Calling [] on nil returns nil instead of raising an exception.
+    # Helpful when looping over nested Hashes.
     #
     # @example
     #   dict = {}
-    #   dict[:foo][:bar][:other] # => nil
+    #   dict[:foo][:bar][:baz] # => nil
     #
     # @param [Object] key The key to lookup.
     def [](key)

data/lib/footing/extensions/object.rb

@@ -15,5 +15,14 @@ module Footing
       !eigen.nil?
     end
 
+    # Trys to invoke a method on the object.
+    # Returns nil if the method isn't supported.
+    def try(name, *args, &block)
+      if respond_to?(name)
+        return public_send(name, *args, &block)
+      end
+      nil
+    end
+
   end
 end

data/lib/footing/extensions/string.rb

@@ -22,8 +22,7 @@ module Footing
       (1..length).map{ |i| (chars - opts[:reject]).sample }.join
     end
 
-    # Escapes a series of chars in the current string.
-    # NOTE: A new string is returned.
+    # Escapes a series of chars.
     def escape(*chars)
       gsub(/(?<!\\)(#{chars.join("|")})/) do |char|
         "\\" + char

data/lib/footing/version.rb

@@ -1,3 +1,3 @@
 module Footing
-  VERSION = "0.1.8"
+  VERSION = "0.1.9"
 end

metadata

@@ -1,83 +1,83 @@
 --- !ruby/object:Gem::Specification
 name: footing
 version: !ruby/object:Gem::Version
-  version: 0.1.8
+  version: 0.1.9
 platform: ruby
 authors:
 - Nathan Hopkins
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-11-26 00:00:00.000000000 Z
+date: 2014-04-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: micro_test
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: micro_mock
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: pry-stack_explorer
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 description: A utility belt lib with sane monkey patching.
@@ -87,6 +87,12 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/footing.rb
 - lib/footing/extensions/array.rb
 - lib/footing/extensions/hash.rb
 - lib/footing/extensions/kernel.rb
@@ -97,12 +103,6 @@ files:
 - lib/footing/extensions/schema_statements.rb
 - lib/footing/extensions/string.rb
 - lib/footing/version.rb
-- lib/footing.rb
-- Gemfile
-- Gemfile.lock
-- LICENSE.txt
-- Rakefile
-- README.md
 homepage: https://github.com/hopsoft/footing
 licenses:
 - MIT
@@ -113,17 +113,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.3
+rubygems_version: 2.2.0
 signing_key: 
 specification_version: 4
 summary: A utility belt lib with sane monkey patching.
@@ -139,4 +139,3 @@ test_files:
 - lib/footing/extensions/string.rb
 - lib/footing/version.rb
 - lib/footing.rb
-has_rdoc: