preplay_unicorn 4.3.1.2.gc450

data/man/man1/unicorn_rails.1

@@ -0,0 +1,208 @@
+.TH UNICORN_RAILS 1 "September 17, 2009" "Unicorn User Manual"
+.SH NAME
+.PP
+unicorn_rails - a script/server-like command to launch the Unicorn HTTP
+server
+.SH SYNOPSIS
+.PP
+unicorn_rails [-c CONFIG_FILE] [-E RAILS_ENV] [-D] [RACKUP_FILE]
+.SH DESCRIPTION
+.PP
+A rackup(1)-like command to launch Rails applications using Unicorn.
+It is expected to be started in your Rails application root
+(RAILS_ROOT), but the "working_directory" directive may be used in the
+CONFIG_FILE.
+.PP
+It is designed to help Rails 1.x and 2.y users transition to Rack, but
+it is NOT needed for Rails 3 applications.
+Rails 3 users are encouraged to use unicorn(1) instead of
+unicorn_rails(1).
+Users of Rails 1.x/2.y may also use unicorn(1) instead of
+unicorn_rails(1).
+.PP
+The outward interface resembles rackup(1), the internals and default
+middleware loading is designed like the \f[C]script/server\f[] command
+distributed with Rails.
+.PP
+While Unicorn takes a myriad of command-line options for compatibility
+with ruby(1) and rackup(1), it is recommended to stick to the few
+command-line options specified in the SYNOPSIS and use the CONFIG_FILE
+as much as possible.
+.SH UNICORN OPTIONS
+.TP
+.B -c, --config-file CONFIG_FILE
+Path to the Unicorn-specific config file.
+The config file is implemented as a Ruby DSL, so Ruby code may executed.
+See the RDoc/ri for the \f[I]Unicorn::Configurator\f[] class for the
+full list of directives available from the DSL.
+Using an absolute path for for CONFIG_FILE is recommended as it makes
+multiple instances of Unicorn easily distinguishable when viewing ps(1)
+output.
+.RS
+.RE
+.TP
+.B -D, --daemonize
+Run daemonized in the background.
+The process is detached from the controlling terminal and stdin is
+redirected to "/dev/null".
+Unlike many common UNIX daemons, we do not chdir to "/" upon
+daemonization to allow more control over the startup/upgrade process.
+Unless specified in the CONFIG_FILE, stderr and stdout will also be
+redirected to "/dev/null".
+Daemonization will \f[I]skip\f[] loading of the
+\f[I]Rails::Rack::LogTailer\f[] middleware under Rails >= 2.3.x.
+By default, unicorn_rails(1) will create a PID file in
+\f[I]"RAILS_ROOT/tmp/pids/unicorn.pid"\f[].
+You may override this by specifying the "pid" directive to override this
+Unicorn config file.
+.RS
+.RE
+.TP
+.B -E, --env RAILS_ENV
+Run under the given RAILS_ENV.
+This sets the RAILS_ENV environment variable.
+Acceptable values are exactly those you expect in your Rails
+application, typically "development" or "production".
+.RS
+.RE
+.TP
+.B -l, --listen ADDRESS
+Listens on a given ADDRESS.
+ADDRESS may be in the form of HOST:PORT or PATH, HOST:PORT is taken to
+mean a TCP socket and PATH is meant to be a path to a UNIX domain
+socket.
+Defaults to "0.0.0.0:8080" (all addresses on TCP port 8080).
+For production deployments, specifying the "listen" directive in
+CONFIG_FILE is recommended as it allows fine-tuning of socket options.
+.RS
+.RE
+.SH RACKUP COMPATIBILITY OPTIONS
+.TP
+.B -o, --host HOST
+Listen on a TCP socket belonging to HOST, default is "0.0.0.0" (all
+addresses).
+If specified multiple times on the command-line, only the last-specified
+value takes effect.
+This option only exists for compatibility with the rackup(1) command,
+use of "-l"/"--listen" switch is recommended instead.
+.RS
+.RE
+.TP
+.B -p, --port PORT
+Listen on the specified TCP PORT, default is 8080.
+If specified multiple times on the command-line, only the last-specified
+value takes effect.
+This option only exists for compatibility with the rackup(1) command,
+use of "-l"/"--listen" switch is recommended instead.
+.RS
+.RE
+.TP
+.B --path PATH
+Mounts the Rails application at the given PATH (instead of "/").
+This is equivalent to setting the RAILS_RELATIVE_URL_ROOT environment
+variable.
+This is only supported under Rails 2.3 or later at the moment.
+.RS
+.RE
+.SH RUBY OPTIONS
+.TP
+.B -e, --eval LINE
+Evaluate a LINE of Ruby code.
+This evaluation happens immediately as the command-line is being parsed.
+.RS
+.RE
+.TP
+.B -d, --debug
+Turn on debug mode, the $DEBUG variable is set to true.
+For Rails >= 2.3.x, this loads the \f[I]Rails::Rack::Debugger\f[]
+middleware.
+.RS
+.RE
+.TP
+.B -w, --warn
+Turn on verbose warnings, the $VERBOSE variable is set to true.
+.RS
+.RE
+.TP
+.B -I, --include PATH
+specify $LOAD_PATH.
+PATH will be prepended to $LOAD_PATH.
+The \[aq]:\[aq] character may be used to delimit multiple directories.
+This directive may be used more than once.
+Modifications to $LOAD_PATH take place immediately and in the order they
+were specified on the command-line.
+.RS
+.RE
+.TP
+.B -r, --require LIBRARY
+require a specified LIBRARY before executing the application.
+The "require" statement will be executed immediately and in the order
+they were specified on the command-line.
+.RS
+.RE
+.SH RACKUP FILE
+.PP
+This defaults to "config.ru" in RAILS_ROOT.
+It should be the same file used by rackup(1) and other Rack launchers,
+it uses the \f[I]Rack::Builder\f[] DSL.
+Unlike many other Rack applications, RACKUP_FILE is completely
+\f[I]optional\f[] for Rails, but may be used to disable some of the
+default middleware for performance.
+.PP
+Embedded command-line options are mostly parsed for compatibility with
+rackup(1) but strongly discouraged.
+.SH ENVIRONMENT VARIABLES
+.PP
+The RAILS_ENV variable is set by the aforementioned -E switch.
+The RAILS_RELATIVE_URL_ROOT is set by the aforementioned --path switch.
+Either of these variables may also be set in the shell or the Unicorn
+CONFIG_FILE.
+All application or library-specific environment variables (e.g.
+TMPDIR, RAILS_ASSET_ID) may always be set in the Unicorn CONFIG_FILE in
+addition to the spawning shell.
+When transparently upgrading Unicorn, all environment variables set in
+the old master process are inherited by the new master process.
+Unicorn only uses (and will overwrite) the UNICORN_FD environment
+variable internally when doing transparent upgrades.
+.SH SIGNALS
+.PP
+The following UNIX signals may be sent to the master process:
+.IP \[bu] 2
+HUP - reload config file, app, and gracefully restart all workers
+.IP \[bu] 2
+INT/TERM - quick shutdown, kills all workers immediately
+.IP \[bu] 2
+QUIT - graceful shutdown, waits for workers to finish their current
+request before finishing.
+.IP \[bu] 2
+USR1 - reopen all logs owned by the master and all workers See
+Unicorn::Util.reopen_logs for what is considered a log.
+.IP \[bu] 2
+USR2 - reexecute the running binary.
+A separate QUIT should be sent to the original process once the child is
+verified to be up and running.
+.IP \[bu] 2
+WINCH - gracefully stops workers but keep the master running.
+This will only work for daemonized processes.
+.IP \[bu] 2
+TTIN - increment the number of worker processes by one
+.IP \[bu] 2
+TTOU - decrement the number of worker processes by one
+.PP
+See the SIGNALS (http://unicorn.bogomips.org/SIGNALS.html) document for
+full description of all signals used by Unicorn.
+.SH SEE ALSO
+.IP \[bu] 2
+unicorn(1)
+.IP \[bu] 2
+\f[I]Rack::Builder\f[] ri/RDoc
+.IP \[bu] 2
+\f[I]Unicorn::Configurator\f[] ri/RDoc
+.IP \[bu] 2
+Unicorn RDoc (http://unicorn.bogomips.org/)
+.IP \[bu] 2
+Rack RDoc (http://rack.rubyforge.org/doc/)
+.IP \[bu] 2
+Rackup HowTo (http://wiki.github.com/rack/rack/tutorial-rackup-howto)
+.SH AUTHORS
+The Unicorn Community <mongrel-unicorn@rubyforge.org>.

data/preplay_unicorn.gemspec

@@ -0,0 +1,44 @@
+# -*- encoding: binary -*-
+ENV["VERSION"] or abort "VERSION= must be specified"
+manifest = File.readlines('.manifest').map! { |x| x.chomp! }
+require 'wrongdoc'
+extend Wrongdoc::Gemspec
+name, summary, title = readme_metadata
+
+# don't bother with tests that fork, not worth our time to get working
+# with `gem check -t` ... (of course we care for them when testing with
+# GNU make when they can run in parallel)
+test_files = manifest.grep(%r{\Atest/unit/test_.*\.rb\z}).map do |f|
+  File.readlines(f).grep(/\bfork\b/).empty? ? f : nil
+end.compact
+
+Gem::Specification.new do |s|
+  s.name = %q{preplay_unicorn}
+  s.version = ENV["VERSION"].dup
+  s.authors = ["#{name} hackers"]
+  s.summary = summary
+  s.date = Time.now.utc.strftime('%Y-%m-%d')
+  s.description = readme_description
+  s.email = %q{mongrel-unicorn@rubyforge.org}
+  s.executables = %w(unicorn unicorn_rails)
+  s.extensions = %w(ext/unicorn_http/extconf.rb)
+  s.extra_rdoc_files = extra_rdoc_files(manifest)
+  s.files = manifest
+  s.homepage = Wrongdoc.config[:rdoc_url]
+  s.rdoc_options = rdoc_options
+  s.rubyforge_project = %q{mongrel}
+  s.test_files = test_files
+
+  # for people that are absolutely stuck on Rails 2.3.2 and can't
+  # up/downgrade to any other version, the Rack dependency may be
+  # commented out.  Nevertheless, upgrading to Rails 2.3.4 or later is
+  # *strongly* recommended for security reasons.
+  s.add_dependency(%q<rack>)
+  s.add_dependency(%q<kgio>, '~> 2.6')
+  s.add_dependency(%q<raindrops>, '~> 0.7')
+
+  s.add_development_dependency('isolate', '~> 3.2')
+  s.add_development_dependency('wrongdoc', '~> 1.6.1')
+
+  # s.licenses = %w(GPLv2 Ruby) # licenses= method is not in older RubyGems
+end

data/script/isolate_for_tests

@@ -0,0 +1,50 @@
+#!/usr/bin/env ruby
+# scripts/Makefiles can read and eval the output of this script and
+# use it as RUBYLIB
+require 'rubygems'
+require 'isolate'
+fp = File.open(__FILE__, "rb")
+fp.flock(File::LOCK_EX)
+
+ruby_engine = defined?(RUBY_ENGINE) ? RUBY_ENGINE : 'ruby'
+opts = {
+  :system => false,
+  # we want "ruby-1.8.7" and not "ruby-1.8", so disable :multiruby
+  :multiruby => false,
+  :path => "tmp/isolate/#{ruby_engine}-#{RUBY_VERSION}",
+}
+
+pid = fork do
+  Isolate.now!(opts) do
+    if RUBY_VERSION.to_f < 2.0
+      gem 'sqlite3-ruby', '1.2.5'
+    end
+    gem 'raindrops', '0.8.0'
+    gem 'kgio-monkey', '0.4.0'
+    gem 'kgio', '2.7.4'
+    gem 'rack', '1.4.1'
+  end
+end
+_, status = Process.waitpid2(pid)
+status.success? or abort status.inspect
+lib_paths = Dir["#{opts[:path]}/gems/*-*/lib"].map { |x| File.expand_path(x) }
+dst = "tmp/isolate/#{ruby_engine}-#{RUBY_VERSION}.mk"
+File.open("#{dst}.#$$", "w") do |fp|
+  fp.puts "ISOLATE_LIBS=#{lib_paths.join(':')}"
+end
+File.rename("#{dst}.#$$", dst)
+
+# pure Ruby gems can be shared across all Rubies
+%w(3.0.0).each do |rails_ver|
+  opts[:path] = "tmp/isolate/rails-#{rails_ver}"
+  pid = fork do
+    Isolate.now!(opts) do
+      gem 'rake', '0.8.7'
+      gem 'rails', rails_ver
+    end
+  end
+  _, status = Process.waitpid2(pid)
+  status.success? or abort status.inspect
+  more = Dir["#{opts[:path]}/gems/*-*/lib"].map { |x| File.expand_path(x) }
+  lib_paths.concat(more)
+end