ramaze 2012.04.14 → 2012.12.08b

data/lib/ramaze/bin/console.rb

@@ -1,87 +0,0 @@
-require 'irb'
-require 'irb/completion'
-
-module Ramaze
-  #:nodoc:
-  module Bin
-    ##
-    # Allows the user to enter an IRB like session that takes advantage of
-    # everything provided by Ramaze.
-    #
-    # Usage:
-    #
-    #    ramaze console
-    #    ramaze console /path/to/app/start.rb
-    #
-    # @author Yorick Peterse
-    # @since  21-07-2011
-    #
-    class Console
-      # String containing the description of this command.
-      Description = 'Starts an IRB session with Ramaze loaded into the session'
-
-      # The banner that is displayed when the -h or --help option is specified.
-      Banner = <<-TXT.strip
-Starts an IRB session and loads Ramaze into the session. All specified Rack
-options are ignored and environment variables are passed to IRB.
-
-Usage:
-  ramaze console [DIR] [OPTIONS]
-
-Example:
-  ramaze console
-  ramaze console /home/foobar/ramaze/start.rb
-      TXT
-
-      ##
-      # Creates a new instance of the command and sets all the options.
-      #
-      # @author Yorick Peterse
-      # @since  21-07-2011
-      #
-      def initialize
-        @options = OptionParser.new do |opt|
-          opt.banner         = Banner
-          opt.summary_indent = '  '
-
-          opt.separator "\nOptions:\n"
-
-          opt.on('-h', '--help', 'Shows this help message') do
-            puts @options
-            exit
-          end
-        end
-      end
-
-      ##
-      # Runs the command based on the given command line arguments.
-      #
-      # @author Yorick Peterse
-      # @since  21-07-2011
-      # @param  [Array] argv An array of command line arguments.
-      #
-      def run(argv = [])
-        @options.parse!(argv)
-
-        start_file = argv.delete_at(0)
-        start_file = File.join(Dir.pwd, 'start.rb') if start_file.nil?
-
-        if File.directory?(start_file)
-          start_file = File.join(start_file, 'start.rb')
-        end
-
-        if !File.exist?(start_file)
-          abort "The file #{start_file} does not exist"
-        end
-
-        start_file             = Pathname.new(start_file).realpath.to_s
-        Ramaze.options.started = true
-
-        require(start_file)
-
-        IRB.start
-        puts 'Ramazement has ended, go in peace.'
-      end
-    end # Console
-  end # Bin
-end # Ramaze

data/lib/ramaze/bin/helper.rb

@@ -1,107 +0,0 @@
-module Ramaze
-  #:nodoc:
-  module Bin
-    ##
-    # Module containing various helper methods useful for most commands.
-    #
-    # @author Yorick Peterse
-    # @author TJ Vanderpoel
-    # @since  21-07-2011
-    #
-    module Helper
-      ##
-      # Checks if the specified PID points to a process that's already running.
-      #
-      # @author TJ Vanderpoel
-      # @since  21-07-2011
-      # @param  [String] pid The path to the PID.
-      # @return [TrueClass|FalseClass]
-      #
-      def is_running?(pid)
-        return false if !File.exist?(pid)
-
-        pid = File.read(pid).to_i
-
-        if is_windows?
-          wmi             = WIN32OLE.connect("winmgmts://")
-          processes, ours = wmi.ExecQuery(
-            "select * from win32_process where ProcessId = #{pid}"
-          ), []
-
-          processes.each { |process| ours << process.Name }
-
-          return ours.first.nil?
-        else
-          begin
-            prio = Process.getpriority(Process::PRIO_PROCESS, pid)
-            return true
-          rescue Errno::ESRCH
-            return false
-          end
-        end
-      end
-
-      ##
-      # Checks if the system the user is using is Windows.
-      #
-      # @author TJ Vanderpoel
-      # @since  21-07-2011
-      # @return [TrueClass|FalseClass]
-      #
-      def is_windows?
-        return @is_win if @is_win
-
-        begin; require "win32ole"; rescue LoadError; end
-
-        @is_win ||= Object.const_defined?("WIN32OLE")
-      end
-
-      ##
-      # Tries to extract the path to the Rackup executable.
-      #
-      # @author TJ Vanderpoel
-      # @since  21-07-2001
-      # @return [String]
-      #
-      def rackup_path
-        return @rackup_path if @rackup_path
-
-        # Check with 'which' on platforms which support it
-        unless is_windows?
-          @rackup_path = %x{which rackup}.to_s.chomp
-
-          if @rackup_path.size > 0 and File.file?(@rackup_path)
-            return @rackup_path
-          end
-        end
-
-        # check for rackup in RUBYLIB
-        libs = ENV["RUBYLIB"].to_s.split(is_windows? ? ";" : ":")
-
-        if rack_lib = libs.detect { |r| r.match %r<(\\|/)rack\1> }
-          require "pathname"
-          @rackup_path = Pathname.new(rack_lib).parent.join("bin").join(
-            "rackup"
-          ).expand_path
-          
-          return @rackup_path if File.file?(@rackup_path)
-        end
-
-        begin
-          require "rubygems"
-          require "rack"
-          require "pathname"
-
-          @rackup_path = Pathname.new(Gem.bindir).join("rackup").to_s
-
-          return @rackup_path if File.file?(@rackup_path)
-        rescue LoadError
-          nil
-        end
-
-        @rackup_path = nil
-        abort "Cannot find the path to the Rackup executable"
-      end
-    end # Helper
-  end # Bin
-end # Ramaze

data/lib/ramaze/bin/restart.rb

@@ -1,95 +0,0 @@
-module Ramaze
-  #:nodoc:
-  module Bin
-    ##
-    # Restarts an application based on a specified directory/rackup file and
-    # PID. The PID is used to kill the process, the Rackup file is used to start
-    # the process again after it has been killed.
-    #
-    # Usage:
-    #
-    #    ramaze restart
-    #    ramaze restart /home/foobar/projects/ramaze/ \
-    #    -P /home/foobar/projects/ramaze/ramaze.pid
-    #
-    # @author Yorick Peterse
-    # @since  21-07-2011
-    #
-    class Restart
-      # The description of this command, displayed in the global help message.
-      Description = 'Restarts an application'
-
-      # The banner, displayed when the -h or --help option is specified.
-      Banner = <<-TXT.strip
-Restarts an active Ramaze application.
-
-Usage:
-  ramaze restart [RACKUP] [OPTIONS]
-
-Example:
-  ramaze restart config.ru -P ramaze.pid
-      TXT
-
-      ##
-      # Creates a new instance of the command and sets all the options.
-      #
-      # @author Yorick Peterse
-      # @since  21-07-2011
-      #
-      def initialize
-        @options = OptionParser.new do |opt|
-          opt.banner         = Banner
-          opt.summary_indent = '  '
-
-          opt.separator "\nOptions:\n"
-
-          opt.on('-h', '--help', 'Shows this help message') do
-            puts @options
-            exit
-          end
-
-          opt.on(
-            '-P',
-            '--pid FILE',
-            'Uses the PID to kill the application'
-          ) do |pid|
-            @pid = pid
-          end
-        end
-      end
-
-      ##
-      # Runs the command based on the specified command line arguments.
-      #
-      # @author Yorick Peterse
-      # @since  21-07-2011
-      # @param  [Array] argv An array containing all command line arguments.
-      #
-      def run(argv = [])
-        @options.parse!(argv)
-
-        @rackup = argv.delete_at(0)
-        @rackup = File.join(Dir.pwd, 'config.ru') if @rackup.nil?
-
-        if File.directory?(@rackup)
-          @rackup = File.join(@rackup, 'config.ru')
-        end
-
-        if !File.exist?(@rackup)
-          abort "The Rackup file #{@rackup} does not exist"
-        end
-
-        stop   = Ramaze::Bin::Runner::Commands[:stop].new
-        start  = Ramaze::Bin::Runner::Commands[:start].new
-        params = [@rackup]
-
-        unless @pid.nil?
-          params.push("-P #{@pid}")
-        end
-
-        stop.run([@pid])
-        start.run(params)
-      end
-    end # Restart
-  end # Bin
-end # Ramaze

data/lib/ramaze/bin/start.rb

@@ -1,221 +0,0 @@
-module Ramaze
-  #:nodoc:
-  module Bin
-    ##
-    # The start command is used to start a Ramaze application. The ramaze start
-    # command optionally takes a directory or path to a file. If it's a
-    # directory this command will look for a Rackup file in that directory,
-    # otherwise it assumes the specified file is a Rackup file.
-    #
-    # Usage:
-    #
-    #    ramaze start
-    #    ramaze start /home/foobar/projects/blog/config.ru
-    #    ramaze start /home/foobar/projects/blog
-    #
-    # @author Yorick Peterse
-    # @since  21-07-2011
-    #
-    class Start
-      include Ramaze::Bin::Helper
-
-      # The description of this command, displayed when the global help menu is
-      # invoked.
-      Description = 'Starts an instance of an application'
-
-      # The banner of this command, displayed when it's invoked with the -h or
-      # --help option.
-      Banner = <<-TXT.strip
-Starts an instance of an application using the settings
-specified in a Rackup file in the current directory.
-
-Usage:
-  ramaze start [RACKUP CONFIG] [OPTIONS]
-
-Example:
-  ramaze start --help
-      TXT
-
-      ##
-      # Creates a new instance of the command and prepares OptionParser.
-      #
-      # @author Yorick Peterse
-      # @since  21-07-2011
-      #
-      def initialize
-        @ruby_options = {}
-        @rack_options = {}
-        @options      = OptionParser.new do |opt|
-          opt.banner         = Banner
-          opt.summary_indent = '  '
-
-          # Sets all Ruby options
-          opt.separator "\nRuby Options:\n"
-
-          opt.on('-e', '--eval LINE', 'Evaluates a line of code') do |code|
-            @ruby_options['-e'] = code
-          end
-
-          opt.on('-d', '--debug', 'Set debugging flags (set $DEBUG to true)') do
-            @ruby_options['-d'] = nil
-          end
-
-          opt.on('-w', '--warn', 'Turns warnings on for the script') do
-            @ruby_options['-w'] = nil
-          end
-
-          opt.on('-I', '--include PATH', 'specifies the $LOAD_PATH') do |path|
-            @ruby_options['-I'] = path
-          end
-
-          opt.on(
-            '-r',
-            '--require LIBRARY',
-            'requires the library before starting'
-          ) do |library|
-            @ruby_options['-r'] = library
-          end
-
-          # Set all Rack options
-          opt.separator "\nRack Options:\n"
-
-          opt.on(
-            '-s',
-            '--server SERVER',
-            'Serve the application using the given server'
-          ) do |server|
-            @rack_options['-s'] = server
-          end
-
-          opt.on(
-            '-o',
-            '--host HOST',
-            'Listens on the given host (0.0.0.0 by default)'
-          ) do |host|
-            @rack_options['-o'] = host
-          end
-
-          opt.on(
-            '-p',
-            '--port PORT',
-            'Uses the given port, set to 9292 by default'
-          ) do |port|
-            @rack_options['-p'] = port
-          end
-
-          opt.on(
-            '-O',
-            '--option NAME[=VALUE]',
-            'Passes the given option and it\'s value to the server'
-          ) do |name|
-            @rack_options['-O'] = name
-          end
-
-          opt.on(
-            '-E',
-            '--env ENVIRONMENT',
-            'Uses the specified environment, set to development by default'
-          ) do |env|
-            @rack_options['-E'] = env
-          end
-
-          opt.on('-D', '--daemonize', 'Runs as a daemon in the background') do
-            @rack_options['-D'] = nil
-          end
-
-          opt.on(
-            '-P',
-            '--pid FILE',
-            'File to store the PID in, defaults to rack.pid'
-          ) do |pid|
-            @rack_options['-P'] = pid
-          end
-
-          # Set all common options
-          opt.separator "\nOptions\n"
-
-          opt.on('-h', '--help', 'Shows this help message') do
-            puts @options
-            exit
-          end
-        end
-      end
-
-      ##
-      # Runs the command based on the given command line arguments.
-      #
-      # @author Yorick Peterse
-      # @since  21-07-2011
-      # @param  [Array] argv An array of command line arguments.
-      #
-      def run(argv = [])
-        begin
-          @options.parse!(argv)
-        rescue => e
-          warn "Error: #{e.message}"
-          abort @options.to_s
-        end
-
-        # Remove all trailing/leading whitespace from the options
-        @rack_options.each do |k, v|
-          @rack_options[k] = v.strip if v.respond_to?(:strip)
-        end
-
-        @ruby_options.each do |k, v|
-          @ruby_options[k] = v.strip if v.respond_to?(:strip)
-        end
-
-        rackup_config = argv.delete_at(0)
-        rackup_config = File.join(Dir.pwd, 'config.ru') if rackup_config.nil?
-
-        # Check if the config is a directory or file
-        if File.directory?(rackup_config)
-          rackup_config = File.join(rackup_config, 'config.ru')
-        end
-
-        if !File.exist?(rackup_config)
-          abort "The Rackup config #{rackup_config} does not exist"
-        end
-
-        # Set the default port and server to use.
-        if !@rack_options['-p']
-          @rack_options['-p'] = 7000
-        end
-
-        # Set the default server to use
-        if !@rack_options['-s']
-          @rack_options['-s'] = Ramaze.options.adapter.handler.to_s
-        end
-
-        # If a PID is supplied we should first check to see if Ramaze isn't
-        # already running.
-        if @rack_options.key?('-P') and is_running?(@rack_options['-P'])
-          abort 'This application is already running'
-        end
-
-        params = []
-
-        @ruby_options.merge(@rack_options).each do |opt, value|
-          params.push("#{opt}#{value}")
-        end
-
-        start_server(rackup_path, rackup_config, *params)
-      end
-
-      ##
-      # Starts a server baed on the rackup path, rackup configuration file and
-      # additional parameters.
-      #
-      # @author Yorick Peterse
-      # @since  21-10-2011
-      # @param  [String] rackup_path The path to the Rackup executable.
-      # @param  [String] rackup_config The path to the config.ru file to use.
-      # @param  [Array] *params Additional parameters to pass to the ``exec()``
-      #  method.
-      #
-      def start_server(rackup_path, rackup_config, *params)
-        exec('ruby', rackup_path, rackup_config, *params)
-      end
-    end # Start
-  end # Bin
-end # Ramaze