roman 0.2.0

data/.index

@@ -0,0 +1,72 @@
+---
+revision: 2013
+type: ruby
+sources:
+- var
+authors:
+- name: Trans
+  email: transfire@gmail.com
+organizations:
+- name: Rubyworks
+requirements:
+- groups:
+  - build
+  development: true
+  name: detroit
+- groups:
+  - build
+  development: true
+  name: ergo
+- groups:
+  - test
+  development: true
+  name: rubytest-cli
+- groups:
+  - test
+  development: true
+  name: lemon
+- groups:
+  - test
+  development: true
+  name: ae
+conflicts: []
+alternatives: []
+resources:
+- type: home
+  uri: http://rubyworks.github.com/roman
+  label: Homepage
+- type: code
+  uri: http://github.com/rubyworks/roman
+  label: Source Code
+- type: docs
+  uri: http://rubydoc.info/gems/roman
+  label: Documentation
+- type: wiki
+  uri: http://wiki.github.com/rubyworks/roman
+  label: User Guide
+- type: bugs
+  uri: http://github.com/rubyworks/roman/issues
+  label: Issue Tracker
+- type: mail
+  uri: http://groups.google.com/group/rubyworks-mailinglist
+  label: Mailing List
+repositories:
+- name: upstream
+  scm: git
+  uri: git://github.com/rubyworks/roman.git
+categories: []
+copyrights:
+- holder: Rubyworks
+  year: '2007'
+  license: BSD-2-Clause
+customs: []
+paths:
+  lib:
+  - lib
+created: '2010-03-02'
+summary: Real Roman Numerals
+title: Roman
+version: 0.2.0
+name: roman
+description: RomanNumeral class for working with roman numerals in a native form.
+date: '2013-03-09'

data/HISTORY.md

@@ -0,0 +1,19 @@
+# RELEASE HISTORY
+
+
+## 0.2.0 / 2013-03-10
+
+This release fixes the conversion of lower-case letters.
+
+Changes:
+
+* Fixed conversion of lower-case letters.
+
+
+## 0.1.0 / 2010-10-10
+
+Initialize release.
+
+Changes:
+
+* All of them ;)

data/LICENSE.txt

@@ -0,0 +1,22 @@
+(BSD-2-Clause License)
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+   1. Redistributions of source code must retain the above copyright notice,
+      this list of conditions and the following disclaimer.
+
+   2. Redistributions in binary form must reproduce the above copyright notice,
+      this list of conditions and the following disclaimer in the documentation
+      and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
+INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
+OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+

data/README.md

@@ -0,0 +1,73 @@
+# Roman Numerals
+
+[Website](http://rubyworks.github.com/roman) /
+[Documentation](http://rubydoc.info/gems/roman/frames) /
+[Report Issue](http://github.com/rubyworks/roman/issues) /
+[Source Code](http://github.com/rubyworks/roman)    
+[![Flattr Me](http://api.flattr.com/button/flattr-badge-large.png)](http://flattr.com/thing/324911/Rubyworks-Ruby-Development-Fund)
+
+## STATUS
+
+[![Gem Version](https://badge.fury.io/rb/roman.png)](http://badge.fury.io/rb/roman)
+[![Build Status](https://travis-ci.org/rubyworks/roman.png)](https://travis-ci.org/rubyworks/roman)
+
+
+## ABOUT
+
+The Roman library provides a full-fledged Numeric subclass
+for working in Roman Numerals.
+
+In most cases this library is probably overkill. Instead, 
+[Ruby Facets](http://rubyworks.github.com/facets) provides Roman numeral
+core extension methods for the `Integer` and `String` classes which are
+likely to do everything that one really needs. However, the RomanNumeral
+class has one advantage. It can be maniputated like any other Numeric
+object without having to switch back and forth between representations.
+Moreover, and probably most importantly, it makes an excellect example of
+how to create a Numeric subclass in Ruby.
+
+
+## HOW TO USE
+
+We can create Roman numerals via the usual instantiation.
+
+    RomanNumeral.new(1)    #=> #<RomanNumeral:0x7f10e378ad48 @i=1>
+
+But to make it easier the Integer class is extended with #to_roman.
+
+    1.to_roman             #=> #<RomanNumeral:0x7f10e378ad48 @i=1>
+
+Roman numerals can also be formed from their String represnetation.
+
+    RomanNumeral.new('I')  #=> #<RomanNumeral:0x7f10e378ad48 @i=1>
+
+    'I'.to_roman           #=> #<RomanNumeral:0x7f10e378ad48 @i=1>
+
+Because +RomanNumeral+ is a full-fledged subclass of Numeric,
+we can work with them like we can an Integer.
+
+     a = 2.to_roman        #=> #<RomanNumeral:0x7f10e378ad48 @i=2>
+     b = 3.to_roman        #=> #<RomanNumeral:0x7f10e378ad48 @i=3>
+     r = a + b             #=> #<RomanNumeral:0x7f10e378ad48 @i=5>
+
+When we want to see the actual Romanized figure, we simple
+call #to_s.
+
+     r.to_s                #=> "IV"
+
+
+## HOW TO INSTALL
+
+Using RubyGems:
+
+    gem install roman
+
+
+## COPYRIGHT & LICENSE
+
+Copyright (c) 2007 Rubyworks
+
+Roman is destributed under the terms of the 
+[BSD-2-Clause](http://spdx.org/license/BSD-2-Clause) license.
+
+Please see LICENSE.txt file for details.

data/lib/roman.rb

@@ -0,0 +1,285 @@
+# Work with Roman numerals just like normal Integers.
+class RomanNumeral < Numeric
+
+  include Comparable
+
+  # The largest integer representable as a roman
+  # numerable by this module.
+  MAX = 3999
+
+  # Taken from O'Reilly's Perl Cookbook 6.23. Regular Expression Grabbag.
+  REGEXP = /^M*(D?C{0,3}|C[DM])(L?X{0,3}|X[LC])(V?I{0,3}|I[VX])$/i
+
+  #
+  ROMAN_VALUES_ASSOC = [
+    ["M", 1000],
+    ["CM", 900],
+    ["D",  500],
+    ["CD", 400],
+    ["C",  100],
+    ["XC",  90],
+    ["L",   50],
+    ["XL",  40],
+    ["X",   10],
+    ["IX",   9],
+    ["V",    5],
+    ["IV",   4],
+    ["I",    1]
+  ]
+
+  #
+  ROMAN_VALUES = ROMAN_VALUES_ASSOC.inject({}){ |h,(r,a)| h[r] = a; h }
+
+  #
+  def self.from_integer(int)
+    #return nil if integer > MAX
+    return "-#{(-int).roman}" if int < 0
+    return "" if int == 0
+    ROMAN_VALUES_ASSOC.each do |(i, v)|
+      return(i + from_integer(int-v)) if v <= int 
+    end
+  end
+
+  #
+  def self.to_integer(roman)
+    #return nil unless roman_string.is_roman_numeral?
+    last = roman[-1,1].upcase
+    roman.reverse.split('').inject(0) do |result, c|
+      c = c.upcase
+      if ROMAN_VALUES[c] < ROMAN_VALUES[last]
+        result -= ROMAN_VALUES[c]
+      else
+        last = c
+        result += ROMAN_VALUES[c]
+      end
+    end
+  end
+
+  # Returns true if +string+ is a roman numeral.
+  def self.is_roman_numeral?(string)
+    REGEXP =~ string
+  end
+
+
+  # Create a new instance from an Integer, String
+  # or other RomanNumeral.
+  def initialize(val)  
+    case val
+    when String
+      @i = self.class.to_integer(val)  
+      @s = val.frozen? ? val : val.dup.freeze  
+    when Numeric  
+      @i = val.to_i  
+    else  
+      raise ArgumentError, 'Cannot convert %p' % val  
+    end  
+  end
+
+  # hash code calculation
+ 
+  def hash
+    @i.hash
+  end
+
+  #
+  def to_s
+    @s ||= self.class.from_integer(@i)
+  end
+
+  #
+  def to_num ; @i ; end
+
+  #
+  def to_i ; @i ; end
+
+  #
+  def to_int ; @i ; end
+
+  #
+  def to_arabic ; @i ; end
+
+  #
+  def to_roman
+    self  
+  end  
+
+  #
+  def eql?(num)
+    self.class.equal?(num.class) && @i == num.to_i  
+  end  
+
+  #
+  def ==(num)
+    @i == num.to_num  
+  end
+
+  #
+  def coerce(o)  
+    [self.class.new(o.to_int), self]  
+  end
+
+  #
+  def <=>(o)  
+    case o
+    when Numeric
+      @i <=> o.to_num
+    else
+      a, b = o.coerce(self)
+      a <=> b
+    end rescue nil  
+  end
+ 
+  # various tests that Fixnum also has
+ 
+  def zero?
+    @i.zero?
+  end
+ 
+  def nonzero?
+    @i.nonzero?
+  end
+ 
+  def odd?
+    @i.odd?
+  end
+ 
+  def even?
+    @i.even?
+  end
+ 
+  def between?(a, b)
+    @i.between? a, b
+  end
+ 
+  def integer?
+    true
+  end
+ 
+  def real?
+    true
+  end
+
+  def +@
+    self
+  end
+ 
+  def -@
+    self.class.new(-@i)
+  end
+
+  #
+  def +(o)
+    if Numeric === o
+      self.class.new(@i + o.to_num)
+    else
+      a, b = o.coerce(self)
+      a + b
+    end
+  end
+
+  #
+  def -(o)
+    if Numeric === o
+      self.class.new(@i - o.to_num)
+    else
+      a, b = o.coerce(self)
+      a - b
+    end
+  end
+
+  #
+  def *(o)
+    if Numeric === o
+      self.class.new(@i * o.to_num)
+    else
+      a, b = o.coerce(self)
+      a * b
+    end
+  end
+
+  #
+  def /(o)
+    if Numeric === o
+      self.class.new(@i / o.to_num)
+    else
+      a, b = o.coerce(self)
+      a / b
+    end
+  end
+
+  def **(o)
+    if Numeric === o
+      self.class.new(@i / o.to_num)
+    else
+      a, b = o.coerce(self)
+      a / b
+    end
+  end
+ 
+  def <<(o)
+    self.class.new(@i << o.to_int)
+  end
+ 
+  def >>(o)
+    self.class.new(@i >> o.to_int)
+  end
+ 
+  # bit operators
+ 
+  def &(o)
+    self.class.new(@i & o.to_int)
+  end
+ 
+  def |(o)
+    self.class.new(@i | o.to_int)
+  end
+
+  # Freeze
+  def freeze
+    to_s
+    super
+  end
+
+end
+
+
+class Integer
+
+  #
+  def self.from_roman(roman)
+    RomanNumeral.to_integer(roman)
+  end
+
+  # Converts this integer to a roman numeral.
+  def to_roman
+    RomanNumeral.new(self)
+  end
+
+end
+
+
+class String
+
+  # Considers string a roman numeral numeral,
+  # and converts it to the corresponding integer.
+  def to_roman
+    RomanNumeral.new(self)
+  end
+
+  # Returns true if a valid roman numeral.
+  def is_roman_numeral?
+    RomanNumeral.is_roman_numeral?(self)
+  end
+
+end
+
+
+class Numeric
+
+  #
+  def to_num
+    self
+  end
+
+end
+

data/lib/roman.yml

@@ -0,0 +1,72 @@
+---
+revision: 2013
+type: ruby
+sources:
+- var
+authors:
+- name: Trans
+  email: transfire@gmail.com
+organizations:
+- name: Rubyworks
+requirements:
+- groups:
+  - build
+  development: true
+  name: detroit
+- groups:
+  - build
+  development: true
+  name: ergo
+- groups:
+  - test
+  development: true
+  name: rubytest-cli
+- groups:
+  - test
+  development: true
+  name: lemon
+- groups:
+  - test
+  development: true
+  name: ae
+conflicts: []
+alternatives: []
+resources:
+- type: home
+  uri: http://rubyworks.github.com/roman
+  label: Homepage
+- type: code
+  uri: http://github.com/rubyworks/roman
+  label: Source Code
+- type: docs
+  uri: http://rubydoc.info/gems/roman
+  label: Documentation
+- type: wiki
+  uri: http://wiki.github.com/rubyworks/roman
+  label: User Guide
+- type: bugs
+  uri: http://github.com/rubyworks/roman/issues
+  label: Issue Tracker
+- type: mail
+  uri: http://groups.google.com/group/rubyworks-mailinglist
+  label: Mailing List
+repositories:
+- name: upstream
+  scm: git
+  uri: git://github.com/rubyworks/roman.git
+categories: []
+copyrights:
+- holder: Rubyworks
+  year: '2007'
+  license: BSD-2-Clause
+customs: []
+paths:
+  lib:
+  - lib
+created: '2010-03-02'
+summary: Real Roman Numerals
+title: Roman
+version: 0.2.0
+name: roman
+description: RomanNumeral class for working with roman numerals in a native form.
+date: '2013-03-09'

data/test/fixnum_case.rb

@@ -0,0 +1,13 @@
+require 'roman'
+
+TestCase Fixnum do
+
+  Method :to_roman do
+    test do
+      1.to_roman.assert == RomanNumeral.new(1)
+      2.to_roman.assert == RomanNumeral.new(2)
+    end
+  end
+
+end
+

data/test/roman_case.rb

@@ -0,0 +1,59 @@
+require 'roman'
+
+TestCase RomanNumeral do
+
+  Method :to_s do
+    test "one to three" do
+      1.to_roman.to_s.assert == 'I'
+      2.to_roman.to_s.assert == 'II'
+      3.to_roman.to_s.assert == 'III'
+    end
+  end
+
+  Method :to_s do
+    test "four" do
+      4.to_roman.to_s.assert == 'IV'
+    end
+  end
+
+  Method :to_s do
+    test "five to eight" do
+      5.to_roman.to_s.assert == 'V'
+      6.to_roman.to_s.assert == 'VI'
+      7.to_roman.to_s.assert == 'VII'
+      8.to_roman.to_s.assert == 'VIII'
+    end
+  end
+
+  Method :to_s do
+    test "nine" do
+      9.to_roman.to_s.assert == 'IX'
+    end
+  end
+
+  Method :to_s do
+    test "ten to thriteen" do
+      10.to_roman.to_s.assert == 'X'
+      11.to_roman.to_s.assert == 'XI'
+      12.to_roman.to_s.assert == 'XII'
+      13.to_roman.to_s.assert == 'XIII'
+    end
+  end
+
+  Method :to_s do 
+    test "fourteen plus" do
+      14.to_roman.to_s.assert == 'XIV'
+      15.to_roman.to_s.assert == 'XV'
+      16.to_roman.to_s.assert == 'XVI'
+    end
+  end
+
+  Method :+ do
+    test do
+      (5.to_roman + 6).assert == 11
+      (2.to_roman + 3.to_roman).assert == 5
+    end
+  end
+
+end
+

data/test/string_case.rb

@@ -0,0 +1,33 @@
+require 'roman'
+
+TestCase String do
+
+  Method :to_roman do
+    test "single digit conversions" do
+      "I".to_roman.assert == RomanNumeral.new(1)
+      "V".to_roman.assert == RomanNumeral.new(5)
+      "X".to_roman.assert == RomanNumeral.new(10)
+
+      "i".to_roman.assert == RomanNumeral.new(1)
+      "v".to_roman.assert == RomanNumeral.new(5)
+      "x".to_roman.assert == RomanNumeral.new(10)
+    end
+
+    test "simple mulit-digit conversions" do
+      "IV".to_roman.assert   == RomanNumeral.new(4)
+      "VI".to_roman.assert   == RomanNumeral.new(6)
+      "VII".to_roman.assert  == RomanNumeral.new(7)
+      "VIII".to_roman.assert == RomanNumeral.new(8)
+      "IX".to_roman.assert   == RomanNumeral.new(9)
+      "XI".to_roman.assert   == RomanNumeral.new(11)
+      "XII".to_roman.assert  == RomanNumeral.new(12)
+      "XIII".to_roman.assert == RomanNumeral.new(13)
+    end
+
+    test "complex conversions" do
+      "XXIV".to_roman.assert   == RomanNumeral.new(24)
+    end
+  end
+
+end
+

metadata

@@ -0,0 +1,142 @@
+--- !ruby/object:Gem::Specification
+name: roman
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+  prerelease: 
+platform: ruby
+authors:
+- Trans
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-03-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: detroit
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: ergo
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubytest-cli
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: lemon
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: ae
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: RomanNumeral class for working with roman numerals in a native form.
+email:
+- transfire@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- HISTORY.md
+- README.md
+files:
+- .index
+- lib/roman.rb
+- lib/roman.yml
+- test/string_case.rb
+- test/fixnum_case.rb
+- test/roman_case.rb
+- LICENSE.txt
+- HISTORY.md
+- README.md
+homepage: http://rubyworks.github.com/roman
+licenses:
+- BSD-2-Clause
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Real Roman Numerals
+test_files:
+- test/string_case.rb
+- test/fixnum_case.rb
+- test/roman_case.rb
+has_rdoc: