RubyGems - mongrel_esi - Versions diffs - 0.4.0 - Mend

mongrel_esi 0.4.0

Files changed (73) hide show

data/COPYING +53 -0
data/LICENSE +471 -0
data/README +186 -0
data/Rakefile +141 -0
data/bin/mongrel_esi +271 -0
data/ext/esi/common.rl +41 -0
data/ext/esi/esi_parser.c +387 -0
data/ext/esi/extconf.rb +6 -0
data/ext/esi/machine.rb +499 -0
data/ext/esi/parser.c +1675 -0
data/ext/esi/parser.h +113 -0
data/ext/esi/parser.rb +49 -0
data/ext/esi/parser.rl +398 -0
data/ext/esi/ruby_esi.rl +135 -0
data/ext/esi/run-test.rb +3 -0
data/ext/esi/test/common.rl +41 -0
data/ext/esi/test/parser.c +1676 -0
data/ext/esi/test/parser.h +113 -0
data/ext/esi/test/parser.rl +398 -0
data/ext/esi/test/test.c +373 -0
data/ext/esi/test1.rb +56 -0
data/ext/esi/test2.rb +45 -0
data/lib/esi/cache.rb +207 -0
data/lib/esi/config.rb +154 -0
data/lib/esi/dispatcher.rb +27 -0
data/lib/esi/handler.rb +236 -0
data/lib/esi/invalidator.rb +40 -0
data/lib/esi/logger.rb +46 -0
data/lib/esi/router.rb +84 -0
data/lib/esi/tag/attempt.rb +6 -0
data/lib/esi/tag/base.rb +85 -0
data/lib/esi/tag/except.rb +24 -0
data/lib/esi/tag/include.rb +190 -0
data/lib/esi/tag/invalidate.rb +54 -0
data/lib/esi/tag/try.rb +40 -0
data/lib/multi_dirhandler.rb +70 -0
data/setup.rb +1585 -0
data/test/integration/basic_test.rb +39 -0
data/test/integration/cache_test.rb +37 -0
data/test/integration/docs/content/500.html +16 -0
data/test/integration/docs/content/500_with_failover.html +16 -0
data/test/integration/docs/content/500_with_failover_to_alt.html +8 -0
data/test/integration/docs/content/ajax_test_page.html +15 -0
data/test/integration/docs/content/cookie_variable.html +3 -0
data/test/integration/docs/content/foo.html +15 -0
data/test/integration/docs/content/include_in_include.html +15 -0
data/test/integration/docs/content/malformed_transforms.html +16 -0
data/test/integration/docs/content/malformed_transforms.html-correct +11 -0
data/test/integration/docs/content/static-failover.html +20 -0
data/test/integration/docs/content/test2.html +1 -0
data/test/integration/docs/content/test3.html +17 -0
data/test/integration/docs/esi_invalidate.html +6 -0
data/test/integration/docs/esi_mixed_content.html +15 -0
data/test/integration/docs/esi_test_content.html +27 -0
data/test/integration/docs/index.html +688 -0
data/test/integration/docs/test1.html +1 -0
data/test/integration/docs/test3.html +9 -0
data/test/integration/docs/test_failover.html +1 -0
data/test/integration/handler_test.rb +270 -0
data/test/integration/help.rb +234 -0
data/test/net/get_test.rb +197 -0
data/test/net/net_helper.rb +16 -0
data/test/net/server_test.rb +249 -0
data/test/unit/base_tag_test.rb +44 -0
data/test/unit/esi-sample.html +56 -0
data/test/unit/help.rb +77 -0
data/test/unit/include_request_test.rb +69 -0
data/test/unit/include_tag_test.rb +14 -0
data/test/unit/parser_test.rb +478 -0
data/test/unit/router_test.rb +34 -0
data/test/unit/sample.html +21 -0
data/tools/rakehelp.rb +119 -0
metadata +182 -0

data/README ADDED Viewed

@@ -0,0 +1,186 @@
+=About=
+MongrelESI is meant to make caching easier by distributing the cache logic.
+The idea is to represent each part of the page as a unique URL.
+The whole page may not be cachable, but most of it probably is.  The cache server works by scanning the requested document for
+specific <esi:* tags before servering the response.  MongrelESI currently, only supports a few basic instructions
+=Tags=
+esi:include:
+  src  - request path, response replaces esi:include tag
+  timeout - how long to wait on the response
+  max-age - how long to cache the entity
+  onerror - whether continue on errors or trigger an exception
+esi:invalidate:
+  encloses invalidation instructions.
+  these instructions currently only support basic invalidation
+  e.g.
+      <esi:invalidate output="no">
+           <?xml version="1.0"?>
+           <!DOCTYPE INVALIDATION SYSTEM "internal:///WCSinvalidation.dtd">
+           <INVALIDATION VERSION="WCS-1.1">
+             <OBJECT>
+               <BASICSELECTOR URI="/path/to/invalidate"/>
+               <ACTION REMOVALTTL="0"/>
+               <INFO VALUE="invalidating fragment test 1"/>
+             </OBJECT>
+           </INVALIDATION>
+      </esi:invalidate>
+  In the above example, only /path/to/invalidate will be invalidated, advanced regex style selectors are only support with ruby as the
+  cache storage.
+esi:try/esi:attempt/esi:except
+  if any tags within the attempt block raise an exception and the onerror attribute is not equal to continue then
+  the server will fall back to the markup within the except block
+=Proxy Config=
+MongrelESI is a proxy server.   To configure where requests should be proxied modify the config/routes.yml file.
+Here's an example:
+ESI::Config.define(listeners) do|config|
+  # define request path routing rules
+  config.routes do|s|
+    s.match( /^\/(content|samples|extras).*/ ) do|r|
+      r.servers = ['127.0.0.1:4000']
+    end
+    s.default do|r|
+      r.servers = ['127.0.0.1:3000']
+    end
+  end
+end
+This sample configuration will route all urls starting with /content, /samples, or /extras
+to the servers running at 127.0.0.1 on port 4000.
+Everything else that matches the .* will be routed to the server running on port 3000.
+Optionally the caching duration can be specificied explicity for each host
+s.default do|r|
+  r.servers = ['127.0.0.1:3000']
+  r.cache_ttl = 300
+end
+This example will cache all requests for 300 seconds, but normally you would want to set the ttl on each individual fragment or include.
+A typical include would look like the following:
+<esi:include src="/content/1" max-age="600+600"/>
+Requesting /home, might respond with the following:
+<html>
+<head><title>Your Page</title>
+</head>
+<body>
+<div class="header"><esi:include src="/content/1 max-age="600+600"/></div>
+<div>Some content</div>
+<div>Some more content</div>
+</body>
+</html>
+If the uri is not already cached, the cache server will request /content/1, which will respond with:
+<div>hello User42</div>
+And finally, MongrelESI will respond to the original client request with the combined documents:
+<html>
+<head><title>Your Page</title>
+</head>
+<body>
+<div class="header"><div>hello User42</div></div>
+<div>Some content</div>
+<div>Some more content</div>
+</body>
+</html>
+== Integrating with your applications ==
+MongrelESI was built to support integrating lots of applications together.
+Primarily, you'll want to integrate by having one base application and many tiny applications that
+surface within your primary application.  In the rails sense think components.  In a bigger sense think
+multiple application technologies all integrating into the same application.  Imagine a java application
+returning up to the minute chat conversations in one part of the page, while rails delivers a reliable listing of
+current forum discussion, and maybe a python presense indicator for forum posts...
+One thing to keep in mind is mongrel esi is a proxy server.  This means for each request it needs to know where to route
+the requests.  To support this config.rb can express any regex to match a url and determine where a request should be
+forwarded as well as defining a default route.
+It is also sometimes convenient to allow multiple applications to store or house static content.  For this to work mongrel esi
+needs to know in what directories to search for static files.  This can be done by using the MultiDirHandler (see rev-config.rb)
+== Supported Features of ESI ==
+From [http://www.w3.org/TR/esi-lang esi-lang]
+MongrelESI supports basic include, exception handling and invalidation.  It does not include support for
+Variable or Conditional processing. It does have suppport for COOKIE variables.
+(e.g. $(HTTP_COOKIE{name})  will be replaced with the value of the cookie, name)
++ Inclusion - ESI can compose pages by assembling included content, which is fetched from the network.
+	This allows each such fragment to have its own metadata (e.g., cacheability and handling information) seperately associated.
+- Variable support - ESI 1.0 supports the use of variables based on HTTP request attributes in a manner
+ 	reminiscent of the Common Gateway Interface. These variables can be used by ESI statements or written directly into the processed markup.
+- Conditional processing - ESI allows conditional logic with Boolean comparisons to be used to influence how a template is processed.
++ Exception and error handling - ESI provides for specification of alternate and default resources in a number of situations.
+== HTTP Readings ==
+* http://www.jmarshall.com/easy/http/
+== Adding New Features and Bug Fixing ==
+Before adding a new feature or bug fix, it's important to add a test to verify the behavior.
+Also, help out by keeping the Changelog updated with new features and major bug fixes
+== Future ideas of improving integration ==
+NOTE: this is a work in progress, below is how I'd like to integrate with rails in the future
+cd to/path/to/your/primary/rails/app
+mongrel_esi add . --default
+mongrel_esi add path/to/your/rails/secondary_app2
+mongrel_esi add path/to/your/rails/secondary_app3
+mongrel_esi add path/to/your/rails/secondary_app4
+mongrel_esi start
+  - starts up mongrel in each of the applications
+== Credits ==
+Support:
+  Zed A. Shaw        -- For writing [http://mongrel.rubyforge.org/ mongrel]
+  Adrian D. Thurston -- For writing [http://www.cs.queensu.ca/~thurston/ragel/ ragel]
+  The [http://www.ruby-lang.org/ ruby] community, for all their insights and help
+Author:
+  Todd Fisher
+Co-Authors:
+  Aaron Batalion -- Design ideas and integrating with Rails, fragment_fu. Ragel advocate
+  Richard Kilmer -- Thread saftey dispatcher, production ready
+  Adam Bair      -- Writing the initial testing framework and logger.
+  Jeff Damick    -- Writing the initial configuration.
+And of course thanks to everyone in #ruby-lang for putting up with my questions
+MenTaLguY for the great help in making good use of ruby

data/Rakefile ADDED Viewed

@@ -0,0 +1,141 @@
+# much of this file orginated as part of mongrel
+require 'rake'
+require 'rake/testtask'
+require 'rake/clean'
+require 'rake/gempackagetask'
+require 'rake/rdoctask'
+require 'tools/rakehelp'
+require 'fileutils'
+include FileUtils
+setup_tests
+setup_clean ["ext/esi/*.{bundle,so,obj,pdb,lib,def,exp}", "ext/esi/Makefile", "pkg", "lib/*.bundle", "*.gem", "doc/site/output", ".config"]
+setup_rdoc ['README', 'LICENSE', 'COPYING', 'lib/**/*.rb', 'doc/**/*.rdoc']
+desc "Does a full compile, test run"
+task :default => [:compile, :test]
+desc "Compiles all extensions"
+task :compile => [:esi] do
+  if Dir.glob(File.join("lib","esi.*")).length == 0
+    STDERR.puts "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
+    STDERR.puts "Gem actually failed to build.  Your system is"
+    STDERR.puts "NOT configured properly to build MongrelESI."
+    STDERR.puts "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
+    exit(1)
+  end
+end
+setup_extension("esi", "esi")
+task :package => [:clean,:compile,:test,:rerdoc]
+namespace :ragel do
+  desc 'test the ragel version'
+  task :verify do
+    version = `ragel --version`.scan(/version ([0-9\.]+)/).first.first
+    if version < "5.24"
+      puts "You need to install a version of ragel greater or equal to 5.24"
+      exit(1)
+    else
+      puts "Using ragel #{version}"
+    end
+  end
+  desc 'generate the ruby ragel parser'
+  task :ruby => :verify do
+    Dir.chdir "ext/esi" do
+      sh "ragel -R ruby_esi.rl | rlgen-ruby -o machine.rb"
+      raise "Failed to build Ruby source" unless File.exist? "machine.rb"
+    end
+  end
+  desc 'generate the ragel parser'
+  task :gen => :verify do
+    Dir.chdir "ext/esi" do
+      sh "ragel parser.rl | rlgen-cd -G1 -o parser.c"
+      raise "Failed to build ESI parser source" unless File.exist? "parser.c"
+    end
+  end
+  desc 'generate the ruby ragel parser'
+  task :ruby => :verify do
+    Dir.chdir "ext/esi" do
+      sh "ragel -R ruby_esi.rl | rlgen-ruby -o machine.rb"
+      raise "Failed to build Ruby source" unless File.exist? "machine.rb"
+    end
+  end
+  desc 'generate a PNG graph of the parser'
+  task :graph => :verify do
+    Dir.chdir "ext/esi" do
+      sh 'ragel -R ruby_esi.rl | rlgen-dot -p > esi.dot'
+      sh 'dot -Tpng esi.dot -o ../../esi.png'
+    end
+  end
+end
+namespace :size do
+  desc 'Number of lines of code and tests'
+  task :measure => [:tests,:code]
+  desc 'Number of lines of tests'
+  task :tests do
+    sh 'find test/ -name "*.rb" | xargs wc -l'
+  end
+  desc 'Number of lines of code'
+  task :code do
+    sh 'find lib/ ext/ -name "*.r*" | grep -v svn | xargs wc -l'
+  end
+end
+name="mongrel_esi"
+version="0.4.0"
+setup_gem(name, version) do |spec|
+  spec.summary = "A small fast ESI HTTP Server built on top of Mongrel"
+  spec.description = spec.summary
+  spec.test_files = Dir.glob('test/test_*.rb')
+  spec.author="Todd A. Fisher"
+  spec.executables=['mongrel_esi']
+  spec.files += %w(COPYING LICENSE README Rakefile setup.rb)
+  spec.required_ruby_version = '>= 1.8.5'
+	if RUBY_PLATFORM =~ /mswin/
+    spec.platform = Gem::Platform::CURRENT
+  else
+    spec.add_dependency('daemons', '>= 1.0.3') # XXX: verify we are using this correctly
+    spec.add_dependency('fastthread', '>= 0.6.2') # mongrel needs it so do we
+  end
+  spec.add_dependency('hpricot', '>= 0.6') # used for invalidation protocol parsing
+  spec.add_dependency('memcache-client', '>= 1.5.0')
+  spec.add_dependency('cgi_multipart_eof_fix', '>= 1.0.0') # mongrel needs it so do we
+  spec.add_dependency('mongrel', '>= 1.0.1') # we need mongrel
+end
+task :install do
+  sh %{rake package}
+  sh %{gem install pkg/#{name}-#{version}}
+end
+task :uninstall => [:clean] do
+  sh %{gem uninstall #{name}}
+end
+task :gem_source do
+  mkdir_p "pkg/gems"
+  FileList["**/*.gem"].each { |gem| mv gem, "pkg/gems" }
+  FileList["pkg/*.tgz"].each {|tgz| rm tgz }
+  rm_rf "pkg/#{name}-#{version}"
+  sh %{ index_gem_repository.rb -d pkg }
+  # TODO: setup something like this
+  #sh %{ scp -r ChangeLog pkg/* rubyforge.org:/var/www/gforge-projects/mongrel/releases/ }
+end

data/bin/mongrel_esi ADDED Viewed

@@ -0,0 +1,271 @@
+#!/usr/bin/env ruby
+# much of this file orginated as part of mongrel_rails
+require 'yaml'
+require 'rubygems'
+require 'mongrel/handlers.rb'
+require 'ostruct'
+SERVER_ROOT=File.expand_path("#{File.dirname(__FILE__)}/../")
+$: << "#{SERVER_ROOT}/lib"
+$: << "#{SERVER_ROOT}/ext"
+require "esi/dispatcher"
+module Mongrel
+  class Start < GemPlugin::Plugin "/commands"
+		include Mongrel::Command::Base
+    def configure
+			options [
+					['-d', '--daemonize', "Run daemonized in the background", :@daemon, false],
+					['-p', '--port PORT', "Which port to bind to", :@port, 2000],
+					['-a', '--address ADDR', "Address to bind to", :@address, "0.0.0.0"],
+					['-l', '--log FILE', "Where to write log messages", :@log_file, "log/mongrel-esi.log"],
+					['-P', '--pid FILE', "Where to write the PID", :@pid_file, "log/mongrel-esi.pid"],
+					['-c', '--chdir PATH', "Change to dir before starting (will be expanded)", :@cwd, Dir.pwd],
+					['-B', '--debug', "Enable debugging mode", :@debug, false],
+					['-C', '--config PATH', "Use a config file", :@config_file, nil],
+          ['-S', '--script PATH', "Load the given file as an extra config script", :@config_script, nil],
+					['-R', '--routes PATH', "Define simple routes /request_path1/:hostname:port, /request_path2/:hostname:port", :@routing, nil],
+					['-s', '--cache TYPE', "Define the type of cache storage default is ruby, available caches are [memcached,ruby]", :@cache, 'ruby'],
+					['',   '--cache-options OPTIONS', "Options for selected cache server, ruby has non, memcached has port, servers, etc...", :@cache_options, {}],
+					['-t', '--allowed-content-types TYPE', "List of content types to auto enable ESI processing", :@allowed_content_types, nil],
+					['-o', '--enable-for-surrogate-only', "Only enable ESI processing with the surrgoate ESI header is present", :@enable_for_surrogate_only, false],
+					['-i', '--enable-invalidator', "Start the invalidation server", :@invalidator, false],
+					['',   '--user USER', "User to run as", :@user, nil],
+					['',   '--group GROUP', "Group to run as", :@group, nil],
+					['',   '--prefix PATH', "URL prefix for cache server", :@prefix, nil]
+			]
+		end
+    def validate
+      @cwd = File.expand_path(@cwd)
+      valid_dir? @cwd, "Invalid path to change to during daemon mode: #@cwd"
+      # Change there to start, then we'll have to come back after daemonize
+      Dir.chdir(@cwd)
+      valid?(@prefix[0].chr == "/" && @prefix[-1].chr != "/", "Prefix must begin with / and not end in /") if @prefix
+      valid_dir? File.dirname(@log_file), "Path to log file not valid: #@log_file"
+      valid_dir? File.dirname(@pid_file), "Path to pid file not valid: #@pid_file"
+      valid_exists? @mime_map, "MIME mapping file does not exist: #@mime_map" if @mime_map
+      valid_exists? @config_file, "Config file not there: #@config_file" if @config_file
+      valid_user? @user if @user
+      valid_group? @group if @group
+      valid?(['memcached','ruby'].include?(@cache), "Cache must be one of memcached or ruby"  )
+      # parse routing rules
+      routes = []
+      if !@routing
+        # default routing rules
+        @routing = "default:127.0.0.1:3000"
+      end
+      @routing.split(',').each do|rule|
+        parts = rule.split(':')
+        if parts.size < 3
+          STDERR.puts "You must supply a url to match separated by a : the hostname and the port"
+          STDERR.puts "For default routing rules use the keyword 'default', such as default:hostname:port"
+          @valid = false
+          break
+        end
+        route = {}
+        route[:match_url] = parts[0]
+        route[:host] = parts[1]
+        route[:port] = parts[2]
+        route[:cache_ttl] = parts[3] if parts.size == 4
+        routes << route
+      end
+      @routing = routes
+      if @allowed_content_types
+        @allowed_content_types = @allowed_content_types.split(',').collect{|type| type}
+      end
+      return @valid
+    end
+    def run
+      # Config file settings will override command line settings
+      settings = { :host => @address,  :port => @port, :cwd => @cwd,
+        :log_file => @log_file, :pid_file => @pid_file,
+        :daemon => @daemon, :debug => @debug, :includes => ["mongrel-esi"],
+        :user => @user, :group => @group, :prefix => @prefix, :config_file => @config_file,
+        :routing => @routing, :cache => @cache, :cache_options => OpenStruct.new( @cache_options ),
+        :allowed_content_types => @allowed_content_types, :config_script => @config_script,
+        :enable_for_surrogate_only => @enable_for_surrogate_only, :invalidator => @invalidator
+      }
+      if @config_file
+        settings.merge! YAML.load_file(@config_file)
+        STDERR.puts "** Loading settings from #{@config_file} (they override command line)." unless settings[:daemon]
+      end
+      config = Mongrel::Configurator.new(settings) do
+        if defaults[:daemon]
+          if File.exist? defaults[:pid_file]
+            log "!!! PID file #{defaults[:pid_file]} already exists.  Mongrel could be running already.  Check your #{defaults[:log_file]} for errors."
+            log "!!! Exiting with error.  You must stop mongrel and clear the .pid before I'll attempt a start."
+            exit 1
+          end
+          daemonize
+          log "Daemonized, any open files are closed.  Look at #{defaults[:pid_file]} and #{defaults[:log_file]} for info."
+          log "Settings loaded from #{@config_file} (they override command line)." if @config_file
+        end
+        log "Starting Mongrel listening at #{defaults[:host]}:#{defaults[:port]}"
+				listener do
+          mime = {}
+          if defaults[:mime_map]
+            log "Loading additional MIME types from #{defaults[:mime_map]}"
+            mime = load_mime_map(defaults[:mime_map], mime)
+          end
+          if defaults[:debug]
+            log "Installing debugging prefixed filters. Look in log/mongrel_debug for the files."
+            debug "/"
+          end
+          log "Mounting ESI at #{defaults[:prefix]}..." if defaults[:prefix]
+          uri defaults[:prefix] || "/", :handler => ESI::Dispatcher.new(settings)
+          log "Loading any ESI specific GemPlugins"
+          load_plugins
+          if defaults[:config_script]
+            log "Loading #{defaults[:config_script]} external config script"
+            run_config(defaults[:config_script])
+          end
+          setup_signals
+        end
+      end
+      config.run
+      config.log "Mongrel available at #{settings[:host]}:#{settings[:port]}"
+      if config.defaults[:daemon]
+        config.write_pid_file
+      else
+        config.log "Use CTRL-C to stop."
+      end
+      config.join
+      if config.needs_restart
+        if RUBY_PLATFORM !~ /mswin/
+          cmd = "ruby #{__FILE__} start #{original_args.join(' ')}"
+          config.log "Restarting with arguments:  #{cmd}"
+          config.stop
+          config.remove_pid_file
+          if config.defaults[:daemon]
+            system cmd
+          else
+            STDERR.puts "Can't restart unless in daemon mode."
+            exit 1
+          end
+        else
+          config.log "Win32 does not support restarts. Exiting."
+        end
+      end
+    end
+	end
+  def Mongrel::send_signal(signal, pid_file)
+    pid = open(pid_file).read.to_i
+    print "Sending #{signal} to Mongrel at PID #{pid}..."
+    begin
+      Process.kill(signal, pid)
+    rescue Errno::ESRCH
+      puts "Process does not exist.  Not running."
+    end
+    puts "Done."
+  end
+  class Stop < GemPlugin::Plugin "/commands"
+    include Mongrel::Command::Base
+    def configure
+      options [
+        ['-c', '--chdir PATH', "Change to dir before starting (will be expanded).", :@cwd, "."],
+        ['-f', '--force', "Force the shutdown (kill -9).", :@force, false],
+        ['-w', '--wait SECONDS', "Wait SECONDS before forcing shutdown", :@wait, "0"],
+        ['-P', '--pid FILE', "Where the PID file is located.", :@pid_file, "log/mongrel-esi.pid"]
+      ]
+    end
+    def validate
+      @cwd = File.expand_path(@cwd)
+      valid_dir? @cwd, "Invalid path to change to during daemon mode: #@cwd"
+      Dir.chdir @cwd
+      valid_exists? @pid_file, "PID file #@pid_file does not exist.  Not running?"
+      return @valid
+    end
+    def run
+      if @force
+        @wait.to_i.times do |waiting|
+          exit(0) if not File.exist? @pid_file
+          sleep 1
+        end
+        Mongrel::send_signal("KILL", @pid_file) if File.exist? @pid_file
+      else
+        Mongrel::send_signal("TERM", @pid_file)
+      end
+    end
+  end
+  class Restart < GemPlugin::Plugin "/commands"
+    include Mongrel::Command::Base
+    def configure
+      options [
+        ['-c', '--chdir PATH', "Change to dir before starting (will be expanded)", :@cwd, '.'],
+        ['-s', '--soft', "Do a soft restart rather than a process exit restart", :@soft, false],
+        ['-P', '--pid FILE', "Where the PID file is located", :@pid_file, "log/mongrel-esi.pid"]
+      ]
+    end
+    def validate
+      @cwd = File.expand_path(@cwd)
+      valid_dir? @cwd, "Invalid path to change to during daemon mode: #@cwd"
+      Dir.chdir @cwd
+      valid_exists? @pid_file, "PID file #@pid_file does not exist.  Not running?"
+      return @valid
+    end
+    def run
+      if @soft
+        Mongrel::send_signal("HUP", @pid_file)
+      else
+        Mongrel::send_signal("USR2", @pid_file)
+      end
+    end
+  end
+end
+GemPlugin::Manager.instance.load "mongrel-esi" => GemPlugin::INCLUDE, "esi" => GemPlugin::EXCLUDE
+if not Mongrel::Command::Registry.instance.run ARGV
+  exit 1
+end