rack-useragent 0.0.3

data/.gitignore

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

data/Gemfile

@@ -0,0 +1,3 @@
+source "http://rubygems.org"
+
+gemspec

data/README.rdoc

@@ -0,0 +1,58 @@
+= Rack::UserAgent
+
+Rack Middleware for filtering by user agent
+
+== Use
+
+Let's say you don't support IE6 and want to prevent IE6 users from accessing to your Rails app. You're in luck. Just add this to your <tt>config/environment.rb</tt>:
+
+  config.gem "bebanjo-rack-useragent", :lib => "rack/user_agent", :source => "http://gems.github.com"
+  
+  config.middleware.use "Rack::UserAgent::Filter", [
+    {:browser => "Internet Explorer", :version => "7.0"}
+  ]
+  
+And, of course, install the gem:
+
+  $ [sudo] rake gems:install
+  
+Done! From now on users with IE version lower than 7.0 will get a nice error message saying that their browsers need to be updated... Ok, ok, not so nice message, you can personalize it by putting an <tt>upgrade.html</tt> file inside the <tt>/public</tt> directory of your application.
+
+<em>- Hey, I need to show localized versions of the message to my french and spanish users!</em>
+
+No problem, just add <tt>upgrade.es.html</tt> and <tt>upgrade.fr.html</tt> to <tt>/public</tt> (Note that <tt>rack.locale</tt> env variable needs to be previously set for this to work. <tt>Rack::Locale</tt> in rack-contrib[http://github.com/rack/rack-contrib] can do that for you)
+
+<em>- Cool!, what about something more dynamic... like ERB?</em>
+
+Granted! You'll have to add to the config which template to use. In <tt>environment.rb</tt>:
+
+  config.middleware.use "Rack::UserAgent::Filter", [
+    {:browser => "Internet Explorer", :version => "7.0"}
+  ], :template => "#{RAILS_ROOT}/app/views/shared/upgrade.html.erb"
+  
+Then you could show the browser version as part of your message:
+
+  Sorry but <%= "#{@browser.browser} #{@browser.version}" %> is not supported
+  
+<em>- Can I use it with non-Rails Rack frameworks, like Sinatra?</em>
+
+Sure. You only have to take into account that you'll always have to set which template to use. i.e: In <tt>config.ru</tt>:
+
+  require 'rack/user_agent'
+  
+  use Rack::UserAgent::Filter, [
+    {:browser => "Internet Explorer", :version => "7.0"}
+  ], :template => File.dirname(__FILE__) + "/public/upgrade.html"
+  
+Enjoy it!
+
+== Authors
+
+* Sergio Gil <sgilperez@gmail.com>
+* Luismi Cavallé <luismi@lmcavalle.com>
+
+== Contributors
+
+We're looking forward for your patches. Fork us!
+
+Copyright (c) 2008 BeBanjo, released under the MIT license

data/Rakefile

@@ -0,0 +1,13 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+require 'rake/testtask'
+desc 'Run all tests'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end

data/lib/rack/user_agent/filter.rb

@@ -0,0 +1,46 @@
+require 'rubygems'
+require 'user_agent'
+require 'erb'
+require 'ostruct'
+
+module Rack::UserAgent
+  class Filter
+    def initialize(app, config = [], options = {})
+      @app = app
+      @browsers = config
+      @template = options[:template]
+    end
+
+    def call(env)
+      browser = UserAgent.parse(env["HTTP_USER_AGENT"]) if env["HTTP_USER_AGENT"]
+      if unsupported?(browser)
+        [400, {"Content-Type" => "text/html"}, page(env['rack.locale'], browser)]
+      else
+        @app.call(env)
+      end
+    end
+
+    private
+
+    def unsupported?(browser)
+       browser && @browsers.any? { |hash| browser < OpenStruct.new(hash) }
+    end
+
+    def page(locale, browser)
+      return "Sorry, your browser is not supported. Please upgrade" unless template = template_file(locale)
+      @browser = browser # for the template
+      ERB.new(File.read(template)).result(binding)
+    end
+
+    def template_file(locale)
+      candidates = [ @template ]
+      
+      if defined?(RAILS_ROOT)
+        candidates += [ File.join(RAILS_ROOT, "public", "upgrade.#{locale}.html"),
+                        File.join(RAILS_ROOT, "public", "upgrade.html") ] 
+      end
+               
+      candidates.compact.detect{ |template| File.exists?(template) }
+    end
+  end
+end

data/lib/rack/user_agent/version.rb

@@ -0,0 +1,5 @@
+module Rack
+  module UserAgent
+    VERSION = "0.0.3"
+  end
+end

data/lib/rack/user_agent.rb

@@ -0,0 +1,6 @@
+require 'rack'
+
+module Rack::UserAgent
+  VERSION = "0.1.0"
+  autoload :Filter, 'rack/user_agent/filter'  
+end

data/rack-useragent.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "rack/user_agent/version"
+
+Gem::Specification.new do |s|
+  s.name        = "rack-useragent"
+  s.version     = Rack::UserAgent::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Sergio Gil", "Luismi Cavallé"]
+  s.email       = ["team@bebanjo.com"]
+  s.homepage    = "http://github.com/bebanjo/rack-useragent"
+  s.summary     = %q{Rack Middleware for filtering by user agent}
+
+  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"]
+  
+  s.add_dependency  'rack', '>= 0.9.1'
+  s.add_dependency  'useragent'
+  
+  s.add_development_dependency  'mocha'
+end

data/test/public/upgrade.es.html

@@ -0,0 +1 @@
+This is upgrade.es.html

data/test/public/upgrade.html

@@ -0,0 +1 @@
+This is upgrade.html

data/test/upgrade.erb

@@ -0,0 +1 @@
+Hello, <%= "#{@browser.browser} #{@browser.version}" %>!

data/test/user_agent_filter_test.rb

@@ -0,0 +1,81 @@
+require 'test/unit'
+require 'rubygems'
+require 'mocha'
+
+require File.dirname(__FILE__) + '/../lib/rack/user_agent'
+
+class UserAgentFilterTest < Test::Unit::TestCase
+  
+  STATUS  = 0
+  HEADERS = 1
+  BODY    = 2
+  
+  def setup
+    @app_response = stub
+    @app = stub(:call => @app_response)
+  end
+  
+  def teardown
+    Object.send(:remove_const, "RAILS_ROOT") if defined?(RAILS_ROOT)
+  end
+  
+  def test_user_agent_supported
+    filter = Rack::UserAgent::Filter.new(@app, [{:browser => "Internet Explorer", :version => "7.0"}])
+    env = {"HTTP_USER_AGENT" => "Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 6.0)"}
+    @app.expects(:call).with(env).returns(@app_response)
+    response = filter.call(env)
+    assert_equal @app_response, response
+  end
+  
+  def test_no_config_given
+    filter = Rack::UserAgent::Filter.new(@app)
+    env = {"HTTP_USER_AGENT" => "Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 6.0)"}
+    response = filter.call(env)
+    assert_equal @app_response, response
+  end
+  
+  def test_no_user_agent
+    filter = Rack::UserAgent::Filter.new(@app, [{:browser => "Internet Explorer", :version => "7.0"}])
+    response = filter.call({})
+    assert_equal @app_response, response
+  end
+  
+  def test_user_agent_unsupported
+    filter = Rack::UserAgent::Filter.new(@app, [{:browser => "Internet Explorer", :version => "7.0"}])
+    response = filter.call("HTTP_USER_AGENT" => "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1)")
+    assert_equal 400, response[STATUS]
+    assert response[BODY].include?("Sorry, your browser is not supported. Please upgrade")
+  end
+  
+  def test_user_agent_not_unsupported
+    filter = Rack::UserAgent::Filter.new(@app, [{:browser => "Internet Explorer", :version => "7.0"}])
+    response = filter.call("HTTP_USER_AGENT" => "Mozilla/5.0 (Macintosh; U; Intel Mac OS X; en-US; rv:1.8.1.14) Gecko/20080404 Firefox/2.0.0.14")
+    assert_equal @app_response, response
+  end
+  
+  def test_upgrade_html_is_served_if_available
+    Object.const_set("RAILS_ROOT", File.dirname(__FILE__))
+    filter = Rack::UserAgent::Filter.new(@app, [{:browser => "Internet Explorer", :version => "7.0"}])
+    response = filter.call("HTTP_USER_AGENT" => "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1)")
+    assert_equal 400, response[STATUS]
+    assert_equal "This is upgrade.html", response[BODY]
+  end
+
+  def test_localized_upgrade_html
+    Object.const_set("RAILS_ROOT", File.dirname(__FILE__))
+    filter = Rack::UserAgent::Filter.new(@app, [{:browser => "Internet Explorer", :version => "7.0"}])
+    response = filter.call("HTTP_USER_AGENT" => "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1)",
+                           "rack.locale" => "es")
+    assert_equal 400, response[STATUS]
+    assert_equal "This is upgrade.es.html", response[BODY]
+  end
+  
+  def test_erb_template
+    filter = Rack::UserAgent::Filter.new(@app, [{:browser => "Internet Explorer", :version => "7.0"}], 
+                                               :template => File.dirname(__FILE__) + "/upgrade.erb")
+    response = filter.call("HTTP_USER_AGENT" => "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1)")
+    assert_equal 400, response[STATUS]
+    assert_equal "Hello, Internet Explorer 6.0!", response[BODY]
+  end
+  
+end

metadata

@@ -0,0 +1,126 @@
+--- !ruby/object:Gem::Specification 
+name: rack-useragent
+version: !ruby/object:Gem::Version 
+  hash: 25
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 3
+  version: 0.0.3
+platform: ruby
+authors: 
+- Sergio Gil
+- "Luismi Cavall\xC3\xA9"
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-04-08 00:00:00 +02: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: 57
+        segments: 
+        - 0
+        - 9
+        - 1
+        version: 0.9.1
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: useragent
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: mocha
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id003
+description: 
+email: 
+- team@bebanjo.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- README.rdoc
+- Rakefile
+- lib/rack/user_agent.rb
+- lib/rack/user_agent/filter.rb
+- lib/rack/user_agent/version.rb
+- rack-useragent.gemspec
+- test/public/upgrade.es.html
+- test/public/upgrade.html
+- test/upgrade.erb
+- test/user_agent_filter_test.rb
+has_rdoc: true
+homepage: http://github.com/bebanjo/rack-useragent
+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: 
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: Rack Middleware for filtering by user agent
+test_files: 
+- test/public/upgrade.es.html
+- test/public/upgrade.html
+- test/upgrade.erb
+- test/user_agent_filter_test.rb