KalibroGem

Build Status Code Climate Coverage Status

KalibroGem is a Ruby gem intended to be an interface for Ruby applications who want to use the open source code analysis webservice Kalibro (http://gitorious.org/kalibro/kalibro).

Installation

Add this line to your application's Gemfile:

gem 'kalibro_gem'

And then execute:

$ bundle

Or install it yourself as:

$ gem install kalibro_gem

Usage

KalibroGem is intended to be an easy interface that encapsulates the usage of all the Kalibro service's endpoints. So have a look at the available entities at lib/kalibro_gem/entities.

All the entities are subclasses from Model, so have a good look at it. Specially notice that all the entities have methods:

  • save
  • exists?
  • find
  • destroy

These four methods should be useful.

We hope to make available soon a full documentation on RDoc that will make easier to understand all this.

A good example on how to get everything from KalibroGem should be Mezuro. So, have a look there for some examples.

Cucumber helpers

Acceptance tests with the Kalibro webservice can be painful. But we've created cucumber hooks that make it easy.

Just add to your env.rb the following:

require 'kalibro_gem/kalibro_cucumber_helpers/hooks.rb'

The test configurations available are:

  • database
  • user
  • password
  • psql_file_path
  • query_file_path
  • kalibro_home
  • tomcat_user
  • tomcat_group
  • tomcat_restart_command

An example on how to change them is:

KalibroGem::KalibroCucumberHelpers.configure do |config|
  config.database = "kalibro_test"
end

We hope to make available soon an YAML parser for test configurations.

Contributing

  1. Install RVM (rvm.io)
  2. Fork it
  3. Run bundle install
  4. Create your feature branch (git checkout -b my-new-feature)
  5. Make your modifications and changes
  6. Commit your changes (git commit -am 'Add some feature')
  7. Push to the branch (git push origin my-new-feature)
  8. Create new Pull Request