utilities 0.0.1

data/LICENSE

@@ -0,0 +1,6 @@
+COPYLEFT
+
+0. the freedom to use the work,
+1. the freedom to study the work,
+2. the freedom to copy and share the work with others,
+3. the freedom to modify the work, and the freedom to distribute modified and therefore derivative works.

data/lib/core.rb

@@ -0,0 +1,125 @@
+module Kernel
+  # Add .inspect to any object passed, than call Kernel.raise
+  def raiser o
+    raise o.inspect
+  end
+end
+
+class Range
+  # Return a range containing elements common to the two ranges, with no duplicates
+  def intersection range
+    values = self.to_a & range.to_a
+    values.empty? ? nil : (values.first..values.last)  
+  end  
+  alias_method :&, :intersection
+  
+  # Detect if the two ranges overlap one with the other
+  def overlap? range
+    !(self & range).count.zero?
+  end
+end
+
+class DateTime
+  # Transform a DateTime to a Time
+  def to_time
+    Time.parse(self.to_s)
+  end
+end
+
+class Time  
+  # Transform a Time to a DateTime
+  def to_datetime
+    DateTime.parse(self.to_s)
+  end
+end
+
+class String  
+  # Transform the String to a Date
+  def to_date
+    Date.parse(self)
+  end
+  
+  # Transform the String to a Time
+  def to_time
+    Time.parse(self)
+  end
+end
+
+class Numeric
+  # Calculate the rank of self based on provided min and max
+  def rank min, max
+    s, min, max = self.to_f, min.to_f, max.to_f
+    min == max ? 0.0 : (s - min) / (max - min)
+  end
+  
+  # Transforms self to a string with *decimals* decimals
+  def to_decimals decimals = 2
+    "%.#{decimals}f" % self
+  end
+  
+  # Calculate the percentage of self on n
+  def percentage_of n, t = 100
+    n == 0 ? 0.0 : self / n.to_f * t
+  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( nil ) do |sum, x|
+      sum ? sum + x : x
+    end
+  end
+  
+  # Calculate the mean of the array, as long as all objects respond to / operator
+  def mean
+    (size > 0) ? sum.to_f / size : 0.0
+  end
+  alias_method :average, :mean
+  
+  # Calculate the number of occurences for each element of the array
+  def frequences
+    inject(Hash.new(0)) { |h, v| h[v] += 1; h }
+  end
+  
+  # Return the variance of the array
+  def variance
+    m = mean
+	  inject(0) { |v, x| v += (x - m) ** 2 }
+  end
+  
+  # Return the standard_deviation of the array
+  def standard_deviation
+	  size > 1 ? Math.sqrt( variance / ( size - 1 ) ) : 0.0
+  end
+  alias_method :std_dev, :standard_deviation
+  
+  # Return the median of the array
+  def median(already_sorted=false)
+    return nil if empty?
+    a = sort unless already_sorted
+    m_pos = size / 2
+    size % 2 == 1 ? a[m_pos] : a[m_pos-1..m_pos].mean
+  end
+  
+  # Return an array of modes with their corresponding occurences
+  def modes
+    freq = frequences
+    max = freq.values.max
+    freq.select { |k, f| f == max }
+  end
+  
+  # Return all statistics from the array in a simple hash
+  def stats
+    {
+      :size => size,
+      :sum => sum,
+      :min => min,
+      :max => max,
+      :mean => mean,
+      :standard_deviation => standard_deviation,
+      :median => median,
+      :modes => modes
+    }
+  end
+end

data/lib/version.rb

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

metadata

@@ -0,0 +1,71 @@
+--- !ruby/object:Gem::Specification 
+name: utilities
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Christian Blais
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-02-15 00:00:00 -05:00
+default_executable: 
+dependencies: []
+
+description: Few utilities include in all my projects, including a module for statistics, some to_date and to_time function as well as intersection method for Range object.
+email: 
+- christ.blais@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/core.rb
+- lib/version.rb
+- LICENSE
+- README
+has_rdoc: true
+homepage: http://github.com/christianblais/utilities
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Few utilities include in all my projects
+test_files: []
+