richunits 0.2.0

data/CHANGES

@@ -0,0 +1,4 @@
+=== 0.1.0 / 2008-03-27
+
+* Initial version, spun-off from Facets.
+

data/MANIFEST

@@ -0,0 +1,24 @@
+doc
+test
+test/test_bytes.rb
+test/test_multipliers.rb
+test/test_times.rb
+CHANGES
+README
+meta
+meta/created
+meta/repository
+meta/homepage
+meta/abstract
+meta/title
+meta/license
+meta/contact
+lib
+lib/rich_units.rb
+lib/rich_units
+lib/rich_units/times.rb
+lib/rich_units/multipliers.rb
+lib/rich_units/weekdays.rb
+lib/rich_units/bytes.rb
+VERSION
+NEWS

data/NEWS

@@ -0,0 +1,3 @@
+This is the initial standalone release of the Rich Kilmer's Units
+system, spun out of Facets.
+

data/README

@@ -0,0 +1,5 @@
+= Rich Units
+
+Rich Kilmer's Units System
+
+

data/VERSION

@@ -0,0 +1 @@
+richunits 0.2.0 beta (2008-09-06)

data/lib/rich_units.rb

@@ -0,0 +1,4 @@
+require 'rich_units/multipliers'
+require 'rich_units/bytes'
+require 'rich_units/times'
+

data/lib/rich_units/bytes.rb

@@ -0,0 +1,164 @@
+# TITLE:
+#
+#   Bytes
+#
+# DESCRIPTION:
+#
+#   Additional methods for Numeric class to make working with
+#   bits and bytes easier.
+#
+# COPYRIGHT:
+#
+#   Copyright (c) 2005 Rich Kilmer
+#
+# LICENSE:
+#
+#   Ruby License
+#
+#   This module is free software. You may use, modify, and/or redistribute this
+#   software under the same terms as Ruby.
+#
+#   This program is distributed in the hope that it will be useful, but WITHOUT
+#   ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+#   FOR A PARTICULAR PURPOSE.
+#
+# HISTORY:
+#
+#   Special thanks to Richard Kilmer for the orignal work.
+#   This library is based on the original library bytes.rb
+#   Copyright (c) 2004 by Rich Kilmer.
+#
+#   Also thanks to Alexander Kellett for suggesting it be
+#   included in Facets.
+#
+# AUTHORS:
+#
+#   - Rich Kilmer
+#   - Thomas Sawyer
+#
+# NOTES:
+#
+#   - This library is not compatible with STICK's units.rb (an spin-off
+#     of Facets old units.rb library). Do not attempt to use both at the same time.
+#
+# TODOs:
+#
+#   - Currently kilo, mega, etc. are all powers of two and not ten,
+#     which technically isn't corrent even though it is common usage.
+#
+#   - The in_* notation is weak. If a better nomentclature is thought
+#     of then consider changing this.
+
+
+# = Binary Multipliers
+#
+# Additional methods for Numeric class to make working with
+# bits and bytes easier. Bits are used as the base value and
+# these methods can be used to convert between different
+# magnitudes.
+#
+# == Synopisis
+#
+#   1.byte               #=> 8
+#   2.bytes              #=> 16
+#   1.kilobit            #=> 1024
+#   1.kilobyte           #=> 8192
+#
+# Use the in_* methods to perform the inverse operations.
+#
+#   8192.in_kilobytes    #=> 1
+#   1024.in_kilobits     #=> 1
+#
+
+class Numeric
+
+  def bit   ; self ; end
+  def bits  ; self ; end
+  def byte  ; self * 8 ; end
+  def bytes ; self * 8 ; end
+
+  [ 'kilo', 'mega', 'giga', 'tera', 'peta', 'exa' ].each_with_index do |m, i|
+    j = i + 1
+    class_eval %{
+      def #{m}bit  ; self * #{1024**j} ; end
+      def #{m}byte ; self * #{1024**j*8} ; end
+      def in_#{m}bits  ; self / #{1024**j} ; end
+      def in_#{m}bytes ; self / #{1024**j*8} ; end
+      alias_method :#{m}bits,  :#{m}bit
+      alias_method :#{m}bytes, :#{m}byte
+    }
+  end
+
+  [ 'kibi', 'mebi', 'gibi', 'tebi', 'pebi', 'exbi' ].each_with_index do |m, i|
+    j = i + 1
+    class_eval %{
+      def #{m}bit  ; self * #{1024**j} ; end
+      def #{m}byte ; self * #{1024**j*8} ; end
+      def in_#{m}bits  ; self / #{1024**j} ; end
+      def in_#{m}bytes ; self / #{1024**j*8} ; end
+      alias_method :#{m}bits,  :#{m}bit
+      alias_method :#{m}bytes, :#{m}byte
+    }
+  end
+
+  # Formated string of bits proportial to size.
+  #
+  #   1024.bits_to_s            #=> "1.00 kb"
+  #   1048576.bits_to_s         #=> "1.00 mb"
+  #   1073741824.bits_to_s      #=> "1.00 gb"
+  #   1099511627776.bits_to_s   #=> "1.00 tb"
+  #
+  # Takes a format string to adjust output.
+  #
+  #   1024.bits_to_s('%.0f')    #=> "1 kb"
+  #
+  def strfbits(fmt='%.2f')
+    case
+    when self < 1024
+      "#{self} bits"
+    when self < 1024**2
+      "#{fmt % (self.to_f / 1024)} kb"
+    when self < 1024**3
+      "#{fmt % (self.to_f / 1024**2)} mb"
+    when self < 1024**4
+      "#{fmt % (self.to_f / 1024**3)} gb"
+    when self < 1024**5
+      "#{fmt % (self.to_f / 1024**4)} tb"
+    else
+      "#{self} bits"
+    end
+  end
+
+  # Formated string of bytes proportial to size.
+  #
+  #   1024.bytes_to_s            #=> "1.00 KB"
+  #   1048576.bytes_to_s         #=> "1.00 MB"
+  #   1073741824.bytes_to_s      #=> "1.00 GB"
+  #   1099511627776.bytes_to_s   #=> "1.00 TB"
+  #
+  # Takes a format string to adjust output.
+  #
+  #   1024.bytes_to_s('%.0f')    #=> "1 KB"
+  #
+  def strfbytes(fmt='%.2f')
+    case
+    when self < 1024
+      "#{self} bytes"
+    when self < 1024**2
+      "#{fmt % (self.to_f / 1024)} KB"
+    when self < 1024**3
+      "#{fmt % (self.to_f / 1024**2)} MB"
+    when self < 1024**4
+      "#{fmt % (self.to_f / 1024**3)} GB"
+    when self < 1024**5
+      "#{fmt % (self.to_f / 1024**4)} TB"
+    else
+      "#{self} bytes"
+    end
+  end
+
+  # deprecated
+  alias_method :octet_units, :strfbytes
+
+end
+

data/lib/rich_units/multipliers.rb

@@ -0,0 +1,99 @@
+# TITLE:
+#
+#   Multipliers
+#
+# DESCRIPTION:
+#
+#   Adds methods to Numeric to make working with
+#   magnitudes (kilo, mega, giga, milli, micro, etc.)
+#   as well as bits and bytes easier.
+#
+# COPYRIGHT:
+#
+#   Copyright (c) 2005 Thomas Sawyer
+#
+# LICENSE:
+#
+#   Ruby License
+#
+#   This module is free software. You may use, modify, and/or redistribute this
+#   software under the same terms as Ruby.
+#
+#   This program is distributed in the hope that it will be useful, but WITHOUT
+#   ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+#   FOR A PARTICULAR PURPOSE.
+#
+# HISTORY:
+#
+#   Thanks to Rich Kilmer and bytes.rb which inspired this library.
+#
+# AUTHORS:
+#
+#   - Thomas Sawyer
+#
+# NOTES:
+#
+#   - This library is not compatible with STICK's units.rb (an spin-off
+#     of Facets old units.rb library). Do not attempt to use both at the same time.
+
+
+# = Multipliers
+#
+# Adds methods to Numeric to make working with
+# magnitudes (kilo, mega, giga, milli, micro, etc.)
+# as well as bits and bytes easier.
+#
+#   1.kilo               #=> 1000
+#   1.milli              #=> 0.001
+#   1.kibi               #=> 1024
+#
+# To display a value in a certain denomination, simply
+# perform the inverse operation by placing the
+# multiplier called on unit (1) in the denominator.
+#
+#   1000 / 1.kilo        #=> 1
+#   1024 / 1.kibi        #=> 1
+#
+
+class Numeric
+
+  # SI Multipliers
+
+  def deka  ; self * 10 ; end
+  def hecto ; self * 100 ; end
+  def kilo  ; self * 1000 ; end
+  def mega  ; self * 1000000 ; end
+  def giga  ; self * 1000000000 ; end
+  def tera  ; self * 1000000000000 ; end
+  def peta  ; self * 1000000000000000 ; end
+  def exa   ; self * 1000000000000000000 ; end
+
+  # SI Fractional
+
+  def deci  ; self.to_f / 10 ; end
+  def centi ; self.to_f / 100 ; end
+  def milli ; self.to_f / 1000 ; end
+  def micro ; self.to_f / 1000000 ; end
+  def nano  ; self.to_f / 1000000000 ; end
+  def pico  ; self.to_f / 1000000000000 ; end
+  def femto ; self.to_f / 1000000000000000 ; end
+  def atto  ; self.to_f / 1000000000000000000 ; end
+
+  # SI Binary
+
+  def kibi ; self * 1024 ; end
+  def mebi ; self * 1024**2 ; end
+  def gibi ; self * 1024**3 ; end
+  def tebi ; self * 1024**4 ; end
+  def pebi ; self * 1024**5 ; end
+  def exbi ; self * 1024**6 ; end
+
+  # Bits and Bytes
+
+  def bit   ; self ; end
+  def bits  ; self ; end
+  def byte  ; self * 8 ; end
+  def bytes ; self * 8 ; end
+
+end
+

data/lib/rich_units/times.rb

@@ -0,0 +1,388 @@
+# TITLE:
+#
+#   Times
+#
+# DESCRIPTION:
+#
+#   Plain-English convenience methods for dealing with dates and times.
+#
+# COPYRIGHT:
+#
+#   Copyright (c) 2005 Rich Kilmer, Thomas Sawyer
+#
+# LICENSE:
+#
+#   Ruby License
+#
+#   This module is free software. You may use, modify, and/or redistribute this
+#   software under the same terms as Ruby.
+#
+#   This program is distributed in the hope that it will be useful, but WITHOUT
+#   ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#   FITNESS FOR A PARTICULAR PURPOSE.
+#
+# HISTORY:
+#
+#   Thanks to Richard Kilmer for the orignal work and Alexander Kellett
+#   for suggesting it for Facets.
+#
+#   Thanks to Dave Hoover and Ryan Platte for the Weekdays implementation.
+#
+# AUTHORS:
+#
+#   - Rich Kilmer
+#   - Thomas Sawyer
+#   - Dave Hoover
+#   - Ryan Platte
+#   - George Moschovitis
+#
+# NOTES:
+#
+#   - This library is not compatible with STICK's units.rb (an spin-off
+#     of Facets old units.rb library). Do not attempt to use both at the same time.
+#
+# TODOs:
+#
+#   TODO Extra Add in_* methods, like in_days, in_hours, etc.
+
+require 'facets/time/change'
+require 'facets/time/set'
+require 'facets/time/ago'
+require 'facets/time/hence'
+
+require 'rich_units/weekdays'
+
+class Time
+
+  NEVER = Time.mktime(2038)
+  ZERO  = Time.mktime(1972)
+
+  # This method calculates the days extrema given two time objects.
+  #   start time is the given time1 at 00:00:00
+  #   end time is the given time2 at 23:59:59:999
+  #
+  # Input:
+  # - the two times (if only time1 is provided then you get an extrema
+  #   of exactly one day extrema.
+  #
+  # Output:
+  # - the time range. you can get the start/end times using
+  #   range methods.
+  #
+  #  CREDIT George Moschovitis
+
+  def self.days_extrema(time1, time2=nil)
+    time2 = time1 if (not time2.valid? Time)
+    time2 = NEVER if (time2 <= time1)
+    start_time = Time.self.start_of_day(time1)
+    end_time = self.end_of_day(time2)
+    return (start_time..end_time)
+  end
+
+  # Seconds since midnight: Time.now.seconds_since_midnight
+
+  def seconds_since_midnight
+    self.hour.hours + self.min.minutes + self.sec + (self.usec/1.0e+6)
+  end
+
+  # Returns a new Time representing the time a number of seconds ago.
+  # Do not use this method in combination with x.months, use months_ago instead!
+  #def ago(seconds)
+  #  # This is basically a wrapper around the Numeric extension.
+  #  #seconds.until(self)
+  #  self - seconds
+  #end
+
+  # Returns a new Time representing the time
+  # a number of minutes ago.
+
+  def minutes_ago(minutes)
+    self - (minutes * 60)
+  end
+
+  # Returns a new Time representing the time
+  # a number of hours ago.
+
+  def hours_ago(hours)
+    self - (hours * 3600)
+  end
+
+  # Returns a new Time representing the time
+  # a number of days ago.
+
+  def days_ago(days)
+    self - (days * 86400)
+  end
+
+  # Returns a new Time representing the time
+  # a number of weeks ago.
+
+  def weeks_ago(weeks)
+    self - (weeks * 604800)
+  end
+
+  # Returns a new Time representing the time
+  # a number of months ago.
+
+  def months_ago(months)
+    years = (month - months / 12).to_i
+    set(:year=>(year - years), :month=>(month - months) % 12)
+  end
+
+  # Returns a new Time representing the time a number of specified
+  # months ago.
+  #def months_ago(months)
+  #  if months >= self.month
+  #    change(:year => self.year - 1, :month => 12).months_ago(months - self.month)
+  #  else
+  #    change(:year => self.year, :month => self.month - months)
+  #  end
+  #end
+
+  # Returns a new Time representing the time
+  # a number of years ago.
+
+  def years_ago(years)
+    set(:year=>(year - years))
+  end
+
+  # Returns a new Time representing the time a number of specified
+  # years ago.
+  #def years_ago(years)
+  #  change(:year => self.year - years)
+  #end
+
+  # Returns a new Time representing the time
+  # a number of minutes hence.
+
+  def minutes_hence(minutes)
+    self + (minutes * 60)
+  end
+
+  # Returns a new Time representing the time
+  # a number of hours hence.
+
+  def hours_hence(hours)
+    self + (hours * 3600)
+  end
+
+  # Returns a new Time representing the time
+  # a number of days hence.
+
+  def days_hence(days)
+    self + (days * 86400)
+  end
+
+  # Returns a new Time representing the time
+  # a number of weeks hence.
+
+  def weeks_hence(weeks)
+    self + (weeks * 604800)
+  end
+
+  # Returns a new Time representing the time
+  # a number of months hence.
+
+  def months_hence(months)
+    years = (month + months / 12).to_i
+    set(:year=>(year + years), :month=>(month + months) % 12)
+  end
+
+  #def months_hence(months)
+  #  if months + self.month > 12
+  #    change(:year => self.year + 1, :month => 1).months_since(months - (self.month == 1 ? 12 : (self.month + 1)))
+  #  else
+  #    change(:year => self.year, :month => self.month + months)
+  #  end
+  #end
+
+  # Returns a new Time representing the time
+  # a number of years hence.
+
+  def years_hence(years)
+    set(:year=>(year + years))
+  end
+
+  # Returns a new Time representing the time a number of seconds
+  # since the instance time. Do not use this method in combination
+  # with x.months, use months_since instead!
+  alias_method :since, :hence
+
+  alias_method :minutes_since, :minutes_hence
+  alias_method :days_since, :days_hence
+  alias_method :weeks_since, :weeks_hence
+  alias_method :months_since, :months_hence
+  alias_method :years_since, :years_hence
+
+  #def years_since(years)
+  #  change(:year => self.year + years)
+  #end
+
+  # Short-hand for years_ago(1)
+  def last_year
+    years_ago(1)
+  end
+
+  # Short-hand for years_since(1)
+  def next_year
+    years_since(1)
+  end
+
+  # Short-hand for months_ago(1)
+  def last_month
+    months_ago(1)
+  end
+
+  # Short-hand for months_since(1)
+  def next_month
+    months_since(1)
+  end
+
+  # Returns a new Time representing the "start" of this week (Monday, 0:00)
+  def beginning_of_week
+    (self - self.wday.days).midnight + 1.day
+  end
+  alias :monday :beginning_of_week
+  alias :at_beginning_of_week :beginning_of_week
+
+  # Returns a new Time representing the start of the given
+  # day in next week (default is Monday).
+  def next_week(day = :monday)
+    days_into_week = { :monday => 0, :tuesday => 1, :wednesday => 2,
+                       :thursday => 3, :friday => 4, :saturday => 5,
+                       :sunday => 6 }
+    since(1.week).beginning_of_week.since(days_into_week[day].day).change(:hour => 0)
+  end
+
+  # Set time to end of day
+  #def end_of_day
+  #  return Time.mktime(year, month, day, 23, 59, 59, 999)
+  #end
+
+  # Returns a new Time representing the start of the day (0:00)
+  def beginning_of_day
+    self - self.seconds_since_midnight
+  end
+  alias :midnight :beginning_of_day
+  alias :at_midnight :beginning_of_day
+  alias :at_beginning_of_day :beginning_of_day
+  alias :start_of_day :beginning_of_day
+
+  # Returns a new Time representing the start of the month
+  # (1st of the month, 0:00)
+  def beginning_of_month
+    #self - ((self.mday-1).days + self.seconds_since_midnight)
+    change(:day => 1,:hour => 0, :min => 0, :sec => 0, :usec => 0)
+  end
+  alias_method :at_beginning_of_month, :beginning_of_month
+
+  # Returns  a new Time representing the start of the year (1st of january, 0:00)
+  def beginning_of_year
+    change(:month => 1,:day => 1,:hour => 0, :min => 0, :sec => 0, :usec => 0)
+  end
+  alias :at_beginning_of_year :beginning_of_year
+
+  # Convenience method which returns a new Time representing
+  # the time 1 day ago
+  def yesterday
+    self.ago(1.day)
+  end
+
+  # Convenience method which returns a new Time representing
+  # the time 1 day since the instance time
+  def tomorrow
+    self.since(1.day)
+  end
+
+  # Returns a new time at start of day
+  def to_start_of_day
+    return Time.mktime(year, month, day, 0, 0, 0, 0)
+  end
+
+  # Returns a new time at end of day
+  def to_end_of_day
+    Time.mktime(year, month, day, 23, 59, 59, 999)
+  end
+
+  # Returns true only if day of time is included in the
+  # range (stime..etime). Only year days are checked.
+  def in_day_range?(stime=ZERO, etime=NEVER)
+    if (etime <= stime)
+      warn "invalid end time (#{etime} < #{stime})" if $DEBUG
+      etime = NEVER
+    end
+
+    stime = stime.to_start_of_day
+    etime = etime.to_end_of_day
+
+    return (stime..etime).include?(time)
+  end
+end
+
+
+class Numeric
+
+  # Enables the use of time calculations and declarations,
+  # like 45.minutes + 2.hours + 4.years. The base unit for
+  # all of these Numeric time methods is seconds.
+  def seconds ; self ; end
+  alias_method :second, :seconds
+  #def as_seconds ; self ; end
+
+  # Converts minutes into seconds.
+  def minutes ; self * 60 ; end
+  alias_method :minute, :minutes
+  #def as_minutes ; self.to_f / 60 ; end
+
+  # Converts hours into seconds.
+  def hours ; self * 60.minutes ; end
+  alias_method :hour, :hours
+  #def as_hours ; self / 60.minutes ; end
+
+  # Converts days into seconds.
+  def days ; self * 24.hours ; end
+  alias_method :day, :days
+  #def as_days ; self / 24.hours ; end
+
+  # Converts weeks into seconds.
+  def weeks ; self * 7.days ; end
+  alias_method :week, :weeks
+  #def as_weeks ; self / 7.days ; end
+
+  # Converts fortnights into seconds.
+  # (A fortnight is 2 weeks)
+  def fortnights ; self * 2.weeks ; end
+  alias_method :fortnight, :fortnights
+  #def as_fortnights ; self / 2.weeks ; end
+
+  # Converts months into seconds.
+  # WARNING: This is not exact as it assumes 30 days to a month.
+  def months ; self * 30.days ; end
+  alias_method :month, :months
+  #def as_months ; self / 30.days ; end
+
+  # Converts years into seconds.
+  def years ; self * 365.days ; end
+  alias_method :year, :years
+  #def as_years ; self / 365.days ; end
+
+  # Calculates time _before_ a given time. Default time is now.
+  # Reads best with arguments: 10.days.before( Time.now - 1.day )
+  def before(time = ::Time.now)
+    time - self
+  end
+  alias_method :until, :before   # Reads best with argument: 10.minutes.until(time)
+  alias_method :ago, :before     # Reads best without arguments: 10.minutes.ago
+
+  # Calculates time _after_ a given time. Default time is now.
+  # Reads best with argument: 10.minutes.after(time)
+  def after(time = ::Time.now)
+    time + self
+  end
+  alias_method :since, :after    # Reads best with argument: 10.minutes.since(time)
+  alias_method :hence, :after    # Reads best with argument: 10.minutes.since(time)
+  alias_method :from_now, :after # Reads best without arguments: 10.minutes.from_now
+  alias_method :later, :after    # Reads best without arguments: 10.minutes.later
+
+end
+

data/lib/rich_units/weekdays.rb

@@ -0,0 +1,53 @@
+# = Weekdays
+#
+# The Weekdays class provides useful weekday terminology.
+
+class Weekdays
+
+  WEEKDAYS = 1..5 # Monday is wday 1
+  ONE_DAY  = 60 * 60 * 24
+
+  def initialize(n)
+    @n = n
+  end
+
+  def ago(time = ::Time.now)
+    step :down, time
+  end
+  alias_method :until, :ago
+  alias_method :before, :ago
+
+  def since(time = ::Time.now)
+    step :up, time
+  end
+  alias_method :from_now, :since
+  alias_method :after, :since
+
+  private
+
+  def step(direction, original_time)
+    result = original_time
+    time = ONE_DAY
+
+    compare = direction == :up ? ">" : "<"
+    time *= -1 if direction == :down
+
+    @n.times do
+      result += time until result.send(compare, original_time) && WEEKDAYS.member?(result.wday)
+      original_time = result
+    end
+    result
+  end
+end
+
+class Numeric
+
+  # Works with day in terms of weekdays.
+  def weekdays
+    Weekdays.new(self)
+  end
+
+  alias_method :weekday, :weekdays
+
+end
+

data/meta/abstract

@@ -0,0 +1,5 @@
+Rich Kilmer's Unit system provides english-esque methods
+for working with common units, such as days and bytes and
+multiplers like kilo, or mega. It does so by reducing basic
+measures to a lower common denominator, such as seconds for
+time measures and bits for byte measures.

data/meta/contact

@@ -0,0 +1 @@
+7ransUnit <transfire@gmail.com>

data/meta/created

@@ -0,0 +1 @@
+2008-02-21

data/meta/homepage

@@ -0,0 +1,2 @@
+http://tigerops.rubyforge.org/richunits
+

data/meta/license

@@ -0,0 +1 @@
+MIT

data/meta/title

@@ -0,0 +1 @@
+Rich Kilmer's Units System

data/test/test_bytes.rb

@@ -0,0 +1,69 @@
+require 'rich_units/bytes.rb'
+require 'test/unit'
+
+class TC_Numeric < Test::Unit::TestCase
+
+  # bits
+
+  def test_bits
+    assert_equal( 8, 8.bits )
+  end
+
+  def test_kilobits
+    assert_equal( 1024**1, 1.kilobit )
+  end
+
+  def test_megabits
+    assert_equal( 1024**2, 1.megabit )
+  end
+
+  def test_gigabits
+    assert_equal( 1024**3, 1.gigabit )
+  end
+
+  def test_terabits
+    assert_equal( 1024**4, 1.terabit )
+  end
+
+  # bytes
+
+  def test_bytes
+    assert_equal( 8192, 1024.bytes )
+  end
+
+  def test_kilobytes
+    assert_equal( 1024**1*8, 1.kilobyte )
+  end
+
+  def test_megabytes
+    assert_equal( 1024**2*8, 1.megabyte )
+  end
+
+  def test_gigabytes
+    assert_equal( 1024**3*8, 1.gigabyte )
+  end
+
+  def test_terabytes
+    assert_equal( 1024**4*8, 1.terabyte )
+  end
+
+  # bits_to_s
+
+  def test_strfbits
+    assert_equal( "1.00 kb", 1024.strfbits )
+    assert_equal( "1.00 mb", 1048576.strfbits )
+    assert_equal( "1.00 gb", 1073741824.strfbits )
+    assert_equal( "1.00 tb", 1099511627776.strfbits )
+  end
+
+  # bytes_to_s
+
+  def test_strfbytes
+    assert_equal( "1.00 KB", 1024.strfbytes )
+    assert_equal( "1.00 MB", 1048576.strfbytes )
+    assert_equal( "1.00 GB", 1073741824.strfbytes )
+    assert_equal( "1.00 TB", 1099511627776.strfbytes )
+  end
+
+end
+

data/test/test_multipliers.rb

@@ -0,0 +1,99 @@
+require 'rich_units/multipliers.rb'
+require 'test/unit'
+
+class TC_Multipliers < Test::Unit::TestCase
+
+  def test_deka
+    assert_equal( 10, 1.deka )
+  end
+
+  def test_hecto
+    assert_equal( 100, 1.hecto )
+  end
+
+  def test_kilo
+    assert_equal( 1000, 1.kilo )
+  end
+
+  def test_mega
+    assert_equal( 1000000, 1.mega )
+  end
+
+  def test_giga
+    assert_equal( 1000000000, 1.giga )
+  end
+
+  def test_tera
+    assert_equal( 1000000000000, 1.tera )
+  end
+
+  def test_peta
+    assert_equal( 1000000000000000, 1.peta )
+  end
+
+  def test_exa
+    assert_equal( 1000000000000000000, 1.exa )
+  end
+
+  # Fractional
+
+  def test_deci
+    assert_equal( 0.1, 1.deci )
+  end
+
+  def test_centi
+    assert_equal( 0.01, 1.centi )
+  end
+
+  def test_milli
+    assert_equal( 0.001, 1.milli )
+  end
+
+  def test_milli
+    assert_equal( 0.000001, 1.micro )
+  end
+
+  def test_nano
+    assert_equal( 0.000000001, 1.nano )
+  end
+
+  def test_pico
+    assert_equal( 0.000000000001, 1.pico )
+  end
+
+  def test_femto
+    assert_equal( 0.000000000000001, 1.femto )
+  end
+
+  def test_atto
+    assert_equal( 0.000000000000000001, 1.atto )
+  end
+
+  # SI Binary
+
+  def test_kibi
+    assert_equal( 1024, 1.kibi )
+  end
+
+  def test_mebi
+    assert_equal( 1024**2, 1.mebi )
+  end
+
+  def test_gibi
+    assert_equal( 1024**3, 1.gibi )
+  end
+
+  def test_tebi
+    assert_equal( 1024**4, 1.tebi )
+  end
+
+  def test_pebi
+    assert_equal( 1024**5, 1.pebi )
+  end
+
+  def test_exbi
+    assert_equal( 1024**6, 1.exbi )
+  end
+
+end
+

data/test/test_times.rb

@@ -0,0 +1,87 @@
+require 'rich_units/times.rb'
+require 'test/unit'
+
+class TC_Times < Test::Unit::TestCase
+
+  #def test_micro_seconds
+  #  assert_equal( 0.000001, 1.microsecond )
+  #end
+
+  #def test_milli_seconds
+  #  assert_equal( 0.001, 1.millisecond )
+  #end
+
+  def test_seconds
+    assert_equal( 60**0, 1.seconds )
+  end
+
+  def test_minutes
+    assert_equal( 60**1, 1.minutes )
+  end
+
+  def test_hours
+    assert_equal( 60**2, 1.hours )
+  end
+
+  def test_days
+    assert_equal( 24*(60**2), 1.days )
+  end
+
+  def test_weeks
+    assert_equal( 7*24*(60**2), 1.weeks )
+  end
+
+  def test_fortnights
+    assert_equal( 14*24*(60**2), 1.fortnights )
+  end
+
+  def test_months
+    assert_equal( 30*24*(60**2), 1.months )
+  end
+
+  def test_years
+    assert_equal( 365*24*(60**2), 1.years )
+  end
+
+  def test_before
+    t = Time.now
+    assert_equal( t - 1.day, 1.day.before(t) )
+  end
+
+  def test_after
+    t = Time.now
+    assert_equal( t + 1.day, 1.day.after(t) )
+  end
+
+end
+
+class WeekdaysTest < Test::Unit::TestCase
+
+  MONDAY = Time.at(1165250000)
+  THURSDAY = Time.at(1165500000)
+  FRIDAY = Time.at(1165606025)
+
+  def test_weekday_after_monday
+    assert_equal 2, 1.weekday.since(MONDAY).wday
+  end
+
+  def test_weekday_after_friday
+    assert_equal 1, 1.weekday.after(FRIDAY).wday
+  end
+
+  def test_weekdays_before_friday
+    assert_equal 2, 3.weekdays.before(FRIDAY).wday
+  end
+
+  #def test_weekday_before_today
+  #  Time.expects(:now).returns(THURSDAY)
+  #  assert_equal 3, 1.weekday.ago.wday
+  #end
+
+  #def test_weekdays_after_today
+  #  Time.expects(:now).returns(MONDAY)
+  #  assert_equal 3, 2.weekday.from_now.wday
+  #end
+
+end
+

metadata

@@ -0,0 +1,91 @@
+--- !ruby/object:Gem::Specification 
+name: richunits
+version: !ruby/object:Gem::Version 
+  version: 0.2.0
+platform: ruby
+authors: 
+- |
+  7ransUnit <transfire@gmail.com>
+
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-09-06 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: Rich Kilmer's Unit system provides english-esque methods for working with common units, such as days and bytes and multiplers like kilo, or mega. It does so by reducing basic measures to a lower common denominator, such as seconds for time measures and bits for byte measures.
+email: transfire@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+- MANIFEST
+- CHANGES
+- VERSION
+- NEWS
+files: 
+- doc
+- MANIFEST
+- test
+- test/test_bytes.rb
+- test/test_multipliers.rb
+- test/test_times.rb
+- CHANGES
+- README
+- meta
+- meta/created
+- meta/repository
+- meta/homepage
+- meta/abstract
+- meta/title
+- meta/license
+- meta/contact
+- lib
+- lib/rich_units.rb
+- lib/rich_units
+- lib/rich_units/times.rb
+- lib/rich_units/multipliers.rb
+- lib/rich_units/weekdays.rb
+- lib/rich_units/bytes.rb
+- VERSION
+- NEWS
+has_rdoc: true
+homepage: |+
+  http://tigerops.rubyforge.org/richunits
+  
+post_install_message: 
+rdoc_options: 
+- --inline-source
+- --title
+- richunits api
+- --main
+- README
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: tigerops
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Rich Kilmer's Unit system provides english-esque methods
+test_files: 
+- test/test_bytes.rb
+- test/test_multipliers.rb
+- test/test_times.rb