stocktrade-money-rails 0.6.0

data/money-rails.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/money-rails/version', __FILE__)
+
+Gem::Specification.new do |s|
+  s.name          = "stocktrade-money-rails"
+  s.version       = MoneyRails::VERSION
+  s.platform      = Gem::Platform::RUBY
+  s.license       = "MIT"
+  s.authors       = ["Andreas Loupasakis", "Shane Emmons", "Simone Carletti", "Pablo Merino"]
+  s.email         = ["alup.rubymoney@gmail.com"]
+  s.description   = "This library provides integration of RubyMoney - Money gem with Rails - StockTrade Special"
+  s.summary       = "Money gem integration with Rails"
+  s.homepage      = "https://github.com/RubyMoney/money-rails"
+
+  s.files         =  Dir.glob("{lib,spec}/**/*")
+  s.files         += %w(CHANGELOG.md LICENSE README.md)
+  s.files         += %w(Rakefile money-rails.gemspec)
+
+  s.test_files    = s.files.grep(/^spec\//)
+
+  s.require_path = "lib"
+
+  s.add_dependency "money",         "~> 5.0.0"
+  s.add_dependency "activesupport", "~> 3.0"
+  s.add_dependency "railties",      "~> 3.0"
+
+  s.add_development_dependency "rails",       "~> 3.0"
+  s.add_development_dependency "rspec-rails", "~> 2.10"
+  s.add_development_dependency 'database_cleaner', ['>= 0.8.0']
+end

data/spec/active_record/monetizable_spec.rb

@@ -0,0 +1,308 @@
+require 'spec_helper'
+
+if defined? ActiveRecord
+  describe MoneyRails::ActiveRecord::Monetizable do
+
+    describe "monetize" do
+      before :each do
+        @product = Product.create(:price_cents => 3000, :discount => 150,
+                                  :bonus_cents => 200, :optional_price => 100,
+                                  :sale_price_amount => 1200)
+        @service = Service.create(:charge_cents => 2000, :discount_cents => 120)
+      end
+
+      it "attaches a Money object to model field" do
+        @product.price.should be_an_instance_of(Money)
+        @product.discount_value.should be_an_instance_of(Money)
+        @product.bonus.should be_an_instance_of(Money)
+      end
+
+      it "returns the expected money amount as a Money object" do
+        @product.price.should == Money.new(3000, "USD")
+      end
+
+      it "assigns the correct value from a Money object" do
+        @product.price = Money.new(3210, "USD")
+        @product.save.should be_true
+        @product.price_cents.should == 3210
+      end
+
+      it "assigns the correct value from a Money object using create" do
+        @product = Product.create(:price => Money.new(3210, "USD"), :discount => 150,
+                                  :bonus_cents => 200, :optional_price => 100)
+        @product.valid?.should be_true
+        @product.price_cents.should == 3210
+      end
+
+      it "updates correctly from a Money object using update_attributes" do
+        @product.update_attributes(:price => Money.new(215, "USD")).should be_true
+        @product.price_cents.should == 215
+      end
+
+      it "respects :as argument" do
+        @product.discount_value.should == Money.new(150, "USD")
+      end
+
+      it "uses numericality validation" do
+        @product.price_cents = "foo"
+        @product.save.should be_false
+
+        @product.price_cents = 2000
+        @product.save.should be_true
+      end
+
+      it "respects numericality validation when using update_attributes" do
+        @product.update_attributes(:price_cents => "some text").should be_false
+        @product.update_attributes(:price_cents => 2000).should be_true
+      end
+
+      it "uses numericality validation on money attribute" do
+        @product.price = "some text"
+        @product.save.should be_false
+
+        @product.price = Money.new(320, "USD")
+        @product.save.should be_true
+      end
+
+      it "respects numericality validation when using update_attributes on money attribute" do
+        @product.update_attributes(:price => "some text").should be_false
+        @product.update_attributes(:price => Money.new(320, 'USD')).should be_true
+      end
+
+      it "doesn't allow nil by default" do
+        @product.price_cents = nil
+        @product.save.should be_false
+      end
+
+      it "allows nil if optioned" do
+        @product.optional_price = nil
+        @product.save.should be_true
+        @product.optional_price.should be_nil
+      end
+
+      it "doesn't raise exception if validation is used and nil is not allowed" do
+        expect { @product.price = nil }.to_not raise_error
+      end
+
+      it "doesn't save nil values if validation is used and nil is not allowed" do
+        @product.price = nil
+        @product.save
+        @product.price_cents.should_not be_nil
+      end
+
+      it "resets money_before_type_cast attr every time a save operation occurs" do
+        v = Money.new(100, :usd)
+        @product.price = v
+        @product.price_money_before_type_cast.should == v
+        @product.save
+        @product.price_money_before_type_cast.should be_nil
+        @product.price = 10
+        @product.price_money_before_type_cast.should == 10
+        @product.save
+        @product.price_money_before_type_cast.should be_nil
+        @product.bonus = ""
+        @product.bonus_money_before_type_cast.should == ""
+        @product.save.should be_false
+        @product.bonus_money_before_type_cast.should be_nil
+      end
+
+      it "uses Money default currency if :with_currency has not been used" do
+        @service.discount.currency.should == Money::Currency.find(:eur)
+      end
+
+      it "overrides default currency with the currency registered for the model" do
+        @product.price.currency.should == Money::Currency.find(:usd)
+      end
+
+      it "overrides default currency with the value of :with_currency argument" do
+        @service.charge.currency.should == Money::Currency.find(:usd)
+        @product.bonus.currency.should == Money::Currency.find(:gbp)
+      end
+
+      it "assigns correctly Money objects to the attribute" do
+        @product.price = Money.new(2500, :USD)
+        @product.save.should be_true
+        @product.price.cents.should == 2500
+        @product.price.currency_as_string.should == "USD"
+      end
+
+      it "assigns correctly Fixnum objects to the attribute" do
+        @product.price = 25
+        @product.save.should be_true
+        @product.price.cents.should == 2500
+        @product.price.currency_as_string.should == "USD"
+
+        @service.discount = 2
+        @service.save.should be_true
+        @service.discount.cents.should == 200
+        @service.discount.currency_as_string.should == "EUR"
+      end
+
+      it "assigns correctly String objects to the attribute" do
+        @product.price = "25"
+        @product.save.should be_true
+        @product.price.cents.should == 2500
+        @product.price.currency_as_string.should == "USD"
+
+        @service.discount = "2"
+        @service.save.should be_true
+        @service.discount.cents.should == 200
+        @service.discount.currency_as_string.should == "EUR"
+      end
+
+      it "overrides default, model currency with the value of :with_currency in fixnum assignments" do
+        @product.bonus = 25
+        @product.save.should be_true
+        @product.bonus.cents.should == 2500
+        @product.bonus.currency_as_string.should == "GBP"
+
+        @service.charge = 2
+        @service.save.should be_true
+        @service.charge.cents.should == 200
+        @service.charge.currency_as_string.should == "USD"
+      end
+
+      it "overrides default, model currency with the value of :with_currency in string assignments" do
+        @product.bonus = "25"
+        @product.save.should be_true
+        @product.bonus.cents.should == 2500
+        @product.bonus.currency_as_string.should == "GBP"
+
+        @service.charge = "2"
+        @service.save.should be_true
+        @service.charge.cents.should == 200
+        @service.charge.currency_as_string.should == "USD"
+      end
+
+      it "overrides default currency with model currency, in fixnum assignments" do
+        @product.discount_value = 5
+        @product.save.should be_true
+        @product.discount_value.cents.should == 500
+        @product.discount_value.currency_as_string.should == "USD"
+      end
+
+      it "overrides default currency with model currency, in string assignments" do
+        @product.discount_value = "5"
+        @product.save.should be_true
+        @product.discount_value.cents.should == 500
+        @product.discount_value.currency_as_string.should == "USD"
+      end
+
+      it "falls back to default currency, in fixnum assignments" do
+        @service.discount = 5
+        @service.save.should be_true
+        @service.discount.cents.should == 500
+        @service.discount.currency_as_string.should == "EUR"
+      end
+
+      it "falls back to default currency, in string assignments" do
+        @service.discount = "5"
+        @service.save.should be_true
+        @service.discount.cents.should == 500
+        @service.discount.currency_as_string.should == "EUR"
+      end
+
+      it "sets field to nil, in nil assignments if allow_nil is set" do
+        @product.optional_price = nil 
+        @product.save.should be_true
+        @product.optional_price.should be_nil
+      end
+
+      it "sets field to nil, in instantiation if allow_nil is set" do
+        pr = Product.new(:optional_price => nil, :price_cents => 5320,
+          :discount => 350, :bonus_cents => 320)
+        pr.optional_price.should be_nil
+        pr.save.should be_true
+        pr.optional_price.should be_nil
+      end
+
+      it "sets field to nil, in blank assignments if allow_nil is set" do
+        @product.optional_price = ""
+        @product.save.should be_true
+        @product.optional_price.should be_nil
+      end
+
+      context "for column with currency:" do
+        it "is overridden by instance currency" do
+          product = Product.create(:price_cents => 5320, :discount => 350, :bonus_cents => 320)
+          product.stub(:currency) { "EUR" }
+          product.bonus.currency_as_string.should == "EUR"
+        end
+      end
+
+      context "for column with model currency:" do
+        it "has default currency if not specified" do
+          product = Product.create(:sale_price_amount => 1234)
+          product.sale_price.currency_as_string == 'USD'
+        end
+        it "is overridden by instance currency column" do
+          product = Product.create(:sale_price_amount => 1234,
+                                   :sale_price_currency_code => 'CAD')
+          product.sale_price.currency_as_string.should == 'CAD'
+        end
+      end
+
+      context "for model with currency column:" do
+        before :each do
+          @transaction = Transaction.create(:amount_cents => 2400, :tax_cents => 600,
+                                            :currency => :usd)
+          @dummy_product1 = DummyProduct.create(:price_cents => 2400, :currency => :usd)
+          @dummy_product2 = DummyProduct.create(:price_cents => 2600) # nil currency
+        end
+
+        it "serializes correctly the currency to a new instance of model" do
+          d = DummyProduct.new
+          d.price = Money.new(10, "EUR")
+          d.save!
+          d.reload
+          d.currency.should == "EUR"
+        end
+
+        it "overrides default currency with the value of row currency" do
+          @transaction.amount.currency.should == Money::Currency.find(:usd)
+        end
+
+        it "overrides default currency with the currency registered for the model" do
+          @dummy_product2.price.currency.should == Money::Currency.find(:gbp)
+        end
+
+        it "overrides default and model currency with the row currency" do
+          @dummy_product1.price.currency.should == Money::Currency.find(:usd)
+        end
+
+        it "constructs the money attribute from the stored mapped attribute values" do
+          @transaction.amount.should == Money.new(2400, :usd)
+        end
+
+        it "instantiates correctly Money objects from the mapped attributes" do
+          t = Transaction.new(:amount_cents => 2500, :currency => "CAD")
+          t.amount.should == Money.new(2500, "CAD")
+        end
+
+        it "assigns correctly Money objects to the attribute" do
+          @transaction.amount = Money.new(2500, :eur)
+          @transaction.save.should be_true
+          @transaction.amount.cents.should == Money.new(2500, :eur).cents
+          @transaction.amount.currency_as_string.should == "EUR"
+        end
+
+        it "uses default currency if a non Money object is assigned to the attribute" do
+          @transaction.amount = 234
+          @transaction.amount.currency_as_string.should == "USD"
+        end
+
+        it "constructs the money object from the mapped method value" do
+          @transaction.total.should == Money.new(3000, :usd)
+        end
+
+      end
+    end
+
+    describe "register_currency" do
+      it "attaches currency at model level" do
+        Product.currency.should == Money::Currency.find(:usd)
+        DummyProduct.currency.should == Money::Currency.find(:gbp)
+      end
+    end
+  end
+end

data/spec/configuration_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+
+describe "configuration" do
+
+  describe "initializer" do
+
+    it "sets default currency" do
+      Money.default_currency.should == Money::Currency.new(:eur)
+    end
+
+    it "registers a custom currency" do
+      Money::Currency.table.should include(:eu4)
+    end
+
+    it "adds exchange rates given in config initializer" do
+      Money.us_dollar(100).exchange_to("CAD").should == Money.new(124, "CAD")
+      Money.ca_dollar(100).exchange_to("USD").should == Money.new(80, "USD")
+    end
+  end
+end

data/spec/dummy/README.rdoc

@@ -0,0 +1,261 @@
+== Welcome to Rails
+
+Rails is a web-application framework that includes everything needed to create
+database-backed web applications according to the Model-View-Control pattern.
+
+This pattern splits the view (also called the presentation) into "dumb"
+templates that are primarily responsible for inserting pre-built data in between
+HTML tags. The model contains the "smart" domain objects (such as Account,
+Product, Person, Post) that holds all the business logic and knows how to
+persist themselves to a database. The controller handles the incoming requests
+(such as Save New Account, Update Product, Show Post) by manipulating the model
+and directing data to the view.
+
+In Rails, the model is handled by what's called an object-relational mapping
+layer entitled Active Record. This layer allows you to present the data from
+database rows as objects and embellish these data objects with business logic
+methods. You can read more about Active Record in
+link:files/vendor/rails/activerecord/README.html.
+
+The controller and view are handled by the Action Pack, which handles both
+layers by its two parts: Action View and Action Controller. These two layers
+are bundled in a single package due to their heavy interdependence. This is
+unlike the relationship between the Active Record and Action Pack that is much
+more separate. Each of these packages can be used independently outside of
+Rails. You can read more about Action Pack in
+link:files/vendor/rails/actionpack/README.html.
+
+
+== Getting Started
+
+1. At the command prompt, create a new Rails application:
+       <tt>rails new myapp</tt> (where <tt>myapp</tt> is the application name)
+
+2. Change directory to <tt>myapp</tt> and start the web server:
+       <tt>cd myapp; rails server</tt> (run with --help for options)
+
+3. Go to http://localhost:3000/ and you'll see:
+       "Welcome aboard: You're riding Ruby on Rails!"
+
+4. Follow the guidelines to start developing your application. You can find
+the following resources handy:
+
+* The Getting Started Guide: http://guides.rubyonrails.org/getting_started.html
+* Ruby on Rails Tutorial Book: http://www.railstutorial.org/
+
+
+== Debugging Rails
+
+Sometimes your application goes wrong. Fortunately there are a lot of tools that
+will help you debug it and get it back on the rails.
+
+First area to check is the application log files. Have "tail -f" commands
+running on the server.log and development.log. Rails will automatically display
+debugging and runtime information to these files. Debugging info will also be
+shown in the browser on requests from 127.0.0.1.
+
+You can also log your own messages directly into the log file from your code
+using the Ruby logger class from inside your controllers. Example:
+
+  class WeblogController < ActionController::Base
+    def destroy
+      @weblog = Weblog.find(params[:id])
+      @weblog.destroy
+      logger.info("#{Time.now} Destroyed Weblog ID ##{@weblog.id}!")
+    end
+  end
+
+The result will be a message in your log file along the lines of:
+
+  Mon Oct 08 14:22:29 +1000 2007 Destroyed Weblog ID #1!
+
+More information on how to use the logger is at http://www.ruby-doc.org/core/
+
+Also, Ruby documentation can be found at http://www.ruby-lang.org/. There are
+several books available online as well:
+
+* Programming Ruby: http://www.ruby-doc.org/docs/ProgrammingRuby/ (Pickaxe)
+* Learn to Program: http://pine.fm/LearnToProgram/ (a beginners guide)
+
+These two books will bring you up to speed on the Ruby language and also on
+programming in general.
+
+
+== Debugger
+
+Debugger support is available through the debugger command when you start your
+Mongrel or WEBrick server with --debugger. This means that you can break out of
+execution at any point in the code, investigate and change the model, and then,
+resume execution! You need to install ruby-debug to run the server in debugging
+mode. With gems, use <tt>sudo gem install ruby-debug</tt>. Example:
+
+  class WeblogController < ActionController::Base
+    def index
+      @posts = Post.all
+      debugger
+    end
+  end
+
+So the controller will accept the action, run the first line, then present you
+with a IRB prompt in the server window. Here you can do things like:
+
+  >> @posts.inspect
+  => "[#<Post:0x14a6be8
+          @attributes={"title"=>nil, "body"=>nil, "id"=>"1"}>,
+       #<Post:0x14a6620
+          @attributes={"title"=>"Rails", "body"=>"Only ten..", "id"=>"2"}>]"
+  >> @posts.first.title = "hello from a debugger"
+  => "hello from a debugger"
+
+...and even better, you can examine how your runtime objects actually work:
+
+  >> f = @posts.first
+  => #<Post:0x13630c4 @attributes={"title"=>nil, "body"=>nil, "id"=>"1"}>
+  >> f.
+  Display all 152 possibilities? (y or n)
+
+Finally, when you're ready to resume execution, you can enter "cont".
+
+
+== Console
+
+The console is a Ruby shell, which allows you to interact with your
+application's domain model. Here you'll have all parts of the application
+configured, just like it is when the application is running. You can inspect
+domain models, change values, and save to the database. Starting the script
+without arguments will launch it in the development environment.
+
+To start the console, run <tt>rails console</tt> from the application
+directory.
+
+Options:
+
+* Passing the <tt>-s, --sandbox</tt> argument will rollback any modifications
+  made to the database.
+* Passing an environment name as an argument will load the corresponding
+  environment. Example: <tt>rails console production</tt>.
+
+To reload your controllers and models after launching the console run
+<tt>reload!</tt>
+
+More information about irb can be found at:
+link:http://www.rubycentral.org/pickaxe/irb.html
+
+
+== dbconsole
+
+You can go to the command line of your database directly through <tt>rails
+dbconsole</tt>. You would be connected to the database with the credentials
+defined in database.yml. Starting the script without arguments will connect you
+to the development database. Passing an argument will connect you to a different
+database, like <tt>rails dbconsole production</tt>. Currently works for MySQL,
+PostgreSQL and SQLite 3.
+
+== Description of Contents
+
+The default directory structure of a generated Ruby on Rails application:
+
+  |-- app
+  |   |-- assets
+  |       |-- images
+  |       |-- javascripts
+  |       `-- stylesheets
+  |   |-- controllers
+  |   |-- helpers
+  |   |-- mailers
+  |   |-- models
+  |   `-- views
+  |       `-- layouts
+  |-- config
+  |   |-- environments
+  |   |-- initializers
+  |   `-- locales
+  |-- db
+  |-- doc
+  |-- lib
+  |   `-- tasks
+  |-- log
+  |-- public
+  |-- script
+  |-- test
+  |   |-- fixtures
+  |   |-- functional
+  |   |-- integration
+  |   |-- performance
+  |   `-- unit
+  |-- tmp
+  |   |-- cache
+  |   |-- pids
+  |   |-- sessions
+  |   `-- sockets
+  `-- vendor
+      |-- assets
+          `-- stylesheets
+      `-- plugins
+
+app
+  Holds all the code that's specific to this particular application.
+
+app/assets
+  Contains subdirectories for images, stylesheets, and JavaScript files.
+
+app/controllers
+  Holds controllers that should be named like weblogs_controller.rb for
+  automated URL mapping. All controllers should descend from
+  ApplicationController which itself descends from ActionController::Base.
+
+app/models
+  Holds models that should be named like post.rb. Models descend from
+  ActiveRecord::Base by default.
+
+app/views
+  Holds the template files for the view that should be named like
+  weblogs/index.html.erb for the WeblogsController#index action. All views use
+  eRuby syntax by default.
+
+app/views/layouts
+  Holds the template files for layouts to be used with views. This models the
+  common header/footer method of wrapping views. In your views, define a layout
+  using the <tt>layout :default</tt> and create a file named default.html.erb.
+  Inside default.html.erb, call <% yield %> to render the view using this
+  layout.
+
+app/helpers
+  Holds view helpers that should be named like weblogs_helper.rb. These are
+  generated for you automatically when using generators for controllers.
+  Helpers can be used to wrap functionality for your views into methods.
+
+config
+  Configuration files for the Rails environment, the routing map, the database,
+  and other dependencies.
+
+db
+  Contains the database schema in schema.rb. db/migrate contains all the
+  sequence of Migrations for your schema.
+
+doc
+  This directory is where your application documentation will be stored when
+  generated using <tt>rake doc:app</tt>
+
+lib
+  Application specific libraries. Basically, any kind of custom code that
+  doesn't belong under controllers, models, or helpers. This directory is in
+  the load path.
+
+public
+  The directory available for the web server. Also contains the dispatchers and the
+  default HTML files. This should be set as the DOCUMENT_ROOT of your web
+  server.
+
+script
+  Helper scripts for automation and generation.
+
+test
+  Unit and functional tests along with fixtures. When using the rails generate
+  command, template test files will be generated for you and placed in this
+  directory.
+
+vendor
+  External libraries that the application depends on. Also includes the plugins
+  subdirectory. If the app has frozen rails, those gems also go here, under
+  vendor/rails/. This directory is in the load path.