farski-systeme 0.3.2 → 0.4.0

data/README.rdoc

@@ -44,6 +44,23 @@ Conversions allow you to display or pass data in a unit other than the SI base.
 	=> 3.28083989501312
 	# 5280 was presumed to be in meters, if you were looking for a result of 1 you should do 5280.feet.in_miles
 
+== Advanced Usage
+
+One useful application of systeme is to take human readable input to produce usable and storable data
+
+	# How far did you walk today?
+	input = "6.25mi"
+	
+	distance = input.to_f
+	unit = ((unit_data = input.match(/([a-zA-Z]+)/)) ? unit_data[1] : "m" )
+	
+	si_distance = distance.send(unit)
+	=> 10058.4
+
+== Parsing
+
+The parse method provides very lax natural language parsing of dimensioned numbers in strings. It works much as one would expect, but two things to note: it will simply ignore any numbers associated with labels it doesn't understand, and it doesn't care if all the numbers in the string are of the same dimensionality. A string like "1 meter 1 centimeter" 1.01 and the string "1 meter 1 kilogram" will return 2.0. The same unit label can appear many times in a single string ("1m 1m 1m" => 3.0). If the parser finds a number with no label, it is technically being dimensioned as 'meter', which has no effect on the value.
+
 = Installation
 
 === As a gem
@@ -54,7 +71,7 @@ The official distributions of this gem are available on RubyForge under the proj
 
 	$ gem install systeme
 	
-Development can be followed on GitHub at http://www.gihub.com/farski/systeme
+Development can be followed on GitHub at http://www.github.com/farski/systeme
 
 	$ gem install farski-systeme
 

data/VERSION.yml

@@ -1,4 +1,4 @@
 --- 
-:minor: 3
-:patch: 2
+:minor: 4
+:patch: 0
 :major: 0

data/lib/systeme.rb

@@ -13,6 +13,22 @@ module Systeme
   include Systeme::Imperial
   include Systeme::Length
   include Systeme::Conversions
+
+	def self.parse(string)
+		return nil if (!string || !string.match(/\d/))
+		
+		string.gsub!(/ */,  '').gsub!(/([a-zA-Z])(\d)/, '\1 \2')
+		parts = string.split(' ')
+		total = parts.inject(0) do |total, part|
+			value = part.to_f
+			label = ((l = part.match(/([a-zA-Z]+)/)) ? l[1] : "m")			
+			total += (value.respond_to?(label) ? value.send(label) : 0)
+		end
+		
+		return total
+	end
 end
 
-Numeric.send :include, Systeme
+Numeric.send :include, Systeme
+
+puts Systeme.parse('1m')

data/test/metric_test.rb

@@ -1,6 +1,6 @@
 require File.dirname(__FILE__) + '/test_helper'
 
-class ImperialTest < Test::Unit::TestCase
+class MetricTest < Test::Unit::TestCase
   should "convert carat to kilogram" do
     assert_equal 0.0002, 1.carat
   end

data/test/parse_test.rb

@@ -0,0 +1,33 @@
+require File.dirname(__FILE__) + '/test_helper'
+
+class ParseTest < Test::Unit::TestCase
+  should "parse a single base unit string" do
+    assert_equal 1, Systeme.parse('1m')
+    assert_equal 1, Systeme.parse('1 meter')
+    assert_equal 1, Systeme.parse('1 meters')
+    assert_equal 1, Systeme.parse('1 m')
+  end
+
+  should "parse a single non-base unit string" do
+    assert_equal 1000, Systeme.parse('1km')
+    assert_equal 1000, Systeme.parse('1 kilometer')
+    assert_equal 1000, Systeme.parse('1 kilometers')
+    assert_equal 1000, Systeme.parse('1 km')
+  end
+
+  should "parse a complex string" do
+    assert_equal 1001, Systeme.parse('1km 1m')
+    assert_equal 1001, Systeme.parse('1 km 1 m')
+    assert_equal 1001, Systeme.parse('1kilometer1meter')
+    assert_equal 1001, Systeme.parse('1 kilometer 1 meter')
+  end
+
+  should "parse a complex string with non-SI units" do
+    assert_equal 1609.344, Systeme.parse('1 mile')
+    assert_equal 1609.3694, Systeme.parse('1 mi 1in')
+  end
+
+  should "parse a complex string with units from different systems" do
+    assert_equal 1610.344, Systeme.parse('1 mile 1m')
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: farski-systeme
 version: !ruby/object:Gem::Version 
-  version: 0.3.2
+  version: 0.4.0
 platform: ruby
 authors: 
 - Chris Kalafarski
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-01-17 00:00:00 -08:00
+date: 2009-02-25 00:00:00 -08:00
 default_executable: 
 dependencies: []
 
@@ -36,12 +36,14 @@ files:
 - test/imperial_test.rb
 - test/international_test.rb
 - test/metric_test.rb
+- test/parse_test.rb
 - test/test_helper.rb
-has_rdoc: false
+has_rdoc: true
 homepage: http://github.com/farski/systeme
 post_install_message: 
-rdoc_options: []
-
+rdoc_options: 
+- --inline-source
+- --charset=UTF-8
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement