michaelherold / balanced-ruby

Balanced API library in ruby.

Balanced

Online Marketplace Payments

Installation

Add this line to your application's Gemfile:

gem 'balanced'

And then execute:

$ bundle

Or install it yourself as:

$ gem install balanced

Documentation & Usage

• Balanced Overview
• RDoc
• Balanced API with Ruby examples
• Example scripts

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Write your code and unit tests
4. Ensure all tests still pass (bundle exec rspec)
5. Commit your changes (git commit -am 'Add some feature')
6. Push to the branch (git push origin my-new-feature)
7. Create new pull request

Specs

The spec suite is a work in progress. Existing specs can either be run using guard or rake.

Guard

$ bundle exec guard

Rake

$ rake spec

We use VCR to stub out and save http interactions. Cassettes are not stored in the repo. They are generated the first time the spec suite is run and stored in spec/cassettes. To clear them and regenerate:

$ rm -rf spec/cassettes

Issues

All issues should be documented at balanced-ruby/issues

Scenarios

####Render

To render executable files from scenario templates run rake render_executables Check /scenarios and make sure each scenario has an executable.rb file

####Delete

To delete previously generated executable files run rake delete_executables

####Test

After generating executable files, make sure they are valid Ruby files by running rspec scenarios/execute.rb from the root directory

Troubleshooting

#####OpenSSL SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed (OpenSSL::SSL::SSLError)

The machine's Ruby/OpenSSL environment can't find any root certificates to trust. Please refer here to find the best solution for your environment.