Contributing to Grape

Update the [CHANGELOG](CHANGELOG.md) with the pull request number. A typical entry looks as follows.

Amend your previous commit and force push the changes.


[](http://badge.fury.io/rb/grape)

You're reading the documentation for the next release of Grape, which should be 0.12.1.

Please read [UPGRADING](UPGRADING.md) when upgrading from a previous version.

* Need help? [Grape Google Group](http://groups.google.com/group/ruby-grape)

error!({ error: "unexpected error", detail: "missing widget" }, 500)

module API

for more details.

The following example exposes statuses.

You can start hacking on Grape on

[Nitrous.IO](https://www.nitrous.io/?utm_source=github.com&utm_campaign=grape&utm_medium=hackonnitrous) in a matter of seconds:

Increment the version, modify [lib/grape/version.rb](lib/grape/version.rb).

Add the next release to [CHANGELOG.md](CHANGELOG.md).

Dir.mkdir(dir)

Dir.chdir(dir) do

system('git init')

system('git pull')

system('git checkout gh-pages')

end

Using `present` with objects that responded to `merge` would cause early evaluation of the represented object, with unexpected side-effects, such as missing parameters or environment within rendering code. Grape now only merges represented objects with a previously rendered body, usually when multiple `present` calls are made in the same route.

class API < Grape::API

Will respond with 404 to `/hello.xml`, `/hello.txt` etc.

gem 'rack', '~> 1.6.0'

Key route_info is excluded from params.

Callbacks defined in a version block are only called for the routes defined in that block. This was a regression introduced in Grape 0.10.0, and is fixed in this version.

Groups of parameters now require their type to be set explicitly as Array or Hash.

Not setting the type now results in MissingGroupTypeError, unsupported type will raise UnsupportedTypeError.

Attributes with `nil` values or with values that evaluate to `false` are no longer considered *missing* and will be returned when `include_missing` is set to `false`.

To implement a custom validator, you need to inherit from `Grape::Validations::Base` instead of `Grape::Validations::Validator`.

when making a API call `GET /foo/v2/1`, the API would set instance variable `@output` to `hello1-v2`

* `Grape::Middleware::Auth::Digest` => [`Rack::Auth::Digest::MD5`](https://github.com/rack/rack/blob/master/lib/rack/auth/digest/md5.rb)

* `Grape::Middleware::Auth::OAuth2` => [warden-oauth2](https://github.com/opperator/warden-oauth2) or [rack-oauth2](https://github.com/nov/rack-oauth2)

and host these files within your application

default_error_status 400

In Grape 0.7.0, the `group`, `optional` and `requires` keywords take an additional `type` attribute which defaults to `Array`. This means that without a `type` attribute, these nested parameters will no longer accept a single hash, only an array (of hashes).

s.platform = Gem::Platform::RUBY

s.authors = ['Michael Bleigh']

s.email = ['michael@intridea.com']

s.summary = 'A simple Ruby framework for building REST-like APIs.'

s.description = 'A Ruby framework for rapid API development with great conventions.'

s.license = 'MIT'