rext 0.3.4

data/History.rdoc

@@ -0,0 +1,97 @@
+
+=== 0.3.4 / 2009-10-08
+
+  * Added metadef alias to meta_def
+  * Added #extendable
+
+=== 0.3.3 / 2009-08-24
+
+* Added Symbol#to_proc [#5]
+
+=== 0.3.2 / 2009-08-24
+
+* Added Symbol#to_proc [#5]
+
+=== 0.3.1 / 2009-08-17
+
+* Added #try
+* Fixed some requires
+
+=== 0.3.0 / 2009-08-11
+
+* Moved some string encoding related methods to string/encode.rb
+* Added String#to_md5 and String#to_sha512
+* Added autospec support
+
+=== 0.2.2 / 2009-06-12
+
+* Fixed require for libs previously removed
+
+=== 0.2.1 / 2009-06-10
+
+* Removed BasicObject due to compatibility issues with other libraries
+
+=== 0.2.0 / 2009-06-10
+
+* Added Enumerable#includes_all?
+
+=== 0.1.1 / 2009-06-10
+
+* Removed sketchy BasicObject #method_added hack for now
+* Added Module#setup
+* Added / Implemented Object#returning
+
+=== 0.1.0 / 2009-05-04
+
+* Added Module#call_method
+* Added String#word_frequency and String#frequency_of_word
+
+=== 0.0.8 / 2009-04-13
+
+* Added Array#chunk/in_groups_of
+* Added Array#pad
+
+=== 0.0.7 / 2009-04-08
+
+* Added Hash#switchify
+* Added String#switchify
+
+=== 0.0.6 / 2009-04-01
+
+* Added String#from
+
+=== 0.0.5 / 2009-04-01
+
+* Added Object#indifferent_hash [#3]
+* Added String#ends_with?
+* Added String#starts_with?
+* Refactored String#singular?
+* Removed Todo list, use lighthouse now
+
+=== 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 
+* Added String#base64_decode 
+* Added String#constantize
+* Added String#camelize
+
+=== 0.0.2 / 2009-03-23
+
+* Added Proc#yield_or_eval docs
+* Renamed class/helpers to module/helpers
+
+=== 0.0.1 / 2009-03-23
+
+* Initial release

data/Manifest

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

data/README.rdoc

@@ -0,0 +1,136 @@
+
+= Rext
+
+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
+
+  require 'rext/all'
+
+  # or 
+
+  require 'rext/string'
+  require 'rext/hash'
+  ...
+
+  # or 
+
+  require 'rext/string/escape'
+  require 'rext/enumerable/every'
+  ...
+
+== Extensions
+
+Below are the methods currently provided by Rext.
+
+* Object
+  - metaclass
+  - meta_def
+  - meta_eval
+  - indifferent_hash
+  - returning
+  - try
+
+* String
+  - url_encode
+  - url_decode
+  - base64_encode
+  - base64_decode
+  - html_escape
+  - merge_word / add_class
+  - digitize
+  - camelize
+  - constantize
+  - wrap
+  - starts_with?
+  - ends_with?
+  - plural?
+  - singular?
+  - first
+  - last
+  - from
+  - file
+  - files
+  - path
+  - switchify
+  - word_frequency
+  - frequency_of_word
+  - to_md5
+  - to_sha512
+
+* Integer
+  - ordanalize
+
+* Numeric
+  - bytes, kilobytes, etc
+  - seconds, minutes, hours, days, ...
+  - to_seconds, to_minutes, to_hours, ...
+  - ago / before
+  - since / from_now
+
+* Hash
+  - delete_at / extract!
+  - switchify
+
+* Time
+  - in_words_since / in_words_since_now
+  - to_time
+
+* Date
+  - to_time
+
+* Module
+  - chainable
+  - extendable
+  - call_method
+
+* Proc
+  - yield_or_eval
+
+* Enumerable
+  - group_by
+  - includes_all?
+  - every
+  
+* Symbol
+  - to_proc
+
+== Contrib
+
+Feel free to fork Rext on github, or submit a ticket:
+http://github.com/visionmedia/rext/issues
+
+== License
+
+(The MIT License)
+
+Copyright (c) 2009 TJ Holowaychuk <tj@vision-media.ca>
+
+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, an d/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.
+ALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,16 @@
+
+$:.unshift 'lib'
+require 'rext'
+require 'rubygems'
+require 'rake'
+require 'echoe'
+
+Echoe.new "rext", Rext::VERSION do |p|
+  p.author = "TJ Holowaychuk"
+  p.email = "tj@vision-media.ca"
+  p.summary = "Ruby extensions"
+  p.url = "http://github.com/visionmedia/rext"
+  p.runtime_dependencies = []
+end
+
+Dir['tasks/**/*.rake'].sort.each { |lib| load lib }

data/benchmarks/enumerable.rb

@@ -0,0 +1,14 @@
+
+list = %w( just some random foo bar like cookies )
+
+benchmark 'Enumerable#group_by', :times => $times do
+  report 'with block' do 
+    list.group_by { |item| item.length } 
+  end
+  report 'with evaled block' do 
+    list.group_by { length }
+  end
+  report 'with proxy' do 
+    list.group_by.length
+  end
+end

data/benchmarks/proc.rb

@@ -0,0 +1,24 @@
+
+def yield_or_eval_test &block
+  block.yield_or_eval 'foo'
+end
+
+def manual &block
+  foo = 'foo'
+  if block.arity > 0
+    yield foo
+  else
+    foo.instance_eval &block
+  end
+end
+
+benchmark 'Proc', :times => $times do
+  report '#yield_or_eval' do 
+    yield_or_eval_test { length }
+    yield_or_eval_test { |foo| foo.length }
+  end
+  report 'manual arity check' do 
+    manual { length }
+    manual { |foo| foo.length }
+  end
+end

data/lib/rext.rb

@@ -0,0 +1,24 @@
+#--
+# Copyright (c) 2009 TJ Holowaychuk <tj@vision-media.ca>
+#
+# 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.
+#++
+
+require 'rext/version'

data/lib/rext/all.rb

@@ -0,0 +1,18 @@
+
+#--
+# Load all extensions.
+#++
+
+require 'rext/version'
+require 'rext/symbol'
+require 'rext/object'
+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'
+require 'rext/time'

data/lib/rext/array.rb

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

data/lib/rext/array/helpers.rb

@@ -0,0 +1,64 @@
+
+require 'enumerator'
+
+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
+  
+  ##
+  # Pad array with expected length +n+, and +pad_with+ an
+  # optional object or nil.
+  #
+  # === Examples
+  #
+  #   [1,2].pad(4)  # => [1,2,nil,nil]
+  #   [1,2].pad(4)  # => [1,2,'x','x']
+  #   [1,2].pad(2)  # => [1,2]
+  #
+  
+  def pad n, pad_with = nil
+    fill pad_with, length, n - length
+  end
+  
+  ##
+  # Split an array into chunks of length +n+. Optionally you
+  # may +pad_with+ an object to retain a uniform length per chunk.
+  #
+  # === Examples
+  #
+  #   [1,2,3].chunk(2)         # => [[1,2], [3, nil]]
+  #   [1,2,3].chunk(2, 'x')    # => [[1,2], [3, 'x']]
+  #   [1,2,3].chunk(2, false)  # => [[1,2], [3]]
+  #   [1,2,3].in_groups_of(2) do |chunk|
+  #     # Do something
+  #   end
+  #
+  # === See
+  #
+  # * Array#pad
+  #
+  
+  def chunk n, pad_with = nil, &block
+    returning [] do |chunks|
+      each_slice n do |chunk|
+        chunk.pad n, pad_with unless pad_with == false
+        yield chunk if block
+        chunks << chunk
+      end
+    end
+  end
+  alias :in_groups_of :chunk
+  
+end