Need help with sabisu-rails?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

kurenn
126 Stars 30 Forks MIT License 87 Commits 15 Opened issues

Description

Simple and powerful engine for exploring your Rails api application

Services available

!
?

Need anything else?

Contributors list

Code Climate Test Coverage Issue Count

Sabisu

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:

http://icalialabs.github.io/sabisu-rails/

Table of contents

Quick start

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: "IcaliaLabs/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.

Customization

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.

Bug tracker & feature request

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.

Contributing

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!

Community

Keep track of new feautres, development issues and community news.

Heroes

Abraham Kuri

A live example

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.

Copyright and license

Code and documentation copyright 2013-2014 Icalia Labs. Code released under the MIT license.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.