acts_as_percentage 0.1.0

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+*.sqlite3

data/Gemfile

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

data/README.md

@@ -0,0 +1,25 @@
+# Installing
+`gem "acts_as_percentage"`
+
+# Requirements
+Rails 3.1.x
+
+# Usage
+
+Allows you to store percent values as an integer.  
+
+    class ProgressBar < ActiveRecord::Base
+        percentage :completed
+    end
+
+
+This assumes there is a column in the database named `completed_basis_point (Integer)`. It creates
+several helper methods for you:
+
+    pb = ProgressBar.create(:completed => 59.87) # => <ProgressBar: @completed_basis_point=5987>
+    pb.completed # => 59.87
+    pb.completed_ratio # => 0.5987
+    pb.completed_basis_point # => 5987
+
+
+Raises `ArgumentError` if the column specified is not present

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/acts_as_percentage.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "acts_as_percentage/version"
+
+Gem::Specification.new do |s|
+  s.name        = "acts_as_percentage"
+  s.version     = ActsAsPercentage::VERSION
+  s.authors     = ["Jared McFarland"]
+  s.email       = ["jared.online@gmail.com"]
+  s.homepage    = ""
+  s.summary     = "Adds simple percentage and ratio helpers to ActiveRecord and allows percents to be stored as an Integer"
+  s.description = "Because most percentages only need to be accurate to two decimals, this gem has you store them as basis points and does the conversion for you."
+
+  s.rubyforge_project = "acts_as_percentage"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+  
+  s.add_dependency "activerecord", "~> 3.1.0"
+  
+  # specify any dependencies here; for example:
+  s.add_development_dependency "rspec", "~> 2.6"
+  s.add_development_dependency "bundler", "~> 1.0.0"
+  s.add_development_dependency "sqlite3-ruby"
+  # s.add_runtime_dependency "rest-client"
+end

data/lib/acts_as_percentage.rb

@@ -0,0 +1,50 @@
+require "active_record"
+require "acts_as_percentage/version"
+
+module ActsAsPercentage #:nodoc:
+  def self.extended(base)
+    base.extend(ClassMethods)
+  end
+  
+  module ClassMethods #:nodoc:
+    
+    # Allows you to store percent values as an integer.  
+    # 
+    #   class ProgressBar < ActiveRecord::Base
+    #     percentage :completed
+    #   end
+    # 
+    # This assumes there is a column in the database named <tt>completed_basis_point (Integer)</tt>. It creates
+    # several helper methods for you:
+    # 
+    #   pb = ProgressBar.create(:completed => 59.87) # => <ProgressBar: @completed_basis_point=5987>
+    #   pb.completed # => 59.87
+    #   pb.completed_ratio # => 0.5987
+    #   pb.completed_basis_point # => 5987
+    # 
+    # Raises <tt>ArgumentError</tt> if the column specified is not present
+    # 
+    def percentage(*attributes)
+      attributes.each do |attribute|
+        basis_point_attribute = "#{attribute}_basis_point"
+        raise ArgumentError.new("#{self} does not respond to #{basis_point_attribute}") unless self.column_names.include?("#{basis_point_attribute}")
+        
+        define_method("#{attribute}") do
+          self.__send__(basis_point_attribute) / 100.0 rescue nil
+        end
+        
+        define_method("#{attribute}_ratio") do
+          self.__send__(basis_point_attribute) / 10000.0 rescue nil
+        end
+        
+        define_method("#{attribute}=") do |percentage|
+          basis_point = percentage ? (Float(percentage) * 100).round : nil
+          self.__send__("#{basis_point_attribute}=", basis_point)
+        end
+      end
+    end
+  end
+  
+end
+
+ActiveRecord::Base.extend ActsAsPercentage

data/lib/acts_as_percentage/version.rb

@@ -0,0 +1,3 @@
+module ActsAsPercentage
+  VERSION = "0.1.0"
+end

data/spec/lib/acts_as_percentage_spec.rb

@@ -0,0 +1,39 @@
+require 'spec_helper'
+
+describe "acts_as_percentage" do
+  let(:progress_bar) { ProgressBar.create(:completed_basis_point => 7569) }
+  
+  it "has completed" do
+    progress_bar.completed.should eql(75.69)
+  end
+  
+  it "has completed_basis_point" do
+    progress_bar.completed_basis_point.should eql(7569)
+  end
+  
+  it "has completed_ratio" do
+    progress_bar.completed_ratio.should eql(0.7569)
+  end
+  
+  it "allows the setting of a perctage" do
+    progress_bar.completed = 89.19
+    progress_bar.completed_basis_point.should eql(8919)
+    progress_bar.completed.should eql(89.19)
+    progress_bar.completed_ratio.should eql(0.8919)
+  end
+  
+  it "allows setting of nil" do
+    progress_bar.completed = nil
+    progress_bar.completed_basis_point.should be_nil
+    progress_bar.completed.should be_nil
+    progress_bar.completed_ratio.should be_nil
+  end
+  
+  it "allows setting with a string" do
+    lambda { ProgressBar.create(:completed => "59.87") }.should_not raise_error
+  end
+  
+  it "raises an error if an unspecified column is present" do
+    lambda { class ProgressBar < ActiveRecord::Base; percentage :foo; end }.should raise_error(ArgumentError)
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,7 @@
+require 'acts_as_percentage'
+
+ActiveRecord::Base.establish_connection(:adapter => "sqlite3", :database => File.dirname(__FILE__) + "/acts_as_percentage.sqlite3")
+
+load File.dirname(__FILE__) + '/support/schema.rb'
+load File.dirname(__FILE__) + '/support/models.rb'
+load File.dirname(__FILE__) + '/support/data.rb'

data/spec/support/data.rb

@@ -0,0 +1 @@
+# Put seed data here

data/spec/support/models.rb

@@ -0,0 +1,3 @@
+class ProgressBar < ActiveRecord::Base
+  percentage :completed
+end

data/spec/support/schema.rb

@@ -0,0 +1,8 @@
+ActiveRecord::Schema.define do
+  self.verbose = false
+  
+  create_table :progress_bars, :force => true do |t|
+    t.integer :completed_basis_point
+    t.timestamps
+  end
+end

metadata

@@ -0,0 +1,108 @@
+--- !ruby/object:Gem::Specification
+name: acts_as_percentage
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Jared McFarland
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-01-21 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: &70265346777660 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *70265346777660
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70265346777020 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :development
+  prerelease: false
+  version_requirements: *70265346777020
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: &70265346776520 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: *70265346776520
+- !ruby/object:Gem::Dependency
+  name: sqlite3-ruby
+  requirement: &70265346775980 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70265346775980
+description: Because most percentages only need to be accurate to two decimals, this
+  gem has you store them as basis points and does the conversion for you.
+email:
+- jared.online@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README.md
+- Rakefile
+- acts_as_percentage.gemspec
+- lib/acts_as_percentage.rb
+- lib/acts_as_percentage/version.rb
+- spec/lib/acts_as_percentage_spec.rb
+- spec/spec_helper.rb
+- spec/support/data.rb
+- spec/support/models.rb
+- spec/support/schema.rb
+homepage: ''
+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: acts_as_percentage
+rubygems_version: 1.8.6
+signing_key: 
+specification_version: 3
+summary: Adds simple percentage and ratio helpers to ActiveRecord and allows percents
+  to be stored as an Integer
+test_files:
+- spec/lib/acts_as_percentage_spec.rb
+- spec/spec_helper.rb
+- spec/support/data.rb
+- spec/support/models.rb
+- spec/support/schema.rb