aeonscope-number_to_fraction 1.0.0

data/CHANGELOG.rdoc

@@ -0,0 +1,3 @@
+= v1.0.0
+
+* Initial version.

data/LICENSE.rdoc

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Brooke Kuhlmann of {Berserk Technologies}[http://www.berserktech.com]
+
+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.rdoc

@@ -0,0 +1,45 @@
+= Overview
+
+A helper that can format a number into a fraction. Unfortunately, this only handles the "pretty printing" of factions less than 1/10th at the moment (as a better algorithm needs to be used for more complex number cases).
+
+= License
+
+Copyright (c) 2009 Brooke Kuhlmann of {Berserk Technologies}[http://www.berserktech.com].
+See the included LICENSE for more info.
+
+= History
+
+See the CHANGELOG file for more info.
+
+= Requirements
+
+1. {Ruby on Rails}[http://rubyonrails.org].
+
+= Installation
+
+Type the following from the command line to install:
+
+* *UNIX*: sudo gem install aeonscope-number_to_function
+* *Windows*: gem install aeonscope-number_to_function
+
+Update your environment.rb file to include the new gem:
+
+* config.gem "aeonscope-number_to_function", :lib => "number_to_function", :source => "http://gems.github.com"
+
+= Usage
+
+Example:
+
+  number_to_function 3.75
+
+Result:
+
+  3 3/4
+
+View the Rspec test suite for more usage and examples.
+
+= Contact/Feedback/Issues
+
+* {Berserk Technologies}[http://www.berserktech.com] - Company web site.
+* Aeonscope[http://www.aeonscope.net] - Personal web site.
+* Twitter[http://www.twitter.com/Aeonscope] - Short bursts of insight and/or noise.

data/Rakefile

@@ -0,0 +1,49 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "number_to_fraction"
+    gem.summary = "A helper that can format a number into a fraction."
+    gem.description = "A helper that can format a number into a fraction."
+    gem.authors = ["Brooke Kuhlmann"]
+    gem.email = "aeonscope@gmail.com"
+    gem.homepage = "http://github.com/aeonscope/number_to_fraction"
+		gem.required_ruby_version = ">= 1.8.6"
+		gem.add_dependency "rails", ">= 2.3.2"
+		gem.rdoc_options << "CHANGELOG.rdoc"
+		gem.files = FileList["[A-Z]*", "{bin,lib,generators,rails_generators,test,spec}/**/*"]
+  end
+
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION')
+    version = File.read('VERSION')
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "number_to_fraction #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION.yml

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

data/lib/number_to_fraction.rb

@@ -0,0 +1,56 @@
+module ActionView
+  module Helpers #:nodoc:
+    module NumberHelper
+      # Formats a +number+ into a fraction string (i.e. 1 1/3 or 2/9). You can customize the format
+      # in the +options+ hash.
+      #
+			# *NOTE*: This function only supports the "pretty printing" of factions less than 1/10th.
+			#
+      # ==== Options
+      # * *precision* - Options. Sets the level of precision. Defaults to 3.
+      #
+      # ==== Examples
+      #  number_to_fraction 0.25 # => 1/4
+      #  number_to_fraction 1.375 # => 1 3/8
+      #  number_to_fraction 5.22 # => 5 2/9
+      #  number_to_fraction 3.55 :precision => 2 # 3 => 5/9
+			def number_to_fraction number = '', options = {}
+				number = number.to_s.strip
+				options.reverse_merge! :precision => 3
+				whole, numerator, denominator = nil
+				if number.include? '.'
+					whole, numerator = number.split '.'
+					rational = Rational(numerator.ljust(options[:precision], '0').to_i, (10 ** options[:precision]))
+					# Check for repeating/complex decimals - yeah, this solution is lame.
+					case
+					when !numerator.match(/^33+/).nil? then numerator, denominator = 1, 3 
+					when !numerator.match(/^66+/).nil? then numerator, denominator = 2, 3
+					when !numerator.match(/^1{1}6+/).nil? then numerator, denominator = 1, 6
+					when !numerator.match(/^8{1}3+/).nil? then numerator, denominator = 5, 6
+					when !numerator.match(/^142/).nil? then numerator, denominator = 1, 7
+					when !numerator.match(/^285/).nil? then numerator, denominator = 2, 7
+					when !numerator.match(/^428/).nil? then numerator, denominator = 3, 7
+					when !numerator.match(/^571/).nil? then numerator, denominator = 4, 7
+					when !numerator.match(/^714/).nil? then numerator, denominator = 5, 7
+					when !numerator.match(/^857/).nil? then numerator, denominator = 6, 7
+					when !numerator.match(/^125/).nil? then numerator, denominator = 1, 8
+					when !numerator.match(/^375/).nil? then numerator, denominator = 3, 8
+					when !numerator.match(/^625/).nil? then numerator, denominator = 5, 8
+					when !numerator.match(/^875/).nil? then numerator, denominator = 7, 8
+					when !numerator.match(/^11+/).nil? then numerator, denominator = 1, 9
+					when !numerator.match(/^22+/).nil? then numerator, denominator = 2, 9
+					when !numerator.match(/^44+/).nil? then numerator, denominator = 4, 9
+					when !numerator.match(/^55+/).nil? then numerator, denominator = 5, 9
+					when !numerator.match(/^77+/).nil? then numerator, denominator = 7, 9
+					when !numerator.match(/^88+/).nil? then numerator, denominator = 8, 9
+					else numerator, denominator = rational.numerator, rational.denominator
+					end
+				else
+					whole = number
+				end
+				whole = nil if whole == '0' && numerator
+				[whole, [numerator, denominator].compact * '/'].compact.join(' ').strip
+			end
+    end
+  end
+end

data/spec/number_to_fraction_spec.rb

@@ -0,0 +1,137 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "Number to Fraction" do
+ 	include ActionView::Helpers::NumberHelper
+
+	it "should be blank when nil" do
+		number_to_fraction(nil).should == ''
+	end
+
+	it "should be blank when blank" do
+		number_to_fraction('').should == ''
+	end
+
+	it "should be 0" do
+		number_to_fraction(0).should == '0'
+	end
+
+	it "should be 1" do
+		number_to_fraction(1).should == '1'
+	end
+
+	it "should be 1/3" do
+		number_to_fraction(0.33).should == "1/3"
+	end
+
+	it "should be 2/3" do
+		number_to_fraction(0.66).should == "2/3"
+	end
+
+	it "should be 1/4" do
+		number_to_fraction(0.25).should == "1/4"
+	end
+
+	it "should be 3/4" do
+		number_to_fraction(0.75).should == "3/4"
+	end
+
+	it "should be 1/5" do
+		number_to_fraction(0.2).should == "1/5"
+	end
+
+	it "should be 2/5" do
+		number_to_fraction(0.4).should == "2/5"
+	end
+
+	it "should be 3/5" do
+		number_to_fraction(0.6).should == "3/5"
+	end
+
+	it "should be 4/5" do
+		number_to_fraction(0.8).should == "4/5"
+	end
+
+	it "should be 1/6" do
+		number_to_fraction(0.166).should == "1/6"
+	end
+
+	it "should be 5/6" do
+		number_to_fraction(0.833).should == "5/6"
+	end
+
+	it "should be 1/7" do
+		number_to_fraction(0.142).should == "1/7"
+	end
+
+	it "should be 2/7" do
+		number_to_fraction(0.285).should == "2/7"
+	end
+
+	it "should be 3/7" do
+		number_to_fraction(0.428).should == "3/7"
+	end
+
+	it "should be 4/7" do
+		number_to_fraction(0.571).should == "4/7"
+	end
+
+	it "should be 5/7" do
+		number_to_fraction(0.714).should == "5/7"
+	end
+
+	it "should be 6/7" do
+		number_to_fraction(0.857).should == "6/7"
+	end
+	
+	it "should be 1/8" do
+		number_to_fraction(0.125).should == "1/8"
+	end
+	
+	it "should be 3/8" do
+		number_to_fraction(0.375).should == "3/8"
+	end
+
+	it "should be 5/8" do
+		number_to_fraction(0.625).should == "5/8"
+	end
+
+	it "should be 7/8" do
+		number_to_fraction(0.875).should == "7/8"
+	end	
+
+	it "should be 1/9" do
+		number_to_fraction(0.11).should == "1/9"
+	end	
+
+	it "should be 2/9" do
+		number_to_fraction(0.22).should == "2/9"
+	end	
+
+	it "should be 4/9" do
+		number_to_fraction(0.44).should == "4/9"
+	end	
+
+	it "should be 5/9" do
+		number_to_fraction(0.55).should == "5/9"
+	end	
+
+	it "should be 7/9" do
+		number_to_fraction(0.77).should == "7/9"
+	end	
+
+	it "should be 8/9" do
+		number_to_fraction(0.88).should == "8/9"
+	end
+	
+	it "should be 1 2/3" do
+		number_to_fraction(1.66).should == "1 2/3"
+	end
+	
+	it "should be 55 2/9" do
+		number_to_fraction(55.22).should == "55 2/9"
+	end
+	
+	it "should be 10203 3/8" do
+		number_to_fraction(10203.375).should == "10203 3/8"
+	end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,11 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'rubygems'
+require 'active_support'
+require 'number_to_fraction'
+require 'spec'
+require 'spec/autorun'
+
+Spec::Runner.configure do |config|  
+end

metadata

@@ -0,0 +1,73 @@
+--- !ruby/object:Gem::Specification 
+name: aeonscope-number_to_fraction
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+platform: ruby
+authors: 
+- Brooke Kuhlmann
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-08-29 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rails
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.3.2
+    version: 
+description: A helper that can format a number into a fraction.
+email: aeonscope@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.rdoc
+- README.rdoc
+files: 
+- CHANGELOG.rdoc
+- LICENSE.rdoc
+- README.rdoc
+- Rakefile
+- VERSION.yml
+- lib/number_to_fraction.rb
+- spec/number_to_fraction_spec.rb
+- spec/spec_helper.rb
+has_rdoc: false
+homepage: http://github.com/aeonscope/number_to_fraction
+licenses: 
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+- CHANGELOG.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: 1.8.6
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: A helper that can format a number into a fraction.
+test_files: 
+- spec/number_to_fraction_spec.rb
+- spec/spec_helper.rb