metric_conversions 0.0.1

data/.gitignore

@@ -0,0 +1,20 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.DS_Store
+lib/.DS_Store
+tests/.DS_Store

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in metric_conversions.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2013 profh
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,70 @@
+# MetricConversions
+==========
+These are a set of methods for length, volume, temperature, area and the like that help a user convert to or from English units to Metric units.  This was done as a class exercise in 67-275 at Carnegie Mellon University, with a pair of students tackling each of the submodules and writing the necessary tests.
+
+
+Installation
+------------
+Installing this gem is pretty simple -- just type on the command line:
+
+```  
+$ gem install metric_conversions 
+```
+
+And add this gem into any other code with:
+
+```  
+require 'rubygems'
+require 'metric_conversions' 
+```
+
+
+Usage
+------------
+There are currently four submodules to this gem:
+
+* Lengths
+* Volumes
+* Temperatures
+* Areas
+
+
+### Lengths ###
+This gem enables you to convert between typical metric and US Standard units. By calling .convert on a number and passing in two arguments, units from and units to, you can convert the given number into its equivalent in the "to" units. 
+
+Example:
+250.convert("in", "cm")
+
+This module was built by Rachel Crown and Dylan Corwin.
+
+
+### Volumes ###
+... notes and explanation goes here ...
+
+This module was built by <YOUR NAME HERE> and <YOUR NAME HERE>.
+
+
+### Temperatures ###
+... notes and explanation goes here ...
+
+This module was built by <YOUR NAME HERE> and <YOUR NAME HERE>.
+
+
+### Areas ###
+... notes and explanation goes here ...
+
+This module was built by <YOUR NAME HERE> and <YOUR NAME HERE>.
+
+
+### Note on tests ###
+
+Each submodule of the gem has a set of basic tests associated with it.  The tests provide other examples of what is possible using this methods and may help the user further understand how this gem can be applied.  The testing suite requires the minitest gem to run properly.  Matt Sears has a nice quick reference guide for using minitest at: [http://mattsears.com/articles/2011/12/10/minitest-quick-reference](http://mattsears.com/articles/2011/12/10/minitest-quick-reference)
+
+
+Contributing
+------------
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/lib/metric_conversions/areas.rb

@@ -0,0 +1,3 @@
+module MetricConversions
+  # Your code goes here...
+end

data/lib/metric_conversions/lengths.rb

@@ -0,0 +1,165 @@
+module MetricConversions
+
+  # rounds a number to 2 digits
+  def round_2
+    (self * 100).round / 100.0
+  end
+
+  # determines if a given unit is metric
+  def is_metric?(unit)
+    return (unit == "mm" || unit == "cm" || unit == "m" || unit == "km")
+  end
+
+  # performs the actual unit length conversion given a value 
+  def convert(from, to)
+    # if we are converting from a metric value
+    if(is_metric?(from))
+        # because from is metric, convert to centimeters
+        cm = self.to_cm(from)
+
+        # if we are converting to a metric value, convert the value
+        if(is_metric?(to))
+          if(to == "mm")
+            cm.to_mm.round_2
+
+          elsif(to == "cm")
+            cm.round_2
+
+          elsif(to == "m")
+            cm.to_m.round_2
+
+          elsif(to == "km")
+            cm.to_km.round_2
+          end
+
+        # the value we are converting to is not metric, so convert the value to inches
+        else
+          inches = cm.to_inches("cm")
+
+          # if we are converting to English values, perform the conversion
+          if(to == "in")
+            inches.round_2
+
+          elsif(to == "ft")
+            inches.to_ft.round_2
+
+          elsif(to == "yd")
+            inches.to_yd.round_2
+
+          elsif(to == "mi")
+            inches.to_mi.round_2
+          end
+        end
+
+    else
+        # the value we are converting from is not metric
+        inches = self.to_inches(from)
+
+        # if the value we are converting to is metric, convert inches to centimeters and make the final conversion
+        if(is_metric?(to))
+          cm = inches.to_cm("in")
+        
+          if(to == "mm")
+            cm.to_mm.round_2
+
+          elsif(to == "cm")
+            cm.round_2
+
+          elsif(to == "m")
+            cm.to_m.round_2
+
+          elsif(to == "km")
+            cm.to_km.round_2
+          end
+
+        # the value we are converting to is in the English system, so perform the conversion
+        else
+          if(to == "in")
+            inches.round_2
+
+          elsif(to == "ft")
+            inches.to_ft.round_2
+
+          elsif(to == "yd")
+            inches.to_yd.round_2
+            
+          elsif(to == "mi")
+            inches.to_mi.round_2
+          end
+        end
+    end
+  end
+
+  # given a from value, convert it to inches
+  def to_inches(from)
+    if(from == "ft")
+      self * 12.0
+
+    elsif(from == "yd")
+      self * 36.0
+
+    elsif(from == "mi")
+      self * 12.0 * 5280
+
+    elsif(from == "cm")
+      self / 2.54
+
+    elsif(from == "in")
+      self * 1.0
+
+    end
+  end
+
+  # given a from value, convert it to centimeters
+  def to_cm(from)
+    if(from == "mm")
+      self / 10.0
+
+    elsif(from == "cm")
+      self * 1.0
+
+    elsif(from == "m")
+      self * 100.0
+
+    elsif(from == "in")
+      self * 2.54
+
+    else
+      self * 100000.0
+
+    end
+  end
+
+  # given inches, convert to feet
+  def to_ft
+    self / 12.0
+  end
+
+  # given inches, convert to yards
+  def to_yd
+    self.to_ft / 3.0
+  end
+
+  # given inches, convert to miles
+  def to_mi
+    self.to_ft / 5280.0
+  end
+
+  # given centimeters, convert to millimeters
+  def to_mm
+    self * 10.0
+  end
+
+  # given centimeters, convert to meters
+  def to_m
+    self / 100.0
+  end
+
+  # given centimeters, convert to kilometers
+  def to_km
+    self / 100000.0
+  end
+end
+
+(2.class).send(:include, MetricConversions)
+((2.54).class).send(:include, MetricConversions)

data/lib/metric_conversions/temperatures.rb

@@ -0,0 +1,3 @@
+module MetricConversions
+  # Your code goes here...
+end

data/lib/metric_conversions/version.rb

@@ -0,0 +1,3 @@
+module MetricConversions
+  VERSION = "0.0.1"
+end

data/lib/metric_conversions/volumes.rb

@@ -0,0 +1,3 @@
+module MetricConversions
+  # Your code goes here...
+end

data/lib/metric_conversions.rb

@@ -0,0 +1,8 @@
+# Provided by bundler to track the version
+require "metric_conversions/version"
+
+# Our code broken into submodules for each team to work on
+require "metric_conversions/lengths"
+require "metric_conversions/volumes"
+require "metric_conversions/temperatures"
+require "metric_conversions/areas"

data/lib/metric_conversions_tests/lengths_test.rb

@@ -0,0 +1,54 @@
+require 'minitest/spec'
+require 'minitest/autorun'
+require '../metric_conversions/lengths.rb'
+
+describe "lengths conversions" do
+  it "should return in inches the number initially given in feet" do
+    assert_equal(12, 1.convert("ft", "in"))
+    assert_equal(18, 1.5.convert("ft", "in"))
+  end
+  
+  it "should return in centimeters the number initially given in inches" do
+    assert_equal(2.54, 1.convert("in", "cm"))
+    assert_equal(635, 250.convert("in", "cm"))
+  end
+  
+  it "should return in inches the number initially given in centimeters" do
+    assert_equal(1, 2.54.convert("cm", "in"))
+    assert_equal(196.85, 500.convert("cm", "in"))
+  end
+  
+  it "should return in cm the number initially given in feet" do
+    assert_equal(91.44, 3.convert("ft", "cm"))
+    assert_equal(60.96, 2.convert("ft", "cm"))
+  end
+  
+  it "should return in cm the number initially given in miles" do
+    assert_equal(321868.8, 2.convert("mi", "cm"))
+  end
+  
+  it "should return in mm the number initially given in ft" do
+    assert_equal(609.6, 2.convert("ft", "mm"))
+  end
+  
+  it "should return in meters the number initially given in yards" do
+    assert_equal(1.83, 2.convert("yd", "m"))
+  end
+  
+  it "should return in km the number initially given in miles" do
+    assert_equal(3.22, 2.convert("mi", "km"))
+  end
+  
+  it "should return in yards the number initially given in km" do
+    assert_equal(2187.23, 2.convert("km", "yd"))
+  end
+  
+  it "should return in ft the number initially given in m" do
+    assert_equal(6.56, 2.convert("m", "ft"))
+  end
+  
+  it "should return in inches the number initially given in mm" do
+    assert_equal(17.01, 432.convert("mm", "in"))
+  end
+  
+end

data/metric_conversions.gemspec

@@ -0,0 +1,17 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/metric_conversions/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["profh and class"]
+  gem.email         = ["profh@cmu.edu"]
+  gem.description   = %q{A set of methods to help make conversions to/from Metric system and English system of measurement}
+  gem.summary       = %q{This was initially done as a class project for 67-275 at Carnegie Mellon University}
+  gem.homepage      = "https://github.com/profh/metric_conversions"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "metric_conversions"
+  gem.require_paths = ["lib"]
+  gem.version       = MetricConversions::VERSION
+end

metadata

@@ -0,0 +1,60 @@
+--- !ruby/object:Gem::Specification
+name: metric_conversions
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- profh and class
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-05-21 00:00:00.000000000 Z
+dependencies: []
+description: A set of methods to help make conversions to/from Metric system and English
+  system of measurement
+email:
+- profh@cmu.edu
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/metric_conversions.rb
+- lib/metric_conversions/areas.rb
+- lib/metric_conversions/lengths.rb
+- lib/metric_conversions/temperatures.rb
+- lib/metric_conversions/version.rb
+- lib/metric_conversions/volumes.rb
+- lib/metric_conversions_tests/lengths_test.rb
+- metric_conversions.gemspec
+homepage: https://github.com/profh/metric_conversions
+licenses: []
+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: This was initially done as a class project for 67-275 at Carnegie Mellon
+  University
+test_files: []