rack-cluster 0.0.1

data/README.markdown

@@ -0,0 +1,56 @@
+# Rack::Cluster
+
+Tools for managing multiple rackup processes. Built in the image of mongrel_cluster. The real use case is a work around for this [mongrel_rails/Rails >=2.3.3 issue](https://rails.lighthouseapp.com/projects/8994/tickets/2844-bad-content-type-error-in-rack-10-with-first-cgi-mongrel-request).
+
+## Install
+
+    gem install rack-cluster -s http://gemcutter.com
+
+## Usage
+
+    rack-cluster [options] command
+        -C, --config PATH
+        -p, --port PORT                  use PORT
+        -E, --env ENVIRONMENT            use ENVIRONMENT for defaults
+        -N, --num-servers INT
+        -s, --server SERVER              serve using SERVER (webrick/mongrel)
+        -P, --pid FILE                   file to store PID
+        -c, --chdir PATH
+        -u, --config-ru PATH
+        -b, --rackup-bin PATH
+        -v, --verbose
+        -h, --help                       Show this message
+            --version                    Show version
+
+    Commands: start, stop, restart
+
+## Caveats
+
+* Truly prototype code, but I wanted to get it out there.
+
+## TODO
+
+* TEST
+* Make `configure` command akin to mongrel_rails cluster::configure
+
+## License
+
+Copyright (c) 2009 Ryan Carmelo Briones &lt;<ryan.briones@brionesandco.com>&gt;
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,29 @@
+require 'rake/gempackagetask'
+
+require File.expand_path(File.dirname(__FILE__) + '/lib/rack/cluster')
+ 
+spec = Gem::Specification.new do |s|
+  s.name = 'rack-cluster'
+  s.version = Rack::Cluster::VERSION
+  s.homepage = 'http://github.com/ryanbriones/rack-cluster'
+  s.summary = 'tools for managing multiple rackup processes'
+  s.files = FileList['[A-Z]*', 'bin/*', 'lib/**/*']
+  s.has_rdoc = false
+  s.bindir = 'bin'
+  s.executables = ['rack-cluster']
+  s.author = 'Ryan Carmelo Briones'
+  s.email = 'ryan.briones@brionesandco.com'
+
+  s.add_runtime_dependency 'rack', '>=1.0.0'
+end
+ 
+Rake::GemPackageTask.new(spec) {}
+
+desc "Write out #{spec.name}.gemspec"
+task :build_gemspec do
+  File.open("#{spec.name}.gemspec", "w") do |f|
+    f.write spec.to_ruby
+  end
+end
+ 
+task :default => [:build_gemspec, :gem]

data/bin/rack-cluster

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+require 'rack/cluster/command'
+
+command = Rack::Cluster::Command.new
+command.parse_options
+command.run

data/lib/rack/cluster.rb

@@ -0,0 +1,5 @@
+module Rack
+  module Cluster
+    VERSION = '0.0.1'
+  end
+end

data/lib/rack/cluster/command.rb

@@ -0,0 +1,87 @@
+require 'optparse'
+require 'yaml'
+
+require 'rack/cluster'
+require 'rack/cluster/runner'
+
+module Rack
+  module Cluster
+    class Command
+      def parse_options
+        @options = {}
+        
+        OptionParser.new do |opts|
+          opts.banner = "Usage: #{$0} [options] command"
+
+          opts.on('-C', '--config PATH') do |config|
+            @options[:config_file] = config
+          end
+
+          opts.on("-p", "--port PORT", "use PORT") do |p|
+            @options[:port] = p
+          end
+
+          opts.on('-E', '--env ENVIRONMENT', 'use ENVIRONMENT for defaults') do |e|
+            @options[:environment] = e
+          end
+
+          opts.on('-N', '--num-servers INT') do |n|
+            @options[:servers] = n
+          end
+
+          opts.on('-s', '--server SERVER', 'serve using SERVER (webrick/mongrel)') do |s|
+            @options[:server] = s
+          end
+
+          opts.on('-P', '--pid FILE', 'file to store PID') do |p|
+            @options[:pid_file] = p
+          end
+
+          opts.on('-c', '--chdir PATH') do |c|
+            @options[:cwd] = c
+          end
+
+          opts.on('-u', '--config-ru PATH') do |config_ru|
+            @options[:config_ru] = config_ru
+          end
+
+          opts.on('-b', '--rackup-bin PATH') do |rackup|
+            @options[:rackup] = rackup
+          end
+
+          opts.on('-v', '--verbose') do |verbose|
+            @options[:verbose] = verbose
+          end
+
+          opts.on_tail('-h', '--help', 'Show this message') do
+            puts opts
+            exit
+          end
+
+          opts.on_tail('--version', 'Show version') do
+            puts Rack::Cluster::VERSION
+            exit
+          end
+
+          opts.parse! ARGV
+        end
+
+        @command = ARGV.shift
+      end
+
+      def run
+        runner_commands = ['start', 'stop', 'restart']
+
+        if @options[:config_file]
+          options_from_config_file = YAML.load_file(@options[:config_file])
+          symbolized_options = Hash[options_from_config_file.map { |k, v| [k.to_sym, v] }]
+          @options = symbolized_options.merge(@options)
+        end
+
+        if runner_commands.include?(@command)
+          Rack::Cluster::Runner.send("#{@command}!", @options)
+        end
+      end
+    end
+  end
+end

data/lib/rack/cluster/runner.rb

@@ -0,0 +1,151 @@
+require 'rack/cluster'
+
+module Rack
+  module Cluster
+    class Runner
+      DEFAULT_OPTIONS = {
+        :port => 3000,
+        :environment => 'development',
+        :servers => 1,
+        :server => 'mongrel',
+        :pid_file => 'tmp/pids/mongrel.pid',
+        :verbose => false,
+        :rackup => 'rackup'
+      }
+      
+      def initialize(options = {})
+        symbolized_options = Hash[options.map { |k, v| [k.to_sym, v] }]
+        @options = DEFAULT_OPTIONS.merge(symbolized_options)
+      end
+
+      def self.start!(options = {})
+        self.new(options).start
+      end
+
+      def self.stop!(options = {})
+        self.new(options).stop
+      end
+
+      def self.restart!(options = {})
+        self.new(options).restart
+      end
+
+      def start
+        start_port.upto(end_port) do |port|
+          if pid_file_for_port_exists?(port) && running_on_port?(port)
+            puts "already running on port #{port}"
+            next
+          end
+
+          if pid_file_for_port_exists?(port) && !running_on_port?(port)
+            puts "cleaning up pid file for port #{port}"
+            File.unlink(pid_file_for_port(port))
+          end
+
+          cmd = "#{@options[:rackup]} -D"
+          cmd << " -s #{@options[:server]}"
+          cmd << " -E #{@options[:environment]}"
+          cmd << " -p #{port}"
+          cmd << " -P #{pid_file_for_port(port)}"
+          cmd << " #{config_ru}" if config_ru
+          
+          puts "starting port #{port}"
+          puts "#{cmd}" if verbose
+          output = `#{cmd}`
+          STDERR.puts(output) unless $?.success?
+        end
+      end
+
+      def stop
+        start_port.upto(end_port) do |port|
+          if pid_file_for_port_exists?(port) && !running_on_port?(port)
+            puts "cleaning up pid file for port #{port}"
+            File.unlink(pid_file_for_port(port))
+          end
+
+          unless running_on_port?(port)
+            puts "no process to stop on port #{port}"
+            next
+          end
+
+          pid = File.read(pid_file_for_port(port)).to_i
+
+          puts "killing #{port}, pid #{pid}"
+          Process.kill("KILL", pid)
+        end
+      end
+
+      def restart
+        stop
+        start
+      end
+
+      def config_ru
+        config_ru_file = @options[:config_ru]
+        config_ru_absolute_path = config_ru_file =~ /^\//
+        cwd = @options[:cwd]
+
+        if config_ru_file && cwd
+          if config_ru_absolute_path
+            config_ru_file
+          else
+            File.join(cwd, config_ru_file)
+          end
+        elsif config_ru_file
+          config_ru_file
+        elsif cwd
+          File.join(cwd, 'config.ru')
+        else
+          'config.ru'
+        end
+      end
+
+      def servers
+        @options[:servers].to_i != 0 ? @options[:servers].to_i : 1
+      end
+
+      def start_port
+        @options[:port].to_i
+      end
+
+      def end_port
+        start_port + (servers - 1)
+      end
+
+      def pid_file_for_port(port)
+        return unless @options[:pid_file]
+
+        pid_file_dir = File.dirname(@options[:pid_file])
+        pid_file_ext = File.extname(@options[:pid_file])
+        pid_file_basename = File.basename(@options[:pid_file], pid_file_ext)
+        
+        full_pid_file_dir = if @options[:cwd]
+                              File.join(@options[:cwd], pid_file_dir)
+                            else
+                              pid_file_dir
+                            end
+
+        File.join(full_pid_file_dir, "#{pid_file_basename}.#{port}#{pid_file_ext}")
+      end
+
+      def pid_file_for_port_exists?(port)
+        return false unless @options[:pid_file]
+        File.exists?(pid_file_for_port(port))
+      end
+
+      def running_on_port?(port)
+        return false unless pid_file_for_port_exists?(port)
+
+        pid = File.read(pid_file_for_port(port)).to_i
+        processes = `ps -p #{pid} -o cmd=`
+        
+        return true if processes =~ /rackup/
+        false
+      end
+
+      def verbose
+        @options[:verbose]
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,69 @@
+--- !ruby/object:Gem::Specification 
+name: rack-cluster
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Ryan Carmelo Briones
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-10-26 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rack
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.0.0
+    version: 
+description: 
+email: ryan.briones@brionesandco.com
+executables: 
+- rack-cluster
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- Rakefile
+- README.markdown
+- bin/rack-cluster
+- lib/rack/cluster/command.rb
+- lib/rack/cluster/runner.rb
+- lib/rack/cluster.rb
+has_rdoc: true
+homepage: http://github.com/ryanbriones/rack-cluster
+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: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: tools for managing multiple rackup processes
+test_files: []
+