unpatched 0.0.1

data/License

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Konstantin Haase
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,62 @@
+Convenience library, like ActiveSupport or extlib, but without a single
+monkey-patch. It is also an API experiment.
+
+# Usage
+
+Stand alone:
+
+``` ruby
+require 'unpatched'
+inlcude Unpatched
+
+like("FooBar").but.underscore!
+about(1).month.and(4).days.ago!
+```
+
+Is that too much sugar? Try this:
+
+``` ruby
+require 'unpatched'
+include Unpatched::Unfancy
+_('FooBar').underscore!
+```
+
+Still too much?
+
+``` ruby
+require 'unpatched'
+Unpatched['FooBar'].underscore!
+```
+
+With Sinatra:
+
+``` ruby
+require 'sinatra'
+require 'unpatched'
+helpers Unpatched
+
+get '/' do
+  expires exactly(1.5).minutes.from_now!
+  "Hey, ho, let's go!"
+end
+```
+
+# When to use an exclamation mark
+
+Short: You don't have to. But methods without one will always return magically
+enhanced objects. Since you never want to pass those on (otherwise, what's the
+point?), you can get vanilla objects by using an exclamation mark.
+
+Rule of thumb: Use it at the end of your method chain.
+
+# Installation
+
+    gem install unpatched
+
+# TODO
+
+* Write code and documentation
+* Fix project description in gemspec
+* Change testing framework if necessary (see Rakefile, currently RSpec)
+* Adjust unpatched.gemspec if your github name is not rkh
+* Adjust License if your real name is not Konstantin Haase

data/Rakefile

@@ -0,0 +1,37 @@
+$LOAD_PATH.unshift File.expand_path('../lib', __FILE__)
+
+begin
+  require 'bundler'
+  Bundler::GemHelper.install_tasks
+rescue LoadError => e
+  $stderr.puts e
+end
+
+desc "run specs"
+task(:spec) { ruby '-S rspec spec' }
+
+desc "generate gemspec"
+task 'unpatched.gemspec' do
+  require 'unpatched/version'
+  content = File.read 'unpatched.gemspec'
+
+  fields = {
+    :authors => `git shortlog -sn`.scan(/[^\d\s].*/),
+    :email   => `git shortlog -sne`.scan(/[^<]+@[^>]+/),
+    :files   => `git ls-files`.split("\n").reject { |f| f =~ /^(\.|Gemfile)/ }
+  }
+
+  fields.each do |field, values|
+    updated = "  s.#{field} = ["
+    updated << values.map { |v| "\n    %p" % v }.join(',')
+    updated << "\n  ]"
+    content.sub!(/  s\.#{field} = \[\n(    .*\n)*  \]/, updated)
+  end
+
+  content.sub! /(s\.version.*=\s+).*/, "\\1\"#{Unpatched::VERSION}\""
+  File.open('unpatched.gemspec', 'w') { |f| f << content }
+end
+
+task :gemspec => 'unpatched.gemspec'
+task :default => :spec
+task :test    => :spec

data/lib/unpatched.rb

@@ -0,0 +1,168 @@
+require 'unpatched/version'
+
+module Unpatched
+  MINUTE = 60
+  HOUR   = 60  * MINUTE
+  DAY    = 24  * HOUR
+  MONTH  = 30  * DAY
+  YEAR   = 365 * DAY
+
+  module Utils
+    extend self
+
+    def wrapped(value)
+      NormalWrapper.new(value)
+    end
+
+    def unwrapped(value)
+      value = value.__instance_eval__ { @value } while Wrapper === value
+      value
+    end
+
+    def numeric(value)
+      case value
+      when Numeric then value
+      when Wrapper then numeric unwrapped(value)
+      else
+        begin
+          Integer value
+        rescue ArgumentError
+          Float value
+        end
+      end
+    end
+
+    alias num numeric
+  end
+
+  class Wrapper < defined?(BasicObject) ? BasicObject : Object
+    def self.const_missing(const) ::Unpatched.const_get(const) end
+    alias __instance_eval__ instance_eval
+
+    if superclass == Object
+      instance_methods.each do |m|
+        undef_method(m) if m.to_s !~ /(?:^__|^send$|^object_id$)/
+      end
+    else  
+      undef ==
+      undef equal?
+      undef instance_eval
+    end
+
+    def initialize(value)
+      @value = Utils.unwrapped(value)
+    end
+
+    def inspect
+      @value.inspect
+    end
+
+    def and(value = (undefined = true))
+      return self if undefined
+      if Wrapper === value
+        Utils.wrapped @value + unwrapped(value)
+      else
+        MultiWrapper.new self, value
+      end
+    end
+
+    alias_method :but, :and
+  end
+
+  class MultiWrapper < Wrapper
+    def initialize(base, value)
+      @base, @value = base, Utils.wrapped(value)
+    end
+
+    private
+    def method_missing(*a, &b)
+      @base + @value.__send__(*a, &b)
+    end
+  end
+
+  class NormalWrapper < Wrapper
+    def second
+      value = Utils.unwrapped @value
+      if value.respond_to? :second
+        value.second
+      else
+        Utils.wrapped Utils.num(value)
+      end
+    rescue TypeError, ArgumentError => err
+      raise err unless value.respond_to? :[]
+      value[1]
+    end
+
+    def underscore
+      to_s.
+        gsub(/::/, '/').
+        gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2').
+        gsub(/([a-z\d])([A-Z])/,'\1_\2').
+        tr("-", "_").
+        downcase
+    end
+
+    def seconds; Utils.wrapped Utils.num(@value)          end
+    def minute;  Utils.wrapped Utils.num(@value) * MINUTE end
+    def hour;    Utils.wrapped Utils.num(@value) * HOUR   end
+    def day;     Utils.wrapped Utils.num(@value) * DAY    end
+    def month;   Utils.wrapped Utils.num(@value) * MONTH  end
+    def year;    Utils.wrapped Utils.num(@value) * YEAR   end
+
+    def before(other)
+      Utils.wrapped Utils.unwrapped(other) - @value
+    end
+
+    def after(other)
+      Utils.wrapped Utils.unwrapped(other) + @value
+    end
+
+    def ago
+      before Time.now
+    end
+
+
+    def from_now
+      after Time.now
+    end
+
+    alias minutes minute
+    alias hours   hour
+    alias days    day
+    alias months  month
+    alias years   year
+
+    private
+
+    def method_missing(m, *a, &b)
+      a.map! { |e| Utils.unwrapped e }
+      if m[-1] == ?! and NormalWrapper.method_defined?(method = m[0..-2])
+        result = __send__(method, *a, &b)
+        Utils.unwrapped result
+      else
+        Utils.wrapped @value.__send__(m, *a, &b)
+      end
+    end
+  end
+
+  module Unfancy
+    private
+    def _(value)
+      Utils.wrapped(value)
+    end
+  end
+
+  module Fancy
+    include Unfancy
+    %w[about exactly like is some].each do |meth|
+      alias_method meth, :_
+      private meth
+    end
+  end
+
+  def self.[](value)
+    Utils.wrapped(value)
+  end
+
+  include Fancy
+end

data/lib/unpatched/version.rb

@@ -0,0 +1,42 @@
+module Unpatched
+  def self.version
+    VERSION
+  end
+
+  module VERSION
+    extend Comparable
+
+    MAJOR     = 0
+    MINOR     = 0
+    TINY      = 1
+    SIGNATURE = [MAJOR, MINOR, TINY]
+    STRING    = SIGNATURE.join '.'
+
+    def self.major; MAJOR  end
+    def self.minor; MINOR  end
+    def self.tiny;  TINY   end
+    def self.to_s;  STRING end
+
+    def self.hash
+      STRING.hash
+    end
+
+    def self.<=>(other)
+      other = other.split('.').map { |i| i.to_i } if other.respond_to? :split
+      SIGNATURE <=> Array(other)
+    end
+
+    def self.inspect
+      STRING.inspect
+    end
+
+    def self.respond_to?(meth, *)
+      meth.to_s !~ /^__|^to_str$/ and STRING.respond_to? meth unless super
+    end
+
+    def self.method_missing(meth, *args, &block)
+      return super unless STRING.respond_to?(meth)
+      STRING.send(meth, *args, &block)
+    end
+  end
+end

data/spec/unpatched_spec.rb

@@ -0,0 +1,14 @@
+require 'unpatched'
+
+describe Unpatched do
+  before { extend Unpatched }
+  it 'should not fail me' do
+    exactly(2).seconds.should == 2
+    exactly(2).minutes.should == 120
+    about(10).minutes.and(1).second.should == 601
+    _('FooBar').underscore.should == 'foo_bar'
+    about(10).minutes.ago!.should be_a(Time)
+    about(10).minutes.from_now!.should be_a(Time)
+    exactly(10).before(12).should == 2
+  end
+end

data/unpatched.gemspec

@@ -0,0 +1,33 @@
+# Run `rake unpatched.gemspec` to update the gemspec.
+Gem::Specification.new do |s|
+  # general infos
+  s.name        = "unpatched"
+  s.version     = "0.0.1"
+  s.description = "Convenience library without a single monkey-patch."
+  s.homepage    = "http://github.com/rkh/unpatched"
+  s.summary     = s.description
+
+  # generated from git shortlog -sn
+  s.authors = [
+    "Konstantin Haase"
+  ]
+
+  # generated from git shortlog -sne
+  s.email = [
+    "konstantin.mailinglists@googlemail.com"
+  ]
+
+  # generated from git ls-files
+  s.files = [
+    "License",
+    "README.md",
+    "Rakefile",
+    "lib/unpatched.rb",
+    "lib/unpatched/version.rb",
+    "spec/unpatched_spec.rb",
+    "unpatched.gemspec"
+  ]
+
+  # dependencies
+  s.add_development_dependency "rspec", "~> 2.0"
+end

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification
+name: unpatched
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Konstantin Haase
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-05-31 00:00:00.000000000 +02:00
+default_executable: 
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &2153180300 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: *2153180300
+description: Convenience library without a single monkey-patch.
+email:
+- konstantin.mailinglists@googlemail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- License
+- README.md
+- Rakefile
+- lib/unpatched.rb
+- lib/unpatched/version.rb
+- spec/unpatched_spec.rb
+- unpatched.gemspec
+has_rdoc: true
+homepage: http://github.com/rkh/unpatched
+licenses: []
+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.6.2
+signing_key: 
+specification_version: 3
+summary: Convenience library without a single monkey-patch.
+test_files: []