rack-static_fallback 1.0.0

data/Gemfile

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

data/README.md

@@ -0,0 +1,36 @@
+Bounces or redirects requests to missing static files.
+Partially inspired by [http://menendez.com/blog/using-django-as-pass-through-image-proxy/](http://menendez.com/blog/using-django-as-pass-through-image-proxy/)
+
+I.e. could be useful when you want to run the server with production database locally
+and have user uploaded content fetched transparently from production site.
+
+Options:
+    :mode - [ :off,
+              :bounce, # returns 404 to any request to static URL,
+              :fallback ] # any request to static path is redirected to :fallback_static_url
+    :static_path_regex - Regexp which matches the path to your static files.
+                         Along the lines of the Capistrano conventions defaults to `%r{/system/(audios|photos|videos)}`
+    :fallback_static_url - URL of the production site
+
+Install via rubygems:
+
+    gem install rack-static_fallback
+
+then, for Rails (any version which supports Rack) apps, add the following to your 'config/environments/development.rb'
+
+    config.middleware.insert_after ::Rack::Lock,
+                                   ::Rack::StaticFallback, :mode => :fallback,
+                                                           :static_path_regex => %r{/system/uploads},
+                                                           :fallback_static_url => "http://myproductionsite.com/"
+
+note that Rails 3 won't auto-load the gem files, so you may need to
+
+    require 'rack/static_fallback'
+
+at the beginning of 'development.rb'. Aternatively, you should also be able to use the gem in non-Rails apps with:
+
+    use ::Rack::StaticFallback, :mode => :fallback,
+                                :static_path_regex => %r{/system/uploads},
+                                :fallback_static_url => "http://myproductionsite.com/"
+
+in your 'config.ru' (this is untested so mileage may vary)

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/lib/rack/generate_readme.rb

@@ -0,0 +1,11 @@
+File.open(File.dirname(__FILE__) + "/../../README.md", "w") do |f|
+  first_comment = []
+  IO.read(File.dirname(__FILE__) + "/static_fallback.rb").each_line do |l|
+    if l =~ /\s*#/
+      first_comment << l.sub(/^\s*#\s/, "").rstrip
+    elsif !first_comment.empty?
+      break
+    end
+  end
+  f.write(first_comment.join("\n"))
+end

data/lib/rack/static_fallback.rb

@@ -0,0 +1,81 @@
+module Rack
+  # Bounces or redirects requests to missing static files.
+  # Partially inspired by [http://menendez.com/blog/using-django-as-pass-through-image-proxy/](http://menendez.com/blog/using-django-as-pass-through-image-proxy/)
+  #
+  # I.e. could be useful when you want to run the server with production database locally
+  # and have user uploaded content fetched transparently from production site.
+  #
+  # Options:
+  #     :mode - [ :off,
+  #               :bounce, # returns 404 to any request to static URL,
+  #               :fallback ] # any request to static path is redirected to :fallback_static_url
+  #     :static_path_regex - Regexp which matches the path to your static files.
+  #                          Along the lines of the Capistrano conventions defaults to `%r{/system/(audios|photos|videos)}`
+  #     :fallback_static_url - URL of the production site
+  # 
+  # Install via rubygems:
+  #
+  #     gem install rack-static_fallback
+  #
+  # then, for Rails (any version which supports Rack) apps, add the following to your 'config/environments/development.rb'
+  #
+  #     config.middleware.insert_after ::Rack::Lock,
+  #                                    ::Rack::StaticFallback, :mode => :fallback,
+  #                                                            :static_path_regex => %r{/system/uploads},
+  #                                                            :fallback_static_url => "http://myproductionsite.com/"
+  # 
+  # note that Rails 3 won't auto-load the gem files, so you may need to
+  # 
+  #     require 'rack/static_fallback'
+  # 
+  # at the beginning of 'development.rb'. Aternatively, you should also be able to use the gem in non-Rails apps with:
+  # 
+  #     use ::Rack::StaticFallback, :mode => :fallback,
+  #                                 :static_path_regex => %r{/system/uploads},
+  #                                 :fallback_static_url => "http://myproductionsite.com/"
+  # 
+  # in your 'config.ru' (this is untested so mileage may vary)
+  # 
+
+  class StaticFallback
+    def initialize(app, options = {})
+      @app = app
+      @mode = options[:mode] || :off
+      # along the lines of the Capistrano defaults
+      @static_path_regex = options[:static_path_regex] || %r{/system/(audios|photos|videos)}
+      @fallback_static_url = options[:fallback_static_url]
+
+      if @mode == :fallback && !@fallback_static_url
+        raise ArgumentError, "Rack::StaticFallback :mode => :fallback option specified without :fallback_static_url option"
+      end
+    end
+
+    def call(env)
+      if env["PATH_INFO"] =~ @static_path_regex
+        # If we get here that means that underlying web server wasn't able to serve the static file,
+        # i.e. it wasn't found.
+        case @mode
+          when :off
+            # pass the request to next middleware, ultimately Rails
+            @app.call(env)
+
+          when :bounce
+            # don't pass the request so that it doesn't hit framework, which
+            # speeds up things significantly
+            not_found
+
+          when :fallback
+            # redirect request to the production server
+            [ 302, { "Location" => ::File.join(@fallback_static_url, env["PATH_INFO"]) }, [] ]
+        end
+
+      else
+        @app.call(env)
+      end
+    end
+
+    def not_found
+      [ 404, { "Content-Type" => "text/html", "Content-Length" => "0" }, [] ]
+    end
+  end
+end

data/rack-static_fallback.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = "rack-static_fallback"
+  s.version     = '1.0.0'
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Evgeniy Dolzhenko", "Mike Fulcher"]
+  s.email       = ["dolzenko@gmail.com", "mike@plan9design.co.uk"]
+  s.homepage    = "http://github.com/dolzenko/rack-static_fallback"
+  s.summary     = "Bounces or redirects requests to missing static files"
+  s.description = "Bounces or redirects requests to missing static files. Could be useful when you want to run the server with production database locally and have user uploaded content fetched transparently from production site."
+
+  s.rubyforge_project = "rack-static_fallback"
+
+  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"]
+  
+  # Runtime
+  s.add_runtime_dependency 'rack'
+end

metadata

@@ -0,0 +1,88 @@
+--- !ruby/object:Gem::Specification 
+name: rack-static_fallback
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: 
+  segments: 
+  - 1
+  - 0
+  - 0
+  version: 1.0.0
+platform: ruby
+authors: 
+- Evgeniy Dolzhenko
+- Mike Fulcher
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-02-08 00:00:00 +00:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rack
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+description: Bounces or redirects requests to missing static files. Could be useful when you want to run the server with production database locally and have user uploaded content fetched transparently from production site.
+email: 
+- dolzenko@gmail.com
+- mike@plan9design.co.uk
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- Gemfile
+- README.md
+- Rakefile
+- lib/rack/generate_readme.rb
+- lib/rack/static_fallback.rb
+- rack-static_fallback.gemspec
+has_rdoc: true
+homepage: http://github.com/dolzenko/rack-static_fallback
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: rack-static_fallback
+rubygems_version: 1.5.0
+signing_key: 
+specification_version: 3
+summary: Bounces or redirects requests to missing static files
+test_files: []
+