rext 0.3.4

data/lib/rext/version.rb

@@ -0,0 +1,4 @@
+
+module Rext
+  VERSION = '0.3.4'
+end

data/rext.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{rext}
+  s.version = "0.3.4"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["TJ Holowaychuk"]
+  s.date = %q{2009-10-08}
+  s.description = %q{Ruby extensions}
+  s.email = %q{tj@vision-media.ca}
+  s.extra_rdoc_files = ["README.rdoc", "lib/rext.rb", "lib/rext/all.rb", "lib/rext/array.rb", "lib/rext/array/helpers.rb", "lib/rext/date.rb", "lib/rext/date/helpers.rb", "lib/rext/enumerable.rb", "lib/rext/enumerable/helpers.rb", "lib/rext/hash.rb", "lib/rext/hash/helpers.rb", "lib/rext/integer.rb", "lib/rext/integer/helpers.rb", "lib/rext/module.rb", "lib/rext/module/helpers.rb", "lib/rext/numeric.rb", "lib/rext/numeric/bytes.rb", "lib/rext/numeric/time.rb", "lib/rext/object.rb", "lib/rext/object/helpers.rb", "lib/rext/object/metaclass.rb", "lib/rext/proc.rb", "lib/rext/proc/helpers.rb", "lib/rext/string.rb", "lib/rext/string/encode.rb", "lib/rext/string/helpers.rb", "lib/rext/symbol.rb", "lib/rext/symbol/helpers.rb", "lib/rext/time.rb", "lib/rext/time/helpers.rb", "lib/rext/version.rb", "tasks/benchmark.rake", "tasks/docs.rake", "tasks/gemspec.rake", "tasks/spec.rake"]
+  s.files = ["History.rdoc", "Manifest", "README.rdoc", "Rakefile", "benchmarks/enumerable.rb", "benchmarks/proc.rb", "lib/rext.rb", "lib/rext/all.rb", "lib/rext/array.rb", "lib/rext/array/helpers.rb", "lib/rext/date.rb", "lib/rext/date/helpers.rb", "lib/rext/enumerable.rb", "lib/rext/enumerable/helpers.rb", "lib/rext/hash.rb", "lib/rext/hash/helpers.rb", "lib/rext/integer.rb", "lib/rext/integer/helpers.rb", "lib/rext/module.rb", "lib/rext/module/helpers.rb", "lib/rext/numeric.rb", "lib/rext/numeric/bytes.rb", "lib/rext/numeric/time.rb", "lib/rext/object.rb", "lib/rext/object/helpers.rb", "lib/rext/object/metaclass.rb", "lib/rext/proc.rb", "lib/rext/proc/helpers.rb", "lib/rext/string.rb", "lib/rext/string/encode.rb", "lib/rext/string/helpers.rb", "lib/rext/symbol.rb", "lib/rext/symbol/helpers.rb", "lib/rext/time.rb", "lib/rext/time/helpers.rb", "lib/rext/version.rb", "rext.gemspec", "spec/array_spec.rb", "spec/date_spec.rb", "spec/enumerable_spec.rb", "spec/hash_spec.rb", "spec/integer_spec.rb", "spec/module_spec.rb", "spec/numeric_spec.rb", "spec/object_spec.rb", "spec/spec.opts", "spec/spec_helper.rb", "spec/string_spec.rb", "spec/symbol_spec.rb", "spec/time_spec.rb", "tasks/benchmark.rake", "tasks/docs.rake", "tasks/gemspec.rake", "tasks/spec.rake"]
+  s.homepage = %q{http://github.com/visionmedia/rext}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Rext", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{rext}
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Ruby extensions}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/spec/array_spec.rb

@@ -0,0 +1,61 @@
+
+require File.dirname(__FILE__) + '/spec_helper'
+require 'rext/array'
+
+describe Array do
+  describe "helpers" do
+    
+    before :each do
+      @items = %w( some foo bar )  
+    end
+    
+    describe "#from" do
+      it "should return elements after the position specified" do
+        @items.from(1).should == %w( foo bar )
+      end
+    end
+    
+    describe "#to" do
+      it "should return elements up to position" do
+        @items.to(1).should == %w( some foo )
+      end
+    end
+    
+    describe "#chunk" do
+      it "should split an array into several containing the length of n" do
+        (1..9).to_a.chunk(3).should == [[1,2,3], [4,5,6], [7,8,9]]
+      end
+      
+      it "should accept a block, yielding each chunk" do
+        chunks = []
+        (1..9).to_a.in_groups_of(3) do |chunk|
+          chunks << chunk
+        end
+        chunks.should == [[1,2,3], [4,5,6], [7,8,9]]
+      end
+      
+      it "should pad with nil by default" do
+        (1..5).to_a.in_groups_of(4).should == [[1,2,3,4], [5,nil,nil,nil]]
+      end
+      
+      it "should not padd when pad_with is false" do
+        (1..6).to_a.in_groups_of(4, false).should == [[1,2,3,4], [5,6]]
+      end
+    end
+    
+    describe "#pad" do
+      it "should pad with nil by default" do
+        [1,2].pad(4).should == [1, 2, nil, nil]
+      end
+      
+      it "should pad an with an object" do
+        [1,2].pad(3 ,'x').should == [1, 2, 'x']
+      end
+      
+      it "should do nothing when the array is of expected length" do
+        [1,2].pad(2).should == [1,2]
+      end
+    end
+    
+  end
+end

data/spec/date_spec.rb

@@ -0,0 +1,14 @@
+
+require File.dirname(__FILE__) + '/spec_helper'
+require 'rext/date'
+
+describe Date do
+  describe "helpers" do
+    describe "#to_time" do
+      it "should convert to a Time instance" do
+        event = Date.parse('may 25th 1987')
+        event.to_time.should be_an_instance_of(Time)
+      end
+    end
+  end
+end

data/spec/enumerable_spec.rb

@@ -0,0 +1,55 @@
+
+require File.dirname(__FILE__) + '/spec_helper'
+require 'rext/enumerable'
+
+describe Enumerable do
+  describe "helpers" do
+    describe "#includes_all?" do
+      it "should return true when all arguments are present" do
+        [1,2,3].includes_all?(1,2).should be_true
+      end
+      
+      it "should return true when not all arguments are present" do
+        [1,1,3,3,4].includes_all?(1,3,6).should be_false
+        [1,1,3,3,4].includes_all?(6,3,1).should be_false
+      end
+    end
+    
+    describe "#group_by" do
+      before :each do
+        @enum = 'foo', :bar, 1, 2, 3
+        @results = {
+          String => ['foo'],
+          Symbol => [:bar],
+          Fixnum => [1, 2, 3]
+        }
+      end
+      
+      it "should group an enum" do
+        @enum.group_by { |v| v.class }.should == @results
+      end
+      
+      it "should group using instance evaluated block" do
+        @enum.group_by { self.class }.should == @results
+      end
+      
+      it "should group by method call" do
+        @enum.group_by.class.should == @results
+      end
+    end
+    
+    describe "#every" do
+      it "should map a method call" do
+        list = %w( cookies icecream sugar )
+        list.every.length.should == [7, 8 ,5]
+      end
+
+      it "should allow mapping shortcuts using a block" do
+        people = []
+        people << mock('Person', :name => 'TJ')
+        people << mock('Person', :name => 'Scott')
+        people.every { name.length }.should == [2, 5]
+      end
+    end
+  end
+end

data/spec/hash_spec.rb

@@ -0,0 +1,36 @@
+
+require File.dirname(__FILE__) + '/spec_helper'
+require 'rext/hash'
+
+describe Hash do
+  describe "helpers" do
+    describe "#delete_at" do
+      it "should delete several keys, returning their values when present" do
+        options = { :foo => 1, :bar => 2 }
+        foo, bar, does_not_exist = options.delete_at :foo, :bar, :does_not_exist
+        foo.should == 1
+        bar.should == 2
+        does_not_exist.should be_nil
+      end
+    end
+    
+    describe "#switchify" do
+      it "should work with bools" do
+        { :use_foobar => true }.switchify.should == ['--use-foobar']
+        { :use_foobar => false }.switchify.should be_empty
+      end
+      
+      it "should stringify numbers and symbols" do
+        { :interval => 15, :icon => :jpeg }.switchify.sort.should == ['--icon', '--interval', '15', 'jpeg']
+      end
+      
+      it "should work with little switches" do
+        { :T => true }.switchify.should == ['-T']
+      end
+      
+      it "should add quotes around strings" do
+        { :glob => 'lib/**/*.rb' }.switchify.should == ['--glob', '"lib/**/*.rb"']
+      end
+    end
+  end  
+end

data/spec/integer_spec.rb

@@ -0,0 +1,19 @@
+
+require File.dirname(__FILE__) + '/spec_helper'
+require 'rext/integer'
+
+describe Integer do
+  describe "helpers" do
+    describe "#ordanalize" do
+      it "should convert integers to an ordanal string" do
+        1.ordinalize.should == '1st'
+        2.ordinalize.should == '2nd'
+        3.ordinalize.should == '3rd'
+        4.ordinalize.should == '4th'
+        11.ordinalize.should == '11th'
+        12.ordinalize.should == '12th'
+        13.ordinalize.should == '13th'
+      end
+    end
+  end
+end

data/spec/module_spec.rb

@@ -0,0 +1,41 @@
+
+require File.dirname(__FILE__) + '/spec_helper'
+require 'rext/module'
+
+describe Module do
+  describe "helpers" do
+    describe "#proxy_method" do
+      it "should implement method_missing, passing regexp captures and arguments to the handler method" do
+        class FooBar
+          call_method :find, :if => /^find_by_(\w+)_(\w+)/
+          call_method :delete, :if => lambda { |meth, *args| meth.to_s =~ /^delete_by_(\w+)_(\w+)/ }
+          def find *args; args end
+          def delete *args; args; end
+        end
+        foo = FooBar.new
+        foo.find_by_user_email.should == ['user', 'email']
+        foo.find_by_user_name('foo').should == ['user', 'name', 'foo']
+        foo.delete_by_user_name('foo', 'bar').should == ['foo', 'bar']
+        lambda { foo.does_not_exist }.should raise_error(NoMethodError)
+      end
+    end
+    
+    describe "#setup" do
+      it "should define included instance evaluated in context to the module passed" do
+        module BarFoo
+          setup do
+            include InstanceMethods
+          end
+          
+          module InstanceMethods
+            def bar_foo
+              'wahoo'
+            end 
+          end
+        end
+        FooBar.send :include, BarFoo
+        FooBar.new.bar_foo.should == 'wahoo'
+      end
+    end
+  end
+end

data/spec/numeric_spec.rb

@@ -0,0 +1,31 @@
+
+require File.dirname(__FILE__) + '/spec_helper'
+require 'rext/numeric'
+
+describe Numeric do
+  describe "time" do
+    describe "#ago / #before" do
+      it "should return the distance in time before now, or specified time" do
+        event = Time.mktime 1987, 5, 25
+        15.days.before(event).should == Time.mktime(1987, 5, 10)
+      end
+    end
+
+    describe "#since / #from_now" do
+      it "should return the distance in time from now, or specified time" do
+        event = Time.mktime 1987, 5, 25
+        5.days.since(event).should == Time.mktime(1987, 5, 30)
+      end
+    end
+  end
+  
+  describe "bytes" do
+    it "should return bytes, kilobytes, megabytes, gigabytes, and terabytes" do
+      5.bytes.should == 5
+      5.kilobytes.should == 5120
+      5.megabytes.should == 5242880
+      5.gigabytes.should == 5368709120
+      5.terabytes.should == 5497558138880
+    end
+  end
+end

data/spec/object_spec.rb

@@ -0,0 +1,101 @@
+
+require File.dirname(__FILE__) + '/spec_helper'
+require 'rext/object'
+
+describe Object do
+  describe "metaclass" do
+    describe "#metaclass" do
+      it "should return the anonymous 'virtual' class" do
+        'foo'.metaclass.should be_an_instance_of(Class)
+      end
+    end
+    
+    describe "#meta_eval" do
+      it "should evaluate a block in context to the metaclass" do
+        object = 'foo'
+        object.meta_eval do
+          define_method :foo do
+            'bar'
+          end
+        end
+        object.foo.should == 'bar'
+      end
+      
+      it "should accept a string to be evaluated" do
+        object = 'foo'
+        object.meta_eval <<-EOF
+          def foo
+            'bar'
+          end
+        EOF
+        object.foo.should == 'bar'
+      end
+    end
+    
+    describe "#meta_def" do
+      it "should define a method within the metaclass" do
+        object = 'foo'
+        object.meta_def(:foo) { |*args| "bar #{ args.join(', ') }" }
+        object.foo(1,2,3).should == 'bar 1, 2, 3'
+      end
+    end
+  end
+  
+  describe "helpers" do
+    describe "#indifferent_hash" do
+      it "should return a hash indifferent to symbols or strings for key access" do
+        hash = indifferent_hash
+        hash['foo'] = 'foo'
+        hash[:foo].should == 'foo'
+        hash['foo'].should == 'foo'
+      end
+    end
+  end
+  
+  describe "#try" do
+    it "should try the block once with no args" do
+      times = 0
+      try { times += 1 }
+      times.should == 1
+    end
+    
+    it "should try the block multiple times when failing" do
+      times = 0
+      try(3) { times += 1; raise 'foo' }
+      times.should == 3
+    end
+    
+    it "should try the block one time when succesful" do
+      times = 0
+      try(3) { times += 1 }
+      times.should == 1
+    end
+    
+    it "should return the value returned by the block" do
+      val = try(3) { 'test' }
+      val.should == 'test'
+    end
+    
+    it "should allow specific exceptions to be rescued" do
+      lambda { try(3){ raise ArgumentError, 'foo' } }.should_not raise_error
+      lambda { try(3, :on => ArgumentError){ raise ArgumentError, 'foo' } }.should_not raise_error
+      lambda { try(3, :on => TypeError){ raise ArgumentError, 'foo' } }.should raise_error(ArgumentError)
+    end
+  end
+  
+  describe "#returning" do
+    it "should return the value given to it" do
+      def frequency_of enum
+        returning Hash.new(0) do |hash|
+          enum.each do |value|
+            hash[value] += 1
+          end
+        end
+      end
+      frequency_of(%w( foo bar foo foo )).should == {
+        'foo' => 3,
+        'bar' => 1,
+      }
+    end
+  end
+end

data/spec/spec.opts

@@ -0,0 +1 @@
+--color

data/spec/spec_helper.rb

@@ -0,0 +1,5 @@
+
+$:.unshift File.dirname(__FILE__) + '/../lib' 
+
+require 'rubygems'
+require 'rext/all'

data/spec/string_spec.rb

@@ -0,0 +1,194 @@
+
+require File.dirname(__FILE__) + '/spec_helper'
+require 'rext/string'
+
+describe String do
+  describe "encode" do
+    describe "#to_md5" do
+      it "should return an md5 hash" do
+        'test'.to_md5.should == '098f6bcd4621d373cade4e832627b4f6'
+        'test'.to_md5.should == 'test'.to_md5
+        'test'.to_md5.should_not == 'tests'.to_md5
+      end
+    end
+    
+    describe "#to_sha512" do
+      it "should return an md5 hash" do
+        'test'.to_sha512.should == 'ee26b0dd4af7e749aa1a8ee3c10ae9923f618980772e473f8819a5d4940e0db27ac185f8a0e1d5f84f88bc887fd67b143732c304cc5fa9ad8e6f57f50028a8ff'
+        'test'.to_sha512.should == 'test'.to_sha512
+        'test'.to_sha512.should_not == 'tests'.to_sha512
+      end
+    end
+    
+    describe "#base64_encode" do
+      it "should base64 encode a string" do
+        'tj'.base64_encode.should == 'dGo='
+        "foo \n bar\n\n".base64_encode.base64_decode.should == "foo \n bar\n\n"
+      end
+    end
+    
+    describe "#base64_decode" do
+      it "should decode a base64 string" do
+        'dGo='.base64_decode.should == 'tj'
+      end
+    end
+  end
+  
+  describe "helpers" do
+    describe "#word_frequency" do
+      it "should return a hash with word keys and count values" do
+        'mm i love cookies mm'.word_frequency.
+        should == {
+          'mm' => 2,  
+          'i' => 1,  
+          'love' => 1,  
+          'cookies' => 1,  
+        }
+      end
+    end
+    
+    describe "#frequency_of_word" do
+      it "should return the frequency of a word, or 0" do
+        'yum yum ? yes'.frequency_of_word('yum').should == 2
+        'yum yum ? yes'.frequency_of_word('yes').should == 1
+        'yum yum ? yes'.frequency_of_word('no').should == 0
+      end
+    end
+    
+    describe "#switchify" do
+      it "should return a switch version of the string" do
+        'some_foo_bar'.switchify.should == '--some-foo-bar'
+      end
+      
+      it "should return small switches when only a single char" do
+        't'.switchify.should == '-t'
+      end
+      
+      it "should raise an InvalidSwitchError when length 0" do
+        lambda { ''.switchify }.should raise_error(String::InvalidSwitchError)
+      end
+    end
+    
+    describe "#path" do
+      it "should return an instance of a pathname" do
+        'History.rdoc'.path.should be_an_instance_of(Pathname)
+      end
+    end
+    
+    describe "#files" do
+      it "should return result of Dir glob" do
+        'lib/*.*'.files.should be_an_instance_of(Array)
+      end
+    end
+    
+    describe "#file" do
+      it "should return an instance of a file" do
+        'History.rdoc'.file.should be_an_instance_of(File)
+      end
+    end
+        
+    describe "#add_class" do
+      it "should add a word that does not exist" do
+        'foo'.add_class('bar').should == 'foo bar'
+      end
+      
+      it "should not add the same word twice" do
+        'foo-bar bar'.add_class('bar').should == 'foo-bar bar'
+      end
+    end
+    
+    describe "#wrap" do
+      it "should wrap a string" do
+        'foo'.wrap('|').should == '|foo|'
+      end
+      
+      it "should wrap with optional suffix" do
+        'foo'.wrap('(', ')').should == '(foo)'
+      end
+    end
+    
+    describe "#starts_with?" do
+      it "should check if a string starts with another" do
+        'foo bar'.starts_with?('foo').should be_true
+        ' foo bar'.starts_with?('foo').should_not be_true
+        'bar foo'.starts_with?('foo').should_not be_true
+      end
+    end
+    
+    describe "#ends_with?" do
+      it "should check if a string ends with another" do
+        'foo bar'.ends_with?('bar').should be_true
+        'foo bar '.ends_with?('bar').should_not be_true
+        'bar foo foo'.ends_with?('foo').should be_true
+      end
+    end
+  
+    describe "#plural?" do
+      it "should check if a string is plural" do
+        'cookies'.should be_plural
+        'cookie'.should_not be_plural
+      end
+    end
+  
+    describe "#singular?" do
+      it "should check if a string is singular" do
+        'cookie'.should be_singular
+        'cookies'.should_not be_singular
+      end
+    end
+  
+    describe "#first" do
+      it "should return the first character" do
+        'foo'.first.should == 'f'
+      end
+      
+      it "should return n number of charcters" do
+        'foo'.first(2).should == 'fo'
+      end
+    end
+  
+    describe "#last" do
+      it "should return the last character" do
+        'bar'.last.should == 'r'
+      end
+      
+      it "should return the last n number of characters" do
+        'bar'.last(2).should == 'ar'
+      end
+    end
+    
+    describe "#from" do
+      it "should return all characters from n" do
+        'cookies'.from(3).should == 'kies'
+      end
+    end
+    
+    describe "#camelize" do
+      it "should camel-case a string, leaving the first character lower by default" do
+        'some_foo_bar'.camelize.should == 'someFooBar'
+      end
+      
+      it "should camel-case a string, with first character capitalized" do
+        'some_foo_bar'.camelize(true).should == 'SomeFooBar'
+      end
+    end
+    
+    describe "#constantize" do
+      it "should convert a string to a constant" do
+        'Rext::VERSION'.constantize.should == Rext::VERSION
+      end
+      
+      it "should raise an error when an invalid constant name is passed" do
+        lambda { 'foo bar'.constantize }.should raise_error(NameError)
+      end
+    end
+  
+    describe "#digitize" do
+      it "should leave only numeric characters" do
+        '$100,000'.digitize.should == '100000'
+        '$100,000'.digitize.to_i.should == 100_000
+      end
+    end
+    
+  end
+end