quantity 0.1.1 → 0.1.2

data/spec/systems.spec

@@ -0,0 +1,31 @@
+require 'quantity'
+
+# This is by no means comprehensive, just to make sure that we are loading
+# units based on the planned require x/y/z syntax.
+
+describe Quantity::Dimension do
+  it "should have the base dimensional units available" do
+    require 'quantity/dimension/base'
+    force = Quantity::Dimension.for(:force)
+    force.name.should == :force
+    force.numerators.first.dimension.should == :length
+  end
+end
+
+describe Quantity::Unit do
+  it "should have the SI system available" do
+    require 'quantity/systems/si'
+    Quantity::Unit.for(:kilometers).name.should == :kilometer
+  end
+
+  it "should have the US system available" do
+    require 'quantity/systems/us'
+    Quantity::Unit.for(:gallons).name.should == :gallon
+  end
+
+  it "should blow up the world" do
+    Quantity::Unit.__reset!
+    Quantity::Dimension.__reset!
+  end
+
+end

data/spec/unit.spec

@@ -0,0 +1,284 @@
+$:.unshift(File.expand_path(File.join(File.dirname(__FILE__), 'lib')))
+
+require 'quantity/dimension'
+require 'quantity/unit'
+
+
+describe Quantity::Unit do
+
+  context "definition" do
+  
+    before(:all) do
+      Quantity::Dimension.__reset!
+      Quantity::Unit.__reset!
+      length = Quantity::Dimension.add_dimension :length, :width
+      Quantity::Dimension.add_dimension :'length^2', :area
+      Quantity::Dimension.add_dimension :'length/time^2', :acceleration
+      Quantity::Dimension.add_dimension :mass
+      Quantity::Dimension.add_dimension :time
+      Quantity::Dimension.add_dimension :'mass*length/time^2', :force
+      Quantity::Dimension.add_dimension length**3, :volume
+    end
+    
+    before(:each) do
+      @length = Quantity::Dimension.for(:length)
+      @mass = Quantity::Dimension.for(:mass)
+      @area = Quantity::Dimension.for(:area)
+      @accel = Quantity::Dimension.for(:acceleration)
+      @force = Quantity::Dimension.for(:force)
+      @time = Quantity::Dimension.for(:time)
+      @volume = Quantity::Dimension.for(:volume)
+  
+      @meter = Quantity::Unit.for(:meter)
+      @mm = Quantity::Unit.for(:mm)
+      @inch = Quantity::Unit.for(:inch)
+      @foot = Quantity::Unit.for(:foot)
+      @second = Quantity::Unit.for(:second)
+      @gram = Quantity::Unit.for(:gram)
+      @liter = Quantity::Unit.for(:liter)
+    end
+ 
+    after(:all) do
+      Quantity::Dimension.__reset!
+      Quantity::Unit.__reset!
+    end
+
+    it "supports adding basic units" do
+      Quantity::Unit.add_unit :meter, @length, 1000, :meters, :m
+      meters = Quantity::Unit.for :meter 
+      meters.dimension.should == @length
+      meters.name.should == :meter
+      meters.value.should == 1000
+    end
+
+    it "supports adding units for complex dimensions" do
+      Quantity::Unit.add_unit :millimeter, @length, 1, :mm, :millimeters
+      Quantity::Unit.add_unit :second, @time, 1000, :seconds, :s
+      Quantity::Unit.add_unit :foot, @length, 304.8, :feet
+      Quantity::Unit.add_unit :inch, @length, 25.4, :inches
+      Quantity::Unit.add_unit :gram, @mass, 1000, :grams
+      Quantity::Unit.add_unit :nanosecond, @time, 10**-6, :nanoseconds
+      Quantity::Unit.add_unit :picogram, @mass, 10**-9, :picograms
+      Quantity::Unit.add_unit :liter, @volume, 10**6, :liters, :l
+      Quantity::Unit.add_unit :mps, @accel, 10**12, :meterspersecond
+      mps = Quantity::Unit.for :mps
+      mps.name.should == :mps
+      mps.value.should == 10**12
+    end
+  
+    it "supports unit aliases" do
+      m1 = Quantity::Unit.for(:meter)
+      m2 = Quantity::Unit.for(:meters)
+      m3 = Quantity::Unit.for(:m)
+      m1.name.should == :meter
+      m2.name.should == :meter
+      m3.name.should == :meter
+    end
+
+    it "interns units" do
+      m1 = Quantity::Unit.for(:meter)
+      m2 = Quantity::Unit.for(:meters)
+      m1.should equal m2
+    end
+
+    it "constructs units from an options hash" do
+      sqft = Quantity::Unit.new({ :name => :sqft, :dimension => @area, :units => { @length => @foot}})
+      sqft.name.should == :sqft
+      sqft.dimension.should == @area
+      sqft.value.should be_close @foot.value**2, 10**-5
+      sqft.string_form.should == 'foot^2'
+    end
+
+    it "constructs complex units from an options hash" do
+      area_p_sec = @area / @time
+      f2ps = Quantity::Unit.new({:name => :f2ps, :dimension => area_p_sec, 
+                                 :units => { @length => @foot, @time => @second }})
+      f2ps.name.should == :f2ps
+      f2ps.value.should be_close((@foot.value**2)/@second.value, 10**-5)
+      f2ps.string_form.should == 'foot^2/second'
+      f2ps.dimension.string_form.should == 'length^2/time'
+      f2ps.value.should be_close 92.90304, 10**-5
+    end
+  
+    it "allows a full reset" do
+      Quantity::Unit.__reset!
+      nil.should == Quantity::Unit.for(:meter)
+    end
+  
+  end
+
+  context "use cases" do
+    before(:all) do
+      Quantity::Dimension.__reset!
+      Quantity::Unit.__reset!
+      @length = Quantity::Dimension.add_dimension :length, :width
+      @area = Quantity::Dimension.add_dimension :'length^2', :area
+      @accel = Quantity::Dimension.add_dimension :'length/time^2', :acceleration
+      @mass = Quantity::Dimension.add_dimension :mass
+      @time = Quantity::Dimension.add_dimension :time
+      @force = Quantity::Dimension.add_dimension :'mass*length/time^2', :force
+      @volume = Quantity::Dimension.add_dimension @length**3, :volume
+
+      Quantity::Unit.__reset!
+      Quantity::Unit.add_unit :meter, @length, 1000, :meters, :m
+      Quantity::Unit.add_unit :millimeter, @length, 1, :mm, :millimeters
+      Quantity::Unit.add_unit :second, @time, 1000, :seconds, :s
+      Quantity::Unit.add_unit :foot, @length, 304.8, :feet
+      Quantity::Unit.add_unit :inch, @length, 25.4, :inches
+      Quantity::Unit.add_unit :gram, @mass, 1000, :grams
+      Quantity::Unit.add_unit :nanosecond, @time, 10**-6, :nanoseconds
+      Quantity::Unit.add_unit :picogram, @mass, 10**-9, :picograms
+      Quantity::Unit.add_unit :liter, @volume, 10**6, :liters, :l
+      Quantity::Unit.add_unit :mps, @accel, 10**12, :meterspersecond
+    end
+    
+    before(:each) do
+      @length = Quantity::Dimension.for(:length)
+      @mass = Quantity::Dimension.for(:mass)
+      @area = Quantity::Dimension.for(:area)
+      @accel = Quantity::Dimension.for(:acceleration)
+      @force = Quantity::Dimension.for(:force)
+      @time = Quantity::Dimension.for(:time)
+      @volume = Quantity::Dimension.for(:volume)
+  
+      @meter = Quantity::Unit.for(:meter)
+      @mm = Quantity::Unit.for(:mm)
+      @inch = Quantity::Unit.for(:inch)
+      @foot = Quantity::Unit.for(:foot)
+      @second = Quantity::Unit.for(:second)
+      @gram = Quantity::Unit.for(:gram)
+      @liter = Quantity::Unit.for(:liter)
+      @mps = Quantity::Unit.for(:mps)
+    end
+
+    after(:all) do
+      Quantity::Dimension.__reset!
+      Quantity::Unit.__reset!
+    end
+
+    context "informational" do
+      it "has a symbol name" do
+        @second.name.should == :second
+      end
+
+      it "has a symbol name for complex units" do
+        @mps.name.should == :mps
+      end
+
+      it "has a reduced form name" do
+        @mps.name.should == :mps
+      end
+
+      it "has a reduced form name for complex units" do
+        @mps.reduced_name.should == :'meters/second^2'
+      end
+    end
+
+    context "multiplication" do
+
+      it "supports basic units" do
+        sqft = @foot * @foot
+        sqft.name.should == :'foot^2'
+      end
+
+      it "supports complex units" do
+        sqft = @foot * @foot
+        cubeft = sqft * @foot
+        cubeft.name.should == :'foot^3'
+      end
+
+      it "supports units of different dimensions" do
+        s_f3 = @second * (@foot * @foot * @foot)
+        s_f3.name.should == :'foot^3*second'
+        s_f3.value.should == @foot.value**3 / @second.value
+      end
+    
+      it "supports different units of the same dimension" do
+        sqft = @foot * @meter
+        sqft.name.should == :'foot^2'
+        sqft.value.should == @foot.value**2
+      end
+
+      it "defaults to the second unit when multiplying units of the same dimension" do
+        sqft = @meter * @foot
+        sqft.name.should == :'foot^2'
+        sqft.value.should be_close 92903.04, 10**-5
+      end
+
+    end
+
+    context "division" do 
+
+      it "supports basic units" do
+        m_s = @meter / @second
+        m_s.name.should == :'meter/second'
+      end
+
+      it "supports mixed units" do
+        result = @meter * @gram / @second
+        result.name.should == :'meter*gram/second'
+      end
+
+      it "supports mixed unit divisors" do
+        result = @meter / (@gram * @second)
+        result.name.should == :'meter/gram*second'
+        result.value.should == @meter.value / (@gram.value*@second.value)
+      end
+
+      it "simplifies results" do
+        result = (@meter * @second) / @second
+        result.name.should == :meter
+        result.value.should == @meter.value
+      end
+
+      it "supports named complex dimensions" do
+        lpm = @liter / @meter
+        lpm.name.should == :'liter/meter'
+        lpm.reduced_name.should == :'mm^2'
+        lpm.value.should == @liter.value / @meter.value
+      end
+
+    end
+
+    context "exponentiation" do
+      it "supports positive exponents" do
+        (@foot**2).should == (@foot * @foot)
+      end
+
+      it "supports negative exponents" do
+        (@foot**-1).name.should == :'1/foot'
+      end
+    end
+
+    context "conversions" do
+
+      it "converts basic units" do
+        @foot.convert(:meter).should == @meter
+      end
+
+      it "converts the portion of a given complex unit to a target unit" do
+        @mps.convert(:foot).should == @foot / @second
+        @liter.convert(:mm).should == @mm**3
+      end
+
+      it "won't convert a simple unit to another dimension" do
+        lambda { @foot.convert(:second) }.should raise_error TypeError
+      end
+
+      it "won't convert a complex unit to a dimension it doesn't contain" do
+        lambda { @mps.convert(:gram) }.should raise_error TypeError
+      end
+
+      it "won't convert to a higher-order unit unless it has an exact matching dimension" do
+        lambda { @liter.convert(:'mm^2') }.should raise_error TypeError
+      end
+      
+      it "breaks down named complex units" do
+        @liter.convert(:mm).should == @mm**3
+      end
+
+    end
+
+  end
+
+end

metadata

@@ -1,7 +1,12 @@
 --- !ruby/object:Gem::Specification 
 name: quantity
 version: !ruby/object:Gem::Version 
-  version: 0.1.1
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 2
+  version: 0.1.2
 platform: ruby
 authors: 
 - Ben Lavender
@@ -10,31 +15,76 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-01-05 00:00:00 +01:00
+date: 2011-05-03 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 2
+        - 9
+        version: 1.2.9
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 8
+        - 7
+        version: 0.8.7
   type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
-    - - ">="
+    - - "="
       - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 2
+        - 9
         version: 1.2.9
-    version: 
+  type: :development
+  version_requirements: *id003
 - !ruby/object:Gem::Dependency 
   name: yard
-  type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
-    - - ">="
+    - - "="
       - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 5
+        - 2
         version: 0.5.2
-    version: 
-description: "    Quantity provides first-class quantities, units, and base quantities in pure ruby.\n    Things like 1.meter / 1.second == 1 meter/second.\n"
-email: blavender@gmail.com
+  type: :development
+  version_requirements: *id004
+description: |
+  Quantity provides first-class quantities, units, and base quantities in pure ruby.
+  Things like 1.meter / 1.second == 1 meter/second.
+
+email: 
+- blavender@gmail.com
+- arto.bendiken@gmail.com
 executables: []
 
 extensions: []
@@ -42,13 +92,22 @@ extensions: []
 extra_rdoc_files: []
 
 files: 
+- .gemspec
+- .gitignore
+- .yardopts
 - AUTHORS
+- Gemfile
 - README
+- README.md
+- Rakefile
 - UNLICENSE
 - VERSION
+- doc/.gitignore
+- lib/quantity.rb
 - lib/quantity/all.rb
-- lib/quantity/dimension/base.rb
 - lib/quantity/dimension.rb
+- lib/quantity/dimension/base.rb
+- lib/quantity/rails.rb
 - lib/quantity/systems/enumerable.rb
 - lib/quantity/systems/imperial.rb
 - lib/quantity/systems/information.rb
@@ -56,34 +115,45 @@ files:
 - lib/quantity/systems/us.rb
 - lib/quantity/unit.rb
 - lib/quantity/version.rb
-- lib/quantity.rb
-has_rdoc: false
+- quantity.gemspec
+- spec/dimension.spec
+- spec/quantity.spec
+- spec/systems.spec
+- spec/unit.spec
+has_rdoc: true
 homepage: http://quantity.rubyforge.org/
-licenses: 
-- Public Domain
+licenses: []
+
 post_install_message: 
 rdoc_options: []
 
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      version: 1.8.2
-  version: 
+      segments: 
+      - 0
+      version: "0"
 required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      segments: 
+      - 0
       version: "0"
-  version: 
 requirements: []
 
 rubyforge_project: quantity
-rubygems_version: 1.3.5
+rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
 summary: Units and quantities for Ruby.
-test_files: []
-
+test_files: 
+- spec/dimension.spec
+- spec/quantity.spec
+- spec/systems.spec
+- spec/unit.spec