utilities 0.0.8 → 0.0.9

data/lib/utilities.rb

@@ -48,24 +48,9 @@ class String
   def to_time
     Time.parse(self)
   end
-
-  # Transform self to a float representation of a time (HH:MM)
-  # Ex: "14:30" => 14.5, "12h00" => 12.0
-  def hour_to_float
-    hour, min = split(/:|h/)
-    hour.to_f + min.to_f / 60.0
-  end
 end
 
 class Numeric
-  # Transform self to a string formatted time (HH:MM)
-  # Ex: 14.5 => "14:30"
-  def hour_to_string delimiter = ':'
-    hour  = self.to_i
-    min   = "%02d" % (self.abs * 60 % 60).to_i
-    "#{hour}#{delimiter}#{min}"
-  end
-
   # Convert to degrees
   def degrees
     self * Math::PI / 180
@@ -76,6 +61,13 @@ class Numeric
     self * self
   end
   
+  #Transform self to a string formatted time (HH:MM) Ex: 14.5 => “14:30“
+  def hour_to_string delimiter = ':'
+    hour  = self.to_i
+    min   = "%02d" % (self.abs * 60 % 60).to_i
+    "#{hour}#{delimiter}#{min}"
+  end
+  
   # Return the square root of self
   def sqrt
     Math.sqrt(self)
@@ -100,10 +92,18 @@ class Numeric
 end
 
 module Utilities
-  module Subclasses
-    # Find every subclass of an object
+  module Submodules
+    # Find every submodules of an object.
+    def submodules
+      constants.collect{ |const_name| const_get(const_name) }.select{ |const| const.class == Module }
+    end
+  end
+  
+  module Subclasses    
+    # Find every subclass of an object.
     def subclasses(direct = false)
       classes = []
+      
       if direct
         ObjectSpace.each_object(Class) do |c|
           classes << c if c.superclass == self
@@ -113,21 +113,15 @@ module Utilities
           classes << c if c.ancestors.include?(self) and (c != self)
         end
       end
+      
       classes
     end
   end
-
-  module Submodules
-    # Find every submodules of an object
-    def submodules
-      constants.collect{ |const_name| const_get(const_name) }.select{ |const| const.class == Module }
-    end
-  end
-
+  
   module Statistics
     # Add each object of the array to each other in order to get the sum, as long as all objects respond to + operator
     def sum
-      inject( :+ )
+      flatten.compact.inject( :+ )
     end
     
     # Calculate squares of each item
@@ -149,7 +143,8 @@ module Utilities
     
     # Calculate the mean of the array, as long as all objects respond to / operator
     def mean
-      (size > 0) ? sum.to_f / size : 0.0
+      a = flatten.compact.to_stat
+      (a.size > 0) ? a.sum.to_f / a.size : 0.0
     end
     alias_method :average, :mean
     
@@ -183,7 +178,7 @@ module Utilities
     
     # Return the first quartile of self
     def first_quartile( already_sorted = false )
-      return nil if empty?
+      return nil unless size >= 4
       a = already_sorted ? self : sort
       a[0..((size / 2) - 1)].extend(Utilities::Statistics).median( true )
     end
@@ -191,7 +186,7 @@ module Utilities
     
     # Return the last quartile of self
     def last_quartile( already_sorted = false )
-      return nil if empty?
+      return nil unless size >= 4
       a = already_sorted ? self : sort
       a[((size / 2) + 1)..-1].extend(Utilities::Statistics).median( true )
     end
@@ -205,7 +200,7 @@ module Utilities
     
     # Calculate the interquartile range of self
     def interquartile_range( already_sorted = false )
-      return nil if empty?
+      return nil unless size >= 4
       a = sort_and_extend( already_sorted )
       a.last_quartile - a.first_quartile
     end
@@ -267,6 +262,19 @@ module Utilities
 end
 
 class Array
+  # Returns true if the array contains only numerical values
+  def numerics?( allow_nil = false )
+    (allow_nil ? compact : self).reject{ |x| x.is_a?( Numeric ) }.empty?
+  end
+  alias_method :numeric?, :numerics?
+  alias_method :narray?, :numerics?
+  
+  # Transforms an array
+  def to_numerics
+    map{ |x| x.to_f }
+  end
+  alias_method :to_numeric, :to_numerics
+  alias_method :to_narray, :to_numerics
   
   # Returns a copy of self reverse sorted
   def reverse_sort
@@ -284,9 +292,11 @@ class Array
   def to_stat
     dup.to_stat!
   end
+  alias_method :to_stats, :to_stat
   
   # Adds the statistics methods to self
   def to_stat!
     extend(Utilities::Statistics)
   end
+  alias_method :to_stats!, :to_stat!
 end

data/lib/version.rb

@@ -1,7 +1,7 @@
 class Utilities
   MAJOR = 0
   MINOR = 0
-  BUILD = 8
+  BUILD = 9
 
   VERSION = "#{MAJOR}.#{MINOR}.#{BUILD}"
 end

data/test/test_utilities.rb

@@ -0,0 +1,63 @@
+require '../lib/utilities'
+
+describe Range do
+  it "#intersection should returns a range containing elements common to the two ranges, with no duplicates" do
+    (1..10).intersection(5..15).should == (5..10)
+    (1..10).intersection(15..25).should == nil
+  end
+  
+  it "#empty? should returns true if given Range is empty" do
+    # Can a range be empty?
+  end
+  
+  it "#overlap? should returns true if the given Range overlaps the other" do
+    (1..5).overlap?(10..20).should == false
+    (1..5).overlap?(4..9).should == true
+    (1..5).overlap?(5..10).should == true
+    (1...5).overlap?(5..10).should == false
+  end
+end
+
+describe Numeric do
+  it "#degrees should returns the right degrees for any given Numeric" do
+    0.degrees.should   == 0
+    90.degrees.should  == Math::PI / 2
+    180.degrees.should == Math::PI
+    360.degrees.should == Math::PI * 2
+  end
+  
+  it "#square should returns the square of any given Numeric (based on Numeric ** method)" do
+    (-5..5).each do |i|
+      i.square.should == i**2
+    end
+  end
+  
+  it "#sqrt should returns the square root of any given Numeric (based on Math::sqrt)" do
+    (1..25).each do |i|
+      i.sqrt.should == Math::sqrt(i)
+    end
+  end
+  
+  it "#rank should returns the rank of any given Numeric" do
+    1.rank(1, 5).should == (1.0 - 1.0) / (5.0 - 1.0)
+    5.rank(3, 9).should == (5.0 - 3.0) / (9.0 - 3.0)
+    -4.rank(1, 5).should == (-4.0 - 1.0) / (5.0 - 1.0)
+    1.rank(1, 1).should == 0.0
+  end
+  
+  it "#to_decimals should return a string of format %.nf" do
+    1.to_decimals(1).should == "1.0"
+    1.to_decimals(4).should == "1.0000"
+    1.983.to_decimals.should == "1.98"
+    1.987.to_decimals.should == "1.99"
+    -1.531.to_decimals.should == "-1.53"
+  end
+  
+  it "#percentage_of should return the percent of any given Numeric on n" do
+    1.percentage_of(100).should == 1
+    1.percentage_of(50).should == 2
+    1.percentage_of(1).should == 100
+    1.percentage_of(50, 50).should == 1
+    100.percentage_of(50).should == 200
+  end
+end

data/utilities.gemspec

@@ -2,7 +2,7 @@
 lib = File.expand_path('../lib/', __FILE__)
 $:.unshift lib unless $:.include?(lib)
  
-require 'lib/version'
+require './lib/version'
  
 Gem::Specification.new do |s|
   s.name        = "utilities"
@@ -19,7 +19,8 @@ Gem::Specification.new do |s|
     'README',
     'utilities.gemspec',
     'lib/utilities.rb',
-    'lib/version.rb']
+    'lib/version.rb',
+    'test/test_utilities.rb']
   
-  s.require_paths = ['lib']
+  s.require_paths = ['lib', 'test']
 end

metadata

@@ -1,13 +1,12 @@
 --- !ruby/object:Gem::Specification 
 name: utilities
 version: !ruby/object:Gem::Version 
-  hash: 15
-  prerelease: 
+  prerelease: false
   segments: 
   - 0
   - 0
-  - 8
-  version: 0.0.8
+  - 9
+  version: 0.0.9
 platform: ruby
 authors: 
 - Christian Blais
@@ -17,7 +16,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-04-26 00:00:00 -04:00
+date: 2011-06-21 00:00:00 -04:00
 default_executable: 
 dependencies: []
 
@@ -37,6 +36,7 @@ files:
 - utilities.gemspec
 - lib/utilities.rb
 - lib/version.rb
+- test/test_utilities.rb
 has_rdoc: true
 homepage: http://github.com/christianblais/utilities
 licenses: []
@@ -46,12 +46,12 @@ rdoc_options: []
 
 require_paths: 
 - lib
+- test
 required_ruby_version: !ruby/object:Gem::Requirement 
   none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
       segments: 
       - 0
       version: "0"
@@ -60,14 +60,13 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
       segments: 
       - 0
       version: "0"
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.5.0
+rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
 summary: Few utilities include in all my projects