quantify 1.0.2 → 1.0.3

data/README

@@ -1,115 +1,167 @@
-A gem to support for physical quantities and unit conversions
+A gem to support physical quantities and unit conversions
 Licensed under the MIT license (See COPYING file for details)
 Author: Andrew Berkeley (andrew.berkeley.is@googlemail.com)
 Homepage: https://github.com/spatchcock/quantify
 
-Examples
-
-  unit = Unit.km                                               #=> #<Quantify::Unit::SI:0xb75c9718 ... >
-  unit.name                                                    #=> 'kilometre'
-  unit.symbol                                                  #=> 'kg'
-  unit.dimensions                                              #=> #<Quantify::Dimensions:0xb75c4254 .. >
-  unit.measures                                                #=> 'length'
-  unit.alternatives :name                                      #=> ['metre', 'megametre', 'gigametre', 'terametre', 'angstrom',
-                                                               #    'astronomical unit', 'baromil', 'chain', 'dram', 'ell', 'fathom',
-                                                               #    'fermi', 'foot us survey', 'foot', 'furlong', 'hand', 'inch',
-                                                               #    'nautical league', 'statute league', 'light year', 'line',
-                                                               #    'link', 'yard']
-  other_unit = Unit.hour
-  other_unit.name                                              #=> 'hour'
-  other_unit.symbol                                            #=> 'h'
-  other_unit.measures                                          #=> 'time'
-  other_unit.alternatives :symbol                              #=> [ 's', 'ks', 'Ms', 'Gs', 'Ts', 'd', 'min' ]
-
-  another_unit = unit / other_unit                             #=> #<Quantify::Unit::Compound:0xb74af323 ... >
-  another_unit.name                                            #=> 'kilometer per hour'
-  another_unit.symbol                                          #=> 'km h^-1'
-  another_unit.measures                                        #=> 'velocity'
-
-  last_unit = Unit.m
-  last.unit.measures                                           #=> 'length'
-  square = last_unit ** 2                                      #=> #<Quantify::Unit::Compound:0xb446f12f ... >
-  square.symbol                                                #=> 'm^2'
-  square.measures                                              #=> 'area'
-
-Define quantity - method 1
-
-  quantity = Quantity.new(1234.5678, :lb)                      #=> #<Quantify::Quantity:0xjk39d570 ... >
-  quantity.value                                               #=> 1234.5678
-  quantity.unit                                                #=> #<Quantify::Unit::NonSI:0xb182124 ... >
-  quantity.unit.symbol                                         #=> 'lb'
-
-Define quantity - method 2
-
-  string = quantity.to_s                                       #=> "1234.5678 lb"
-  quantity = Quantity.parse(string)                            #=> #<Quantify::Quantity:0xj982b4f9 ... >
-  quantity.to_s                                                #=> "1234.5678 lb"
-
-Define quantity - method 3
-
-  quantity = 1234.5678.lb                                      #=> #<Quantify::Quantity:02387f7340 ... >
-  quantity.to_s                                                #=> "1234.5678 lb"
-
-Multiply by scalar
+There are several ways to initialize a quantity object
 
-  new_quantity = quantity * 4                                  #=> #<Quantify::Quantity:87b37f720 ... >
-  new_quantity.to_s                                            #=> "4938.2712 lb"
+  mass = Quantity.new(100,:lb)          => <Quantify::Quantity:0xb7332bbc ... >
+  mass = Quantity.new(100,'pound')      => <Quantify::Quantity:0xb7332bbc ... >
+  mass = 100.lb                         => <Quantify::Quantity:0xb7332bbc ... >
+  mass = 100.pound                      => <Quantify::Quantity:0xb7332bbc ... >
+  mass = Quantity.parse "100 lb"        => <Quantify::Quantity:0xb7332bbc ... >
+  mass = "100 lb".to_q                  => <Quantify::Quantity:0xb7332bbc ... >
 
-Convert unit
+Quantity object attributes
 
-  converted_quantity = new_quantity.to_kg                      #=> #<Quantify::Quantity:0b8787a688 ... >
-  converted_quantity.to_s                                      #=> "2239.96213731074 kg"
+  mass.value                            => 100.0
+  mass.unit                             => <Quantify::Unit::NonSI:0xb7332b08 ... >
+  mass.unit.name                        => "pound"
+  mass.unit.symbol                      => "lb"
 
-One line conversion of a quantity to a new unit
-5000 litres into US petroleum barrels
+  # unique identifier, follows JScience
+  mass.unit.label                       => "lb"
+  mass.unit.pluralized_name             => "pounds"
+  mass.to_s                             => "100 lb"
+  mass.to_s(:name)                      => "100 pounds"
 
-  5000.L.to_bbl.value                                          #=> 31.4490528488754
+  # Describe the physical quantity represented by the quantity
+  mass.represents                       => "mass"
 
-Complex example
+Convert a quantity to a different unit
 
-Define energy units
+  energy = 100.kWh                      => <Quantify::Quantity:0xb7332bbc ... >
+  energy.to_s(:name)                    => "100 kilowatt hours"
 
-  kW = Unit.kW                                                 #=> #<Quantify::Unit::SI:0xb7586620 ... >
-  kW.name                                                      #=> 'kilowatt'
-  kW.measures                                                  #=> 'power'
+  energy = quantity.to_megajoules       => <Quantify::Quantity:0xb7332bbc ... >
+  energy.to_s                           => "360.0 MJ"
 
-  h = Unit.h                                                   #=> #<Quantify::Unit::NonSI:0xb7582994 ... >
-  h.symbol                                                     #=> 'h'
-  h.measures                                                   #=> 'time'
+  energy = quantity.to_MJ               => <Quantify::Quantity:0xb7332bbc ... >
+  energy.to_s                           => "360.0 MJ"
+
+  energy = quantity.to(:MJ)             => <Quantify::Quantity:0xb7332bbc ... >
+  energy.to_s                           => "360.0 MJ"
+
+  # Initialize a unit object and pass as conversion argument
+  unit = Unit.MJ                        => <Quantify::Unit::SI:0xb75c9718 ... >
+  energy = quantity.to(unit)            => <Quantify::Quantity:0xb7332bbc ... >
+  energy.to_s                           => "360.0 MJ"
+
+  # Single line conversion of litres to barrels, returning only the value
+  5000.L.to_bbl.value                   => 31.4490528488754
+
+Convert the units of a quantity with a compound unit
+
+  speed = 70.mi/1.h                     => <Quantify::Quantity:0xb7332bbc ... >
+  speed.to_s                            => "70.0 mi h^-1"
+
+  speed_in_kms = speed.to_km            => <Quantify::Quantity:0xb7332bbc ... >
+  speed_in_kms.to_s                     => "112.65408 km h^-1"
+
+  speed_in_mins = speed_in_kms.to_min   => <Quantify::Quantity:0xb7332bbc ... >
+  speed_in_mins.to_s                    => "1.877568 km min^-1"
+
+Convert a quantity to the corresponding SI unit
+
+  energy = 100.kWh                      => <Quantify::Quantity:0xb7332bbc ... >
+  energy.to_s                           => "100 kWh"
+  si = quantity.to_si                   => <Quantify::Quantity:0x4j4j9sbc ... >
+  si.to_s                               => "360000000.0 J"
+
+Operate on a quantity
+
+  mass = 10.kg * 3                      => <Quantify::Quantity:0xb7332bbc ... >
+  mass.to_s                             => 30.0 kg
+
+  distance = 100.light_years / 20       => <Quantify::Quantity:0xb7332bbc ... >
+  distance.to_s                         => 5.0 ly
+
+  area = 10.m * 10.m                    => <Quantify::Quantity:0xb7332bbc ... >
+  area.to_s :name                       => 100.0 square metres
+
+  speed = 250.mi / 3.h                  => <Quantify::Quantity:0xb7332bbc ... >
+  speed.to_s(:name)                     => 83.3333333333333 miles per hour
+
+  speed = 70.mi/1.h                     => <Quantify::Quantity:0xb7332bbc ... >
+  time = 0.5.h                          => <Quantify::Quantity:3xf3472hjc ... >
+  distance = speed * time               => <Quantify::Quantity:7d7f8g9d5g ... >
+  distance.to_s                         => 35.0 mi
+
+Additional operations
+The result of quantity operations is commonly a new quantity with a compound unit.
+Unless the result is equivalent to one of the base SI units (m, kg, s, K, etc.) or
+one of the following, square metre, cubic metre, joule, watt, newton or pascal, then
+the compound unit represents appropriate combination of the units involved, albeit
+with any like-units within the numerator and denominator grouped under a single
+power/index.
+
+Units are not automatically cancelled or rationalized (made consistent). This is
+because it cannot be assumed that that is the desire of the user. For example, a
+quantity with units <mass> per <mass> is technically dimensionless, but the user
+might prefer to explicitly represent the units rather than reduce to a dimensionless
+quantity. In addition, this quantity might be expressed in terms of grams per tonne,
+and the user may not necessarily prefer a conversion into consistent mass units
+(e.g. g/g or t/t). Therefore, the following methods are available...
+
+  # Where units representing the same physical quantity appear together, they can
+  # made consistent by simply converting to the unit which is desired
+  area = 12.yd * 36.ft                  => <Quantify::Quantity:0xb7332bbc ... >
+  area.to_s                             => "432.0 yd ft"
+  area.to_yd
+  area.to_s                             => "144.0 yd^2"
+
+  # Alternatively, all units within the numerator and denominator respectively
+  # can be standardized.
+  quantity = (12.ft*8.mi)/(1.s*8.min)
+  quantity.to_s                         => 12.0 ft mi s^-1 min^-1
+  quantity.rationalize_units!
+  quantity.to_s                         => 1056.0 ft^2 s^-2
+
+  # A quantity with arbitrary cancelable units can be cancelled manually
+  quantity = (12.m**6) / 2.m**2
+  quantity.to_s                         => "746496.0 m^6 m^-2"
+  quantity.cancel_base_units! :m
+  quantity.to_s                         => "746496.0 m^4"
+
+Note: there are more comprehensive and flexible methods for manupulating compound
+units available as part of of the class Unit::Compound. These can be used to
+convert a conpound unit into the precise form required. If such an approach is
+used, any quantity object can be converted to the new form by simply passing the
+new unit object into the Quantity#to method.
+
+Initialize a unit object
+
+  unit = Unit.for :km                    => <Quantify::Unit::SI:0xb75c9718 ... >
+  unit = Unit.km                         => <Quantify::Unit::SI:0xb75c9718 ... >
+  unit = Unit.kilometre                  => <Quantify::Unit::SI:0xb75c9718 ... >
+  
+  unit.name                              => 'kilometre'
+  unit.symbol                            => 'kg'
+  unit.label                             => 'kg'
+  unit.dimensions                        => <Quantify::Dimensions:0xb75c4254 .. >
+  unit.measures                          => 'length'
+  unit.alternatives :name                => ['metre','megametre','gigametre',
+                                             'terametre','angstrom','astronomical unit',
+                                             'baromil','chain','dram','ell','fathom',
+                                             'fermi','foot us survey','foot','furlong',
+                                             'hand','inch','nautical league',
+                                             'statute league','light year', 'line','link',
+                                             'yard']
 
-Create compound unit for energy
-
-  kWh = kW / h                                                 #=> #<Quantify::Unit::Compound:0xb756b0b4 ... >
-  kWh.name                                                     #=> 'kilowatt hour'
-  kWh.measures                                                 #=> 'energy'
-  kWh.alternatives :symbol                                     #=> ['J', 'kJ', 'MJ', 'GJ', 'TJ', 'BTU', 'cal', 'CHU',
-                                                               #    'dyn cm', 'eV', 'erg', 'Eh']
-  kWh.alternatives :name                                       #=> ['joule', 'kilojoule', 'megajoule', 'gigajoule',
-                                                               #    'terajoule', 'british thermal unit', 'calorie',
-                                                               #    'celsius heat unit', 'dyne centimetre', 'electron volt',
-                                                               #    'erg', 'hartree']
-
-Create mass unit
-
-  kg = Unit.kg                                                 #=> #<Quantify::Unit::SI:0xb758b594 ... >
-
-Create emission factor compound unit
-
-  kg_per_kWh = kg / kWh                                        #=> #<Quantify::Unit::Compound:0xb746f093 ... >
-  kg_per_kWh.symbol                                            #=> "kg_kW^-1_h^-1
-  kg_per_kWh.name                                              #=> 'kilogram per kilowatt hour'
-
-Create emission factor quantity
-
-  emission_factor = Quantity.new(0.54, kg_per_kWh)             #=> #<Quantify::Quantity:0xb75cd570 ... >
-  emission_factor.to_s                                         #=> "0.54 kg kW^-1 h^-1"
-
-Create consumption quantity
-
-  consumption = Quantity.new(9885.5, kWh)                      #=> #<Quantify::Quantity:0xb7j4k3570 ... >
-  consumption.to_s                                             #=> "9885.5 kWh"
+  other_unit = Unit.hour
+  other_unit.name                        => 'hour'
+  other_unit.symbol                      => 'h'
+  other_unit.measures                    => 'time'
+  other_unit.alternatives :symbol        => [ 's', 'ks', 'Ms', 'Gs', 'Ts', 'd', 'min' ]
 
-Calculate emissions
+  another_unit = unit / other_unit       => <Quantify::Unit::Compound:0xb74af323 ... >
+  another_unit.name                      => 'kilometer per hour'
+  another_unit.symbol                    => 'km h^-1'
+  another_unit.measures                  => 'velocity'
+  another_unit.base_units.map(&:name)    => ['kilogram','hour']
 
-  emissions = consumption * emission_factor                    #=> #<Quantify::Quantity:0xb456g2s70 ... >
-  emissions.to_s                                               #=> "5338.17 kg"
+  last_unit = Unit.m
+  last.unit.measures                     => 'length'
+  square = last_unit ** 2                => <Quantify::Unit::Compound:0xb446f12f ... >
+  square.symbol                          => 'm^2'
+  square.measures                        => 'area'

data/lib/quantify/dimensions.rb

@@ -76,7 +76,7 @@ module Quantify
       if options[:physical_quantity]
         @@dimensions << Dimensions.new(options)
       else
-        raise InvalidDimensionError, "Cannot load dimensions without physical quantity description"
+        raise Exceptions::InvalidDimensionError, "Cannot load dimensions without physical quantity description"
       end
     end
 
@@ -122,10 +122,10 @@ module Quantify
           end
           return quantity.clone
         else
-          raise InvalidArgumentError, "Physical quantity not known: #{name}"
+          raise Exceptions::InvalidArgumentError, "Physical quantity not known: #{name}"
         end
       else
-        raise InvalidArgumentError, "Argument must be a Symbol or String"
+        raise Exceptions::InvalidArgumentError, "Argument must be a Symbol or String"
       end
     end
 
@@ -202,9 +202,9 @@ module Quantify
       if describe and not loaded?
         @@dimensions << self
       elsif describe
-        raise InvalidDimensionError, "A dimension instance with the same physical quantity already exists"
+        raise Exceptions::InvalidDimensionError, "A dimension instance with the same physical quantity already exists"
       else
-        raise InvalidDimensionError, "Cannot load dimensions without physical quantity description"
+        raise Exceptions::InvalidDimensionError, "Cannot load dimensions without physical quantity description"
       end
     end
 
@@ -497,7 +497,7 @@ module Quantify
       options.each_pair do |base_quantity,index|
         base_quantity = base_quantity.to_s.downcase.to_sym
         unless index.is_a? Integer and BASE_QUANTITIES.include? base_quantity
-          raise InvalidDimensionError, "An invalid base quantity was specified (#{base_quantity})"
+          raise Exceptions::InvalidDimensionError, "An invalid base quantity was specified (#{base_quantity})"
         end
         variable = "@#{base_quantity}"
         if self.instance_variable_defined?(variable)

data/lib/quantify/exception.rb

@@ -1,21 +1,23 @@
 module Quantify
+  module Exceptions
 
-  class QuantityParseError < Exception
-  end
+    class QuantityParseError < Exception
+    end
 
-  class InvalidObjectError < Exception
-  end
+    class InvalidObjectError < Exception
+    end
 
-  class InvalidUnitError < Exception
-  end
+    class InvalidUnitError < Exception
+    end
 
-  class InvalidDimensionError < Exception
-  end
+    class InvalidDimensionError < Exception
+    end
 
-  class InvalidPhysicalQuantityError < Exception
-  end
+    class InvalidPhysicalQuantityError < Exception
+    end
 
-  class InvalidArgumentError < Exception
+    class InvalidArgumentError < Exception
+    end
+    
   end
-
 end

data/lib/quantify/quantity.rb

@@ -47,10 +47,10 @@ module Quantify
       if quantity = /\A([\d\s.,]+)(\D+.*)\z/.match(string)
         Quantity.new($1.strip, $2)
       else
-        raise Quantify::QuantityParseError, "Cannot parse string into value and unit"
+        raise Quantify::Exceptions::QuantityParseError, "Cannot parse string into value and unit"
       end
-    rescue Quantify::InvalidArgumentError
-      raise Quantify::QuantityParseError, "Cannot parse string into value and unit"
+    rescue Quantify::Exceptions::InvalidArgumentError
+      raise Quantify::Exceptions::QuantityParseError, "Cannot parse string into value and unit"
     end
 
     def self.configure &block
@@ -195,10 +195,10 @@ module Quantify
           @value = value.send operator, other.value
           return self
         else
-          raise Quantify::InvalidObjectError "Cannot add or subtract Quantities with different dimensions"
+          raise Quantify::Exceptions::InvalidObjectError "Cannot add or subtract Quantities with different dimensions"
         end
       else
-        raise Quantify::InvalidObjectError "Cannot add or subtract non-Quantity objects"
+        raise Quantify::Exceptions::InvalidObjectError "Cannot add or subtract non-Quantity objects"
       end
     end
 
@@ -211,12 +211,12 @@ module Quantify
         @value = value.send(operator,other.value)
         return self
       else
-        raise Quantify::InvalidArgumentError "Cannot multiply or divide a Quantity by a non-Quantity or non-Numeric object"
+        raise Quantify::Exceptions::InvalidArgumentError "Cannot multiply or divide a Quantity by a non-Quantity or non-Numeric object"
       end
     end
 
     def pow!(power)
-      raise InvalidArgumentError, "Argument must be an integer" unless power.is_a? Integer
+      raise Exceptions::InvalidArgumentError, "Argument must be an integer" unless power.is_a? Integer
       @value = value ** power
       @unit = unit ** power
       return self
@@ -267,7 +267,14 @@ module Quantify
 
     def rationalize_units
       return self unless unit.is_a? Unit::Compound
-      self.to unit.rationalize_base_units
+      self.to unit.clone.rationalize_base_units!
+    end
+
+    def rationalize_units!
+      rationalized_quantity = self.rationalize_units
+      @value = rationalized_quantity.value
+      @unit = rationalized_quantity.unit
+      return self
     end
 
     def cancel_base_units!(*units)
@@ -303,7 +310,7 @@ module Quantify
       if object.kind_of? Numeric
         return Quantity.new(object, Unit.unity), self
       else
-        raise InvalidArgumentError, "Cannot coerce #{self.class} into #{object.class}"
+        raise Exceptions::InvalidArgumentError, "Cannot coerce #{self.class} into #{object.class}"
       end
     end
 
@@ -317,7 +324,7 @@ module Quantify
       if method.to_s =~ /(to_)(.*)/
         to($2)
       else
-        raise NoMethodError, "Undefined method '#{method}' for #{self}:#{self.class}"
+        super
       end
     end
 

data/lib/quantify/unit/base_unit.rb

@@ -110,7 +110,7 @@ module Quantify
           elsif options[:dimensions].is_a? String or options[:dimensions].is_a? Symbol
             @dimensions = Dimensions.for options[:dimensions]
           else
-            raise InvalidArgumentError, "Unknown physical_quantity specified"
+            raise Exceptions::InvalidArgumentError, "Unknown physical_quantity specified"
           end
           @factor = options[:factor].nil? ? 1.0 : options[:factor].to_f
           @symbol = options[:symbol].nil? ? nil : options[:symbol].standardize
@@ -145,7 +145,7 @@ module Quantify
       #
       def load
         yield self if block_given?
-        raise InvalidArgumentError, "A unit with the same label: #{self.name}) already exists" if loaded?
+        raise Exceptions::InvalidArgumentError, "A unit with the same label: #{self.name}) already exists" if loaded?
         Quantify::Unit.units << self if valid?
       end
 
@@ -327,7 +327,7 @@ module Quantify
 
       def valid?
         return true if valid_descriptors? and valid_dimensions?
-        raise InvalidArgumentError, "Unit definition must include a name, a symbol, a label and physical quantity"
+        raise Exceptions::InvalidArgumentError, "Unit definition must include a name, a symbol, a label and physical quantity"
       end
 
       def valid_descriptors?
@@ -428,7 +428,7 @@ module Quantify
       #
       def with_prefix(name_or_symbol)
         if self.name =~ /\A(#{valid_prefixes(:name).join("|")})/
-          raise InvalidArgumentError, "Cannot add prefix where one already exists: #{self.name}"
+          raise Exceptions::InvalidArgumentError, "Cannot add prefix where one already exists: #{self.name}"
         end
         
         prefix = Unit::Prefix.for(name_or_symbol,valid_prefixes)
@@ -442,7 +442,7 @@ module Quantify
           new_unit_options[:physical_quantity] = self.dimensions
           self.class.new(new_unit_options)
         else
-          raise InvalidArgumentError, "Prefix unit is not known: #{prefix}"
+          raise Exceptions::InvalidArgumentError, "Prefix unit is not known: #{prefix}"
         end
       end
 
@@ -472,7 +472,7 @@ module Quantify
         if object.kind_of? Numeric and object == 1
           return Unit.unity, self
         else
-          raise InvalidArgumentError, "Cannot coerce #{self.class} into #{object.class}"
+          raise Exceptions::InvalidArgumentError, "Cannot coerce #{self.class} into #{object.class}"
         end
       end
       

data/lib/quantify/unit/compound_base_unit.rb

@@ -14,8 +14,8 @@ module Quantify
       attr_accessor :unit, :index
 
       def initialize(unit,index=1)
-        @unit = Unit.match(unit) || raise(InvalidUnitError, "Base unit not known: #{unit}")
-        raise InvalidUnitError, "Base unit cannot be compound unit" if @unit.is_a? Compound
+        @unit = Unit.match(unit) || raise(Exceptions::InvalidUnitError, "Base unit not known: #{unit}")
+        raise Exceptions::InvalidUnitError, "Base unit cannot be compound unit" if @unit.is_a? Compound
         @index = index
       end
 

data/lib/quantify/unit/compound_unit.rb

@@ -32,7 +32,7 @@ module Quantify
       # base units or just a subset - the numerator or denominator units.
       #
       def self.consolidate_base_units(base_units)
-        raise InvalidArgumentError, "Must provide an array of base units" unless base_units.is_a? Array
+        raise Exceptions::InvalidArgumentError, "Must provide an array of base units" unless base_units.is_a? Array
 
         new_base_units = []
 
@@ -97,7 +97,7 @@ module Quantify
               not unit.first.is_a? Compound and unit.size == 2
             @base_units << CompoundBaseUnit.new(unit.first,unit.last)
           else
-            raise InvalidArgumentError, "#{unit} does not represent a valid base unit"
+            raise Exceptions::InvalidArgumentError, "#{unit} does not represent a valid base unit"
           end
         end
         @acts_as_alternative_unit = true
@@ -158,7 +158,7 @@ module Quantify
       #
       def cancel_base_units!(*units)
         units.each do |unit|
-          raise InvalidArgumentError, "Cannot cancel by a compound unit" if unit.is_a? Unit::Compound
+          raise Exceptions::InvalidArgumentError, "Cannot cancel by a compound unit" if unit.is_a? Unit::Compound
           unit = Unit.for unit unless unit.is_a? Unit::Base
 
           numerator_unit = numerator_units.find { |base| unit == base.unit }
@@ -175,10 +175,10 @@ module Quantify
 
       def rationalize_base_units!(scope=:partial,*units)
         if scope == :full
-          Compound.rationalize_base_units(@base_units,units)
+          Compound.rationalize_base_units(@base_units,*units)
         else
-          Compound.rationalize_base_units(numerator_units,units)
-          Compound.rationalize_base_units(denominator_units,units)
+          Compound.rationalize_base_units(numerator_units,*units)
+          Compound.rationalize_base_units(denominator_units,*units)
         end
         consolidate_numerator_and_denominator_units!
       end

data/lib/quantify/unit/prefix/base_prefix.rb

@@ -1,5 +1,3 @@
-# To change this template, choose Tools | Templates
-# and open the template in the editor.
 
 module Quantify
   module Unit

data/lib/quantify/unit/prefix/prefix.rb

@@ -34,7 +34,7 @@ module Quantify
             return nil
           end
         else
-          raise InvalidArgumentError, "Argument must be a Symbol or String"
+          raise Exceptions::InvalidArgumentError, "Argument must be a Symbol or String"
         end
       end
 

data/lib/quantify/unit/unit.rb

@@ -60,7 +60,7 @@ module Quantify
       unit = Unit.for unit
       other_unit = Unit.for other_unit
       unless unit.is_alternative_for? other_unit
-        raise InvalidUnitError, "Units do not represent the same physical quantity"
+        raise Exceptions::InvalidUnitError, "Units do not represent the same physical quantity"
       end
       new_unit = (unit / other_unit)
       value = 1/new_unit.factor
@@ -94,7 +94,7 @@ module Quantify
         ( name_symbol_label_or_object.is_a?(String) and name_symbol_label_or_object.empty? )
       name_symbol_or_label = name_symbol_label_or_object
       unless name_symbol_or_label.is_a? String or name_symbol_or_label.is_a? Symbol
-        raise InvalidArgumentError, "Argument must be a Symbol or String"
+        raise Exceptions::InvalidArgumentError, "Argument must be a Symbol or String"
       end
       if unit = Unit.match(name_symbol_or_label)
         return unit
@@ -102,7 +102,7 @@ module Quantify
       if unit = Unit.parse(name_symbol_or_label)
         return unit
       end
-    rescue InvalidUnitError
+    rescue Exceptions::InvalidUnitError
       return nil
     end
 
@@ -111,7 +111,7 @@ module Quantify
     def self.parse(string)
       string = string.standardize
       if string.scan(/(\/|per)/).size > 1
-        raise InvalidArgumentError, "Malformed unit: multiple uses of '/' or 'per'"
+        raise Exceptions::InvalidArgumentError, "Malformed unit: multiple uses of '/' or 'per'"
       end
 
       units = []

data/spec/quantity_spec.rb

@@ -246,5 +246,20 @@ describe Quantity do
     quantity.unit.base_units.size.should == 1
     quantity.to_s.should == "40.720412743579 inHg"
   end
+
+  it "should rationalize units and return new quantity" do
+    quantity = 12.yards*36.feet
+    quantity.to_s.should eql "432.0 yd ft"
+    new_quantity=quantity.rationalize_units
+    quantity.to_s.should eql "432.0 yd ft"
+    new_quantity.to_s.should eql "144.0 yd^2"
+  end
+
+  it "should rationalize units and modify value in place" do
+    quantity = 12.yards*36.feet
+    quantity.to_s.should eql "432.0 yd ft"
+    quantity.rationalize_units!
+    quantity.to_s.should eql  "144.0 yd^2"
+  end
 end
 

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: quantify
 version: !ruby/object:Gem::Version 
-  hash: 19
+  hash: 17
   prerelease: 
   segments: 
   - 1
   - 0
-  - 2
-  version: 1.0.2
+  - 3
+  version: 1.0.3
 platform: ruby
 authors: 
 - Andrew Berkeley