rext 0.3.4

data/lib/rext/object/metaclass.rb

@@ -0,0 +1,29 @@
+
+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
+  alias :metaeval :meta_eval
+  
+  ##
+  # Define a singleton method.
+  
+  def meta_def name, &block
+    meta_eval { define_method name, &block }
+  end
+  alias :metadef :meta_def
+
+end

data/lib/rext/proc.rb

@@ -0,0 +1,7 @@
+
+
+#--
+# Load Proc specific rext extensions.
+#++
+
+require 'rext/proc/helpers'

data/lib/rext/proc/helpers.rb

@@ -0,0 +1,22 @@
+
+class Proc
+  
+  ##
+  # Yield or instance evaluate the +object+ passed
+  # based on this proc's arity.
+  #
+  # === Examples
+  #
+  #   def foo &block
+  #     block.yield_or_eval 'bar'
+  #   end
+  #
+  #   foo { |v| v.length }  # => 3
+  #   foo { length }        # => 3
+  #
+  
+  def yield_or_eval object
+    arity > 0 ? self.call(object) : object.instance_eval(&self)
+  end
+  
+end

data/lib/rext/string.rb

@@ -0,0 +1,7 @@
+
+#--
+# Load String specific rext extensions.
+#++
+
+require 'rext/string/encode'
+require 'rext/string/helpers'

data/lib/rext/string/encode.rb

@@ -0,0 +1,82 @@
+
+require 'rack'
+require 'digest/sha2'
+require 'digest/md5'
+
+class String
+  
+  ##
+  # Return 32 character md5 string.
+  #
+  # === Examples
+  #
+  #  'test'.to_md5  # => 098f6bcd4621d373cade4e832627b4f6
+  #
+  
+  def to_md5
+    ::Digest::MD5.hexdigest self
+  end
+  
+  ##
+  # Return 128 character sha512 string.
+  #
+  # === Examples
+  #
+  #  'test'.to_sha512  # => ee26b0dd4af7e749aa1a8ee3c10ae9923f618980772e473f8819a5d4940e0db27ac185f8a0e1d5f84f88bc887fd67b143732c304cc5fa9ad8e6f57f50028a8ff
+  #
+  
+  def to_sha512
+    ::Digest::SHA512.hexdigest self
+  end
+  
+  ##
+  # Return Base 64 decoded string.
+  #
+  # === Examples
+  #
+  #  'Y29va2llcw=='.base64_decode  # => cookies
+  #
+    
+  def base64_decode
+    unpack('m').first
+  end
+  
+  ##
+  # Return Base 64 encoded string.
+  #
+  # === Examples
+  #
+  #  'cookies'.base64_encode  # => Y29va2llcw==
+  #
+  
+  def base64_encode
+    [self].pack('m').chop
+  end
+  
+  ##
+  # URL encode. Shortcut for Rack::Utils.encode.
+
+  def url_encode
+    Rack::Utils.escape self
+  end
+
+  ##
+  # URL decode. Shortcut for Rack::Utils.unescape.
+
+  def url_decode
+    Rack::Utils.unescape self
+  end
+
+  ##
+  # Escape html entities. Shortcut for Rack::Utils.escape_html.
+  #
+  # === Examples
+  #
+  #   'im <strong>strong</strong>.escape_html  # => im &lt;strong&gt;strong&lt;/strong&gt;
+  #
+
+  def escape_html
+    Rack::Utils.escape_html self
+  end
+  
+end

data/lib/rext/string/helpers.rb

@@ -0,0 +1,246 @@
+
+require 'extlib'
+
+class String
+  
+  ##
+  # Returns a File instance.
+  #
+  # === Examples
+  #
+  #   'History.rdoc'.file.mtime
+  #
+  
+  def file
+    File.new self
+  end
+  
+  ##
+  # Returns a Pathname instance.
+  #
+  # === Examples
+  #
+  #   'lib'.path.join('foo').expand_path
+  #
+  
+  def path
+    require 'pathname'
+    Pathname.new self
+  end
+  
+  ##
+  # Returns an array of files matching self.
+  #
+  # === Examples
+  #
+  #  'lib/**/*.rb'.files
+  #
+  
+  def files
+    Dir[self]
+  end
+  
+  ##
+  # Merge the +word+ passed into the string. This
+  # is useful for adding classes which may already 
+  # exist in a string.
+  #
+  # === Examples 
+  #
+  #   'product'.merge_word('sold')        # => "product sold"
+  #   'product sold'.merge_word('sold')   # => "product sold"
+  #
+  
+  def merge_word word
+    self << " #{word}" unless split.include? word
+    self
+  end
+  alias :add_class :merge_word
+  
+  ##
+  # Digitize a string.
+  #
+  # === Examples:
+  #
+  #  '$100,000'.digitize  # => 100000
+  #
+  
+  def digitize
+    gsub /[^\d]/, ''
+  end
+  
+  ##
+  # Returns a constant when the string is a valid constant name.
+  
+  def constantize
+    Extlib::Inflection.constantize self
+  end
+  
+  ##
+  # Convert a string to camel-case, and optionally +capitalize_first_letter+.
+  
+  def camelize capitalize_first_letter = false
+    string = Extlib::Inflection.camelize(self)
+    return string if capitalize_first_letter
+    string[0,1] = string.first.downcase
+    string
+  end
+  
+  ##
+  # Wrap a string with a +prefix+ and optional
+  # +suffix+. When the +suffix+ is not present
+  # the +prefix+ will be used.
+  #
+  # === Examples
+  #
+  #   'foo'.wrap('|')       # => |foo|
+  #   'foo'.wrap('(', ')')  # => (foo)
+  #
+  
+  def wrap prefix, suffix = nil
+    prefix + self + (suffix || prefix)
+  end
+  
+  ##
+  # Check if a string starts with another +string+.
+  #
+  # === Examples
+  #
+  #   'foo bar'.starts_with? 'foo'  # => true
+  #
+
+  def starts_with? string
+    index(string) == 0
+  end
+  
+  ##
+  # Check if a string ends with another +string+.
+  #
+  # === Examples
+  #
+  #   'foo bar'.ends_with? 'bar'  # => true
+  #
+
+  def ends_with? string
+    rindex(string) == length - string.length
+  end
+  
+  ##
+  # Determines if a string is plural.
+  #
+  # === Examples
+  #
+  #   'cookies'.plural?  # => true
+  #   'cookie'.plural?   # => false
+  #
+
+  def plural?
+    singular != self
+  end
+
+  ##
+  # Determines if a string is singular.
+  #
+  # === Examples
+  #
+  #   'cookies'.singular?  # => false
+  #   'cookie'.singular?   # => true
+  #
+
+  def singular?
+    not plural?
+  end
+
+  ##
+  # First +n+ character(s).
+  #
+  # === Examples
+  #
+  #   'foo'.first     # => f
+  #   'foo'.first(2)  # => fo
+  #
+
+  def first n = 1
+    self[0, n]
+  end
+
+  ##
+  # Last +n+ character(s).
+  #
+  # === Examples
+  #
+  #   'bar'.last     # => r
+  #   'bar'.last(2)  # => ar
+  #
+  
+  def last n = 1
+    self[-n, n]
+  end
+  
+  ##
+  # All characters after +n+.
+  #
+  # === Examples
+  #
+  #   '.css'.from(1)  #=> css
+  #
+  
+  def from n
+    self[n, length]
+  end
+  
+  ##
+  # Replace all underscores with hyphens.
+
+  def dasherize
+    tr '_', '-'
+  end
+  
+  ##
+  # Return hash of word frequencies.
+  #
+  # === Examples
+  #
+  #   'foo foo bar'.word_frequency 
+  #   # => { 'foo' => 2, 'bar' => 1 }
+  #
+  
+  def word_frequency
+    split.inject Hash.new(0) do |frequencies, word|
+      frequencies[word] += 1
+      frequencies
+    end
+  end
+  
+  ##
+  # Return frequency of _word_ or 0.
+  #
+  # === Examples
+  #
+  #   'foo foo bar'.frequency_of_word('foo') # => 2
+  #   'foo foo bar'.frequency_of_word('bar') # => 1
+  #
+  
+  def frequency_of_word word
+    word_frequency[word]
+  end
+  
+  class InvalidSwitchError < StandardError; end
+  
+  ##
+  # Returns the switch equivilant of this string.
+  #
+  # === Examples
+  #
+  #  'foo_bar'.switchify         # => --foo-bar
+  #  'lots_of_foobar'.switchify  # => --lots-of-foobar
+  #  't'.switchify               # => -t
+  #  ''.switchify                # => InvalidSwitchError
+  #
+  
+  def switchify
+    raise InvalidSwitchError, 'switch must have a length > 0' if length.zero?
+    length > 1 ? "--#{dasherize}" : "-#{self}"
+  end
+    
+end

data/lib/rext/symbol.rb

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

data/lib/rext/symbol/helpers.rb

@@ -0,0 +1,16 @@
+
+class Symbol
+  
+  ##
+  # Return a proc which sends itself as a message
+  # to the first proc argument.
+  #
+  # === Examples
+  #
+  #  %w( some foo bar ).map(&:length)  # => [4, 3, 3]
+  #
+  
+  def to_proc
+    Proc.new { |object| object.send self }
+  end
+end

data/lib/rext/time.rb

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

data/lib/rext/time/helpers.rb

@@ -0,0 +1,43 @@
+
+class Time
+  
+  def to_time #:nodoc:
+    self
+  end
+  
+  ##
+  # Time in words since +time+ or now.
+  #
+  # === Examples
+  #
+  #   5.seconds.ago.in_words_since_now  # => less than one minute
+  #   5.days.ago.in_words_since_now     # => 5 days
+  #   1.month.ago.in_words_since_now    # => 1 month
+  #   101.years.ago.in_words_since_now  # => hundreds of years
+  #
+  #   "the article was published #{article.created_at.in_words_since_now} ago"  
+  #   # => the article was published 15 minutes ago
+  #
+
+  def in_words_since time = Time.now
+    return if self > time
+    seconds = (time - self).to_i
+    # TODO: abstract this out
+    pluralize = lambda do |type| 
+      n = seconds.send(:"to_#{type}s")
+      n == 1 ? "one #{type}" : "#{n} #{type}s"
+    end
+    case seconds
+    when 0..59                ; 'less than one minute'
+    when 1.minute..59.minutes ; pluralize[:minute]
+    when 1.hour..23.hours     ; pluralize[:hour]
+    when 1.day..6.days        ; pluralize[:day]
+    when 1.week..3.weeks      ; pluralize[:week]
+    when 1.month..11.months   ; pluralize[:month]
+    when 1.year..99.years     ; pluralize[:year]
+    else 'hundreds of years'
+    end
+  end
+  alias :in_words_since_now :in_words_since
+  
+end