notgun 0.9.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 38cc9ebbf61380ac8482b45e79eaeefd0f8130f3
+  data.tar.gz: 5df2d2a1a642e9c7f3265fc6f6cd65a1692a77f0
+SHA512:
+  metadata.gz: 827f98ff6bdb115d48616b351a71f2048016cdb39800049a03d379ffe96504643a24b840391cf5d7fbefd0cf284cdbfa208faf4ee8914a81f69e9ba16e8fc4f5
+  data.tar.gz: f6f52ec3a621c606bfcf538a24a02f5c52b77feb82f10b3d29743d91899a324c094983f1f5c278c3b6a74f8a01642e1a75fae5d740a9ce774ea70c72a64c1371

data/.gitignore

@@ -0,0 +1,4 @@
+/pkg
+/test/verbose.log
+notgun.1.html
+/Gemfile.lock

data/CHANGELOG.md

@@ -0,0 +1,19 @@
+0.9.2 - 2016-08-03
+==================
+
+* Forked and renamed to notgun (timriley)
+
+* Added compatibility with Rack versions 2.0+ (macournoyer via [shotgun#61](https://github.com/rtomayko/shotgun/pull/61))
+
+0.9.1 - 2015-03-01
+==================
+
+* Fixed a long-standing issue that caused Shotgun not to show any access logs
+  in the terminal (#57).
+
+* Made `--url` option actually work (Adam Mckaig, #49).
+
+Previous versions
+=================
+
+(See commit list.)

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,18 @@
+Copyright (c) 2009 Ryan Tomayko <tomayko.com/about>
+
+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 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/README.md

@@ -0,0 +1,110 @@
+# Notgun
+
+Notgun is a fork of [Shotgun](https://github.com/rtomayko/shotgun) with Rack 2.0+ compatibility.
+
+### Usage
+
+Installation:
+
+```shell
+gem install notgun
+```
+
+Starting a server with a rackup file:
+
+```shell
+notgun config.ru
+```
+Using Thin and starting on port 6000 instead of 9393 (default):
+
+```shell
+notgun --server=thin --port=6000 config.ru
+```
+Running Sinatra apps:
+
+
+```shell
+notgun hello.rb
+```
+
+See 'notgun --help' for more advanced usage.
+
+_Original Shotgun README follows:_
+
+---
+
+# Shotgun
+
+This is an automatic reloading version of the rackup command that's shipped with
+Rack. It can be used as an alternative to the complex reloading logic provided
+by web frameworks or in environments that don't support application reloading.
+
+The shotgun command starts one of Rack's supported servers (e.g., mongrel, thin,
+webrick) and listens for requests but does not load any part of the actual
+application. Each time a request is received, it forks, loads the application in
+the child process, processes the request, and exits the child process. The
+result is clean, application-wide reloading of all source files and templates on
+each request.
+
+Usage
+-----
+
+Installation:
+
+```shell
+  gem install shotgun
+```
+
+Starting a server with a rackup file:
+
+```shell
+  shotgun config.ru
+```
+Using Thin and starting on port 6000 instead of 9393 (default):
+
+```shell
+  shotgun --server=thin --port=6000 config.ru
+```
+Running Sinatra apps:
+
+
+```shell
+  shotgun hello.rb
+```
+
+See 'shotgun --help' for more advanced usage.
+
+Compatibility
+---
+
+Because of the underlying technique used, Shotgun is only compatible with
+systems that support `fork(2)` (probably just MRI on POSIX systems).
+
+Caveats
+---
+
+* For performance reasons, Shotgun automatically includes middleware to serve
+  static files (similar to `Rack::Static`). If you rely on Rack serving static
+  assets, then do include `Rack::Static` yourself.
+
+* If you use Sinatra, you may need to [set the session secret manually][sinatra-caveat].
+
+* Similar to a Rackup file (`config.ru`), you can't use `require_relative` in
+  your preload files (`shotgun.rb`).
+
+Links
+-----
+
+[Shotgun](http://github.com/rtomayko/shotgun)
+
+[Rack](http://rack.rubyforge.org/)
+
+[Sinatra](http://www.sinatrarb.com/)
+
+The reloading system in Ian Bicking's webware framework served as inspiration
+for the approach taken in Shotgun. Ian lays down the pros and cons of this
+approach in the following article:
+
+http://ianbicking.org/docs/Webware_reload.html
+
+[sinatra-caveat]: https://groups.google.com/forum/#!topic/sinatrarb/pUFSoyQXyQs

data/RELEASING

@@ -0,0 +1,8 @@
+1. update notgun.gemspec version and date
+2. update revision history in notgun.1
+3. rake man
+4. git add -u
+4. tag <version>
+5. rake package
+6. git push origin master <version>
+7. gem push pkg/notgun-<version>.gem

data/Rakefile

@@ -0,0 +1,17 @@
+require "bundler/gem_tasks"
+
+require 'rake/clean'
+require 'rake/testtask'
+
+task :default => [:test]
+
+Rake::TestTask.new(:test) do |t|
+  t.test_files = FileList['test/test_notgun_*.rb']
+  t.ruby_opts = ['-rubygems'] if defined? Gem
+end
+
+desc "build manual"
+task :man do
+  ENV['RONN_ORGANIZATION'] = "Notgun #{SPEC.version}"
+  sh "ronn -5r -stoc man/*.ronn"
+end

data/bin/notgun

@@ -0,0 +1,164 @@
+#!/usr/bin/env ruby
+
+require 'optparse'
+
+env = ENV['RACK_ENV'] || 'development'
+host = ENV['HOST'] || '127.0.0.1'
+port = ENV['PORT'] || 9393
+mount_path = "/"
+browse = false
+server = nil
+public_dir = 'public' if File.directory?('public')
+options = {:Port => port, :Host => host, :AccessLog => []}
+
+opts = OptionParser.new("", 24, '  ') { |opts|
+  opts.banner = "Usage: notgun [ruby options] [rack options] [rackup config]"
+
+  opts.separator ""
+  opts.separator "Ruby options:"
+
+  lineno = 1
+  opts.on("-e", "--eval LINE", "evaluate a LINE of code") { |line|
+    eval line, TOPLEVEL_BINDING, "-e", lineno
+    lineno += 1
+  }
+
+  opts.on("-d", "--debug", "set debugging flags (set $DEBUG to true)") {
+    $DEBUG = true
+  }
+  opts.on("-w", "--warn", "turn warnings on for your script") {
+    $-w = true
+  }
+
+  opts.on("-I", "--include PATH",
+          "specify $LOAD_PATH (may be used more than once)") { |path|
+    $LOAD_PATH.unshift(*path.split(":"))
+  }
+
+  opts.on("-r", "--require LIBRARY",
+          "require the library, before executing your script") { |library|
+    require library
+  }
+
+  opts.separator ""
+  opts.separator "Rack options:"
+  opts.on("-s", "--server SERVER", "server (webrick, mongrel, thin, etc.)") { |s|
+    server = s
+  }
+
+  opts.on("-o", "--host HOST", "listen on HOST (default: 127.0.0.1)") { |host|
+    options[:Host] = host
+  }
+
+  opts.on("-p", "--port PORT", "use PORT (default: 9393)") { |port|
+    options[:Port] = port
+  }
+
+  opts.on("-E", "--env ENVIRONMENT", "use ENVIRONMENT for defaults (default: development)") { |e|
+    env = e
+  }
+
+  opts.separator ""
+  opts.separator "Notgun options:"
+
+  opts.on("-O", "--browse", "open browser immediately after starting") {
+    browse = true
+  }
+
+  opts.on("-u", "--url URL", "specify url path (default: #{mount_path})") { |url|
+    mount_path = url
+  }
+
+  opts.on("-P", "--public PATH", "serve static files under PATH") { |path|
+    public_dir = path
+  }
+
+  opts.on_tail("-h", "--help", "show this message") do
+    puts opts
+    exit
+  end
+
+  opts.on_tail("--version", "show version") do
+    require 'rack'
+    puts "Rack #{Rack.version}"
+    exit
+  end
+
+  opts.parse! ARGV
+}
+
+config = ARGV[0] || "config.ru"
+abort "configuration #{config} not found" unless File.exist? config
+
+# extract additional arguments from first #\ line in config file.
+if File.read(config)[/^#\\(.*)/]
+  opts.parse! $1.split(/\s+/)
+end
+
+# use the BROWSER environment variable or fall back to a more or less standard
+# set of commands
+ENV['BROWSER'] ||=
+  %w[open xdg-open x-www-browser firefox opera mozilla netscape].find do |comm|
+    next if comm == 'open' && `uname` !~ /Darwin/
+    ENV['PATH'].split(':').any? { |dir| File.executable?("#{dir}/#{comm}") }
+  end
+ENV['RACK_ENV'] = env
+
+require 'rack'
+
+require 'notgun'
+
+require 'thin' if server.to_s.downcase == 'thin'
+server = Rack::Handler.get(server) || Rack::Handler.default
+
+app =
+  Rack::Builder.new do
+    map(mount_path) do
+
+      # these middleware run in the master process.
+      use Notgun::Static, public_dir if public_dir
+      use Notgun::SkipFavicon
+
+      # loader forks the child and runs the embedded config followed by the
+      # application config.
+      run Notgun::Loader.new(config) {
+        case env
+        when 'development'
+          use Rack::CommonLogger, STDERR  unless server.name =~ /CGI/
+          use Rack::ShowExceptions
+          use Rack::Lint
+        when 'deployment', 'production'
+          use Rack::CommonLogger, STDERR  unless server.name =~ /CGI/
+        end
+      }
+    end
+  end
+
+Notgun.enable_copy_on_write
+
+# trap exit signals
+downward = false
+['INT', 'TERM', 'QUIT'].each do |signal|
+  trap(signal) do
+    exit! if downward
+    downward = true
+    server.shutdown if server.respond_to?(:shutdown)
+    Process.wait rescue nil
+    exit!
+  end
+end
+
+# load notgun.rb in current working directory if it exists
+Notgun.preload
+
+base_url = "http://#{options[:Host]}:#{options[:Port]}#{mount_path}"
+puts "== Notgun/#{server.to_s.sub(/Rack::Handler::/, '')} on #{base_url}"
+server.run app, options do |inst|
+  if browse
+    if ENV['BROWSER']
+      system "#{ENV['BROWSER']} '#{base_url}'"
+    else
+      abort "BROWSER environment variable not set and no browser detected"
+    end
+  end
+end

data/lib/notgun.rb

@@ -0,0 +1,44 @@
+require 'rack'
+
+module Notgun
+  autoload :Loader,      'notgun/loader'
+  autoload :SkipFavicon, 'notgun/favicon'
+  autoload :Static,      'notgun/static'
+
+  def self.new(rackup_file, &block)
+    Loader.new(rackup_file, &block)
+  end
+
+  def self.enable_copy_on_write
+    GC.copy_on_write_friendly = true if GC.respond_to?(:copy_on_write_friendly=)
+  end
+
+  def self.preload(files=%w[./config/notgun.rb ./notgun.rb])
+    files.each do |preload_file|
+      if File.exist?(preload_file)
+        module_eval File.read(preload_file), preload_file
+        return preload_file
+      end
+    end
+  end
+
+  def self.before_fork(&block)
+    @before_fork ||= []
+    @before_fork << block if block
+    @before_fork
+  end
+
+  def self.after_fork(&block)
+    @after_fork ||= []
+    @after_fork << block if block
+    @after_fork
+  end
+
+  def self.before_fork!
+    before_fork.each { |block| block.call }
+  end
+
+  def self.after_fork!
+    after_fork.each { |block| block.call }
+  end
+end

data/lib/notgun/favicon.rb

@@ -0,0 +1,16 @@
+module Notgun
+  # Responds to requests for /favicon.ico with a content free 404 and caching
+  # headers.
+  class SkipFavicon < Struct.new(:app)
+    def call(env)
+      if env['PATH_INFO'] == '/favicon.ico'
+        [404, {
+          'Content-Type'  => 'image/png',
+          'Cache-Control' => 'public, max-age=100000000000'
+        }, []]
+      else
+        app.call(env)
+      end
+    end
+  end
+end

data/lib/notgun/loader.rb

@@ -0,0 +1,141 @@
+require 'rack/utils'
+require 'thread'
+
+module Notgun
+  # Rack app that forks, loads the rackup config in the child process,
+  # processes a single request, and exits. The response is communicated over
+  # a unidirectional pipe.
+  class Loader
+    include Rack::Utils
+    attr_reader :rackup_file
+
+    def initialize(rackup_file, &block)
+      @rackup_file = rackup_file
+      @config = block || Proc.new { }
+    end
+
+    def call(env)
+      dup.call!(env)
+    end
+
+    def call!(env)
+      @env = env
+      @reader, @writer = IO.pipe
+
+      Notgun.before_fork!
+
+      if @child = fork
+        proceed_as_parent
+      else
+        Notgun.after_fork!
+        proceed_as_child
+      end
+    end
+
+    ##
+    # Stuff that happens in the parent process
+
+    def proceed_as_parent
+      @writer.close
+      rand
+      result, status, headers = Marshal.load(@reader)
+      body = Body.new(@child, @reader)
+      case result
+      when :ok
+        [status, headers, body]
+      when :error
+        error, backtrace = status, headers
+        body.close
+        [
+          500,
+          {'Content-Type'=>'text/html;charset=utf-8'},
+          [format_error(error, backtrace)]
+        ]
+      else
+        fail "unexpected response: #{result.inspect}"
+      end
+    end
+
+    class Body < Struct.new(:pid, :fd)
+      def each
+        while chunk = fd.read(1024)
+          yield chunk
+        end
+      end
+
+      def close
+        fd.close
+      ensure
+        Process.wait(pid)
+      end
+    end
+
+    def format_error(error, backtrace)
+      "<h1>Boot Error</h1>" +
+      "<p>Something went wrong while loading <tt>#{escape_html(rackup_file)}</tt></p>" +
+      "<h3>#{escape_html(error)}</h3>" +
+      "<pre>#{escape_html(backtrace.join("\n"))}</pre>"
+    end
+
+    ##
+    # Stuff that happens in the child process
+
+    def proceed_as_child
+      boom = false
+      @reader.close
+      status, headers, body = assemble_app.call(@env)
+      Marshal.dump([:ok, status, headers.to_hash], @writer)
+      spec_body(body).each { |chunk| @writer.write(chunk) }
+      body.close if body.respond_to?(:close)
+    rescue Object => boom
+      Marshal.dump([
+        :error,
+        "#{boom.class.name}: #{boom.to_s}",
+        boom.backtrace
+      ], @writer)
+    ensure
+      @writer.close
+      exit! boom ? 1 : 0
+    end
+
+    def assemble_app
+      config = @config
+      inner_app = self.inner_app
+      Rack::Builder.new {
+        instance_eval(&config)
+        run inner_app
+      }.to_app
+    end
+
+    def inner_app
+      if rackup_file =~ /\.ru$/
+        config = File.read(rackup_file)
+        eval "Rack::Builder.new {( #{config}\n )}.to_app", nil, rackup_file
+      else
+        require File.expand_path(rackup_file)
+        if defined? Sinatra::Application
+          Sinatra::Application.set :reload, false
+          Sinatra::Application.set :logging, false
+          Sinatra::Application.set :raise_errors, true
+          Sinatra::Application
+        else
+          Object.const_get(camel_case(File.basename(rackup_file, '.rb')))
+        end
+      end
+    end
+
+    def camel_case(string)
+      string.split("_").map { |part| part.capitalize }.join
+    end
+
+    def spec_body(body)
+      if body.respond_to? :to_str
+        [body]
+      elsif body.respond_to?(:each)
+        body
+      else
+        fail "body must respond to #each"
+      end
+    end
+  end
+end

data/lib/notgun/static.rb

@@ -0,0 +1,20 @@
+require 'rack/file'
+
+module Notgun
+  # Serves static files out of the specified directory.
+  class Static
+    def initialize(app, public_dir='./public')
+      @file = Rack::File.new(public_dir)
+      @app = app
+    end
+
+    def call(env)
+      status, headers, body = @file.call(env)
+      if status > 400
+        @app.call(env)
+      else
+        [status, headers, body]
+      end
+    end
+  end
+end

data/man/index.txt

@@ -0,0 +1,6 @@
+ruby(1)    http://man.cx/ruby
+
+# other resources
+rack       http://rack.rubyforge.org/doc/README.html
+rack-spec  http://rack.rubyforge.org/doc/SPEC.html
+sinatra    http://www.sinatrarb.com/

data/man/notgun.1

@@ -0,0 +1,231 @@
+.\" generated with Ronn/v0.7.3
+.\" http://github.com/rtomayko/ronn/tree/0.7.3
+.
+.TH "SHOTGUN" "1" "March 2015" "Notgun 0.9.1" ""
+.
+.SH "NAME"
+\fBnotgun\fR \- reloading rack development server
+.
+.SH "SYNOPSIS"
+\fBnotgun\fR [\fIoptions\fR] [\fIrackup\-file\fR]
+.
+.SH "DESCRIPTION"
+\fBNotgun\fR is a simple process\-per\-request Rack \fIhttp://rack\.rubyforge\.org/doc/README\.html\fR server designed for use in development environments\. Each time a request is received, \fBnotgun\fR forks, loads the \fIrackup\-file\fR, processes a single request and exits\. The result is application\-wide reloading of all configuration, source files, and templates without the need for complex application\-level reloading logic\.
+.
+.P
+When no \fIrackup\-file\fR is given, \fBnotgun\fR uses the \fBconfig\.ru\fR file in the current working directory\.
+.
+.SH "OPTIONS"
+Notgun runs at \fBhttp://127\.0\.0\.1:9393\fR by default\. The following options control server behavior:
+.
+.TP
+\fB\-E\fR, \fB\-\-env\fR=\fIenvironment\fR
+Sets the \fBRACK_ENV\fR environment variable to \fIenvironment\fR and selects the default set of utility middleware\. When \fIenvironment\fR is \'development\', notgun inserts the \fBRack::Lint\fR and \fBRack::CommonLogger\fR middleware components; when \fIenvironment\fR is \'production\' or \'deployed\', \fBRack::CommonLogger\fR is inserted; otherwise, no utility middleware are inserted\.
+.
+.TP
+\fB\-P\fR, \fB\-\-public\fR=\fIpath\fR
+Serve requests for static files that exist under \fIpath\fR from the notgun master process without forking a worker process\. This option is automatically enabled when a \fB\./public\fR directory is detected, but can be configured explicitly for non\-conventional static file directory locations\.
+.
+.IP
+Setting this option appropriately can severely improve overall page load times for applications with many static assets\.
+.
+.TP
+\fB\-s\fR, \fB\-\-server\fR=\fImongrel\fR|\fIwebrick\fR|\fIthin\fR|\fIother\fR
+The Rack server handler implementation used to serve requests\. Supported values include: \fBmongrel\fR, \fBwebrick\fR, and \fBthin\fR\. By default, notgun first tries to use \fBmongrel\fR and falls back to \fBwebrick\fR if mongrel is not available\.
+.
+.TP
+\fB\-o\fR, \fB\-\-host\fR=\fIaddr\fR
+The hostname or address of the interface the HTTP server should bind to\. Overrides the \fBHOST\fR environment variable\. Default: \fB127\.0\.0\.1\fR\.
+.
+.TP
+\fB\-p\fR, \fB\-\-port\fR=\fIport\fR
+The port the HTTP server should bind to\. Overrides the \fBPORT\fR environment variable\. Default: \fB9393\fR\.
+.
+.TP
+\fB\-O\fR, \fB\-\-browse\fR
+Open browser at http://\fIhost\fR:\fIport\fR/ immediately after the server is started\.
+.
+.P
+Ruby environment related options:
+.
+.TP
+\fB\-r\fR, \fB\-\-require\fR \fIlibrary\fR
+Require \fIlibrary\fR before loading the application and starting the server\. This can be used to load a portion of the application code in the master process so it doesn\'t need to be loaded in the child\. See \fIPRELOADING\fR][] for more information on this approach\.
+.
+.TP
+\fB\-e\fR, \fB\-\-eval\fR \fIcommand\fR
+Evaluate arbitrary \fIcommand\fR within the notgun master Ruby interpreter\. \fIcommand\fR is evaluated as program arguments are parsed\. Multiple \fB\-e\fR arguments are allowed\.
+.
+.TP
+\fB\-d\fR, \fB\-\-debug\fR
+Turns on debug mode\. \fB$DEBUG\fR will be set \fBtrue\fR\.
+.
+.TP
+\fB\-w\fR, \fB\-\-warn\fR
+Enable verbose mode without printing version message at the beginning\. It sets the \fB$VERBOSE\fR variable to true\.
+.
+.TP
+\fB\-I\fR, \fB\-\-include\fR \fIpath\fR
+Add \fIpath\fR to the Ruby load path (\fB$LOAD_PATH\fR)\. May be used more than once\.
+.
+.P
+Miscellaneous:
+.
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Show usage message and exit\.
+.
+.TP
+\fB\-\-version\fR
+Show the Rack version and exit\.
+.
+.SH "ENVIRONMENT"
+The following environment variables affect the configuration of \fBnotgun\fR:
+.
+.TP
+\fBHOST\fR
+The hostname or address of the interface the HTTP server should bind to\. See the \fB\-h\fR option\.
+.
+.TP
+\fBPORT\fR
+The port the HTTP server should bind to\. See the \fB\-p\fR option\.
+.
+.SH "PRELOADING"
+It\'s possible to load support libraries and portions of the application in the notgun master process to reduce the amount of work that needs to be done for each request in worker processes\. There\'s two ways of accomplishing this: either by specifying one or more \fB\-\-require\fR (\fB\-r\fR) arguments or through the use of a \fBnotgun\.rb\fR file\.
+.
+.P
+During start up, notgun looks for a \fBnotgun\.rb\fR or \fBconfig/notgun\.rb\fR file\. If either file is found, it\'s loaded into the notgun master process\. Code at the top\-level of the \fBnotgun\.rb\fR is run once on startup, so just require whatever you want to preload\. It\'s also possible to register callbacks to run before each request in either the master or child worker process:
+.
+.TP
+\fBafter_fork {\fR \fIstuff\fR \fB}\fR
+Run \fIstuff\fR in the notgun child worker process immediately after forking\. Any files or socket connections opened in the master process should be closed / re\-established by an \fBafter_fork\fR block\.
+.
+.TP
+\fBbefore_fork {\fR \fIstuff\fR \fB}\fR
+Run \fIstuff\fR in the notgun master process on each request before forking the child worker process\. This is typically less useful than \fBafter_fork\fR, but provided for completeness\.
+.
+.P
+Example \fBconfig/notgun\.rb\fR file from the main github\.com rails project:
+.
+.IP "" 4
+.
+.nf
+
+# make sure the load path includes RAILS_ROOT
+ENV[\'RAILS_ROOT\'] ||= File\.expand_path(\'\.\./\.\.\', __FILE__)
+$:\.unshift ENV[\'RAILS_ROOT\']
+
+# bring in the base rails environment and some libraries
+require \'config/environment\'
+require \'google\-charts\'
+require \'aws\-s3\'
+
+# disable Rails\'s built in class reloading
+Rails\.configuration\.cache_classes = true
+
+# reset database and redis connections in workers
+after_fork do
+  ActiveRecord::Base\.establish_connection
+  CHIMNEY\.client = $redis
+end
+.
+.fi
+.
+.IP "" 0
+.
+.SH "INSTALLING"
+Notgun is distributed as a gem package at rubygems\.org:
+.
+.P
+\fIhttp://rubygems\.org/gems/notgun\fR
+.
+.br
+\fBgem install notgun\fR
+.
+.P
+The \fBrack\fR package is required\. The \fBmongrel\fR package is recommended\.
+.
+.SH "CONTRIBUTING"
+Fork and report issues at github\.com:
+.
+.P
+\fIhttp://github\.com/rtomayko/notgun/\fR
+.
+.br
+\fBgit clone git://github\.com/rtomayko/notgun\.git\fR
+.
+.SH "VERSION HISTORY"
+.
+.SS "Version 0\.9\.1 (2015 March 1)"
+.
+.IP "\(bu" 4
+Fix a long\-standing issue that caused Notgun not to show any access logs in the terminal (#57)\.
+.
+.IP "\(bu" 4
+Make \fB\-\-url\fR option actually work\.
+.
+.IP "" 0
+.
+.SS "Version 0\.9 (2011 February 24)"
+.
+.IP "\(bu" 4
+\fIhttp://github\.com/rtomayko/notgun/compare/0\.8\.\.\.0\.9\fR
+.
+.IP "\(bu" 4
+Various Ruby 1\.9\.2 fixes\.
+.
+.IP "\(bu" 4
+Handle application class names consisting of multiple words\.
+.
+.IP "" 0
+.
+.SS "Version 0\.8 (2010 June 24)"
+.
+.IP "\(bu" 4
+\fIhttp://github\.com/rtomayko/notgun/compare/0\.7\.\.\.0\.8\fR
+.
+.IP "\(bu" 4
+Preloading support\. The \fBnotgun\.rb\fR or \fBconfig/notgun\.rb\fR file is loaded at startup and may require libraries and register callbacks for fork events\. See the section on \fIPRELOADING\fR\.
+.
+.IP "\(bu" 4
+Fix starting with the Thin handler (\fBnotgun \-s thin\fR)
+.
+.IP "\(bu" 4
+Actually include the notgun(1) roff manual\.
+.
+.IP "" 0
+.
+.SS "Version 0\.7 (2010 June 22)"
+.
+.IP "\(bu" 4
+\fIhttp://github\.com/rtomayko/notgun/compare/0\.6\.\.\.0\.7\fR
+.
+.IP "\(bu" 4
+Static files now served from the notgun master process, making notgun tolerable for apps with many/unbundled static assets\.
+.
+.IP "\(bu" 4
+Added \fB\-\-public\fR (\fB\-P\fR) for specifying a non\-standard root / public directory\.
+.
+.IP "\(bu" 4
+Response bodies are now streamed over the master < worker pipe instead of being marshalled\. Improves performance with large response bodies, and reduces notgun master process RES usage\.
+.
+.IP "\(bu" 4
+GET /favicon\.ico requests are served an empty response by the notgun master process\. Prevents the need to fork a worker process\.
+.
+.IP "\(bu" 4
+\fBINT\fR, \fBTERM\fR, \fBQUIT\fR now properly trigger server shutdown\. The second \fBINT\fR, \fBTERM\fR, \fBQUIT\fR causes the master process to exit hard\.
+.
+.IP "\(bu" 4
+Non \fB\.ru\fR config files (e\.g\., sinatra app files) may now define command line options in the same way as \fB\.ru\fR files: by including a \fB#\e \-p 5555 \.\.\.\fR line\.
+.
+.IP "" 0
+.
+.SS "Versions < 0\.7 (2009\-2010)"
+.
+.IP "\(bu" 4
+\fIhttp://github\.com/rtomayko/notgun/commits/0\.6\fR
+.
+.IP "" 0
+.
+.SH "SEE ALSO"
+ruby(1)

data/man/notgun.1.ronn

@@ -0,0 +1,220 @@
+notgun(1) -- reloading rack development server
+===============================================
+
+## SYNOPSIS
+
+`notgun` [<options>] [<rackup-file>]
+
+## DESCRIPTION
+
+**Notgun** is a simple process-per-request [Rack][] server designed for use in
+development environments. Each time a request is received, `notgun` forks,
+loads the <rackup-file>, processes a single request and exits.  The result is
+application-wide reloading of all configuration, source files, and templates
+without the need for complex application-level reloading logic.
+
+When no <rackup-file> is given, `notgun` uses the `config.ru` file in the
+current working directory.
+
+## OPTIONS
+
+Notgun runs at `http://127.0.0.1:9393` by default. The following options
+control server behavior:
+
+ * `-E`, `--env`=<environment>:
+   Sets the `RACK_ENV` environment variable to <environment> and selects
+   the default set of utility middleware. When <environment> is 'development',
+   notgun inserts the `Rack::Lint` and `Rack::CommonLogger` middleware
+   components; when <environment> is 'production' or 'deployed',
+   `Rack::CommonLogger` is inserted; otherwise, no utility middleware are
+   inserted.
+
+ * `-P`, `--public`=<path>:
+   Serve requests for static files that exist under <path> from the notgun
+   master process without forking a worker process. This option is
+   automatically enabled when a `./public` directory is detected, but can be
+   configured explicitly for non-conventional static file directory locations.
+
+   Setting this option appropriately can severely improve overall page load
+   times for applications with many static assets.
+
+ * `-s`, `--server`=<mongrel>|<webrick>|<thin>|<other>:
+   The Rack server handler implementation used to serve requests. Supported
+   values include: `mongrel`, `webrick`, and `thin`. By default, notgun first
+   tries to use `mongrel` and falls back to `webrick` if mongrel is not
+   available.
+
+ * `-o`, `--host`=<addr>:
+   The hostname or address of the interface the HTTP server should bind to.
+   Overrides the `HOST` environment variable. Default: `127.0.0.1`.
+
+ * `-p`, `--port`=<port>:
+   The port the HTTP server should bind to. Overrides the `PORT` environment
+   variable. Default: `9393`.
+
+ * `-O`, `--browse`:
+   Open browser at http://<host>:<port>/ immediately after the server
+   is started.
+
+Ruby environment related options:
+
+ * `-r`, `--require` <library>:
+   Require <library> before loading the application and starting the server.
+   This can be used to load a portion of the application code in the master
+   process so it doesn't need to be loaded in the child. See [PRELOADING]][]
+   for more information on this approach.
+
+ * `-e`, `--eval` <command>:
+   Evaluate arbitrary <command> within the notgun master Ruby interpreter.
+   <command> is evaluated as program arguments are parsed. Multiple `-e`
+   arguments are allowed.
+
+ * `-d`, `--debug`:
+   Turns on debug mode. `$DEBUG` will be set `true`.
+
+ * `-w`, `--warn`:
+   Enable verbose mode without printing version message at the beginning. It
+   sets the `$VERBOSE` variable to true.
+
+ * `-I`, `--include` <path>:
+   Add <path> to the Ruby load path (`$LOAD_PATH`). May be used more than once.
+
+Miscellaneous:
+
+ * `-h`, `--help`:
+   Show usage message and exit.
+
+ * `--version`:
+   Show the Rack version and exit.
+
+## ENVIRONMENT
+
+The following environment variables affect the configuration of `notgun`:
+
+ * `HOST`:
+  The hostname or address of the interface the HTTP server should bind to. See
+  the `-h` option.
+
+ * `PORT`:
+   The port the HTTP server should bind to. See the `-p` option.
+
+## PRELOADING
+
+It's possible to load support libraries and portions of the application in the
+notgun master process to reduce the amount of work that needs to be done for
+each request in worker processes. There's two ways of accomplishing this: either
+by specifying one or more `--require` (`-r`) arguments or through the use of a
+`notgun.rb` file.
+
+During start up, notgun looks for a `notgun.rb` or `config/notgun.rb` file.
+If either file is found, it's loaded into the notgun master process. Code at
+the top-level of the `notgun.rb` is run once on startup, so just require
+whatever you want to preload. It's also possible to register callbacks to run
+before each request in either the master or child worker process:
+
+  * `after_fork {` <stuff> `}`:
+    Run <stuff> in the notgun child worker process immediately after forking.
+    Any files or socket connections opened in the master process should be
+    closed / re-established by an `after_fork` block.
+
+  * `before_fork {` <stuff> `}`:
+    Run <stuff> in the notgun master process on each request before forking
+    the child worker process. This is typically less useful than `after_fork`,
+    but provided for completeness.
+
+Example `config/notgun.rb` file from the main github.com rails project:
+
+    # make sure the load path includes RAILS_ROOT
+    ENV['RAILS_ROOT'] ||= File.expand_path('../..', __FILE__)
+    $:.unshift ENV['RAILS_ROOT']
+
+    # bring in the base rails environment and some libraries
+    require 'config/environment'
+    require 'google-charts'
+    require 'aws-s3'
+
+    # disable Rails's built in class reloading
+    Rails.configuration.cache_classes = true
+
+    # reset database and redis connections in workers
+    after_fork do
+      ActiveRecord::Base.establish_connection
+      CHIMNEY.client = $redis
+    end
+
+## INSTALLING
+
+Notgun is distributed as a gem package at rubygems.org:
+
+<http://rubygems.org/gems/notgun><br>
+`gem install notgun`
+
+The `rack` package is required. The `mongrel` package is recommended.
+
+## CONTRIBUTING
+
+Fork and report issues at github.com:
+
+<http://github.com/rtomayko/notgun/><br>
+`git clone git://github.com/rtomayko/notgun.git`
+
+## VERSION HISTORY
+
+### Version 0.9.1 (2015 March 1)
+
+ * Fix a long-standing issue that caused Notgun not to show any access logs
+   in the terminal (#57).
+
+ * Make `--url` option actually work.
+
+### Version 0.9 (2011 February 24)
+
+ * <http://github.com/rtomayko/notgun/compare/0.8...0.9>
+
+ * Various Ruby 1.9.2 fixes.
+
+ * Handle application class names consisting of multiple words.
+
+### Version 0.8 (2010 June 24)
+
+ * <http://github.com/rtomayko/notgun/compare/0.7...0.8>
+
+ * Preloading support. The `notgun.rb` or `config/notgun.rb` file is
+   loaded at startup and may require libraries and register callbacks
+   for fork events. See the section on [PRELOADING][].
+
+ * Fix starting with the Thin handler (`notgun -s thin`)
+
+ * Actually include the notgun(1) roff manual.
+
+### Version 0.7 (2010 June 22)
+
+ * <http://github.com/rtomayko/notgun/compare/0.6...0.7>
+
+ * Static files now served from the notgun master process, making
+   notgun tolerable for apps with many/unbundled static assets.
+
+ * Added `--public` (`-P`) for specifying a non-standard root / public
+   directory.
+
+ * Response bodies are now streamed over the master &lt; worker pipe
+   instead of being marshalled. Improves performance with large response
+   bodies, and reduces notgun master process RES usage.
+
+ * GET /favicon.ico requests are served an empty response by the notgun
+   master process. Prevents the need to fork a worker process.
+
+ * `INT`, `TERM`, `QUIT` now properly trigger server shutdown. The second
+   `INT`, `TERM`, `QUIT` causes the master process to exit hard.
+
+ * Non `.ru` config files (e.g., sinatra app files) may now define command
+   line options in the same way as `.ru` files: by including a
+   `#\ -p 5555 ...` line.
+
+### Versions &lt; 0.7 (2009-2010)
+
+ * <http://github.com/rtomayko/notgun/commits/0.6>
+
+## SEE ALSO
+
+ruby(1)

data/notgun.gemspec

@@ -0,0 +1,23 @@
+Gem::Specification.new do |s|
+  s.name = 'notgun'
+  s.version = '0.9.2'
+
+  s.description = "Reloading Rack development server (Shotgun fork with Rack 2.0+ support)"
+  s.summary     = s.description
+
+  s.license = "MIT"
+
+  s.authors = ["Ryan Tomayko"]
+  s.email = "rtomayko@gmail.com"
+
+  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.add_dependency 'rack',    '>= 1.0'
+
+  s.add_development_dependency 'rake'
+  s.add_development_dependency 'test-unit'
+
+  s.homepage = "https://github.com/timriley/notgun"
+end

data/test/big.ru

@@ -0,0 +1,15 @@
+class BigResponse
+  def call(env)
+    [200, {'Content-Type'=>'text/html'}, self]
+  end
+
+  def each
+    yield "<pre>"
+    1024.times do
+      yield(('.' * 1023) + "\n")
+    end
+    yield "</pre>"
+  end
+end
+
+run BigResponse.new

data/test/boom.ru

@@ -0,0 +1,4 @@
+require 'rack'
+
+use Rack::Lock
+run lambda { |env| fail 'boom' }

data/test/slow.ru

@@ -0,0 +1,16 @@
+class SlowResponse
+  def call(env)
+    [200, {'Content-Type'=>'text/html'}, self]
+  end
+
+  def each
+    yield "<pre>"
+    10.times do
+      yield(('.' * 10) + "\n")
+      sleep 0.5
+    end
+    yield "</pre>"
+  end
+end
+
+run SlowResponse.new

data/test/test-sinatra.ru

@@ -0,0 +1,14 @@
+require 'sinatra'
+
+set :logging, false
+
+get '/' do
+  puts 'hello world'
+  "Hello World"
+end
+
+get '/boom' do
+  fail 'boom'
+end
+
+run Sinatra::Application

data/test/test.ru

@@ -0,0 +1,7 @@
+require 'rack'
+
+app = lambda { |env|
+  [200, {'Content-Type'=>'text/plain'}, ['BANG!']] }
+
+use Rack::ContentLength
+run app

data/test/test_notgun_loader.rb

@@ -0,0 +1,50 @@
+require 'test/unit'
+require 'rack/mock'
+require 'notgun'
+
+class NotgunLoaderTest < Test::Unit::TestCase
+  def rackup_file(name)
+    "#{File.dirname(__FILE__)}/#{name}"
+  end
+
+  def test_knows_the_rackup_file
+    file = rackup_file('test.ru')
+    notgun = Notgun::Loader.new(file)
+    assert_equal file, notgun.rackup_file
+  end
+
+  def test_processes_requests
+    file = rackup_file('test.ru')
+    notgun = Notgun::Loader.new(file)
+    request = Rack::MockRequest.new(notgun)
+    res = request.get("/")
+    assert_equal 200, res.status
+    assert_equal "BANG!", res.body
+    assert_equal "text/plain", res.headers['Content-Type']
+  end
+
+  def test_processes_large_requests
+    file = rackup_file('big.ru')
+    notgun = Notgun::Loader.new(file)
+    request = Rack::MockRequest.new(notgun)
+    res = request.get("/")
+    assert_equal 200, res.status
+    assert res.body =~ %r|<pre>(?:.{1023}\n){1024}</pre>|,
+      "body of size #{res.body.size} does not match expected output"
+  end
+
+  def test_logging
+    file = rackup_file('verbose.ru')
+
+    $logger = File.open('test/verbose.log', 'w')
+    $logger.sync = true
+
+    notgun = Notgun::Loader.new(file)
+    request = Rack::MockRequest.new(notgun)
+    request.get('/', 'REMOTE_ADDR' => 'foo.local')
+
+    $logger.close
+
+    assert_match /^foo.local/, File.read('test/verbose.log')
+  end
+end

data/test/test_notgun_static.rb

@@ -0,0 +1,26 @@
+require 'test/unit'
+require 'rack/mock'
+require 'notgun'
+
+class NotgunStaticTest < Test::Unit::TestCase
+  def setup
+    @app = lambda { |env| [200,{'Content-Type'=>'text/plain'}, ['holla']] }
+    @public = File.dirname(__FILE__)
+  end
+
+  def test_serving_files
+    static = Notgun::Static.new(@app, @public)
+    request = Rack::MockRequest.new(static)
+    res = request.get("/big.ru")
+    assert_equal 200, res.status
+    assert_equal File.size("#{@public}/big.ru"), res.body.size
+  end
+
+  def test_cascading_when_file_not_found
+    static = Notgun::Static.new(@app, @public)
+    request = Rack::MockRequest.new(static)
+    res = request.get("/does-not-exist")
+    assert_equal 200, res.status
+    assert_equal 'holla', res.body
+  end
+end

data/test/verbose.ru

@@ -0,0 +1,7 @@
+require 'rack'
+
+app = lambda { |env|
+  [200, {'Content-Type'=>'text/plain'}, ['BANG!']] }
+
+use Rack::CommonLogger, $logger
+run app

metadata

@@ -0,0 +1,118 @@
+--- !ruby/object:Gem::Specification
+name: notgun
+version: !ruby/object:Gem::Version
+  version: 0.9.2
+platform: ruby
+authors:
+- Ryan Tomayko
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-08-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: test-unit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Reloading Rack development server (Shotgun fork with Rack 2.0+ support)
+email: rtomayko@gmail.com
+executables:
+- notgun
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- CHANGELOG.md
+- Gemfile
+- LICENSE
+- README.md
+- RELEASING
+- Rakefile
+- bin/notgun
+- lib/notgun.rb
+- lib/notgun/favicon.rb
+- lib/notgun/loader.rb
+- lib/notgun/static.rb
+- man/index.txt
+- man/notgun.1
+- man/notgun.1.ronn
+- notgun.gemspec
+- test/big.ru
+- test/boom.ru
+- test/slow.ru
+- test/test-sinatra.ru
+- test/test.ru
+- test/test_notgun_loader.rb
+- test/test_notgun_static.rb
+- test/verbose.ru
+homepage: https://github.com/timriley/notgun
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Reloading Rack development server (Shotgun fork with Rack 2.0+ support)
+test_files:
+- test/big.ru
+- test/boom.ru
+- test/slow.ru
+- test/test-sinatra.ru
+- test/test.ru
+- test/test_notgun_loader.rb
+- test/test_notgun_static.rb
+- test/verbose.ru