status_cats 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format documentation

data/.rvmrc

@@ -0,0 +1 @@
+rvm 1.9.3@status_cats

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in status_cats.gemspec
+gemspec

data/README.md

@@ -0,0 +1,46 @@
+# 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](http://www.flickr.com/photos/girliemac/sets/72157628409467125/detail/)
+
+There is also an [apache module](https://gist.github.com/1476499).
+
+## Usage
+
+Install:
+
+```
+gem install status_cats
+```
+
+Place inside your rackup file:
+
+``` ruby
+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.
+
+``` ruby
+use StatusCats, :only => [ 403, 404, 500 ]
+
+# or ...
+
+use StatusCats, :except => 200...300
+```
+
+## Known issues
+
+Status code 100 (Continue) cannot have a response body. Triggering it will case 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](http://www.flickr.com/photos/girliemac/),
+released under [this](http://creativecommons.org/licenses/by/2.0/deed.en) Creative Commons License.

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/config.ru

@@ -0,0 +1,8 @@
+require 'rubygems'
+require 'bundler/setup'
+require 'status_cats'
+
+require File.expand_path('../spec/test_app', __FILE__)
+
+use StatusCats
+run TestApp.new

data/lib/status_cats.rb

@@ -0,0 +1,31 @@
+require 'rack/file'
+
+class StatusCats
+
+  CATS = [ 100, 200, 206, 207, 300, 301, 302, 303, 307, 401, 402, 403, 404, 405, 406, 408, 409, 410, 413, 414, 416, 417, 418, 422, 423, 424, 426, 429, 431, 444, 450, 500, 502, 507, 508, 599 ].freeze
+  CATS_DIR = File.expand_path("../../cats", __FILE__)
+
+  def initialize(app, options = {})
+    @app, @options = app, options
+  end
+
+  def call(env)
+    @status, @headers, @response = @app.call(env)
+    if display_cat?
+      _, @headers, @response = Rack::File.new(CATS_DIR).call("PATH_INFO" => "#{@status}.jpg")
+    end
+    [ @status, @headers, @response ]
+  end
+
+  def display_cat?
+    cats = CATS
+    if @options.has_key?(:only)
+      cats = Array(@options[:only]) & cats
+    end
+    if @options.has_key?(:except)
+      cats = cats - Array(@options[:except])
+    end
+    cats.include?(@status.to_i)
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,21 @@
+require 'rubygems'
+require 'bundler/setup'
+require 'rack/test'
+require 'status_cats'
+require 'test_app'
+
+RSpec::Matchers.define :be_replaced_with_cat do |code|
+  match do |actual|
+    if code.nil?
+      actual.body != "Hello, World!"
+    else
+      path = File.expand_path("../../cats/#{code}.jpg", __FILE__)
+      file = File.open(path, 'rb')
+      actual.body == file.read &&
+      actual.status == code &&
+      actual.headers["Content-Length"] == file.size.to_s &&
+      actual.headers["Content-Type"] == "image/jpeg"
+    end
+  end
+
+end

data/spec/status_cats_spec.rb

@@ -0,0 +1,69 @@
+require 'spec_helper'
+
+describe StatusCats do
+
+  include Rack::Test::Methods
+
+  describe "cat responses" do
+
+    let(:app) { StatusCats.new(TestApp.new) }
+
+    StatusCats::CATS.each do |code|
+
+      it "displays cat for status #{code}" do
+        get code.to_s
+        last_response.should be_replaced_with_cat(code)
+      end
+
+    end
+
+    it "won't replace response with a cat if there is no file for it" do
+      get "201"
+      last_response.should_not be_replaced_with_cat
+    end
+
+  end
+
+  describe ":only" do
+
+    let(:app) { StatusCats.new(TestApp.new, :only => 200...300) }
+
+    it "will replace response with a cat if status is within range" do
+      get "206"
+      last_response.should be_replaced_with_cat(206)
+    end
+
+    it "will not replace if there is no file for it" do
+      get "201"
+      last_response.should_not be_replaced_with_cat
+    end
+
+    it "will not replace if out of range" do
+      get "404"
+      last_response.should_not be_replaced_with_cat(404)
+    end
+
+  end
+
+  describe ":except" do
+
+    let(:app) { StatusCats.new(TestApp.new, :except => 200...300) }
+
+    it "will replace response with a cat if status is not in range" do
+      get "404"
+      last_response.should be_replaced_with_cat(404)
+    end
+
+    it "will not replace response with a cat if status is in range" do
+      get "206"
+      last_response.should_not be_replaced_with_cat(206)
+    end
+
+    it "won't replace cats that are not known" do
+      get "201"
+      last_response.should_not be_replaced_with_cat
+    end
+
+  end
+
+end

data/spec/test_app.rb

@@ -0,0 +1,11 @@
+class TestApp
+
+  def call(env)
+    status  = env["PATH_INFO"].gsub(/\D/, '').to_i
+    status = 404 if status < 100
+    headers = {"Content-Type" => "text/html"}
+    body    = ["Hello, World!"]
+    [ status, headers, body ]
+  end
+
+end

data/status_cats.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name        = "status_cats"
+  s.version     = "0.0.1"
+  s.authors     = ["iain"]
+  s.email       = ["iain@iain.nl"]
+  s.homepage    = "https://github.com/iain/status_cats"
+  s.summary     = %q{Rack middleware; replaces responses with cats}
+  s.description = %q{Rack middleware replacing responses with relevant pictures of cats, based on the status code.}
+
+  s.rubyforge_project = "status_cats"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # specify any dependencies here; for example:
+  s.add_development_dependency "rspec", ">= 2"
+  s.add_development_dependency "rack-test"
+  s.add_runtime_dependency "rack"
+end

metadata

@@ -0,0 +1,131 @@
+--- !ruby/object:Gem::Specification
+name: status_cats
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- iain
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-12-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &2163992540 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :development
+  prerelease: false
+  version_requirements: *2163992540
+- !ruby/object:Gem::Dependency
+  name: rack-test
+  requirement: &2163992140 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2163992140
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: &2163991680 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *2163991680
+description: Rack middleware replacing responses with relevant pictures of cats, based
+  on the status code.
+email:
+- iain@iain.nl
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .rvmrc
+- Gemfile
+- README.md
+- Rakefile
+- cats/100.jpg
+- cats/200.jpg
+- cats/206.jpg
+- cats/207.jpg
+- cats/300 (1).jpg
+- cats/300.jpg
+- cats/301.jpg
+- cats/302.jpg
+- cats/303.jpg
+- cats/307.jpg
+- cats/401.jpg
+- cats/402.jpg
+- cats/403.jpg
+- cats/404.jpg
+- cats/405.jpg
+- cats/406.jpg
+- cats/408.jpg
+- cats/409.jpg
+- cats/410.jpg
+- cats/413.jpg
+- cats/414.jpg
+- cats/416.jpg
+- cats/417.jpg
+- cats/418.jpg
+- cats/422.jpg
+- cats/423.jpg
+- cats/424.jpg
+- cats/426.jpg
+- cats/429.jpg
+- cats/431.jpg
+- cats/444.jpg
+- cats/450.jpg
+- cats/500.jpg
+- cats/502.jpg
+- cats/507.jpg
+- cats/508.jpg
+- cats/599.jpg
+- config.ru
+- lib/status_cats.rb
+- spec/spec_helper.rb
+- spec/status_cats_spec.rb
+- spec/test_app.rb
+- status_cats.gemspec
+homepage: https://github.com/iain/status_cats
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: status_cats
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Rack middleware; replaces responses with cats
+test_files:
+- spec/spec_helper.rb
+- spec/status_cats_spec.rb
+- spec/test_app.rb