facets 1.0.0 → 1.0.1

data/lib/facets/english/time.rb

@@ -1,327 +0,0 @@
-#--
-# Time In English
-#
-# Copyright (c) 2005 Thomas Sawyer
-# Copyright (c) 2004 Rich Kilmer
-#
-# 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.
-#
-# ===========================================================================
-#  REVISION HISTORY
-# ===========================================================================
-#  * 2005.04.28 trans  Ported from Rich Kilmer's lib.
-# ===========================================================================
-#
-# :TODO: Extra methods
-# Add in_* methods, like in_days, in_hours, etc.
-#
-# :CREDIT:
-# Credit goes to Richard Kilmer for the orignal work and
-# Alexander Kellett for suggesting them for Nano (then Facets).
-#
-#++
-
-require 'facet/time/change'
-
-#:title: Time In English
-#
-# Plain-English convenience methods for dealing with dates and times.
-#
-
-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 :from_now, :after # Reads best without arguments: 10.minutes.from_now
-  alias_method :later, :after    # Reads best without arguments: 10.minutes.later
-
-end
-
-class Time
-
-  NEVER = Time.mktime(2038)
-  ZERO = Time.mktime(1972)
-
-  # 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 seconds
-  # since the instance time. Do not use this method in combination
-  # with x.months, use months_since instead!
-  def since(seconds)
-    # This is basically a wrapper around the Numeric extension.
-    #seconds.since(self)
-    self + seconds
-  end
-  alias_method :in, :since
-
-  # 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
-
-  def months_since(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 specified
-  # years ago.
-  def years_ago(years)
-    change(:year => self.year - years)
-  end
-
-  def years_since(years)
-    change(:year => self.year + years)
-  end
-
-  # Short-hand for months_ago(1)
-  def last_year
-    years_since(1)
-  end
-
-  # Short-hand for months_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(:mday => 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,:mday => 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
-
-  # Rrturns a new time at end of day
-  def to_end_of_day
-    return 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
-
-
-#  _____         _
-# |_   _|__  ___| |_
-#   | |/ _ \/ __| __|
-#   | |  __/\__ \ |_
-#   |_|\___||___/\__|
-#
-
-=begin testing
-
-require 'test/unit'
-#require 'mega/multiplier'
-
-class TC_Numeric < 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
-
-=end

data/lib/facets/group/inflect.rb

@@ -1,71 +0,0 @@
-#--
-# Inflect
-#
-# Copyright (c) 2005 Thomas Sawyer
-#
-# 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.
-#
-#================================================================================
-# Revision History
-#================================================================================
-#  2005-10-25  trans  
-#  Brought over to Calibre from Facets after "SOC Revelation".
-#================================================================================
-#++
-
-#:title: Inflect
-#
-# Collection of Facets that apply to inflecting a String or Symbol.
-#
-#   "dog".plural          #=> "dogs"
-#   "dog_tail".camelcase  #=> "DogTail"
-#   "1".ordinal           #=> "1st"
-#
-#   :going.upcase         #=> :GOING
-#   :Arrow.capitlized?    #=> true
-#
-# = Author(s)
-#
-# * Thomas Sawyer
-# * (see Facets for corollary)
-#
-
-require 'facet/string/singular'
-require 'facet/string/plural'
-
-require 'facet/string/camelcase'
-require 'facet/string/camelize'
-
-require 'facet/string/underscore'
-require 'facet/string/humanize'
-
-require 'facet/string/basename'
-require 'facet/string/demodulize'
-
-require 'facet/string/upcase'
-require 'facet/string/downcase'
-require 'facet/string/capitalized'
-
-require 'facet/string/ordinal'
-
-# don't exist, should they?
-#require 'facet/symbol/singular'
-#require 'facet/symbol/plural'
-
-require 'facet/symbol/camelcase'
-require 'facet/symbol/camelize'
-
-require 'facet/symbol/underscore'
-
-require 'facet/symbol/upcase'
-require 'facet/symbol/downcase'
-require 'facet/symbol/capitalize'
-require 'facet/symbol/capitalized'
-

data/lib/facets/group/nilasemptiness.rb

@@ -1,34 +0,0 @@
-
-# :title: NilClass as Emptiness/Nothingness
-#
-# The ideas here is to have nil act more like
-# an empty set than an error catcher.
-# So you get responses like
-#
-#   nil.include?(:x) # => nil
-#
-# instead of an error being raised.
-#
-# WARNING! One should be aware that in some rare cases
-# incompatabilites may arise when using these methods in
-# conjuction with other libraries.
-
-require 'nilclass/to_f'
-require 'nilclass/to_h'
-require 'nilclass/op_fetch'
-require 'nilclass/include'
-require 'nilclass/empty'
-require 'nilclass/size'
-#require 'nano/nilclass/length'
-
-# Effectively, the following is what happens:
-#
-# class NilClass
-#   def to_f; 0.0; end
-#   def to_h; {}; end
-#   def size; 0; end
-#   def length; 0; end
-#   def empty?; true; end
-#   def [](*args); nil; end
-#   def include?(*args); nil; end
-# end

data/lib/facets/group/random.rb

@@ -1,21 +0,0 @@
-
-# :title: Randomization Methods
-#
-# All the facets related to _randomness_.
-#
-
-require 'facet/array/at_rand'
-require 'facet/array/rand_indexes'
-require 'facet/array/rand_subset'
-require 'facet/array/shuffle'
-
-require 'facet/hash/rand_value'
-require 'facet/hash/rand_key'
-require 'facet/hash/rand_pair'
-require 'facet/hash/shuffle'
-
-require 'facet/string/at_rand'
-require 'facet/string/rand_byte'
-require 'facet/string/shuffle'
-
-require 'facet/kernel/maybe'