ruby-style 1.1.0 → 1.1.1

data/README

@@ -28,8 +28,8 @@ Subversion access is available at svn://code.jeremyevans.net/ruby-style/.
   the fly
 * Supports both command line and yaml config file configuration
 * Is easily extensible to support running other frameworks and protocols other
-  than the included ones (Rails and Ramaze; SCGI, Mongrel, and Evented
-  Mongrel)
+  than the included ones (Rails, Ramaze, and a generic adapter; SCGI, Mongrel,
+  and Evented Mongrel)
 
 == Running and configuration
 
@@ -173,44 +173,55 @@ below for information on the adapter_config config file variable.
 Example Rails+Mongrel style.yaml that listens on ports 8912 and 8193 on any
 interface, with three listeners per port.  Note how the :adapter_config entry 
 is used to set up settings specific to the Rails adapter, such as placing
-Rails in development mode.
-
----
-:port: 8912
-:bind: ""
-:fork: 3
-:number: 2
-:killtime: 1
-:adapter: rails
-:handler: mongrel
-:adapter_config:
-  :environment: development
-  :log_file: log/rails-mongrel.log
-  :docroot: public
-  :num_processors: 99
-  :timeout: 100
+Rails in development mode.  Ignore the pipes at the beginning of the line, 
+blame RDoc limitations.
+
+ | ---
+ | :port: 8912
+ | :bind: ""
+ | :fork: 3
+ | :number: 2
+ | :killtime: 1
+ | :adapter: rails
+ | :handler: mongrel
+ | :adapter_config:
+ |   :environment: development
+ |   :log_file: log/rails-mongrel.log
+ |   :docroot: public
+ |   :num_processors: 99
+ |   :timeout: 100
 
 Example Rails+SCGI style.yaml that has four listeners on port 8912:
 
----
-:port: 8912
-:fork: 4
-:number: 1 
-:adapter: rails
-:handler: scgi
-:adapter_config:
-  :logfile: log/railsscgi.log
-  :maxconns: 10
-  :environment: production
+ | ---
+ | :port: 8912
+ | :fork: 4
+ | :number: 1 
+ | :adapter: rails
+ | :handler: scgi
+ | :adapter_config:
+ |   :logfile: log/railsscgi.log
+ |   :maxconns: 10
+ |   :environment: production
 
 Very simple configuration that runs Ramaze+Evented Mongrel in unsupervised
 mode on port 3000.
 
----
-:port: 3000
-:unsupervised: 1
-:adapter: ramaze
-:handler: evented_mongrel
+ | ---
+ | :port: 3000
+ | :unsupervised: 1
+ | :adapter: ramaze
+ | :handler: evented_mongrel
+
+Using the generic adapter to host a camping application (you are responsible
+for having the camping application in a my_camping_app.rb file in your 
+$LOAD_PATH that uses Mongrel to run camping):
+
+ | ---
+ | :port: 3301
+ | :adapter: generic
+ | :adapter_config:
+ |   :script: my_camping_app
 
 == How restarting works
 
@@ -219,51 +230,51 @@ killing the exisiting process.  It repeats this for all existing child processes
 
 For example:
 
-# style idling with three listeners
-Thu Sep  6 12:01:47 PDT 2007
-11460 ??  I       0:00.00 ruby: RailsMongrelStyle dir:/home/billg/testrails supervisor (ruby)
- 6540 ??  I       0:02.52 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
-  272 ??  I       0:02.52 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
-27808 ??  I       0:02.51 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
-# Restart occurs, new process started (1207)
-Thu Sep  6 12:01:49 PDT 2007
-11460 ??  I       0:00.00 ruby: RailsMongrelStyle dir:/home/billg/testrails supervisor (ruby)
-27808 ??  I       0:02.51 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
-  272 ??  I       0:02.52 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
- 6540 ??  I       0:02.52 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
- 1207 ??  R       0:00.95 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
-# Old process killed (27808)
-Thu Sep  6 12:01:51 PDT 2007
-11460 ??  I       0:00.01 ruby: RailsMongrelStyle dir:/home/billg/testrails supervisor (ruby)
- 6540 ??  I       0:02.52 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
-  272 ??  I       0:02.52 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
- 1207 ??  I       0:02.51 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
-# New process started (3204)
-Thu Sep  6 12:01:53 PDT 2007
-11460 ??  I       0:00.01 ruby: RailsMongrelStyle dir:/home/billg/testrails supervisor (ruby)
-  272 ??  I       0:02.52 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
- 6540 ??  I       0:02.52 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
- 1207 ??  I       0:02.51 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
- 3204 ??  R       0:01.01 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
-# Old process killed (6540)
-Thu Sep  6 12:01:55 PDT 2007
-11460 ??  I       0:00.01 ruby: RailsMongrelStyle dir:/home/billg/testrails supervisor (ruby)
-  272 ??  I       0:02.52 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
- 1207 ??  I       0:02.51 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
- 3204 ??  I       0:02.49 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
-# New process started (6766)
-Thu Sep  6 12:01:57 PDT 2007
-11460 ??  I       0:00.01 ruby: RailsMongrelStyle dir:/home/billg/testrails supervisor (ruby)
-  272 ??  I       0:02.52 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
- 1207 ??  I       0:02.51 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
- 3204 ??  I       0:02.49 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
- 6766 ??  R       0:00.99 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
-# Old process killed (272)
-Thu Sep  6 12:01:59 PDT 2007
-11460 ??  I       0:00.01 ruby: RailsMongrelStyle dir:/home/billg/testrails supervisor (ruby)
- 1207 ??  I       0:02.51 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
- 3204 ??  I       0:02.49 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
- 6766 ??  I       0:02.49 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
+  # style idling with three listeners
+  Thu Sep  6 12:01:47 PDT 2007
+  11460 ??  I       0:00.00 ruby: RailsMongrelStyle dir:/home/billg/testrails supervisor (ruby)
+   6540 ??  I       0:02.52 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
+    272 ??  I       0:02.52 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
+  27808 ??  I       0:02.51 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
+  # Restart occurs, new process started (1207)
+  Thu Sep  6 12:01:49 PDT 2007
+  11460 ??  I       0:00.00 ruby: RailsMongrelStyle dir:/home/billg/testrails supervisor (ruby)
+  27808 ??  I       0:02.51 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
+    272 ??  I       0:02.52 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
+   6540 ??  I       0:02.52 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
+   1207 ??  R       0:00.95 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
+  # Old process killed (27808)
+  Thu Sep  6 12:01:51 PDT 2007
+  11460 ??  I       0:00.01 ruby: RailsMongrelStyle dir:/home/billg/testrails supervisor (ruby)
+   6540 ??  I       0:02.52 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
+    272 ??  I       0:02.52 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
+   1207 ??  I       0:02.51 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
+  # New process started (3204)
+  Thu Sep  6 12:01:53 PDT 2007
+  11460 ??  I       0:00.01 ruby: RailsMongrelStyle dir:/home/billg/testrails supervisor (ruby)
+    272 ??  I       0:02.52 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
+   6540 ??  I       0:02.52 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
+   1207 ??  I       0:02.51 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
+   3204 ??  R       0:01.01 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
+  # Old process killed (6540)
+  Thu Sep  6 12:01:55 PDT 2007
+  11460 ??  I       0:00.01 ruby: RailsMongrelStyle dir:/home/billg/testrails supervisor (ruby)
+    272 ??  I       0:02.52 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
+   1207 ??  I       0:02.51 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
+   3204 ??  I       0:02.49 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
+  # New process started (6766)
+  Thu Sep  6 12:01:57 PDT 2007
+  11460 ??  I       0:00.01 ruby: RailsMongrelStyle dir:/home/billg/testrails supervisor (ruby)
+    272 ??  I       0:02.52 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
+   1207 ??  I       0:02.51 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
+   3204 ??  I       0:02.49 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
+   6766 ??  R       0:00.99 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
+  # Old process killed (272)
+  Thu Sep  6 12:01:59 PDT 2007
+  11460 ??  I       0:00.01 ruby: RailsMongrelStyle dir:/home/billg/testrails supervisor (ruby)
+   1207 ??  I       0:02.51 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
+   3204 ??  I       0:02.49 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
+   6766 ??  I       0:02.49 ruby: RailsMongrelStyle dir:/home/billg/testrails port:8912 environment:production (ruby)
 
 Result, three brand new listening processes, total time to restart is about 12
 seconds (2 * (2 killtime * 1 number * 3 fork)).
@@ -277,7 +288,8 @@ Machine were modified to support this.
 
 Support for other adapters is easily added by adding the run method to the
 Style class.  This can be easy (as it is with Ramaze), or more difficult (as it
-is with Rails).  If the adapter uses Rack, it should be fairly simple.
+is with Rails).  If the adapter uses Rack, it should be fairly simple. You can
+also just use the generic adapter to specify a string to require.
 
 Style loads adapters and handlers from style/{adapter,handler} relative to the
 load path, so you can add your own adapters and handlers without modifying the

data/lib/style/adapter/generic.rb

@@ -0,0 +1,9 @@
+class Style
+  # This requires config[:adapter_config][:script] || 'style_adapter',
+  # which means you can use it to host other supported web frameworks.
+  # Those frameworks should start the server that style is currently using,
+  # in order to pick up the correct socket.
+  def run
+   require(config[:adapter_config][:script] || 'style_adapter')
+  end
+end

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.9.4
 specification_version: 1
 name: ruby-style
 version: !ruby/object:Gem::Version 
-  version: 1.1.0
-date: 2008-01-27 00:00:00 -08:00
+  version: 1.1.1
+date: 2008-02-23 00:00:00 -08:00
 summary: Supervised TCPServer, Yielding Listeners Easily
 require_paths: 
 - lib
@@ -38,11 +38,14 @@ files:
 - lib/style/handler/evented_mongrel.rb
 - lib/style/adapter/ramaze.rb
 - lib/style/adapter/rails.rb
+- lib/style/adapter/generic.rb
 test_files: []
 
 rdoc_options: 
 - --inline-source
 - --line-numbers
+- README
+- lib
 extra_rdoc_files: []
 
 executables: