Likeno

Likeno is the Mezuro Team's take on RESTful APIs integration with Rails applications. It tries to mimic ActiveRecord's API.

Basically back in 2013, the Mezuro team was getting started with micro services. In order to keep the code clean and following Rails' standards we looked at active_resource and it proved to not fulfill our requirements about nested objects and her which also has failed the same way. With those frustations in mind we started coding all the CRUD requests using faraday_middleware but still giving flexibility for custom requests whenever necessary. Likeno is the final product of this.

It's name come from the fact that by itself Likeno has no purpose at all. It only lives associated to another softwares, providing them with the necessary methods for RESTful APIs. So we can say that Likeno has a symbiosis relation with other applications. This leads us to lichens which are a good symbiosis example. As the Mezuro project has lots of Esperanto words, we finally get to Likeno: is the Esperanto word for lichen.

Contributing

Please, have a look the wiki pages about development workflow and code standards:

Installation

Add this line to your application's Gemfile:

gem 'likeno'

And then execute:

$ bundle

Or install it yourself as:

$ gem install likeno

Usage

Likeno provides default actions for communicating with Rails applications following the scaffold routes. All communication is assumed to use JSON. Specially have a look at the methods from Likeno::Entity:

C create
R find (retrieve)
U update
D destroy

Additionally we provide other useful methods:

save and save!
to_hash
==

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 Likeno should be KalibroClient (https://github.com/mezuro/kalibro_client). So, have a look there for some examples.

Custom Requests

Likeno allows the creation of custom requests. For example:

class MyClass
  def my_custom_request(...)
    action = 'my_action'
    params = {}
    method = :get
    prefix = ''
    Likeno::Entity.request(action, params, method, prefix) # The path used will be '/my_classes/my_action'
  end
end

It returns a hash with the response body.

Versioning

Kolekti follows the semantic versioning policy.