sinatra-more-server 0.4.0.a

data/README.md

@@ -0,0 +1,64 @@
+Sinatra::MoreServer
+===================
+
+Adds support for more web servers to [Sinatra](http://sinatrarb.com)::Base#run!
+
+Also, adds a helper method to ensure the server used from #run! supports async.callback, so all the
+fancy comet implementations work.
+
+BigBand
+-------
+
+Sinatra::MoreServer is part of the [BigBand](http://github.com/rkh/big_band) stack.
+Check it out if you are looking for other fancy Sinatra extensions.
+
+Additional Servers
+------------------
+
+Out of the box, Sinatra supports:
+
+* [Webrick](http://www.ruby-doc.org/stdlib/libdoc/webrick/rdoc/)
+* [Thin](http://code.macournoyer.com/thin/)
+* [Mongrel](http://mongrel.rubyforge.org/)
+
+Currently, this extensions adds support for:
+
+* [Unicorn](http://unicorn.bogomips.org/)
+* [Rainbows!](http://rainbows.bogomips.org/)
+* [Zbatery](http://zbatery.bogomip.org/)
+* [Ebb](http://ebb.rubyforge.org/)
+
+Usage
+-----
+
+Classic style:
+
+    require "sinatra"
+    require "sinatra/more_server"
+
+Or in your own subclass:
+
+    require "sinatra/base"
+    require "sinatra/more_server"
+    
+    class Foo < Sinatra::Base
+      register Sinatra::MoreServer
+    end
+
+Async only, please!
+-------------------
+
+You use `async.callback`? Maybe via a library like [async\_sinatra](http://github.com/raggi/async_sinatra)
+or [pusher](http://github.com/macournoyer/pusher)? Then you might want to make sure we only use a server
+that supports it:
+
+    require "sinatra"
+    require "sinatra/more_server"
+    
+    configure do
+      has_async_callback!
+    end
+
+As mentioned above, this will only have effect on running your script directly. However, in any other case,
+you will choose your server manually, anyway. (Hint: As far as I know, only thin- and rainbows!-based implementations
+support async.callback at the moment.)

data/lib/sinatra/more_server/rainbows.rb

@@ -0,0 +1,13 @@
+require "sinatra/more_server/unicorn"
+require "rainbows"
+
+class Sinatra
+  module MoreServer
+    # Rack Handler to use Rainbows for Sinatra::Base.run!
+    module Rainbows
+      def self.run(app, options = {})
+        Sinatra::MoreServer::Unicorn.run app, options.merge(:Backend => ::Rainbows)
+      end
+    end
+  end
+end

data/lib/sinatra/more_server/unicorn.rb

@@ -0,0 +1,27 @@
+require "sinatra/base"
+require "unicorn"
+require "rack/content_length"
+require "rack/chunked"
+
+class Sinatra
+  module MoreServer
+    # Rack Handler to use Unicorn for Sinatra::Base.run!
+    module Unicorn
+      def self.run(app, options={})
+        app = Rack::Builder.new do
+          # TODO: env dependend stuff.
+          use Rack::CommonLogger, $stderr
+          use Rack::ShowExceptions
+          run app
+        end.to_app
+        options[:Backend] ||= ::Unicorn
+        options[:Host] ||= ::Unicorn::Const::DEFAULT_HOST
+        options[:Port] ||= ::Unicorn::Const::DEFAULT_PORT
+        options[:listeners] = ["#{options.delete :Host}:#{options.delete :Port}"]
+        server = options.delete(:Backend)::HttpServer.new app, options
+        yield server if block_given?
+        server.start.join
+      end
+    end
+  end
+end

data/lib/sinatra/more_server/zbatery.rb

@@ -0,0 +1,13 @@
+require "sinatra/more_server/unicorn"
+require "zbatery"
+
+class Sinatra
+  module MoreServer
+    # Rack Handler to use Rainbows for Sinatra::Base.run!
+    module Rainbows
+      def self.run(app, options = {})
+        Sinatra::MoreServer::Unicorn.run app, options.merge(:Backend => ::Zbatery)
+      end
+    end
+  end
+end

data/lib/sinatra/more_server.rb

@@ -0,0 +1,27 @@
+require "sinatra/base"
+
+module Sinatra
+  # Adds more servers to Sinatra::Base#run! (currently unicorn and rainbows).
+  module MoreServer
+    autoload :Unicorn,  "sinatra/more_server/unicorn"
+    autoload :Rainbows, "sinatra/more_server/rainbows"
+    autoload :Zbatery,  "sinatra/more_server/zbatery"
+
+    def self.registered(klass)
+      ::Rack::Handler.register "unicorn",  "::Sinatra::MoreServer::Unicorn"
+      ::Rack::Handler.register "rainbows", "::Sinatra::MoreServer::Rainbows"
+      ::Rack::Handler.register "zbatery",  "::Sinatra::MoreServer::Zbatery"
+      ::Rack::Handler.register "ebb",      "::Rack::Handler::Ebb"
+      ::Rack::Handler.autoload :Ebb,       "ebb"
+      klass.server += ["ebb", "zbatery", "rainbows", "unicorn"]
+      klass.set :async_server, ["thin", "zbatery", "rainbows"]
+    end
+    
+    def has_async_callback!
+      set :server, async_server
+    end
+    
+  end
+  
+  register MoreServer
+end

data/spec/sinatra/more_server_spec.rb

@@ -0,0 +1,29 @@
+require File.expand_path(__FILE__ + "/../../spec_helper.rb")
+
+describe Sinatra::MoreServer do
+  before { app :MoreServer }
+
+  describe "additional server" do
+    it("should offer unicorn")   { app.server.should include("unicorn")  }
+    it("should offer rainbows")  { app.server.should include("rainbows") }
+    it("should offer zbatery")   { app.server.should include("zbatery")  }
+    it("should offer ebb")       { app.server.should include("ebb")      }
+  end
+
+  describe "async_server" do
+    it("should not offer ebb as an async server")     { app.async_server.should_not include("ebb")     }
+    it("should not offer mongrel as an async server") { app.async_server.should_not include("mongrel") }
+    it("should not offer webrick as an async server") { app.async_server.should_not include("webrick") }
+    it("should not offer unicorn as an async server") { app.async_server.should_not include("unicorn") }
+
+    it("should offer thin as an async server")     { app.async_server.should include("thin")     }
+    it("should offer rainbows as an async server") { app.async_server.should include("rainbows") }
+    it("should offer zbatery as an async server")  { app.async_server.should include("zbatery")  }
+
+    it "uses async_server instead of server when async support is requested" do
+      app.has_async_callback!
+      app.server.should == app.async_server
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,3 @@
+require "sinatra/rspec"
+require "sinatra/more_server"
+Sinatra::Base.set :environment, :test

metadata

@@ -0,0 +1,107 @@
+--- !ruby/object:Gem::Specification 
+name: sinatra-more-server
+version: &id001 !ruby/object:Gem::Version 
+  version: 0.4.0.a
+platform: ruby
+authors: 
+- Konstantin Haase
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-02-15 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: monkey-lib
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - "="
+      - *id001
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: sinatra-sugar
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - "="
+      - *id001
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: sinatra-test-helper
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - "="
+      - *id001
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: sinatra
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.9.4
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.3.0
+    version: 
+description: Adds more server to Sinatra::Base#run! (part of BigBand).
+email: konstantin.mailinglists@googlemail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/sinatra/more_server/rainbows.rb
+- lib/sinatra/more_server/unicorn.rb
+- lib/sinatra/more_server/zbatery.rb
+- lib/sinatra/more_server.rb
+- spec/sinatra/more_server_spec.rb
+- spec/spec_helper.rb
+- README.md
+has_rdoc: yard
+homepage: http://github.com/rkh/sinatra-more-server
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 1.3.1
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Adds more server to Sinatra::Base#run! (part of BigBand).
+test_files: []
+