human_numbers 0.0.4 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2c27203e87af4959fab86a60ebe89f77f2f8c44d
-  data.tar.gz: 870df52ff4bf50da56ba750c9a9473074474e966
+  metadata.gz: 51879c78691b24478ed71ee9bd575ef199a0e6de
+  data.tar.gz: e62d835ba04175b547c8c1fc6f6a59ba829357ac
 SHA512:
-  metadata.gz: 66d8ed47bdabf5f534893140eef1b60e5ea155abf75eff96bb5ddaf0fbed885a3cfc37db0e3fc2325f170cffd383fe73ca33001e1c616f76df0d6f9abc368a30
-  data.tar.gz: 314579ebbe2f2f8708ae7f493c339b34eac34f837dc83ef7ef8a2cba3debafd4984d0c526dac955f92d539deda4ee71b164614b7825757ad2cdd6314dacc2f62
+  metadata.gz: d29db2bd8b55c18c3cf21533c137feb286d6ace111d0a452949557caaa4e82bb8e141cd83b1563e8c8b6fd4afc11f84848024cdeae8ef2d0131e10489b7c9a52
+  data.tar.gz: 678e077627851c8478df921b63791345c835c9c803cc4f09ce134f94c831d4b17f4ac462a9174bdd61909d183c943cb075995f12bc405bdf1fb5381ea7ca6a37

data/lib/human_numbers.rb

@@ -1,4 +1,6 @@
 module HumanNumbers
+  UPPER_BOUND = 10 ** 33
 end
 
 require 'human_numbers/english'
+require 'human_numbers/french'

data/lib/human_numbers/english.rb

@@ -5,32 +5,33 @@ module HumanNumbers::English
 
   def self.cardinal_number(n, prefix='')
     return prefix.empty? ? 'zero' : '' if n.zero?
-    if n >= 1_000_000_000_000_000_000_000_000_000_000_000
+    if n >= HumanNumbers::UPPER_BOUND
       raise ArgumentError, "number too large to print in English: #{n}"
     end
 
-    prefix + if n >= 1_000_000_000_000_000_000_000_000_000_000
-      cardinal_factor(n, 'nonillion', 1_000_000_000_000_000_000_000_000_000_000)
-    elsif n >= 1_000_000_000_000_000_000_000_000_000
-      cardinal_factor(n, 'octillion',   1_000_000_000_000_000_000_000_000_000)
-    elsif n >= 1_000_000_000_000_000_000_000_000
-      cardinal_factor(n, 'septillion',  1_000_000_000_000_000_000_000_000)
-    elsif n >= 1_000_000_000_000_000_000_000
-      cardinal_factor(n, 'sextillion',  1_000_000_000_000_000_000_000)
-    elsif n >= 1_000_000_000_000_000_000
-      cardinal_factor(n, 'quintillion', 1_000_000_000_000_000_000)
-    elsif n >= 1_000_000_000_000_000
-      cardinal_factor(n, 'quadrillion', 1_000_000_000_000_000)
-    elsif n >= 1_000_000_000_000
-      cardinal_factor(n, 'trillion',    1_000_000_000_000)
-    elsif n >= 1_000_000_000
-      cardinal_factor(n, 'billion',     1_000_000_000)
-    elsif n >= 1_000_000
-      cardinal_factor(n, 'million',     1_000_000)
-    elsif n >= 1000
-      cardinal_factor(n, 'thousand',    1000)
-    elsif n >= 100
-      cardinal_factor(n, 'hundred',     100)
+    prefix +
+    if    n >= 10 ** 30
+      cardinal_factor(n, 'nonillion',   10 ** 30)
+    elsif n >= 10 ** 27
+      cardinal_factor(n, 'octillion',   10 ** 27)
+    elsif n >= 10 ** 24
+      cardinal_factor(n, 'septillion',  10 ** 24)
+    elsif n >= 10 ** 21
+      cardinal_factor(n, 'sextillion',  10 ** 21)
+    elsif n >= 10 ** 18
+      cardinal_factor(n, 'quintillion', 10 ** 18)
+    elsif n >= 10 ** 15
+      cardinal_factor(n, 'quadrillion', 10 ** 15)
+    elsif n >= 10 ** 12
+      cardinal_factor(n, 'trillion',    10 ** 12)
+    elsif n >= 10 ** 9
+      cardinal_factor(n, 'billion',     10 ** 9)
+    elsif n >= 10 ** 6
+      cardinal_factor(n, 'million',     10 ** 6)
+    elsif n >= 10 ** 3
+      cardinal_factor(n, 'thousand',    10 ** 3)
+    elsif n >= 10 ** 2
+      cardinal_factor(n, 'hundred',     10 ** 2)
     elsif n >= 20
       simple_cardinal(n / 10 * 10) + simple_cardinal(n % 10, '-')
     else
@@ -40,35 +41,36 @@ module HumanNumbers::English
 
   def self.simple_cardinal(n, prefix='')
     return '' if n.zero?
-    prefix + case n
-             when  1; 'one'
-             when  2; 'two'
-             when  3; 'three'
-             when  4; 'four'
-             when  5; 'five'
-             when  6; 'six'
-             when  7; 'seven'
-             when  8; 'eight'
-             when  9; 'nine'
-             when 10; 'ten'
-             when 11; 'eleven'
-             when 12; 'twelve'
-             when 13; 'thirteen'
-             when 14; 'fourteen'
-             when 15; 'fifteen'
-             when 16; 'sixteen'
-             when 17; 'seventeen'
-             when 18; 'eighteen'
-             when 19; 'nineteen'
-             when 20; 'twenty'
-             when 30; 'thirty'
-             when 40; 'forty'
-             when 50; 'fifty'
-             when 60; 'sixty'
-             when 70; 'seventy'
-             when 80; 'eighty'
-             when 90; 'ninety'
-             end
+    prefix +
+    case n
+    when  1; 'one'
+    when  2; 'two'
+    when  3; 'three'
+    when  4; 'four'
+    when  5; 'five'
+    when  6; 'six'
+    when  7; 'seven'
+    when  8; 'eight'
+    when  9; 'nine'
+    when 10; 'ten'
+    when 11; 'eleven'
+    when 12; 'twelve'
+    when 13; 'thirteen'
+    when 14; 'fourteen'
+    when 15; 'fifteen'
+    when 16; 'sixteen'
+    when 17; 'seventeen'
+    when 18; 'eighteen'
+    when 19; 'nineteen'
+    when 20; 'twenty'
+    when 30; 'thirty'
+    when 40; 'forty'
+    when 50; 'fifty'
+    when 60; 'sixty'
+    when 70; 'seventy'
+    when 80; 'eighty'
+    when 90; 'ninety'
+    end
   end
 
   def self.ordinal_number(n)

data/lib/human_numbers/french.rb

@@ -0,0 +1,118 @@
+# -*- coding: utf-8 -*-
+
+module HumanNumbers::French
+  def self.cardinal_factor(n, name, factor, gender)
+    factored = n / factor
+    mod = n % factor
+    name += 's' if factor > 1000 and factored > 1
+    cardinal_number(factored) + "-#{name}" + cardinal_number(mod, gender, '-')
+  end
+
+  def self.cardinal_number(n, gender=:masculine, prefix='')
+    return prefix.empty? ? 'zéro' : '' if n.zero?
+    if n >= HumanNumbers::UPPER_BOUND
+      raise ArgumentError, "number too large to print in French: #{n}"
+    end
+
+    prefix +
+    if    n >= 10 ** 30
+      cardinal_factor(n, 'quintillion',  10 ** 30, gender)
+    elsif n >= 10 ** 27
+      cardinal_factor(n, 'quadrilliard', 10 ** 27, gender)
+    elsif n >= 10 ** 24
+      cardinal_factor(n, 'quadrillion',  10 ** 24, gender)
+    elsif n >= 10 ** 21
+      cardinal_factor(n, 'trilliard',    10 ** 21, gender)
+    elsif n >= 10 ** 18
+      cardinal_factor(n, 'trillion',     10 ** 18, gender)
+    elsif n >= 10 ** 15
+      cardinal_factor(n, 'billiard',     10 ** 15, gender)
+    elsif n >= 10 ** 12
+      cardinal_factor(n, 'billion',      10 ** 12, gender)
+    elsif n >= 10 ** 9
+      cardinal_factor(n, 'milliard',     10 ** 9, gender)
+    elsif n >= 10 ** 6
+      cardinal_factor(n, 'million',      10 ** 6, gender)
+    elsif n >= 2000
+      cardinal_factor(n, 'mille',        10 ** 3, gender)
+    elsif n >= 1000
+      'mille' + simple_cardinal(n % 1000, gender, '-')
+    elsif n > 100 and n % 100 == 0
+      cardinal_number(n / 100) + '-cents'
+    elsif n >= 200
+      cardinal_factor(n, 'cent', 100, gender)
+    elsif n >= 100
+      'cent' + simple_cardinal(n % 100, gender, '-')
+    elsif n > 80
+      'quatre-vingt' + simple_cardinal(n - 80, gender, '-')
+    elsif n == 80
+      'quatre-vingts'
+    elsif n == 71
+      'soixante-et-onze'
+    elsif n > 60
+      'soixante' + simple_cardinal(n - 60, gender, '-')
+    elsif n > 20
+      mod = n % 10
+      simple_cardinal(n / 10 * 10) +
+        simple_cardinal(mod, gender, mod == 1 ? '-et-' : '-')
+    else
+      simple_cardinal(n, gender)
+    end
+  end
+
+  def self.simple_cardinal(n, gender=:masculine, prefix='')
+    return '' if n.zero?
+
+    prefix +
+    case n
+    when  1; gender == :masculine ? 'un' : 'une'
+    when  2; 'deux'
+    when  3; 'trois'
+    when  4; 'quatre'
+    when  5; 'cinq'
+    when  6; 'six'
+    when  7; 'sept'
+    when  8; 'huit'
+    when  9; 'neuf'
+    when 10; 'dix'
+    when 11; 'onze'
+    when 12; 'douze'
+    when 13; 'treize'
+    when 14; 'quatorze'
+    when 15; 'quinze'
+    when 16; 'seize'
+    when 17; 'dix-sept'
+    when 18; 'dix-huit'
+    when 19; 'dix-neuf'
+    when 20; 'vingt'
+    when 30; 'trente'
+    when 40; 'quarante'
+    when 50; 'cinquante'
+    when 60; 'soixante'
+    end
+  end
+
+  def self.ordinal_number(n, gender)
+    case n
+    when 1; gender == :masculine ? 'premier' : 'première'
+    when 5; 'cinquième'
+    else
+      cardinal_number(n, gender).sub(/f$/, 'v').sub(/e?$/, 'ième')
+    end
+  end
+end
+
+class Integer
+  def to_french(style = :cardinal, gender = :masculine)
+    unless [:masculine, :feminine].include? gender
+      raise ArgumentError, "unrecognized gender: #{gender}"
+    end
+
+    (self < 0 ? 'moins ' : '') +
+      case style
+      when :ordinal;  HumanNumbers::French::ordinal_number(self.abs,  gender)
+      when :cardinal; HumanNumbers::French::cardinal_number(self.abs, gender)
+      else raise ArgumentError, "unrecognized number style: #{style}"
+      end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: human_numbers
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.1.0
 platform: ruby
 authors:
 - Kyle Brown
@@ -45,11 +45,14 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 1.1.11
 description: |
-  human_numbers defines the methods Float#to_english and Integer#to_english for
-  converting numbers to English strings. By default, a cardinal number will be
-  returned (one, two, three), but supplying an :ordinal argument will return an
-  ordinal (first, second, third). Handles numbers with absolute value less than
-  1000000000000000000000000000000000.
+  human_numbers defines the method #to_english on the classes Float and
+  Integer, as well as the method #to_french on the Integer class, for
+  converting numbers to natural language strings. By default, a cardinal
+  number will be returned (one, two, three), but supplying an :ordinal
+  argument will cause it to return an ordinal (first, second, third). It
+  works with numbers whose absolute value is less than 10^33. #to_french
+  supports a second argument for specifying the gender of the word,
+  which can be either :masculine or :feminine.
 email: picokyle@gmail.com
 executables: []
 extensions: []
@@ -57,6 +60,7 @@ extra_rdoc_files: []
 files:
 - lib/human_numbers.rb
 - lib/human_numbers/english.rb
+- lib/human_numbers/french.rb
 homepage: https://github.com/kybp/human_numbers
 licenses:
 - MIT
@@ -80,5 +84,5 @@ rubyforge_project:
 rubygems_version: 2.5.1
 signing_key: 
 specification_version: 4
-summary: Print numbers in English
+summary: Print numbers in English and French
 test_files: []