epitools 0.4.19 → 0.4.20

data/README.rdoc

@@ -12,7 +12,7 @@ Extras:
 * {Rash}[http://rdoc.info/github/epitron/epitools/master/Rash] (a hash which can have Regexps as keys, allowing a single (key,value) pair to match many keys.)
 * {Progressbar}[http://rdoc.info/github/epitron/epitools/master/Progressbar] (better than the progressbar gem)
 * {Browser}[http://rdoc.info/github/epitron/epitools/master/Browser] (a fake browser, using mechanize, Progressbar, and CacheDB)
-  
+
 == Installing
 
   gem install epitools

data/VERSION

@@ -1 +1 @@
-0.4.19
+0.4.20

data/epitools.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{epitools}
-  s.version = "0.4.19"
+  s.version = "0.4.20"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["epitron"]
-  s.date = %q{2011-03-30}
+  s.date = %q{2011-04-02}
   s.description = %q{Miscellaneous utility libraries to make my life easier.}
   s.email = %q{chris@ill-logic.com}
   s.extra_rdoc_files = [
@@ -34,6 +34,7 @@ Gem::Specification.new do |s|
     "lib/epitools/lcs.rb",
     "lib/epitools/metaclass.rb",
     "lib/epitools/niceprint.rb",
+    "lib/epitools/numwords.rb",
     "lib/epitools/path.rb",
     "lib/epitools/permutations.rb",
     "lib/epitools/pretty_backtrace.rb",
@@ -49,6 +50,7 @@ Gem::Specification.new do |s|
     "spec/clitools_spec.rb",
     "spec/lcs_spec.rb",
     "spec/metaclass_spec.rb",
+    "spec/numwords_spec.rb",
     "spec/path_spec.rb",
     "spec/permutations_spec.rb",
     "spec/rash_spec.rb",
@@ -69,6 +71,7 @@ Gem::Specification.new do |s|
     "spec/clitools_spec.rb",
     "spec/lcs_spec.rb",
     "spec/metaclass_spec.rb",
+    "spec/numwords_spec.rb",
     "spec/path_spec.rb",
     "spec/permutations_spec.rb",
     "spec/rash_spec.rb",

data/lib/epitools.rb

@@ -34,6 +34,7 @@ end
   colored
   clitools
   permutations
+  numwords
 ].each do |mod|
   require_wrapper.call mod
 end

data/lib/epitools/numwords.rb

@@ -0,0 +1,110 @@
+require 'epitools/basetypes'
+
+class Numeric
+  
+  NAMES_SMALL = [
+    "zero", "one", "two", "three", "four", "five", "six", "seven", "eight", "nine", "ten", "eleven", "twelve", "thirteen", "fourteen", "fifteen", "sixteen", "seventeen", "eighteen", "nineteen"
+  ]
+
+  NAMES_MEDIUM = [
+    "twenty", "thirty", "fourty", "fifty", "sixty", "seventy", "eighty", "ninety"
+  ] 
+
+  NAMES_LARGE = [
+    "thousand", "million", "billion", "trillion", "quadrillion", "quintillion", "sextillion", "septillion", "octillion", "nonillion", "decillion", "undecillion", "duodecillion", "tredecillion", "quattuordecillion", "quindecillion", "sexdecillion", "septendecillion", "octodecillion", "novemdecillion", "vigintillion", "unvigintillion", "duovigintillion", "trevigintillion", "quattuorvigintillion", "quinvigintillion", "sexvigintillion", "septenvigintillion", "octovigintillion", "novemvigintillion", "trigintillion", "untrigintillion", "duotrigintillion"
+  ]
+
+  
+  #
+  # Convert this number to words (eg: 69 => 'sixty-nine').
+  # Works with numbers up to a googol (10^100).
+  #
+  def to_words
+    
+    if is_a? Integer
+      num = self
+    else
+      num = self.to_i
+    end
+    
+    if (n = to_s.size) > 102
+      return "more than a googol! (#{n} digits)"
+    end
+    
+    whole_thing = []
+    
+    triplets = commatize.split(',')
+    num_triplets = triplets.size
+    
+    triplets.each_with_index do |triplet, i|
+      result = []
+      
+      tens, hunds = nil, nil
+      
+      chars = triplet.chars.to_a
+      
+      raise "Error: Not a triplet: #{triplet}" if chars.size > 3 or chars.size < 1      
+      
+      if chars.size == 3
+        n = chars.shift.to_i 
+        hunds = NAMES_SMALL[n] + "-hundred" if n > 0 
+        chars.shift if chars.first == '0'
+      end
+      
+      if chars.size == 2 
+        n = chars.join('').to_i
+        
+        if n > 0 and n < 20 
+          tens = NAMES_SMALL[n] 
+        elsif n > 0
+          tens = NAMES_MEDIUM[chars.shift.to_i - 2]
+          if chars.first != '0'
+            tens += "-" + NAMES_SMALL[chars.shift.to_i]
+          else
+            chars.shift
+          end
+        end
+      end
+      
+      if chars.size == 1
+        n = chars.join('').to_i 
+        tens = NAMES_SMALL[n] if n > 0 
+      end
+            
+      
+      if hunds 
+        if tens 
+          result << "#{hunds} and #{tens}" 
+        else 
+          result << hunds 
+        end
+      else 
+        result << tens if tens
+      end
+  
+      magnitude = (num_triplets - i)
+      result << NAMES_LARGE[magnitude-2] if magnitude > 1
+        
+      whole_thing << result.join(' ')
+    end
+    
+    whole_thing.join ', '
+    
+  end
+
+  #
+  # Gives all numbers ".thousand", ".million", up to ".duotrigintillion" methods.
+  # eg: 10.million #=> 10_000_000
+  #
+  def method_missing(meth, &block)
+    if magnitude = NAMES_LARGE.index(meth.to_s)
+      pow = (magnitude+1) * 3
+      self * 10**pow
+    else
+      super
+    end
+  end
+  
+end
+
+

data/spec/numwords_spec.rb

@@ -0,0 +1,29 @@
+require 'epitools/numwords'
+
+describe Numeric do
+  
+  it "to_wordses" do
+    {
+      10 => "ten",
+      3_123 => "three thousand, one-hundred and twenty-three",
+      123_124 => "one-hundred and twenty-three thousand, one-hundred and twenty-four",
+      
+      8_128_937_981_273_987_129_837_174_612_897_638_613 => "eight undecillion, one-hundred and twenty-eight decillion, nine-hundred and thirty-seven nonillion, nine-hundred and eighty-one octillion, two-hundred and seventy-three septillion, nine-hundred and eighty-seven sextillion, one-hundred and twenty-nine quintillion, eight-hundred and thirty-seven quadrillion, one-hundred and seventy-four trillion, six-hundred and twelve billion, eight-hundred and ninety-seven million, six-hundred and thirty-eight thousand, six-hundred and thirteen",
+      
+      3_486_597_230_495_871_304_981_320_498_123_498_263_984_739_841_834_091_823_094_812_039_481_231_623_987_461_293_874_698_123_649_817_236 => "three duotrigintillion, four-hundred and eighty-six untrigintillion, five-hundred and ninety-seven trigintillion, two-hundred and thirty novemvigintillion, four-hundred and ninety-five octovigintillion, eight-hundred and seventy-one septenvigintillion, three-hundred and four sexvigintillion, nine-hundred and eighty-one quinvigintillion, three-hundred and twenty quattuorvigintillion, four-hundred and ninety-eight trevigintillion, one-hundred and twenty-three duovigintillion, four-hundred and ninety-eight unvigintillion, two-hundred and sixty-three vigintillion, nine-hundred and eighty-four novemdecillion, seven-hundred and thirty-nine octodecillion, eight-hundred and fourty-one septendecillion, eight-hundred and thirty-four sexdecillion, ninety-one quindecillion, eight-hundred and twenty-three quattuordecillion, ninety-four tredecillion, eight-hundred and twelve duodecillion, thirty-nine undecillion, four-hundred and eighty-one decillion, two-hundred and thirty-one nonillion, six-hundred and twenty-three octillion, nine-hundred and eighty-seven septillion, four-hundred and sixty-one sextillion, two-hundred and ninety-three quintillion, eight-hundred and seventy-four quadrillion, six-hundred and ninety-eight trillion, one-hundred and twenty-three billion, six-hundred and fourty-nine million, eight-hundred and seventeen thousand, two-hundred and thirty-six",
+      
+      1763241823498172490817349807213409238409123409128340981234781236487126348791263847961238794612839468917236489712364987162398746129834698172364987123 => "more than a googol! (148 digits)"      
+    }.each do |num, result|
+      num.to_words.should == result
+    end
+  end
+
+  it "has .thousand, .million, etc." do
+    10.thousand.should == 10_000
+    20.billion.should == 20_000_000_000
+    1.9.million.should == 1_900_000
+    37.2872.duotrigintillion.should == 37287200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
+    lambda { 10.googol }.should raise_error
+  end
+  
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: epitools
 version: !ruby/object:Gem::Version 
-  hash: 41
+  hash: 39
   prerelease: false
   segments: 
   - 0
   - 4
-  - 19
-  version: 0.4.19
+  - 20
+  version: 0.4.20
 platform: ruby
 authors: 
 - epitron
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-03-30 00:00:00 -04:00
+date: 2011-04-02 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -91,6 +91,7 @@ files:
 - lib/epitools/lcs.rb
 - lib/epitools/metaclass.rb
 - lib/epitools/niceprint.rb
+- lib/epitools/numwords.rb
 - lib/epitools/path.rb
 - lib/epitools/permutations.rb
 - lib/epitools/pretty_backtrace.rb
@@ -106,6 +107,7 @@ files:
 - spec/clitools_spec.rb
 - spec/lcs_spec.rb
 - spec/metaclass_spec.rb
+- spec/numwords_spec.rb
 - spec/path_spec.rb
 - spec/permutations_spec.rb
 - spec/rash_spec.rb
@@ -154,6 +156,7 @@ test_files:
 - spec/clitools_spec.rb
 - spec/lcs_spec.rb
 - spec/metaclass_spec.rb
+- spec/numwords_spec.rb
 - spec/path_spec.rb
 - spec/permutations_spec.rb
 - spec/rash_spec.rb