Parent

Heel::Server

Attributes

options[RW]
parsed_options[RW]
stderr[R]
stdin[R]
stdout[R]

Public Class Methods

kill_existing_proc() click to toggle source
# File lib/heel/server.rb, line 32
def kill_existing_proc
  Heel::Server.new.kill_existing_proc
end
new(argv = []) click to toggle source
# File lib/heel/server.rb, line 37
def initialize(argv = [])
  argv ||= []

  set_io

  @options        = default_options
  @parsed_options = ::OpenStruct.new
  @parser         = option_parser
  @error_message  = nil

  begin
    @parser.parse!(argv)
  rescue ::OptionParser::ParseError => pe
    msg = ["#{@parser.program_name}: #{pe}",
                    "Try `#{@parser.program_name} --help` for more information"]
                    @error_message = msg.join("\n")
  end
end

Public Instance Methods

default_directory() click to toggle source
# File lib/heel/server.rb, line 72
def default_directory
  ENV["HEEL_DEFAULT_DIRECTORY"] || File.join(::Heel::Server.home_directory,".heel")
end
default_options() click to toggle source
# File lib/heel/server.rb, line 56
def default_options
  if @default_options.nil? then
    @default_options                 = ::OpenStruct.new
    @default_options.show_version    = false
    @default_options.show_help       = false
    @default_options.address         = "0.0.0.0"
    @default_options.port            = 4331
    @default_options.document_root   = Dir.pwd
    @default_options.daemonize       = false
    @default_options.highlighting    = false
    @default_options.kill            = false
    @default_options.launch_browser  = true
  end
  return @default_options
end
ensure_not_running() click to toggle source

make sure that if we are daemonizing the process is not running

# File lib/heel/server.rb, line 198
def ensure_not_running
  if options.daemonize and File.exist?(pid_file) then
    @stdout.puts "ERROR: PID File #{pid_file} already exists.  Heel may already be running."
    @stdout.puts "ERROR: Check the Log file #{log_file}"
    @stdout.puts "ERROR: Heel will not start until the .pid file is cleared (`heel --kill' to clean it up)."
    exit 1
  end
end
error_version_help_kill() click to toggle source

if Version or Help options are set, then output the appropriate information instead of running the server.

# File lib/heel/server.rb, line 152
def error_version_help_kill
  if @parsed_options.show_version then
    @stdout.puts "#{@parser.program_name}: version #{Heel::VERSION}"
    exit 0
  elsif @parsed_options.show_help then
    @stdout.puts @parser.to_s
    exit 0
  elsif @error_message then
    @stdout.puts @error_message
    exit 1
  elsif @parsed_options.kill then
    kill_existing_proc
  end
end
kill_existing_proc() click to toggle source

kill an already running background heel process

# File lib/heel/server.rb, line 168
def kill_existing_proc
  if File.exists?(pid_file) then
    begin
      pid = open(pid_file).read.to_i
      @stdout.puts "Sending TERM to process #{pid}"
      Process.kill("TERM", pid)
    rescue Errno::ESRCH
      @stdout.puts "Unable to kill process with pid #{pid}.  Process does not exist.  Removing stale pid file."
      File.unlink(pid_file)
    rescue Errno::EPERM 
      @stdout.puts "Unable to kill process with pid #{pid}.  No permissions to kill process."
    end
  else
    @stdout.puts "No pid file exists, no process to kill"
  end
  @stdout.puts "Done."
  exit 0
end
launch_browser() click to toggle source
# File lib/heel/server.rb, line 207
def launch_browser
  Thread.new do 
    print "Launching your browser"
    if options.daemonize then
      puts " at http://#{options.address}:#{options.port}/"
    else
      puts "..."
    end
    ::Launchy.open("http://#{options.address}:#{options.port}/")
  end
end
log_file() click to toggle source
# File lib/heel/server.rb, line 80
def log_file
  File.join(default_directory,"heel.log")
end
merge_options() click to toggle source
# File lib/heel/server.rb, line 133
def merge_options
  options = default_options.marshal_dump
  @parsed_options.marshal_dump.each_pair do |key,value|
    options[key] = value
  end

  @options = OpenStruct.new(options)
end
option_parser() click to toggle source
# File lib/heel/server.rb, line 84
def option_parser
  OptionParser.new do |op|
    op.separator ""

    op.on("-a", "--address ADDRESS", "Address to bind to",
                                    "  (default: #{default_options.address})") do |add|
      @parsed_options.address = add
                                    end

    op.on("-d", "--daemonize", "Run daemonized in the background") do 
      raise ::OptionParser::ParseError, "Daemonizing is not supported on windows" if Thin.win? 
      @parsed_options.daemonize = true
    end

    op.on("-h", "--help", "Display this text") do 
      @parsed_options.show_help = true
    end

    op.on("-k", "--kill", "Kill an existing daemonized heel process") do
      @parsed_options.kill = true
    end

    op.on("--[no-]highlighting", "Turn on or off syntax highlighting",
                                         "  (default: off)") do |highlighting|
      @parsed_options.highlighting = highlighting
                                         end

    op.on("--[no-]launch-browser", "Turn on or off automatic browser launch",
                                           "  (default: on)") do |l|
      @parsed_options.launch_browser = l
                                           end

    op.on("-p", "--port PORT", Integer, "Port to bind to",
                                    "  (default: #{default_options.port})") do |port|
      @parsed_options.port = port
                                    end

    op.on("-r","--root ROOT", 
                  "Set the document root"," (default: #{default_options.document_root})") do |document_root|
      @parsed_options.document_root = File.expand_path(document_root)
      raise ::OptionParser::ParseError, "#{@parsed_options.document_root} is not a valid directory" if not File.directory?(@parsed_options.document_root)
                  end

    op.on("-v", "--version", "Show version") do 
      @parsed_options.show_version = true
    end
  end
end
pid_file() click to toggle source
# File lib/heel/server.rb, line 76
def pid_file
  File.join(default_directory,"heel.pid")
end
run() click to toggle source

run the heel server with the current options.

# File lib/heel/server.rb, line 280
def run

  error_version_help_kill
  merge_options
  setup_heel_dir
  ensure_not_running

  server_thread = start_thin_server

  if options.launch_browser then
    launch_browser.join
  end
  server_thread.join
end
set_io(stdin = $stdin, stdout = $stdout ,setderr = $stderr) click to toggle source

set the IO objects in a single method call. This is really only for testing instrumentation

# File lib/heel/server.rb, line 144
def set_io(stdin = $stdin, stdout = $stdout ,setderr = $stderr)
  @stdin  = stdin
  @stdout = stdout
  @stderr = stderr
end
setup_heel_dir() click to toggle source

setup the directory that heel will use as the location to run from, where its logs will be stored and its PID file if backgrounded.

# File lib/heel/server.rb, line 189
def setup_heel_dir
  if not File.exists?(default_directory) then
    FileUtils.mkdir_p(default_directory)
    @stdout.puts "Created #{default_directory}"
    @stdout.puts "heel's PID (#{pid_file}) and log file (#{log_file}) are stored here"
  end
end
start_thin_server() click to toggle source
# File lib/heel/server.rb, line 253
def start_thin_server
  server = thin_server

  server_thread = Thread.new do
    begin
      if options.daemonize then
        if cpid = fork then
          # wait for the top child of the server double fork to exit
          Process.waitpid(cpid)
        else
          server.daemonize
          server.start
        end
      else
        begin
          server.start
        rescue RuntimeError 
          $stderr.puts "ERROR: Unable to start server.  Heel may already be running.  Please check running processes or run `heel --kill'"
          exit 1
        end
      end
    end
  end
end
thin_server() click to toggle source
# File lib/heel/server.rb, line 219
def thin_server
  server = Thin::Server.new(options.address, options.port)

  # overload the name of the process so it shows up as heel not thin
  def server.name
    "heel (v#{Heel::VERSION})"
  end

  server.pid_file = pid_file
  server.log_file = log_file

  app = Heel::RackApp.new({ :document_root => options.document_root,
                            :highlighting  => options.highlighting})

  Heel::Logger.log_file = log_file
  server.app = Rack::Builder.new {
    use Heel::Logger
    map "/" do 
      run app
    end
    map "/heel_css" do 
      run Rack::File.new(Heel::Configuration.data_path( "css" )) 
    end
    map "/heel_icons" do
      run Rack::File.new(Heel::Configuration.data_path("famfamfam", "icons")) 
    end

  }
  
  server.app = Thin::Stats::Adapter.new(server.app, "/heel_stats")

  return server
end

[Validate]

Generated with the Darkfish Rdoc Generator 2.