mack_ruby_core_extensions 0.0.5 → 0.1.1

data/doc/files/lib/extensions/float_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Tue Mar 25 17:56:02 -0400 2008</td>
+      <td>Tue Mar 25 20:37:52 -0400 2008</td>
     </tr>
     </table>
   </div>

data/doc/files/lib/extensions/hash_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Tue Mar 25 15:42:07 -0400 2008</td>
+      <td>Wed Mar 26 19:19:12 -0400 2008</td>
     </tr>
     </table>
   </div>
@@ -69,6 +69,13 @@
   <div id="contextContent">
 
 
+    <div id="requires-list">
+      <h3 class="section-bar">Required files</h3>
+
+      <div class="name-list">
+      uri&nbsp;&nbsp;
+      </div>
+    </div>
 
    </div>
 

data/doc/files/lib/extensions/kernel_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Fri Mar 14 12:40:30 -0400 2008</td>
+      <td>Wed Mar 26 10:20:07 -0400 2008</td>
     </tr>
     </table>
   </div>

data/doc/files/lib/extensions/math_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Fri Mar 14 12:40:30 -0400 2008</td>
+      <td>Tue Mar 25 20:37:52 -0400 2008</td>
     </tr>
     </table>
   </div>

data/doc/files/lib/extensions/method_not_implemented_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Fri Mar 14 12:40:30 -0400 2008</td>
+      <td>Tue Mar 25 20:37:52 -0400 2008</td>
     </tr>
     </table>
   </div>

data/doc/files/lib/extensions/module_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Tue Mar 25 15:42:41 -0400 2008</td>
+      <td>Tue Mar 25 20:37:52 -0400 2008</td>
     </tr>
     </table>
   </div>

data/doc/files/lib/extensions/nil_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Tue Mar 25 15:42:51 -0400 2008</td>
+      <td>Tue Mar 25 20:37:52 -0400 2008</td>
     </tr>
     </table>
   </div>

data/doc/files/lib/extensions/object_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Tue Mar 25 17:28:02 -0400 2008</td>
+      <td>Wed Mar 26 14:44:19 -0400 2008</td>
     </tr>
     </table>
   </div>

data/doc/files/lib/extensions/string_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Tue Mar 25 17:47:44 -0400 2008</td>
+      <td>Tue Mar 25 20:37:52 -0400 2008</td>
     </tr>
     </table>
   </div>

data/doc/files/lib/extensions/symbol_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Fri Mar 14 12:40:30 -0400 2008</td>
+      <td>Tue Mar 25 20:37:52 -0400 2008</td>
     </tr>
     </table>
   </div>

data/doc/files/lib/mack_ruby_core_extensions_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Tue Mar 25 17:56:57 -0400 2008</td>
+      <td>Wed Mar 26 10:23:16 -0400 2008</td>
     </tr>
     </table>
   </div>

data/doc/files/lib/utils/inflections_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Tue Mar 25 16:34:03 -0400 2008</td>
+      <td>Tue Mar 25 20:37:52 -0400 2008</td>
     </tr>
     </table>
   </div>

data/doc/files/lib/utils/inflector_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Tue Mar 25 17:26:23 -0400 2008</td>
+      <td>Tue Mar 25 20:37:52 -0400 2008</td>
     </tr>
     </table>
   </div>

data/doc/fr_file_index.html

@@ -26,7 +26,6 @@
     <a href="files/lib/extensions/float_rb.html">lib/extensions/float.rb</a><br />
     <a href="files/lib/extensions/hash_rb.html">lib/extensions/hash.rb</a><br />
     <a href="files/lib/extensions/kernel_rb.html">lib/extensions/kernel.rb</a><br />
-    <a href="files/lib/extensions/logger_rb.html">lib/extensions/logger.rb</a><br />
     <a href="files/lib/extensions/math_rb.html">lib/extensions/math.rb</a><br />
     <a href="files/lib/extensions/method_not_implemented_rb.html">lib/extensions/method_not_implemented.rb</a><br />
     <a href="files/lib/extensions/module_rb.html">lib/extensions/module.rb</a><br />

data/lib/extensions/hash.rb

@@ -1,3 +1,4 @@
+require 'uri'
 class Hash
   
   def join(pair_string, join_string)
@@ -24,7 +25,7 @@ class Hash
       if v.is_a?(Hash)
         stack << [k,v]
       else
-        v = Rack::Utils.escape(v) if escape
+        v = URI.escape(v.to_s) if escape
         params << "#{k}=#{v}&"
       end
     end
@@ -34,7 +35,7 @@ class Hash
         if v.is_a?(Hash)
           stack << ["#{parent}[#{k}]", v]
         else
-          v = Rack::Utils.escape(v) if escape
+          v = URI.escape(v.to_s) if escape
           params << "#{parent}[#{k}]=#{v}&"
         end
       end

data/lib/extensions/kernel.rb

@@ -3,7 +3,7 @@ require 'stringio'
 
 module Kernel
   
-  def self.pp_to_s(object)
+  def pp_to_s(object)
     pp_out = StringIO.new
     PP.pp(object,pp_out)
     return pp_out.string
@@ -20,7 +20,11 @@ module Kernel
         return yield
       rescue #{retry_exceptions.join(", ")} => e
         retries -= 1
-        retry if retries > 0
+        if retries > 0
+          retry
+        else
+          raise e
+        end
       end        
     }
 

data/lib/extensions/object.rb

@@ -6,12 +6,18 @@ class Object
     self.to_s
   end
   
+  # Uses <code>define_method</code> to create an empty for the method parameter defined.
+  # That method will then raise MethodNotImplemented. This is useful for creating interfaces
+  # and you want to stub out methods that others need to implement.
   def self.needs_method(meth)
     define_method(meth) do
       raise MethodNotImplemented.new(meth)
     end
   end
   
+  # This prints out running time for the block provided. This is great for things
+  # like Rake tasks, etc... where you would like to know how long it, or a section of
+  # it took to run.
   def running_time(message = "", logger = nil)
     s_time = Time.now
     s = "---Starting at #{s_time}---"
@@ -33,45 +39,49 @@ class Object
     logger.info x unless logger.nil?
   end
   
+  # This method will call send to all the methods defined on the previous method.
+  # 
+  # Example:
+  #   Fruit.send_with_chain([:new, :get_citrus, :get_orange, :class]) # => Orange
+  # 
+  # This would be the equivalent:
+  #   Fruit.new.get_citrus.get_orange.class
   def send_with_chain(methods, *args)
     obj = self
-    methods = [methods] unless methods.is_a?(Array)
-    methods.each {|m| obj = obj.send(m, *args)}
+    [methods].flatten.each {|m| obj = obj.send(m, *args)}
     obj
   end
   
-=begin
-  ivar_cache allows you to cache the results of the block into an instance variable in a class,
-  and then will serve up that instance variable the next time you call that method again.
-
-  old way:
-  def show_page_link
-    unless @show_page_link # check if instance variable exists
-      # if the instance variable doesn't exist let's do some work and assign it to the instance variable.
-      @show_page_link = link_to("show", some_url(:id => self.id, :foo => bar, etc... => etc))
-    end
-    @show_page_link # now return the instance variable
-  end
-
-  new way:
-  def show_page_link
-    ivar_cache do
-      link_to("show", some_url(:id => self.id, :foo => bar, etc... => etc))
-    end
-  end
-
-  this does everything the old way did, but it is much cleaner, and a lot less code!
-  in case you're wondering it caches the result, by default, to an instance variable named after the method,
-  so in our above example the instance variable would be name, @show_page_link. this can be overridden like such:
-
-  def show_page_link
-    ivar_cache("foo_var") do
-      link_to("show", some_url(:id => self.id, :foo => bar, etc... => etc))
-    end
-  end
-
-  now it will cache it to @foo_var
-=end  
+  # ivar_cache allows you to cache the results of the block into an instance variable in a class,
+  # and then will serve up that instance variable the next time you call that method again.
+  # 
+  # old way:
+  #   def show_page_link
+  #     unless @show_page_link # check if instance variable exists
+  #       # if the instance variable doesn't exist let's do some work and assign it to the instance variable.
+  #       @show_page_link = link_to("show", some_url(:id => self.id, :foo => bar, etc... => etc))
+  #     end
+  #     @show_page_link # now return the instance variable
+  #   end
+  # 
+  # new way:
+  #   def show_page_link
+  #     ivar_cache do
+  #       link_to("show", some_url(:id => self.id, :foo => bar, etc... => etc))
+  #     end
+  #   end
+  # 
+  # this does everything the old way did, but it is much cleaner, and a lot less code!
+  # in case you're wondering it caches the result, by default, to an instance variable named after the method,
+  # so in our above example the instance variable would be name, <code>@show_page_link</code>. this can be overridden like such:
+  # 
+  #   def show_page_link
+  #     ivar_cache("foo_var") do
+  #       link_to("show", some_url(:id => self.id, :foo => bar, etc... => etc))
+  #     end
+  #   end
+  # 
+  # now it will cache it to <code>@foo_var</code>
   def ivar_cache(var_name = nil, &block)
     if var_name.nil?
       call = caller[0]
@@ -89,18 +99,19 @@ class Object
       call = caller[0]
       var_name = call[(call.index('`')+1)...call.index("'")]
     end
-    remove_instance_variable("@#{var_name}") rescue
+    remove_instance_variable("@#{var_name}") #rescue
     yield if block_given?
   end
   
+  # Returns the namespaces for a particular object.
+  # 
+  # Examples:
+  #   Animals::Dog::Poodle.new.namespaces # => ["Animals", "Dog"]
   def namespaces
     ivar_cache("object_namespaces") do
       nss = []
       full_name = self.class.name.to_s
-      ns = full_name.split("::")
-      ns.each do |n|
-        nss << n
-      end
+      nss = full_name.split("::")
       nss.pop
       nss
     end

data/lib/mack_ruby_core_extensions.rb

@@ -2,6 +2,6 @@
   require "utils/#{k}"
 end
 
-[:array, :class, :float, :hash, :kernel, :logger, :math, :method_not_implemented, :module, :nil, :object, :string, :symbol].each do |k|
+[:array, :class, :float, :hash, :kernel, :math, :method_not_implemented, :module, :nil, :object, :string, :symbol].each do |k|
   require "extensions/#{k}"
 end

data/test/extensions/float_test.rb

@@ -4,6 +4,8 @@ class FloatTest < Test::Unit::TestCase
 
   def test_prec
     assert_equal 1.1, 1.1234.prec(1)
+    assert_equal 1.12, 1.1234.prec(2)
+    assert_equal 1.0, 1.0.prec(1)
   end
   
 end

data/test/extensions/hash_test.rb

@@ -1,12 +1,5 @@
 require File.dirname(__FILE__) + '/../test_helper.rb'
-
 class HashTest < Test::Unit::TestCase
-
-  def setup
-  end
-  
-  def teardown
-  end
   
   def test_minus
     h = {:a => "aaa", :b => "bbb", :c => "ccc"}
@@ -31,4 +24,27 @@ class HashTest < Test::Unit::TestCase
     assert ("rel=\"nofollow\" alt=\"pickles\"" == h.join("%s=\"%s\"", " ") || "alt=\"pickles\" rel=\"nofollow\"" == h.join("%s=\"%s\"", " "))
   end
   
+  def test_to_params
+    h = {:a => "aaa", :b => "bbb", :c => "ccc"}
+    assert(h.to_params == "a=aaa&b=bbb&c=ccc" ||
+           h.to_params == "b=bbb&c=ccc&a=aaa" || 
+           h.to_params == "b=bbb&c=ccc&a=aaa" || 
+           h.to_params == "b=bbb&a=aaa&c=ccc")
+
+    h = {:a => "aaa", :b => "bbb", :c => "Hello World!"}
+
+    assert(h.to_params == "b=bbb&c=Hello%20World!&a=aaa" ||
+           h.to_params == "b=bbb&a=aaa&c=Hello%20World!")
+           
+    assert(h.to_params(false) == "b=bbb&c=Hello World!&a=aaa" ||
+           h.to_params(false) == "b=bbb&a=aaa&c=Hello World!")
+    
+    h = {:a => "aaa", :b => {:one => "won", :two => "too"}}
+    assert_equal "a=aaa&b[one]=won&b[two]=too", h.to_params
+    
+    h = {:one => "one", :two => "too", :three => 3}
+    assert_match "three=3", h.to_params
+    
+  end
+  
 end

data/test/extensions/kernel_test.rb

@@ -2,14 +2,17 @@ require File.dirname(__FILE__) + '/../test_helper.rb'
 
 class KernelTest < Test::Unit::TestCase
 
-  def setup
+  def test_pp_to_s
+    x = pp_to_s([1, 2, :three, "four"])
+    assert_equal %{[1, 2, :three, \"four\"]\n}, x
   end
   
-  def teardown
+  def test_retryable
+    assert_equal 1, retryable { 1 }
+    assert_raise(Exception) { retryable { raise Exception.new } }
+    assert_raise(TypeError) { retryable { retryable { 1 + nil} } }
+    assert_raise(TypeError) { retryable { retryable(:on => NameError) { 1 + nil} } }
   end
   
-  # replace this with tests of your own.
-  def test_truth
-    assert true
-  end
+
 end

data/test/extensions/math_test.rb

@@ -2,14 +2,29 @@ require File.dirname(__FILE__) + '/../test_helper.rb'
 
 class MathTest < Test::Unit::TestCase
 
-  def setup
+  def test_log2
+    assert_equal 2.32193, Math.log2(5).prec(5)
+    assert_equal 4.64386, Math.log2(25).prec(5)
   end
   
-  def teardown
+  def test_min
+    assert_equal 2, Math.min(2, 5)
+    assert_equal 2, Math.min(5, 2)
+    assert_equal 2, Math.min(2, 2)
+    assert_equal 2.0, Math.min(2, 5)
+    assert_equal 2.5, Math.min(5.1, 2.5)
+    assert_equal 2.12, Math.min(2.12, 2.54)
+    assert_raise(ArgumentError) { assert_equal 2, Math.min(2, nil) }
   end
   
-  # replace this with tests of your own.
-  def test_truth
-    assert true
+  def test_max
+    assert_equal 5, Math.max(2, 5)
+    assert_equal 5, Math.max(5, 2)
+    assert_equal 2, Math.max(2, 2)
+    assert_equal 5, Math.max(2, 5)
+    assert_equal 5.1, Math.max(5.1, 2.5)
+    assert_equal 2.54, Math.max(2.12, 2.54)
+    assert_raise(ArgumentError) { assert_equal 2, Math.max(2, nil) }
   end
+
 end