#halt now accepts an optional message argument

[weppos]

When #message is given, it sets the response body with the message.

This is useful in case you need to set a different response for the same HTTP error. For instance, a 403 may be caused by an invalid password, an invalid username, or a bad OAUTH token.

[weppos]

Real world example, given the following error helper

def error(code, message)
  self.format = :json
  halt(code, { message: message }.to_json)
end

I'd like to be able to perform

def authenticate!
  authentication_context or error(401, I18n.t("api.message_error_authentication_failed"))
end

or to use the helper as a result of an exception handler.

def handle_record_not_found(exception)
  halt(404, { message: exception.message }.to_json)
end

[coveralls]

Changes Unknown when pulling 141dd97 on weppos:halt-with-message into * on lotus:master*.

[AlfonsoUceda]

👍 looks good

[jodosha]

@weppos Thanks for this PR it looks good, merged 👍