small 0.3 → 0.4

data/README.md

@@ -1,6 +1,136 @@
 Small
 ======
 
-Small collection of useful Ruby utilities.
+Small collection of useful Ruby utilities
 
-Tested with 1.9.3-p125
+## Classes
+
+* **Math**
+
+	* fibanocci(n)
+	* factorial(n)
+
+* **String**
+
+	* camelize
+	* dashize
+	* humanize
+	* underscore
+	* constantize
+	* encode64
+	* decode64
+	* to_sha1
+	* to_sha256(provider)
+	* to_md5
+	* escape
+	* unescape
+
+* **Integer**
+
+	* year, years
+	* month, months
+	* week, weeks
+	* day, days
+	* hour, hours
+	* minute, minutes
+	* second, seconds
+	
+* **Array**
+
+	* extract_options
+	* sample
+	
+* **Hash**
+
+	* stringify_keys!
+	* symbolize_keys!
+	* to_params
+	
+* **Time**
+
+	* since(seconds)
+	* ago(seconds)
+	* advance(options)
+	* change(options)
+	* to_date
+	* to_datetime
+	* to_formatted_s(format)
+	* leap_year?
+	* weekend?
+	* today?
+	* future?
+	* past?
+	* days_in_month
+	* days_to_week_start(start_day)
+	* weekends
+	* business_week(start_day)
+	* beginning_of_business_week(start_day)
+	* end_of_business_week(start_day)
+	* beginning_of_day
+	* beginning_of_week(start_day)
+	* beginning_of_month
+	* beginning_of_year
+	* end_of_day
+	* end_of_week(start_day)
+	* end_of_month
+	* end_of_year
+	* tomorrow
+	* yesterday
+	* next_year
+	* last_year
+	* next_month
+	* last_month
+	* next_week
+	* last_week
+
+* **Object**
+
+	* blank?
+	* present?
+	* presence
+	* try(method, &block)
+
+* **Benchmark** - *small DSL for Benchmark class*
+	
+	* benchmark(&block)
+	* measure(&block)
+	* realtime(&block)
+	* run(n, &block)
+<br />
+	
+		require 'small/benchmark'
+		
+		benchmark do |b|
+		  b.report("test") do
+		    run 50_000 do
+			  puts "hello world"
+			end
+		  end
+		end
+		
+**Notes:** + = some codes extracted from ActiveSupport, but some codes are modified
+
+## Benchmark
+
+Using a `time` command execution
+
+
+**Small**: `time ruby -r small -e 'puts Time.now.end_of_week'`
+	
+	2012-05-06 23:59:59 -0500
+
+	real	0m0.167s
+	user	0m0.113s
+	sys	    0m0.048s
+
+**ActiveSupport**: `time ruby -r active_support/all -e 'puts Time.now.end_of_week'`
+
+	2012-05-06 23:59:59 -0500
+
+	real	0m1.320s
+	user	0m1.240s
+	sys	    0m0.074s
+	
+## License
+
+**small** is licensed under the MIT license

data/lib/small.rb

@@ -1,12 +1,13 @@
 
 module Small
-  VERSION = "0.3"
+  VERSION = "0.4"
 end
 
 require 'small/object'
 require 'small/string'
-require 'small/integer'
 require 'small/math'
 require 'small/array'
 require 'small/hash'
+require 'small/units'
+require 'small/integer'
 require 'small/time'

data/lib/small/array.rb

@@ -1,4 +1,5 @@
 class Array
+
   def extract_options!
     last.is_a?(Hash) ? pop : {}
   end

data/lib/small/benchmark.rb

@@ -0,0 +1,29 @@
+require 'benchmark'
+
+module Small
+  module Benchmark
+
+    def benchmark(tab = 25)
+      ::Benchmark.bm(tab) do |b|
+        yield b
+      end
+    end
+
+    def measure(name = nil)
+      ::Benchmark.measure(name) { yield }
+    end
+
+    def realtime
+      ::Benchmark.realtime { yield }
+    end
+
+    def run(n = 100_000)
+      n.to_i.times do |i|
+        yield i
+      end
+    end
+
+  end
+end
+
+include Small::Benchmark

data/lib/small/integer.rb

@@ -1,39 +1,12 @@
 class Integer
+  extend Small::Units
+ 
+  unit :year,   31536000 # http://www.wolframalpha.com/input/?i=year
+  unit :month,  2592000
+  unit :week,   604800
+  unit :day,    86400
+  unit :hour,   3600
+  unit :minute, 60
+  unit :second, 1
 
-  def year
-    # http://www.wolframalpha.com/input/?i=year
-    self * 31536000
-  end
-
-  def month
-    self * 3600 * 24 * 30
-  end
-
-  def week
-    self * 3600 * 24 * 7
-  end
-
-  def day
-    self * 3600 * 24
-  end
-
-  def hour
-    self * 3600
-  end
-
-  def minute
-    self * 60
-  end
-
-  def second
-    self * 1
-  end
-
-  alias :years :year
-  alias :months :month
-  alias :weeks :week
-  alias :days :day
-  alias :hours :hour
-  alias :minutes :minute
-  alias :seconds :second
 end

data/lib/small/object.rb

@@ -4,6 +4,15 @@ class Object
     respond_to?(:empty?) ? empty? : !self
   end
 
+  def present?
+    !blank?
+  end
+
+  def presence
+    self if present?
+  end
+
+
   def try(*a, &b)
     if a.empty? && block_given?
       yield self

data/lib/small/time.rb

@@ -2,13 +2,55 @@ require 'time'
 require 'date'
 require 'datetime' unless defined?(DateTime)
 
-# Some codes extracted from Rails
+# Some codes extracted from Rails, but modified codes and additional codes
 class Time
 
   DATE_FORMATS = {
     :default => "%Y-%m-%d %H:%M:%S"
   }
 
+  DAYS_INTO_WEEK = {
+    :monday     => 0,
+    :tuesday    => 1,
+    :wednesday  => 2,
+    :thursday   => 3,
+    :friday     => 4,
+    :saturday   => 5,
+    :sunday     => 6 
+  }
+
+  def since(seconds)
+    self + seconds
+  end
+
+  def ago(seconds)
+    since(-seconds)
+  end
+
+  def advance(options)
+    seconds = (options[:years] || 0).years +
+      (options[:months] || 0).months +
+      (options[:weeks] || 0).weeks + 
+      (options[:days] || 0).days +
+      (options[:hours] || 0).hours +
+      (options[:minutes] || 0).minutes +
+      (options[:seconds] || 0).seconds 
+    since(seconds)
+  end
+
+  def change(options)
+    ::Time.send(
+      utc? ? :utc : :local,
+      options[:year]  || year,
+      options[:month] || month,
+      options[:day]   || day,
+      options[:hour]  || hour,
+      options[:min]   || (options[:hour] ? 0 : min),
+      options[:sec]   || ((options[:hour] || options[:min]) ? 0 : sec),
+      options[:usec]  || ((options[:hour] || options[:min] || options[:sec]) ? 0 : usec)
+    )
+  end
+
   def to_date
     ::Date.new(year, month, day)
   end
@@ -25,8 +67,120 @@ class Time
     end
   end
 
+  def leap_year?
+    to_date.leap?
+  end
+
+  def weekend?
+    weekends.include?(self)
+  end
+
   def today?
     to_date == ::Time.now.to_date
   end
 
+  def future?
+    self > ::Time.now
+  end
+
+  def past?
+    self < ::Time.now
+  end
+
+  def days_in_month
+    ::Date.civil(year, month, -1).day
+  end
+
+  def days_to_week_start(start_day = :monday)
+    start_day_number = DAYS_INTO_WEEK[start_day]
+    current_day_number = wday != 0 ? wday - 1 : 6
+    days_span = current_day_number - start_day_number
+    days_span >= 0 ? days_span : 7 + days_span
+  end
+
+  def weekends
+    [end_of_week.ago(1.day), end_of_week]
+  end
+
+  def business_week(start_day = :monday)
+    days = []
+    5.times {|i| days << beginning_of_week(start_day).since(i.days) }
+    days
+  end
+
+  def beginning_of_business_week(start_day = :monday)
+    business_week(start_day).first
+  end
+
+  def end_of_business_week(start_day = :monday)
+    business_week(start_day).last
+  end
+
+  def beginning_of_day
+    change(:hour => 0)
+  end
+  alias :midnight :beginning_of_day
+
+  def beginning_of_week(start_day = :monday)
+    days_to_start = days_to_week_start(start_day)
+    (self - days_to_start.days).midnight
+  end
+
+  def beginning_of_month
+    change(:day => 1, :hour => 0)
+  end
+
+  def beginning_of_year
+    change(:month => 1, :day => 1, :hour => 0)
+  end
+
+  def end_of_day
+    change(:hour => 23, :min => 59, :sec => 59, :usec => 999999.99)
+  end
+
+  def end_of_week(start_day = :monday)
+    days_to_end =  6 - days_to_week_start(start_day)
+    (self + days_to_end.days).end_of_day
+  end
+
+  def end_of_month
+    change(:day => days_in_month, :hour => 23, :min => 59, :sec => 59, :usec => 999999.99)
+  end
+
+  def end_of_year
+    change(:month => 12, :day => 31, :hour => 23, :min => 59, :sec => 59, :usec => 999999.999)
+  end
+
+  def tomorrow
+    advance(:days => 1)
+  end
+
+  def yesterday
+    advance(:days => -1)
+  end
+
+  def next_year
+    advance(:years => 1)
+  end
+
+  def last_year
+    advance(:years => -1)
+  end
+
+  def next_month
+    advance(:months => 1)
+  end
+
+  def last_month
+    advance(:months => -1)
+  end
+
+  def next_week
+    advance(:weeks => 1)
+  end
+
+  def last_week
+    advance(:weeks => -1)
+  end
+
 end

data/lib/small/units.rb

@@ -0,0 +1,14 @@
+module Small
+  module Units
+    
+    def unit(name, value)
+      class_eval <<-METHOD
+        def #{name}
+          self * #{value.to_i}
+        end
+        alias :#{name}s :#{name}
+      METHOD
+    end
+
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: small
 version: !ruby/object:Gem::Version
-  version: '0.3'
+  version: '0.4'
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-04-27 00:00:00.000000000 Z
+date: 2012-05-04 00:00:00.000000000 Z
 dependencies: []
 description: 
 email: bryann83@gmail.com
@@ -20,12 +20,14 @@ files:
 - README.md
 - LICENSE
 - lib/small/array.rb
+- lib/small/benchmark.rb
 - lib/small/hash.rb
 - lib/small/integer.rb
 - lib/small/math.rb
 - lib/small/object.rb
 - lib/small/string.rb
 - lib/small/time.rb
+- lib/small/units.rb
 - lib/small.rb
 homepage: https://github.com/bry4n/small
 licenses: []