wordify 0.1.0

data/README.rdoc

@@ -0,0 +1,11 @@
+== Wordify
+
+Wordify converts Numerics into words (currently only British English format).
+
+Example:
+
+  120345.in_words #=> "one hundred and twenty thousand, three hundred and fourty five"
+
+And in tokens...
+
+  120345.in_words(:tokens => true) #=> "one two zero three four five"

data/lib/wordify.rb

@@ -0,0 +1,38 @@
+$:.unshift(File.dirname(__FILE__)) unless $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+module Wordify; end
+
+require 'wordify/token'
+require 'wordify/tokeniser'
+require 'wordify/constructor'
+
+module Wordify
+  class << self
+    def units; %w[zero one two three four five six seven eight nine]; end
+    def teens; %w[ten eleven twelve thirteen fourteen fifteen sixteen seventeen eighteen nineteen]; end
+    def tens;  %w[zero ten twenty thirty fourty fifty sixty seventy eighty ninety]; end
+    def qnts
+      %w[hundred thousand million billion trillion quadrillion quintillion] + 
+      %w[sextillion septillion octillion nonillion decillion undecillion]  +
+      %w[duodecillion tredecillion quattuordecillion quindecillion sexdecillion] +
+      %w[septendecillion octodecillion novemdecillion vigintillion centillion]
+    end
+  end
+
+  module Numeric
+    def in_words(options={})
+      options[:tokens] ? tokenise : construct_sentence
+    end
+    
+    protected
+    
+      def construct_sentence
+        Wordify::Constructor.new(self).to_sentence
+      end
+
+      def tokenise
+        Wordify::Tokeniser.new(self).to_s
+      end
+  end
+end
+
+class Numeric; include Wordify::Numeric; end

data/lib/wordify/constructor.rb

@@ -0,0 +1,71 @@
+class Wordify::Constructor
+  attr_reader :number
+  
+  def initialize(number)
+    @number = number
+  end
+  
+  def to_sentence
+    if unreadable? || out_of_range?
+      sentence = number.to_s
+    else
+      sentence = []
+      tokens_in_hundreds.each_with_index do |h, i|
+        sentence << (qnts[i] and i+1 != qnts.size ? "#{h} #{qnts[i]}" : h) if h
+      end
+
+      last = sentence.pop
+      prev = sentence.compact
+      sentence = if qnts.detect{ |q| last.include?(q) }
+        [prev, last].flatten.join(', ')
+      else
+        [(prev.any? ? prev.join(', ') : nil), last].compact.join(' and ')
+      end
+      sentence += ' ' + tokenised_decimals if decimals
+    end
+    sentence
+  end
+  alias_method :to_s, :to_sentence
+    
+  def eql?(other)
+    to_sentence == other.to_sentence
+  end
+  alias_method :==, :eql?
+  
+  def <=>(other)
+    to_sentence <=> other.to_sentence
+  end
+    
+  def out_of_range?
+    tokens.size > 23
+  end
+  
+  def unreadable?
+    number.to_s.match(/[\+\-]/) != nil
+  end
+    
+  def parts
+    @parts ||= number.to_s.split('.')
+  end
+  
+  def tokens
+    @tokens ||= parts[0].reverse.scan(/([0-9]{1,3})/).flatten.map { |i| i.reverse }.reverse
+  end
+  
+  def tokens_in_hundreds
+    @tokens_in_hundreds ||= tokens.map { |token| Wordify::Token::Hundreds.new(token).to_s }
+  end
+
+  def decimals
+    @decimals ||= parts[1] ? ".#{parts[1]}" : nil
+  end
+  
+  def tokenised_decimals
+    @decimals_to_tokens ||= decimals ? Wordify::Tokeniser.new(decimals).to_s : nil
+  end
+  
+  def qnts
+    Wordify.qnts.first(tokens_in_hundreds.size).reverse
+  end
+
+end

data/lib/wordify/token.rb

@@ -0,0 +1,4 @@
+module Wordify::Token; end
+require 'wordify/token/unit'
+require 'wordify/token/tens'
+require 'wordify/token/hundreds'

data/lib/wordify/token/hundreds.rb

@@ -0,0 +1,44 @@
+class Wordify::Token::Hundreds
+  attr_reader :string, :number
+  def initialize(string)
+    @string, @number = string, string.to_i
+  end
+  
+  def raw_tokens
+    @raw_tokens ||= string.scan(/[0-9]/).map { |t| Wordify::Token::Unit.new(t) }
+  end
+
+  def tokens
+    @tokens ||= ([Wordify::Token::Unit.new('0')]*(3-raw_tokens.size)) + raw_tokens
+  end
+
+  def size
+    tokens.size
+  end
+
+  def hundreds
+    tokens[0].zero? ? nil : "#{tokens[0].unit} hundred"
+  end
+  
+  def tens
+    Wordify::Token::Tens.new(tokens[1], tokens[2]).to_s
+  end
+
+  def group
+    @group ||= [hundreds, tens].compact
+  end
+
+  def to_s
+    return nil if number.zero?
+    group.any? ? group.join(' and ') : nil
+  end
+
+  def eql?(other)
+    to_s == other.to_s
+  end
+  alias_method :==, :eql?
+  
+  def <=>(other)
+    to_s <=> other.to_s
+  end
+end

data/lib/wordify/token/tens.rb

@@ -0,0 +1,41 @@
+class Wordify::Token::Tens
+  attr_reader :tens, :unit
+  def initialize(*unit_tokens)
+    @tens, @unit = unit_tokens
+    raise StandardError,  'Invalid tokens' unless valid?
+  end
+  
+  def ten?
+    tens.number > 1
+  end
+  
+  def teen?
+    tens.number == 1
+  end
+  
+  def valid?
+    tens.is_a?(Wordify::Token::Unit) and unit.is_a?(Wordify::Token::Unit)
+  end
+  
+  def to_s
+    chars = []
+    if ten?
+      chars << Wordify.tens[tens.number]
+      chars << unit.unit unless unit.zero?
+    elsif teen?
+      chars << Wordify.teens[unit.number]
+    else
+      chars << unit.unit unless unit.zero?
+    end
+    chars.any? ? chars.join(' ') : nil
+  end
+  
+  def eql?(other)
+    to_s == other.to_s
+  end
+  alias_method :==, :eql?
+  
+  def <=>(other)
+    to_s <=> other.to_s
+  end
+end

data/lib/wordify/token/unit.rb

@@ -0,0 +1,36 @@
+class Wordify::Token::Unit
+  attr_reader :character
+  def initialize(char)
+    @character = char
+  end
+  
+  def number
+    point? ? nil : character.to_i
+  end
+  
+  def point?
+    character == '.'
+  end
+  
+  def unit?
+    not point?
+  end
+  
+  def zero?
+    character == '0'
+  end
+  
+  def unit
+    @unit ||= point? ? 'point' : Wordify.units[character.to_i]
+  end
+  alias_method :to_s, :unit
+  
+  def eql?(other)
+    character == other.character
+  end
+  alias_method :==, :eql?
+  
+  def <=>(other)
+    character <=> other.character
+  end
+end

data/lib/wordify/tokeniser.rb

@@ -0,0 +1,29 @@
+class Wordify::Tokeniser
+  attr_reader :number
+
+  def initialize(number)
+    @number = number
+  end
+  
+  def to_s
+    unreadable? ? number.to_s : tokens.map { |t| t.to_s }.join(' ')
+  end
+  
+  def eql?(other)
+    to_s == other.to_s
+  end
+  alias_method :==, :eql?
+  
+  def <=>(other)
+    to_s <=> other.to_s
+  end
+  
+  def unreadable?
+    number.to_s.match(/[\+\-]/) != nil
+  end
+  
+  def tokens
+    @tokens ||= number.to_s.scan(/(.)/).flatten.map { |char| Wordify::Token::Unit.new(char) }
+  end
+  
+end

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification 
+name: wordify
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Alex Neill
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-12-01 00:00:00 +00:00
+default_executable: 
+dependencies: []
+
+description: Covert Numerics into words
+email: alex@featureless.co.uk
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.rdoc
+- lib/wordify.rb
+- lib/wordify/token.rb
+- lib/wordify/token/hundreds.rb
+- lib/wordify/token/tens.rb
+- lib/wordify/token/unit.rb
+- lib/wordify/constructor.rb
+- lib/wordify/tokeniser.rb
+has_rdoc: true
+homepage: http://github.com/ajn/wordify
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Wordify
+- --main
+- README.rdoc
+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: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Covert Numerics into words
+test_files: []
+