archerfinley-google4r-checkout-1.0.5

= google4r/checkout

google4r/checkout is a library to access the Google Checkout API.

=== License

google4r itself is distributed under an MIT style license.

However, the library includes the cacert.pem:http://curl.haxx.se/ca/cacert.pem file from the Mozilla project. This file is distributed under the MPL:http://www.mozilla.org/MPL/.

== More Information

You can find more information on the Google Checkout API here:http://code.google.com/apis/checkout/developer/index.html. Note that the API documentation assumes an understanding of the Google Checkout XML API.

== Google Checkout Tests

You have to place a file called 'frontend_configuration.rb' in the directory'test' with the configuration for the Google4R::Checkout::Frontend class to use for running the tests.

The file should contain content similar to:

Uncomment the following line if you are using Google Checkout in Great Britain

and adjust it if you want to test google4r-checkout against any other (future)

Google Checkout service.

Money.default_currency = 'GBP'

The test configuration for the Google4R::Checkout::Frontend class.

FRONTEND_CONFIGURATION = { :merchant_id => '', :merchant_key => '', :use_sandbox => true }

== Dependencies

The unit tests use Mocha so you have to install the gem "mocha" to run the tests. You will also need the money gem library.

== How To: Freeze a google4r version in a Rails project

rake rails:freeze:gems only works for the Rails gems. So, how do you freeze your own gems like google4r? It turns out to be pretty straightforward:

cd RAILS_ROOT cd vendor gem unpack google4r-checkout ls

... google4r-checkout-0.1.1 ...

Then, open RAILS_ROOT/config/environment.rb in your favourite text editor and add the following lines at the top of the file just below require File.join(File.dirname(FILE), 'boot'):

Freeze non-Rails gem.

Dir.glob(File.join(RAILS_ROOT, 'vendor', '*', 'lib')) do |path| $LOAD_PATH << path end

Now you can use the following in your own code:

require 'google4r/checkout'