Sabisu is a powerful postman-like engine client to explore your Rails application api. It's still under heavy development, but it is quite impressive and beautiful. Give it a try!
It was created by Abraham Kuri from Icalia Labs.
To get started, checkout:
Install sabisu is extremely easy, just add some gems to your Gemfile
For projects using Rails 4.2 or newer, configure the following:
gem 'sabisu_rails', github: "jvrsgsty/sabisu-rails"
gem 'compass-rails', '~> 2.0.2'
gem 'furatto'
gem 'font-awesome-rails'
gem 'simple_form'
For projects using Rails installations older than 4.2, configure the following:
gem 'sabisu_rails'
gem 'compass-rails'
gem 'furatto'
gem 'font-awesome-rails'
gem 'simple_form'
And then execute:
$ bundle install
After you install Sabisu you need to run the generator:
rails g simple_form:install
rails g sabisu_rails:install
The generator will install in initializer which describes all the Sabisu configuration options.
Some of these configuration options include you api endpoint base uri, so as your resources, so you better take a look at it.
Once you are done with the configuration, start your rails application and navigate to http://localhost:3000/sabisu_rails/explorer
If everything went good you should see a nice explorer interface with your resources.
Sabisu is highly customizable to make your life easier, here is a quick example of a real app configuration, remember you have the configuration file under config/initializers/sabisu_rails.rb
.
SabisuRails.setup do |config|
# Base uri for posting the
config.base_api_uri = 'api.sabisu.dev'
# Ignored attributes for building the forms
# config.ignored_attributes = %w{ created_at updated_at id }
# HTTP methods
# config.http_methods = %w{ GET POST PUT DELETE PATCH }
# Headers to include on each request
config.api_headers = {'Accept' => 'application/vnd.sabisu.v1'}
# Resources on the api
# You can customize the resources attributes for setting them on the form for posting to the server like so:
#
# config.resources = [{:products => [:title, :price]}, :users]
#
# In case you don't specify the attributes, Sabisu will pick them all.
#
config.resources = [:products, :users]
end
We invite you to look at the full file for further customization.
Have a bug or a feature request? Please open a new issue. Before opening any issue, please search for existing issues.
We recommend you to read the version milestiones if you feel like want to collaborate.
Please submit all pull requests against a separate branch. Although it does not have tests yet, be a nice guy and add some for your feature. We'll be working hard to add them too.
In case you are wondering what to attack, we have a milestone with the version to work, some fixes and refactors. Feel free to start one.
Thanks!
Keep track of new feautres, development issues and community news.
- Follow @kurenn
- Have a question about anything, email us at [email protected]
Abraham Kuri
We have deployed an example application on Heroku for you to give it a spin, visit http://sabisu.herokuapp.com/sabisu_rails/explorer and because is a demo the api only has GET endpoints.
The authentication credentials are:
username: admin
password: sekret
The file configuration for Heroku turns out to be more complex, check it out:
SabisuRails.setup do |config|
config.base_api_uri = ENV['API_URL']
config.resources = [:products,:users]
config.default_resource = "users"
end
We are working to provide a full working example and wiki documentation for further implementation.
Code and documentation copyright 2013-2014 Icalia Labs. Code released under the MIT license.