visionmedia-rext 0.0.3 → 0.0.4

data/History.rdoc

@@ -1,4 +1,16 @@
 
+=== 0.0.4 / 2009-03-25
+
+* Added Object#metaclass
+* Added Object#meta_eval
+* Added Object#meta_def
+* Added BasicObject for Ruby < 1.9
+* Added n param to String#first / last
+* Added byte conversion 1.byte, 6.kilobytes etc
+* Added form param to #to_time
+* Added Array#from / to
+* Moved time related methods from Integer to Numeric
+
 === 0.0.3 / 2009-03-25
 
 * Added String#base64_encode 

data/Manifest

@@ -2,6 +2,10 @@ benchmarks/enumerable.rb
 benchmarks/proc.rb
 History.rdoc
 lib/rext/all.rb
+lib/rext/array/helpers.rb
+lib/rext/array.rb
+lib/rext/compat/basic_object.rb
+lib/rext/compat.rb
 lib/rext/date/helpers.rb
 lib/rext/date.rb
 lib/rext/enumerable/helpers.rb
@@ -9,10 +13,14 @@ lib/rext/enumerable.rb
 lib/rext/hash/helpers.rb
 lib/rext/hash.rb
 lib/rext/integer/helpers.rb
-lib/rext/integer/time.rb
 lib/rext/integer.rb
 lib/rext/module/helpers.rb
 lib/rext/module.rb
+lib/rext/numeric/bytes.rb
+lib/rext/numeric/time.rb
+lib/rext/numeric.rb
+lib/rext/object/metaclass.rb
+lib/rext/object.rb
 lib/rext/proc/helpers.rb
 lib/rext/proc.rb
 lib/rext/string/escape.rb
@@ -26,11 +34,15 @@ Manifest
 Rakefile
 README.rdoc
 rext.gemspec
+spec/array_spec.rb
+spec/compat_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_helper.rb
 spec/string_spec.rb
 spec/time_spec.rb

data/README.rdoc

@@ -1,10 +1,16 @@
 
 = Rext
 
-This gem is primarily used for the Evolution CMS project, and its dependencies,
-however it is de-coupled and free to use within your own project. As to compliment
-existing extension libraries such as extlib, this library does not provide
-methods such as String#camelize etc.
+Rext is primarily used for the Evolution CMS project, and its dependencies,
+however it is de-coupled and free to use within your own project.
+
+== Motivations
+
+* ActiveSupport does not contain everything we need, and is messy IMO
+* Very easy to cherry-pick what you need
+* Provide better documentation
+* Attention to quality and performance
+* Abstraction of loosely coupled helpers used throughout Evolution and its sub-gems
 
 == Usage
 
@@ -26,6 +32,11 @@ methods such as String#camelize etc.
 
 Below are the methods currently provided by Rext.
 
+* Object
+  - metaclass
+  - meta_def
+  - meta_eval
+
 * String
   - url_encode
   - url_decode
@@ -34,6 +45,8 @@ Below are the methods currently provided by Rext.
   - html_escape
   - merge_word / add_class
   - digitize
+  - camelize
+  - constantize
   - wrap
   - start_with?
   - end_with?
@@ -47,6 +60,9 @@ Below are the methods currently provided by Rext.
 
 * Integer
   - ordanalize
+
+* Numeric
+  - bytes, kilobytes, etc
   - seconds, minutes, hours, days, ...
   - to_seconds, to_minutes, to_hours, ...
   - ago / before
@@ -72,6 +88,16 @@ Below are the methods currently provided by Rext.
   - group_by
   - every ( Copyright http://github.com/mynyml )
 
+== Compatibility
+
+Rext provides methods which support Ruby 1.8.x and 1.9.x, as
+well as forward compatibility for features such as BasicObject.
+
+== Contrib
+
+Feel free to fork Rext on github, or submit a ticket:
+http://visionmedia.lighthouseapp.com/projects/28074-rext/overview
+
 == License
 
 (The MIT License)

data/lib/rext/all.rb

@@ -4,10 +4,14 @@
 #++
 
 require 'rext'
+require 'rext/object'
+require 'rext/compat'
 require 'rext/module'
 require 'rext/proc'
 require 'rext/enumerable'
+require 'rext/array'
 require 'rext/hash'
+require 'rext/numeric'
 require 'rext/integer'
 require 'rext/string'
 require 'rext/date'

data/lib/rext/array/helpers.rb

@@ -0,0 +1,18 @@
+
+class Array
+  
+  ##
+  # Return array of elements after +position+.
+
+  def from position
+    self[position..-1]
+  end
+
+  ##
+  # Return array of elements up to +position+.
+  
+  def to position
+    self[0..position]
+  end
+  
+end

data/lib/rext/array.rb

@@ -0,0 +1,6 @@
+
+#--
+# Load Array specific rext extensions.
+#++
+
+require 'rext/array/helpers'

data/lib/rext/compat/basic_object.rb

@@ -0,0 +1,16 @@
+
+require 'rext/module/helpers'
+
+class BasicObject
+  instance_methods.each { |m| undef_method m unless m.match(/^__/) }
+end
+
+module RemoveBasicObjectMethods
+  def method_added name
+    BasicObject.send :undef_method, name if self == Object
+    super
+  end
+end
+
+Object.extend RemoveBasicObjectMethods
+Kernel.extend RemoveBasicObjectMethods

data/lib/rext/compat.rb

@@ -0,0 +1,6 @@
+
+#--
+# Load Compatibility specific rext extensions.
+#++
+
+require 'rext/compat/basic_object' unless defined? BasicObject

data/lib/rext/date/helpers.rb

@@ -3,10 +3,9 @@ class Date
   
   ##
   # Convert Date to a Time instance.
-  #
   
-  def to_time
-    Time.utc year, month, day
+  def to_time form = :utc
+    Time.send form, year, month, day
   end
   
 end

data/lib/rext/enumerable/helpers.rb

@@ -1,4 +1,5 @@
 
+require 'rext/compat/basic_object'
 require 'rext/module/helpers'
 require 'rext/proc/helpers'
 
@@ -19,9 +20,7 @@ module Enumerable
   # * Enumerable#proxy
   #
   
-  class Proxy
-    instance_methods.each { |m| undef_method m unless m.match(/^__/) }
-    
+  class Proxy < BasicObject
     def initialize object, meth
       @object, @method = object, meth
     end

data/lib/rext/integer.rb

@@ -4,4 +4,3 @@
 #++
 
 require 'rext/integer/helpers'
-require 'rext/integer/time'

data/lib/rext/numeric/bytes.rb

@@ -0,0 +1,16 @@
+
+class Numeric
+  
+  def bytes; self end
+  def kilobytes; self * 1024 end
+  def megabytes; self * 1024.kilobytes end
+  def gigabytes; self * 1024.megabytes end
+  def terabytes; self * 1024.gigabytes end
+  
+  alias :byte :bytes
+  alias :kilobyte :kilobytes
+  alias :megabyte :megabytes
+  alias :gigabyte :gigabytes
+  alias :terabyte :terabytes
+  
+end

data/lib/rext/{integer → numeric}/time.rb

@@ -1,5 +1,5 @@
 
-class Integer
+class Numeric
   
   def seconds; self            end
   def minutes; self * 60       end

data/lib/rext/numeric.rb

@@ -0,0 +1,7 @@
+
+#--
+# Load Numeric specific rext extensions.
+#++
+
+require 'rext/numeric/time'
+require 'rext/numeric/bytes'

data/lib/rext/object/metaclass.rb

@@ -0,0 +1,27 @@
+
+class Object
+  
+  ##
+  # Return the metaclass of this object.
+  
+  def metaclass
+    class << self; self end
+  end
+  
+  ##
+  # Evaluate a +string+ or +block+ in context to this
+  # object metaclass.
+  
+  def meta_eval string = nil, &block
+    return metaclass.class_eval(string) if string
+    metaclass.class_eval &block
+  end
+  
+  ##
+  # Define a singleton method.
+  
+  def meta_def name, &block
+    meta_eval { define_method name, &block }
+  end
+
+end

data/lib/rext/object.rb

@@ -0,0 +1,6 @@
+
+#--
+# Load Object specific rext extensions.
+#++
+
+require 'rext/object/metaclass'

data/lib/rext/string/helpers.rb

@@ -176,17 +176,29 @@ class String
   end
 
   ##
-  # First character.
+  # First +n+ character(s).
+  #
+  # === Examples
+  #
+  #   'foo'.first     # => f
+  #   'foo'.first(2)  # => fo
+  #
 
-  def first 
-    self[0,1]
+  def first n = 1
+    self[0,n]
   end
 
   ##
-  # Last character.
-
-  def last
-    self[-1, 1]
+  # Last +n+ character(s).
+  #
+  # === Examples
+  #
+  #   'bar'.last     # => r
+  #   'bar'.last(2)  # => ar
+  #
+  
+  def last n = 1
+    self[-n, n]
   end
   
 end

data/lib/rext/version.rb

@@ -1,4 +1,4 @@
 
 module Rext
-  VERSION = '0.0.3'
+  VERSION = '0.0.4'
 end

data/rext.gemspec

@@ -2,15 +2,15 @@
 
 Gem::Specification.new do |s|
   s.name = %q{rext}
-  s.version = "0.0.3"
+  s.version = "0.0.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-03-25}
   s.description = %q{Ruby extensions}
   s.email = %q{tj@vision-media.ca}
-  s.extra_rdoc_files = ["lib/rext/all.rb", "lib/rext/date/helpers.rb", "lib/rext/date.rb", "lib/rext/enumerable/helpers.rb", "lib/rext/enumerable.rb", "lib/rext/hash/helpers.rb", "lib/rext/hash.rb", "lib/rext/integer/helpers.rb", "lib/rext/integer/time.rb", "lib/rext/integer.rb", "lib/rext/module/helpers.rb", "lib/rext/module.rb", "lib/rext/proc/helpers.rb", "lib/rext/proc.rb", "lib/rext/string/escape.rb", "lib/rext/string/helpers.rb", "lib/rext/string.rb", "lib/rext/time/helpers.rb", "lib/rext/time.rb", "lib/rext/version.rb", "lib/rext.rb", "README.rdoc", "tasks/benchmark.rake", "tasks/docs.rake", "tasks/gemspec.rake", "tasks/spec.rake"]
-  s.files = ["benchmarks/enumerable.rb", "benchmarks/proc.rb", "History.rdoc", "lib/rext/all.rb", "lib/rext/date/helpers.rb", "lib/rext/date.rb", "lib/rext/enumerable/helpers.rb", "lib/rext/enumerable.rb", "lib/rext/hash/helpers.rb", "lib/rext/hash.rb", "lib/rext/integer/helpers.rb", "lib/rext/integer/time.rb", "lib/rext/integer.rb", "lib/rext/module/helpers.rb", "lib/rext/module.rb", "lib/rext/proc/helpers.rb", "lib/rext/proc.rb", "lib/rext/string/escape.rb", "lib/rext/string/helpers.rb", "lib/rext/string.rb", "lib/rext/time/helpers.rb", "lib/rext/time.rb", "lib/rext/version.rb", "lib/rext.rb", "Manifest", "Rakefile", "README.rdoc", "rext.gemspec", "spec/date_spec.rb", "spec/enumerable_spec.rb", "spec/hash_spec.rb", "spec/integer_spec.rb", "spec/module_spec.rb", "spec/spec_helper.rb", "spec/string_spec.rb", "spec/time_spec.rb", "tasks/benchmark.rake", "tasks/docs.rake", "tasks/gemspec.rake", "tasks/spec.rake", "Todo.rdoc"]
+  s.extra_rdoc_files = ["lib/rext/all.rb", "lib/rext/array/helpers.rb", "lib/rext/array.rb", "lib/rext/compat/basic_object.rb", "lib/rext/compat.rb", "lib/rext/date/helpers.rb", "lib/rext/date.rb", "lib/rext/enumerable/helpers.rb", "lib/rext/enumerable.rb", "lib/rext/hash/helpers.rb", "lib/rext/hash.rb", "lib/rext/integer/helpers.rb", "lib/rext/integer.rb", "lib/rext/module/helpers.rb", "lib/rext/module.rb", "lib/rext/numeric/bytes.rb", "lib/rext/numeric/time.rb", "lib/rext/numeric.rb", "lib/rext/object/metaclass.rb", "lib/rext/object.rb", "lib/rext/proc/helpers.rb", "lib/rext/proc.rb", "lib/rext/string/escape.rb", "lib/rext/string/helpers.rb", "lib/rext/string.rb", "lib/rext/time/helpers.rb", "lib/rext/time.rb", "lib/rext/version.rb", "lib/rext.rb", "README.rdoc", "tasks/benchmark.rake", "tasks/docs.rake", "tasks/gemspec.rake", "tasks/spec.rake"]
+  s.files = ["benchmarks/enumerable.rb", "benchmarks/proc.rb", "History.rdoc", "lib/rext/all.rb", "lib/rext/array/helpers.rb", "lib/rext/array.rb", "lib/rext/compat/basic_object.rb", "lib/rext/compat.rb", "lib/rext/date/helpers.rb", "lib/rext/date.rb", "lib/rext/enumerable/helpers.rb", "lib/rext/enumerable.rb", "lib/rext/hash/helpers.rb", "lib/rext/hash.rb", "lib/rext/integer/helpers.rb", "lib/rext/integer.rb", "lib/rext/module/helpers.rb", "lib/rext/module.rb", "lib/rext/numeric/bytes.rb", "lib/rext/numeric/time.rb", "lib/rext/numeric.rb", "lib/rext/object/metaclass.rb", "lib/rext/object.rb", "lib/rext/proc/helpers.rb", "lib/rext/proc.rb", "lib/rext/string/escape.rb", "lib/rext/string/helpers.rb", "lib/rext/string.rb", "lib/rext/time/helpers.rb", "lib/rext/time.rb", "lib/rext/version.rb", "lib/rext.rb", "Manifest", "Rakefile", "README.rdoc", "rext.gemspec", "spec/array_spec.rb", "spec/compat_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_helper.rb", "spec/string_spec.rb", "spec/time_spec.rb", "tasks/benchmark.rake", "tasks/docs.rake", "tasks/gemspec.rake", "tasks/spec.rake", "Todo.rdoc"]
   s.has_rdoc = true
   s.homepage = %q{http://github.com/visionmedia/rext}
   s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Rext", "--main", "README.rdoc"]

data/spec/array_spec.rb

@@ -0,0 +1,24 @@
+
+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
+    
+  end
+end

data/spec/compat_spec.rb

@@ -0,0 +1,28 @@
+
+require 'rext/compat'
+
+describe Rext do
+  describe "compatibility" do
+    describe BasicObject do
+      
+      before :each do
+        @object = BasicObject.new  
+      end
+      
+      it "should have no methods" do
+        lambda { @object.send }.should raise_error(NoMethodError)
+      end
+      
+      it "should preserve __* methods" do
+        lambda { @object.__send__ }.should_not raise_error(NoMethodError)
+      end
+      
+      it "should now allow additional ancestor methods to be accessed" do
+        module Kernel; def foo; end end
+        class Object; def foo; end end
+        lambda { @object.foo }.should raise_error(NoMethodError)
+      end
+      
+    end
+  end
+end

data/spec/date_spec.rb

@@ -3,13 +3,11 @@ 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/hash_spec.rb

@@ -3,7 +3,6 @@ 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 }
@@ -13,6 +12,5 @@ describe Hash do
         does_not_exist.should be_nil
       end
     end
-    
   end  
 end

data/spec/integer_spec.rb

@@ -15,22 +15,4 @@ describe Integer do
       end
     end
   end
-  
-  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
 end

data/spec/module_spec.rb

@@ -3,7 +3,6 @@ require 'rext/module'
 
 describe Module do
   describe "helpers" do
-    
     describe "#chain" do
       it "should allow chaining via super" do
         class Foo
@@ -33,6 +32,5 @@ describe Module do
         lambda { Foo.new.does_not_exist }.should raise_error(NoMethodError)
       end
     end
-    
   end
 end

data/spec/numeric_spec.rb

@@ -0,0 +1,20 @@
+
+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
+end

data/spec/object_spec.rb

@@ -0,0 +1,42 @@
+
+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
+end

data/spec/string_spec.rb

@@ -89,12 +89,20 @@ describe String 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 "#camelize" do

data/spec/time_spec.rb

@@ -3,7 +3,6 @@ require 'rext/time'
 
 describe Time do
   describe "helpers" do
-    
     describe "#in_words_since" do
       it "should convert time lost to words" do
         event = Time.now - 5.seconds
@@ -18,6 +17,5 @@ describe Time do
         event.in_words_since_now.should == 'hundreds of years'
       end
     end
-    
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: visionmedia-rext
 version: !ruby/object:Gem::Version 
-  version: 0.0.3
+  version: 0.0.4
 platform: ruby
 authors: 
 - TJ Holowaychuk
@@ -21,6 +21,10 @@ extensions: []
 
 extra_rdoc_files: 
 - lib/rext/all.rb
+- lib/rext/array/helpers.rb
+- lib/rext/array.rb
+- lib/rext/compat/basic_object.rb
+- lib/rext/compat.rb
 - lib/rext/date/helpers.rb
 - lib/rext/date.rb
 - lib/rext/enumerable/helpers.rb
@@ -28,10 +32,14 @@ extra_rdoc_files:
 - lib/rext/hash/helpers.rb
 - lib/rext/hash.rb
 - lib/rext/integer/helpers.rb
-- lib/rext/integer/time.rb
 - lib/rext/integer.rb
 - lib/rext/module/helpers.rb
 - lib/rext/module.rb
+- lib/rext/numeric/bytes.rb
+- lib/rext/numeric/time.rb
+- lib/rext/numeric.rb
+- lib/rext/object/metaclass.rb
+- lib/rext/object.rb
 - lib/rext/proc/helpers.rb
 - lib/rext/proc.rb
 - lib/rext/string/escape.rb
@@ -51,6 +59,10 @@ files:
 - benchmarks/proc.rb
 - History.rdoc
 - lib/rext/all.rb
+- lib/rext/array/helpers.rb
+- lib/rext/array.rb
+- lib/rext/compat/basic_object.rb
+- lib/rext/compat.rb
 - lib/rext/date/helpers.rb
 - lib/rext/date.rb
 - lib/rext/enumerable/helpers.rb
@@ -58,10 +70,14 @@ files:
 - lib/rext/hash/helpers.rb
 - lib/rext/hash.rb
 - lib/rext/integer/helpers.rb
-- lib/rext/integer/time.rb
 - lib/rext/integer.rb
 - lib/rext/module/helpers.rb
 - lib/rext/module.rb
+- lib/rext/numeric/bytes.rb
+- lib/rext/numeric/time.rb
+- lib/rext/numeric.rb
+- lib/rext/object/metaclass.rb
+- lib/rext/object.rb
 - lib/rext/proc/helpers.rb
 - lib/rext/proc.rb
 - lib/rext/string/escape.rb
@@ -75,11 +91,15 @@ files:
 - Rakefile
 - README.rdoc
 - rext.gemspec
+- spec/array_spec.rb
+- spec/compat_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_helper.rb
 - spec/string_spec.rb
 - spec/time_spec.rb

data/Todo.rdoc

@@ -1,15 +0,0 @@
-
-== Major:
-
-* in_words_since should == to_words_since?
-* Hash.new { |h,k| h[k.to_s] if k.is_a? Symbol }
-* best method for allowing map and others to utilize instance_eval and Proxy
-* move time stuff to Numeric not Integer
-
-== Minor:
-
-* Nothing
-
-== Brainstorming:
-
-* Nothing