Project

grape_doc

0.02
No commit activity in last 3 years
No release in over 3 years
Documentation generator for Grape API
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 2.11

Runtime

>= 0.2.1, ~> 0.2
>= 1.7.4, ~> 1.7
~> 2.0
 Project Readme

GrapeDoc

This gem generate API documentation from Grape API.

Installation

Add this line to your application's Gemfile under development group

gem 'grape_doc'

And then execute:

$ bundle

Or install it yourself as:

$ gem install grape_doc

Usage

To generate API documentation you should cd to your app directory

$ cd app_dir

# rails
$ grape_doc

# non-rails
$ grape_doc --path sinatra_app.rb # for example

It'll generate documentation for each Grape::API subclass and place it into grape_doc directory. Each API subclass were placed as separated file.

You can pass a doc formatter as parameter

$ grape_doc

At this time it supports only MarkDown format.

API description

Parameters

grape > 0.2.1

desc "Returns a tweet."
params do
  requires :id, 
           :type => Integer, 
           :desc => "Tweet id."
end
get '/show/:id' do
  Tweet.find(params[:id])
end

grape <= 0.2.1

desc "Returns a tweet.",
:params => {
  :id => {
    :desc => "Tweet id.",
    :type => Integer,
    :requires => true
  }
}
get '/show/:id' do
  Tweet.find(params[:id])
end

TODO

  • generate plain response
  • generate response from Grape::Entity
  • generate response from Grape::Entity with nested entities
  • other output formats
  • write docs into separated files
  • add code documentation
  • and more others features

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request