ruby-nuggets 0.2.9.266 → 0.3.0.275

data/README

@@ -2,7 +2,7 @@
 
 == VERSION
 
-This documentation refers to ruby-nuggets version 0.2.9
+This documentation refers to ruby-nuggets version 0.3.0
 
 
 == DESCRIPTION

data/lib/nuggets/numeric/duration.rb

@@ -0,0 +1,109 @@
+#--
+###############################################################################
+#                                                                             #
+# A component of ruby-nuggets, some extensions to the Ruby programming        #
+# language.                                                                   #
+#                                                                             #
+# Copyright (C) 2007-2008 Jens Wille                                          #
+#                                                                             #
+# Authors:                                                                    #
+#     Jens Wille <jens.wille@uni-koeln.de>                                    #
+#                                                                             #
+# ruby-nuggets is free software; you can redistribute it and/or modify it     #
+# under the terms of the GNU General Public License as published by the Free  #
+# Software Foundation; either version 3 of the License, or (at your option)   #
+# any later version.                                                          #
+#                                                                             #
+# ruby-nuggets 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. See the GNU General Public License for    #
+# more details.                                                               #
+#                                                                             #
+# You should have received a copy of the GNU General Public License along     #
+# with ruby-nuggets. If not, see <http://www.gnu.org/licenses/>.              #
+#                                                                             #
+###############################################################################
+#++
+
+class Numeric
+
+  # call-seq:
+  #   num.hms => anArray
+  #
+  # Converts _num_ into hour, minute, and second portions.
+  def hms
+    raise ArgumentError, "negative duration #{self}" if self < 0
+
+    one_minute = 60
+    one_hour   = 60 * one_minute
+
+    [((h,) = divmod(one_hour)).last.divmod(one_minute), h].reverse.flatten  # *SCNR* ;-)
+  end
+
+  # call-seq:
+  #   num.ymd => anArray
+  #
+  # Converts _num_ into year, month, and day portions.
+  def ymd
+    raise ArgumentError, "negative duration #{self}" if self < 0
+
+    one_day   = 24 * 60 * 60
+    one_month = 30 * one_day
+    one_year  = 365.25 * one_day
+
+    y, m = divmod(one_year)
+    m, d = m.divmod(one_month)
+
+    [y, m, d / one_day]
+  end
+
+  # call-seq:
+  #   num.to_hms(precision = 0, labels = %w[h m s]) => aString
+  #
+  # Produces a stringified version of _num_'s time portions (cf. #hms),
+  # with the specified +precision+ for the seconds (treated as floating
+  # point). The individual parts are labelled as specified in the +labels+
+  # parameter (hours, minutes, seconds in that order). Leading parts with
+  # a value of zero are omitted.
+  #
+  # Examples:
+  #   180.to_hms               #=> "3m0s"
+  #   180.75.to_hms            #=> "3m1s"
+  #   180.75.to_hms(2)         #=> "3m0.75s"
+  #   8180.to_hms              #=> "2h16m20s"
+  #   8180.to_hms(0, %w[: :])  #=> "2:16:20"
+  def to_hms(precision = 0, labels = %w[h m s], time = hms)
+    h, m, s = time
+
+    h.zero? ? m.zero? ?
+      "%0.#{precision}f#{labels[2]}" % [s] :
+      "%d#{labels[1]}%0.#{precision}f#{labels[2]}" % [m, s] :
+      "%d#{labels[0]}%d#{labels[1]}%0.#{precision}f#{labels[2]}" % [h, m, s]
+  end
+
+  # call-seq:
+  #   num.to_ymd(include_hms = false, labels = %w[y m d]) => aString
+  #
+  # Produces a stringified version of _num_'s date portions (cf. #ymd),
+  # analogous to #to_hms. Includes time portions (cf. #hms) if +include_hms+
+  # is true.
+  def to_ymd(include_hms = false, labels = %w[y m d])
+    unless include_hms
+      to_hms(0, labels, ymd)
+    else
+      y, m, d = ymd
+      e = d.truncate
+
+      "#{to_hms(0, labels, [y, m, e])} #{((d - e) * 24 * 60 * 60).to_hms}"
+    end
+  end
+
+end
+
+if $0 == __FILE__
+  [123, 123456789, 0, 0.001, 1.23, 1234.56789].each { |n|
+    p n
+    p [n.hms, n.to_hms, n.to_hms(2)]
+    p [n.ymd, n.to_ymd, n.to_ymd(true)]
+  }
+end

data/lib/nuggets/version.rb

@@ -3,8 +3,8 @@ module Nuggets
   module Version
 
     MAJOR = 0
-    MINOR = 2
-    TINY  = 9
+    MINOR = 3
+    TINY  = 0
 
     class << self
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: ruby-nuggets
 version: !ruby/object:Gem::Version 
-  version: 0.2.9.266
+  version: 0.3.0.275
 platform: ruby
 authors: 
 - Jens Wille
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-07-30 00:00:00 +02:00
+date: 2008-08-15 00:00:00 +02:00
 default_executable: 
 dependencies: []
 
@@ -59,6 +59,7 @@ files:
 - lib/nuggets/array/format.rb
 - lib/nuggets/array/combination.rb
 - lib/nuggets/numeric/between.rb
+- lib/nuggets/numeric/duration.rb
 - lib/nuggets/numeric/signum.rb
 - lib/nuggets/numeric/limit.rb
 - lib/nuggets/numeric/to_multiple.rb
@@ -82,10 +83,10 @@ has_rdoc: true
 homepage: http://prometheus.rubyforge.org/ruby-nuggets
 post_install_message: 
 rdoc_options: 
-- --title
-- ruby-nuggets Application documentation
 - --charset
 - UTF-8
+- --title
+- ruby-nuggets Application documentation
 - --main
 - README
 - --all