Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Rack middleware replacing status codes with relevant pictures of cats.
Ruby
Branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
cats
lib
spec
.gitignore
.rspec
.rvmrc
Gemfile
README.md
Rakefile
config.ru
status_cats.gemspec

README.md

Status Cats

Rack middleware replacing responses with relevant pictures of cats, based on the status code.

The pictures are made/collected by girliemac on Flickr

There is also an apache module.

Usage

Install:

gem install status_cats

Place inside your rackup file:

require 'status_cats'
use StatusCats

This will also replace valid responses, even 200, basically making your application useless.

You can manage which status codes should be replaced with cats, by using the :only and :except options, which take arrays or ranges.

use StatusCats, :only => [ 403, 404, 500 ]

# or ...

use StatusCats, :except => 200...300

Development

Install dependencies:

bundle install

Run tests:

rake

You can run the demo application:

bundle exec rackup

The application will trigger the response code depending on the path you visit, so visiting http://localhost:9292/418 will respond with a teapot.

Known issues

Status code 100 (Continue) cannot have a response body. Triggering it will cause Rack to throw up.

License

The Ruby code in this project is released under the MIT License.

The pictures of cats are by Flickr user girliemac, released under this Creative Commons License.

Something went wrong with that request. Please try again.