footing 0.0.1

data/Gemfile

@@ -0,0 +1,6 @@
+source :rubygems
+
+group :development do
+  gem "pry"
+  gem "yard"
+end

data/Gemfile.lock

@@ -0,0 +1,18 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    coderay (1.0.7)
+    method_source (0.8)
+    pry (0.9.10)
+      coderay (~> 1.0.5)
+      method_source (~> 0.8)
+      slop (~> 3.3.1)
+    slop (3.3.2)
+    yard (0.8.2.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  pry
+  yard

data/README.md

@@ -0,0 +1,54 @@
+# Footing
+
+#### NOTE: this lib is experimental at the moment
+
+This lib extends native objects with additional functionality.
+
+## No implicit monkey patching
+
+**No surprises here.** You must explicitly ask for Footing goodness to be added to your objects.
+
+```ruby
+# some examples of explicit patching
+Footing.patch!(String)
+String.ancestors
+[
+  String,
+  Footing::String::InstanceMethods,
+  Comparable,
+  Object,
+  PP::ObjectMixin,
+  Kernel,
+  BasicObject
+]
+
+Footing.patch!(Numeric)
+[
+  Numeric,
+  Footing::Numeric::InstanceMethods,
+  Comparable,
+  Object,
+  PP::ObjectMixin,
+  Kernel,
+  BasicObject
+]
+```
+
+## Instance patching
+
+If you don't want to corrupt your entire runtime, you can patch an instance.
+
+```ruby
+s = "foo"
+Footing.patch!(s)
+s.respond_to? :escape # => true
+"foo".respond_to? :escape # => false
+```
+
+## Kick the tires
+
+* `git clone git://github.com/hopsoft/footing.git`
+* `cd /path/to/footing`
+* `bundle`
+* `./console`
+* `Footing.patch(String)`

data/lib/extensions/kernel.rb

@@ -0,0 +1,5 @@
+module Footing
+  module Kernel
+
+  end
+end

data/lib/extensions/numeric.rb

@@ -0,0 +1,26 @@
+module Footing
+  module Numeric
+
+    module InstanceMethods
+
+      # Returns the percentage that this number is of the passed number.
+      # @example
+      #   8.percent_of(10) # => 80.0
+      # @param [Numeric] number The number to calculate the percentage with
+      def percent_of(number)
+        percent = (self.to_f / number.to_f) * 100 if number > 0
+        percent ||= 0.0
+      end
+
+      # Rounds the number to a certain number of decimal places.
+      # @example
+      #   1.784329.round_to(1) # => 1.8
+      # @param [Numeric] decimal_places The number of decimal places to round to
+      def round_to(decimal_places)
+        (self * 10**decimal_places).round.to_f / 10**decimal_places
+      end
+
+    end
+
+  end
+end

data/lib/extensions/object.rb

@@ -0,0 +1,21 @@
+module Footing
+  module Object
+    module InstanceMethods
+
+      # Returns the eigen class for the object.
+      def eigen
+        eigen = class << self
+          self
+        end
+      rescue Exception => ex
+        nil
+      end
+
+      # Indicates if the object has an eigen class.
+      def has_eigen?
+        !eigen.nil?
+      end
+
+    end
+  end
+end

data/lib/extensions/string.rb

@@ -0,0 +1,15 @@
+module Footing
+  module String
+    module InstanceMethods
+
+      # Escapes a series of chars in the current string.
+      # NOTE: A new string is returned.
+      def escape(*chars)
+        gsub(/(?<!\\)(#{chars.join("|")})/) do |char|
+          "\\" + char
+        end
+      end
+
+    end
+  end
+end

data/lib/footing.rb

@@ -0,0 +1,62 @@
+module Footing
+
+  # Patches the object with all applicable Hopsoft extensions and monkey patches.
+  # Works for Modules, Classes, and instances of objects.
+  # @param [Object] obj The object to patch.
+  def self.patch!(obj)
+    if obj.class == Module || obj.class == Class
+      # patching a Module or Class
+      violate(obj)
+    else
+      # patching an instance
+      eigen = nil
+      begin
+        eigen = class << obj
+          self
+        end
+      rescue Exception => ex
+      end
+
+      raise "#{obj.class.name} doesn't support instance patching!" unless eigen
+      violate(eigen)
+    end
+  end
+
+  private
+
+  # Violates the object by applying all applicable Footing extensions and monkey patches.
+  # @param [Object] obj The object to voilate.
+  def self.violate(obj)
+    chain = obj.ancestors.reduce({}) do |memo, ancestor|
+      memo[ancestor] = ancestor.name.split("::")
+      memo
+    end
+    chain[obj] = obj.name.split("::") if obj.name
+
+    chain.each do |ancestor, names|
+      context = obj
+      footing_context = Footing
+
+      names.each do |name|
+        const = context.const_get(name)
+        footing_const = footing_context.const_get(name) if footing_context.const_defined?(name) break unless footing_const.name =~ /^Footing/
+        break if footing_const.name =~ /^(Footing|Footing::Object)$/
+        const.extend footing_const::ClassMethods if defined?(footing_const::ClassMethods)
+        const.send :include, footing_const::InstanceMethods if defined?(footing_const::InstanceMethods)
+        context = const
+        footing_context = footing_const
+      end
+    end
+
+    true
+  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
+end

metadata

@@ -0,0 +1,57 @@
+--- !ruby/object:Gem::Specification
+name: footing
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Nathan Hopkins
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-07-23 00:00:00.000000000 Z
+dependencies: []
+description: ! "    Footing provides some sanity for monkey patching practices.\n
+  \   It also is a utility lib that contains additional functionality for core objects
+  that you might find useful.\n"
+email:
+- natehop@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/extensions/kernel.rb
+- lib/extensions/numeric.rb
+- lib/extensions/object.rb
+- lib/extensions/string.rb
+- lib/footing.rb
+- Gemfile
+- Gemfile.lock
+- README.md
+homepage: https://github.com/hopsoft/footing
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Foundational patching lib.
+test_files: []
+has_rdoc: