Sha256: f01e9080b11f6408741fe36b56f853bb4f67572e9b526bc0b4548ecea146d2a2

Contents?: true

Size: 1.36 KB

Versions: 22

Compression:

Stored size: 1.36 KB

Contents

                                    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:

    gem install shotgun

Starting a server with a rackup file:

    shotgun config.ru

Using Thin and starting on port 6000 instead of 9393 (default):

    shotgun --server=thin --port=6000 config.ru

Running Sinatra apps:

    shotgun hello.rb

See 'shotgun --help' for more advanced usage.

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

Version data entries

22 entries across 21 versions & 3 rubygems

Version Path
shotgun-0.9 README
shotgun-0.8 README
shotgun-0.7 README
middleman-0.13.1 lib/middleman/vendor/gems/ruby/1.9.1/gems/shotgun-0.5/README
middleman-0.13.1 lib/middleman/vendor/gems/ruby/1.8/gems/shotgun-0.6/README
shotgun-0.6 README
shotgun-0.5 README
tommygun-0.4.01 README
tommygun-0.4 README
middleman-0.12.2 lib/middleman/vendor/gems/gems/shotgun-0.4/README
middleman-0.12.1 lib/middleman/vendor/gems/gems/shotgun-0.4/README
middleman-0.12.0.pre3 lib/middleman/vendor/gems/gems/shotgun-0.4/README
middleman-0.12.0.pre2 lib/middleman/vendor/gems/gems/shotgun-0.4/README
middleman-0.12.0.pre lib/middleman/vendor/gems/gems/shotgun-0.4/README
middleman-0.10.17 vendor/gems/gems/shotgun-0.4/README
middleman-0.10.16 vendor/gems/gems/shotgun-0.4/README
middleman-0.10.15 vendor/gems/gems/shotgun-0.4/README
middleman-0.10.14 vendor/gems/gems/shotgun-0.4/README
shotgun-0.4 README
shotgun-0.1 README