Rack::HTTP::Status
This gem provides exception classes that represent each HTTP status.
Installation
Add this line to your application's Gemfile:
gem 'rack-http-status'
And then execute:
$ bundle
Or install it yourself as:
$ gem install rack-http-status
Usage
# In Rails
class ExampleController < ApplicationController
include Rack::HTTP::Status
rescue_from Status do |status|
render plain: "Status code was: #{status.code} - #{status}", status: status
end
def action1
head NoContent # => HTTP 204 No Content
end
def action2
raise NotFound # => HTTP 404 with "Status code was: 404 - Not Found" body
end
end
Each status class inherits from Rack::HTTP::Status
, and contains the following convenience methods:
Method | Description | Example |
---|---|---|
#to_sym |
Returns the symbolized version of this HTTP status | NotFound.to_sym #=> :not_found |
#to_i |
Returns the HTTP status code's value | NoContent.to_i #=> 204 |
#to_s |
Returns the description of the HTTP status | NonAuthoritativeInformation.to_s #=> "Non-Authoritative Information" |
Development
After checking out the repo, run bin/setup
to install dependencies. You can also run bin/console
for an interactive prompt that will allow you to experiment.
Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/kenaniah/rack-http-status.