passenger 3.0.21 → 3.9.1.beta

data/lib/phusion_passenger/classic_rails/framework_spawner.rb

@@ -1,311 +0,0 @@
-#  Phusion Passenger - http://www.modrails.com/
-#  Copyright (c) 2010 Phusion
-#
-#  "Phusion Passenger" is a trademark of Hongli Lai & Ninh Bui.
-#
-#  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 OR COPYRIGHT HOLDERS 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.
-
-require 'rubygems'
-require 'phusion_passenger/abstract_server'
-require 'phusion_passenger/abstract_server_collection'
-require 'phusion_passenger/app_process'
-require 'phusion_passenger/classic_rails/application_spawner'
-require 'phusion_passenger/exceptions'
-require 'phusion_passenger/constants'
-require 'phusion_passenger/utils'
-module PhusionPassenger
-module ClassicRails
-
-# This class is capable of spawning Ruby on Rails application instances
-# quickly. This is done by preloading the Ruby on Rails framework into memory,
-# before spawning the application instances.
-#
-# A single FrameworkSpawner instance can only hold a single Ruby on Rails
-# framework version. So be careful when using FrameworkSpawner: the applications
-# that you spawn through it must require the same RoR version. To handle multiple
-# RoR versions, use multiple FrameworkSpawner instances.
-#
-# FrameworkSpawner uses ApplicationSpawner internally.
-#
-# *Note*: FrameworkSpawner may only be started asynchronously with AbstractServer#start.
-# Starting it synchronously with AbstractServer#start_synchronously has not been tested.
-class FrameworkSpawner < AbstractServer
-	include Utils
-	
-	# This exception means that the FrameworkSpawner server process exited unexpectedly.
-	class Error < AbstractServer::ServerError
-	end
-	
-	# Creates a new instance of FrameworkSpawner.
-	#
-	# Extra supported options:
-	# - <tt>framework_version</tt>: The Ruby on Rails version to use. It is not checked whether
-	#   this version is actually installed.
-	#
-	# All other options will be passed on to ApplicationSpawner and RequestHandler.
-	#
-	# Note that the specified Rails framework will be loaded during the entire life time
-	# of the FrameworkSpawner server. If you wish to reload the Rails framework's code,
-	# then restart the server by calling AbstractServer#stop and AbstractServer#start.
-	def initialize(options = {})
-		if !options.respond_to?(:'[]')
-			raise ArgumentError, "The 'options' argument does not seem to be an options hash"
-		end
-		@framework_version = options["framework_version"]
-		if options.has_key?("print_framework_loading_exceptions")
-			@print_framework_loading_exceptions = options["print_framework_loading_exceptions"]
-		else
-			@print_framework_loading_exceptions = true
-		end
-		if !@framework_version
-			raise ArgumentError, "The 'framework_version' option must specified"
-		end
-		
-		super()
-		@options = options
-		self.max_idle_time = DEFAULT_FRAMEWORK_SPAWNER_MAX_IDLE_TIME
-		define_message_handler(:spawn_application, :handle_spawn_application)
-		define_message_handler(:reload, :handle_reload)
-	end
-	
-	# Overrided from AbstractServer#start.
-	#
-	# May raise these additional exceptions:
-	# - FrameworkInitError: An error occurred while loading the specified Ruby on Rails framework.
-	# - FrameworkSpawner::Error: The FrameworkSpawner server exited unexpectedly.
-	def start
-		super
-		begin
-			channel = MessageChannel.new(@owner_socket)
-			result = channel.read
-			if result.nil?
-				raise Error, "The framework spawner server exited unexpectedly."
-			else
-				status = result[0]
-			end
-			if status == 'exception'
-				child_exception = unmarshal_exception(channel.read_scalar)
-				stop
-				message = "Could not load Ruby on Rails framework version #{@framework_version}: " <<
-					"#{child_exception.class} (#{child_exception.message})"
-				options = { :version => @framework_version }
-				if @print_framework_loading_exceptions
-					print_exception(self.class.to_s, child_exception)
-				end
-				raise FrameworkInitError.new(message, child_exception, options)
-			end
-		rescue IOError, SystemCallError, SocketError => e
-			stop if started?
-			raise Error, "The framework spawner server exited unexpectedly: #{e}"
-		rescue
-			stop if started?
-			raise
-		end
-	end
-	
-	# Spawn a RoR application using the Ruby on Rails framework
-	# version associated with this FrameworkSpawner.
-	# When successful, an Application object will be returned, which represents
-	# the spawned RoR application.
-	#
-	# All options accepted by ApplicationSpawner.new and RequestHandler.new are accepted.
-	#
-	# FrameworkSpawner will internally cache the code of applications, in order to
-	# speed up future spawning attempts. This implies that, if you've changed
-	# the application's code, you must do one of these things:
-	# - Restart this FrameworkSpawner by calling AbstractServer#stop, then AbstractServer#start.
-	# - Reload the application by calling reload with the correct app_root argument.
-	#
-	# Raises:
-	# - AbstractServer::ServerNotStarted: The FrameworkSpawner server hasn't already been started.
-	# - AppInitError: The application raised an exception or called exit() during startup.
-	# - ApplicationSpawner::Error: The ApplicationSpawner server exited unexpectedly.
-	# - FrameworkSpawner::Error: The FrameworkSpawner server exited unexpectedly.
-	def spawn_application(options = {})
-		app_root = options["app_root"]
-		options = sanitize_spawn_options(options)
-		options["app_root"] = app_root
-		# No need for the ApplicationSpawner to print exceptions. All
-		# exceptions raised by the ApplicationSpawner are sent back here,
-		# so we just need to decide here whether we want to print it.
-		print_exceptions = options["print_exceptions"]
-		options["print_exceptions"] = false
-		
-		begin
-			connect do |channel|
-				channel.write("spawn_application", *options.to_a.flatten)
-				result = channel.read
-				if result.nil?
-					raise IOError, "Connection closed"
-				end
-				if result[0] == 'exception'
-					e = unmarshal_exception(channel.read_scalar)
-					if print_exceptions && e.respond_to?(:child_exception) && e.child_exception
-						print_exception(self.class.to_s, e.child_exception)
-					elsif print_exceptions
-						print_exception(self.class.to_s, e)
-					end
-					raise e
-				else
-					return AppProcess.read_from_channel(channel)
-				end
-			end
-		rescue SystemCallError, IOError, SocketError => e
-			raise Error, "The framework spawner server exited unexpectedly: #{e}"
-		end
-	end
-	
-	# Remove the cached application instances at the given group name.
-	# If nil is specified as group name, then all cached application
-	# instances will be removed, no matter the group name.
-	#
-	# <b>Long description:</b>
-	# Application code might be cached in memory by a FrameworkSpawner. But
-	# once it a while, it will be necessary to reload the code for an
-	# application, such as after deploying a new version of the application.
-	# This method makes sure that any cached application code is removed, so
-	# that the next time an application instance is spawned, the application
-	# code will be freshly loaded into memory.
-	#
-	# Raises:
-	# - FrameworkSpawner::Error: The FrameworkSpawner server exited unexpectedly.
-	def reload(app_group_name = nil)
-		connect do |channel|
-			if app_group_name.nil?
-				channel.write("reload")
-			else
-				channel.write("reload", app_group_name)
-			end
-		end
-	rescue SystemCallError, IOError, SocketError
-		raise Error, "The framework spawner server exited unexpectedly: #{e}"
-	end
-
-protected
-	# Overrided method.
-	def before_fork # :nodoc:
-		if GC.copy_on_write_friendly?
-			# Garbage collect now so that the child process doesn't have to
-			# do that (to prevent making pages dirty).
-			GC.start
-		end
-	end
-
-	# Overrided method.
-	def initialize_server # :nodoc:
-		$0 = "Passenger FrameworkSpawner: #{@framework_version}"
-		@spawners = AbstractServerCollection.new
-		channel = MessageChannel.new(@owner_socket)
-		begin
-			preload_rails
-		rescue StandardError, ScriptError, NoMemoryError => e
-			channel.write('exception')
-			channel.write_scalar(marshal_exception(e))
-			return
-		end
-		channel.write('success')
-	end
-	
-	# Overrided method.
-	def finalize_server # :nodoc:
-		@spawners.cleanup
-	end
-
-private
-	def preload_rails
-		Object.const_set(:RAILS_ROOT, ".")
-		gem 'rails', "=#{@framework_version}"
-		require 'initializer'
-		require 'active_support'
-		require 'active_record'
-		require 'action_controller'
-		require 'action_view'
-		require 'action_pack'
-		require 'action_mailer'
-		require 'dispatcher'
-		begin
-			if ::Rails::VERSION::MAJOR >= 2
-				require 'active_resource'
-			else
-				require 'action_web_service'
-			end
-			require 'ruby_version_check'
-			require 'active_support/whiny_nil'
-		rescue NameError
-			# Rails < 1.1
-			require 'action_web_service'
-		end
-		Object.send(:remove_const, :RAILS_ROOT)
-	end
-
-	def handle_spawn_application(client, *options)
-		app_process = nil
-		options = sanitize_spawn_options(Hash[*options])
-		app_group_name = options["app_group_name"]
-		@spawners.synchronize do
-			begin
-				spawner = @spawners.lookup_or_add(app_group_name) do
-					spawner = ApplicationSpawner.new(@options.merge(options))
-					if options["app_spawner_timeout"] && options["app_spawner_timeout"] != -1
-						spawner.max_idle_time = options["app_spawner_timeout"]
-					end
-					spawner.start
-					spawner
-				end
-			rescue InvalidPath, AppInitError, ApplicationSpawner::Error => e
-				client.write('exception')
-				client.write_scalar(marshal_exception(e))
-				if e.respond_to?(:child_exception) && e.child_exception.is_a?(LoadError)
-					# A source file failed to load, maybe because of a
-					# missing gem. If that's the case then the sysadmin
-					# will install probably the gem. So we clear RubyGems's
-					# cache so that it can detect new gems.
-					Gem.clear_paths
-				end
-				return
-			end
-			begin
-				app_process = spawner.spawn_application(options)
-			rescue ApplicationSpawner::Error => e
-				spawner.stop
-				@spawners.delete(app_group_name)
-				client.write('exception')
-				client.write_scalar(marshal_exception(e))
-				return
-			end
-		end
-		client.write('success')
-		app_process.write_to_channel(client)
-	ensure
-		app_process.close if app_process
-	end
-	
-	def handle_reload(client, app_group_name = nil)
-		@spawners.synchronize do
-			if app_group_name
-				@spawners.delete(app_group_name)
-			else
-				@spawners.clear
-			end
-		end
-	end
-end
-
-end # module ClassicRails
-end # module PhusionPassenger

data/lib/phusion_passenger/exceptions.rb

@@ -1,103 +0,0 @@
-#  Phusion Passenger - http://www.modrails.com/
-#  Copyright (c) 2010 Phusion
-#
-#  "Phusion Passenger" is a trademark of Hongli Lai & Ninh Bui.
-#
-#  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 OR COPYRIGHT HOLDERS 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.
-
-module PhusionPassenger
-
-# Indicates that there is no Ruby on Rails version installed that satisfies
-# a given Ruby on Rails Gem version specification.
-class VersionNotFound < StandardError
-	attr_reader :gem_version_spec
-	
-	# - +message+: The exception message.
-	# - +gem_version_spec+: The Ruby on Rails Gem version specification that caused this error.
-	def initialize(message, gem_version_spec)
-		super(message)
-		@gem_version_spec = gem_version_spec
-	end
-end
-
-# An abstract base class for AppInitError and FrameworkInitError. This represents
-# the failure when initializing something.
-class InitializationError < StandardError
-	# The exception that caused initialization to fail. This may be nil.
-	attr_accessor :child_exception
-
-	# Create a new InitializationError. +message+ is the error message,
-	# and +child_exception+ is the exception that caused initialization
-	# to fail.
-	def initialize(message, child_exception = nil)
-		super(message)
-		@child_exception = child_exception
-	end
-end
-
-# Raised when Rack::ApplicationSpawner, ClassicRails::ApplicationSpawner,
-# ClassicRails::FrameworkSpawner or SpawnManager was unable to spawn an application,
-# because the application either threw an exception or called exit.
-#
-# If the application called exit, then +child_exception+ is an instance of
-# +SystemExit+.
-class AppInitError < InitializationError
-	# The application type, e.g. "rails" or "rack".
-	attr_accessor :app_type
-	# Any messages printed to stderr before the failure. May be nil.
-	attr_accessor :stderr
-	
-	def initialize(message, child_exception = nil, app_type = "rails", stderr = nil)
-		super(message, child_exception)
-		@app_type = app_type
-		@stderr = stderr
-	end
-end
-
-# Raised when ClassicRails::FrameworkSpawner or ClassicRails::SpawnManager was unable to load a
-# version of the Ruby on Rails framework. The +child_exception+ attribute is guaranteed
-# non-nil.
-class FrameworkInitError < InitializationError
-	attr_reader :vendor
-	attr_reader :version
-	
-	def initialize(message, child_exception, options)
-		super(message, child_exception)
-		if options[:vendor]
-			@vendor = options[:vendor]
-		else
-			@version = options[:version]
-		end
-	end
-end
-
-class UnknownError < StandardError
-	attr_accessor :real_class_name
-	
-	def initialize(message, class_name, backtrace)
-		super("#{message} (#{class_name})")
-		set_backtrace(backtrace)
-		@real_class_name = class_name
-	end
-end
-
-class InvalidPath < StandardError
-end
-
-end # module PhusionPassenger

data/lib/phusion_passenger/html_template.rb

@@ -1,107 +0,0 @@
-#  Phusion Passenger - http://www.modrails.com/
-#  Copyright (c) 2010 Phusion
-#
-#  "Phusion Passenger" is a trademark of Hongli Lai & Ninh Bui.
-#
-#  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 OR COPYRIGHT HOLDERS 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.
-
-require 'erb'
-require 'phusion_passenger'
-
-module PhusionPassenger
-
-# A convenience utility class for rendering our error pages.
-class HTMLTemplate
-	def initialize(template_name, options = {})
-		@buffer = ''
-		@template = ERB.new(File.read("#{TEMPLATES_DIR}/#{template_name}.html.erb"),
-			nil, nil, '@buffer')
-		options.each_pair do |name, value|
-			self[name] = value
-		end
-	end
-	
-	def []=(name, value)
-		instance_variable_set("@#{name}".to_sym, value)
-		return self
-	end
-	
-	def result
-		return @template.result(binding)
-	end
-
-private
-	include ERB::Util
-	
-	def get_binding
-		return binding
-	end
-	
-	def layout(template_name, options = {})
-		options.each_pair do |name, value|
-			self[name] = value
-		end
-		layout_template = ERB.new(File.read("#{TEMPLATES_DIR}/#{template_name}.html.erb"))
-		b = get_binding do
-			old_size = @buffer.size
-			yield
-			@buffer.slice!(old_size .. @buffer.size)
-		end
-		@buffer << layout_template.result(b)
-	end
-	
-	def include(filename)
-		return File.read("#{TEMPLATES_DIR}/#{filename}")
-	end
-	
-	def backtrace_html_for(error)
-		html = %Q{
-			<table class="backtrace">
-			<tr class="headers">
-				<th>#</th>
-				<th>File</th>
-				<th>Line</th>
-				<th>Location</th>
-			</tr>
-		}
-		in_passenger = false
-		error.backtrace.each_with_index do |item, i|
-			filename, line, location = item.split(':', 3)
-			in_passenger ||= starts_with(filename, "#{LIBDIR}/phusion_passenger")
-			class_names = in_passenger ? "passenger" : "framework"
-			class_names << ((i & 1 == 0) ? " uneven" : " even")
-			html << %Q{
-				<tr class="backtrace_line #{class_names}">
-					<td class="index">#{i}</td>
-					<td class="filename">#{filename}</td>
-					<td class="line">#{line}</td>
-					<td class="location">#{location}</td>
-				</tr>
-			}
-		end
-		html << "</table>\n"
-		return html
-	end
-	
-	def starts_with(str, substr)
-		return str[0 .. substr.size - 1] == substr
-	end
-end
-
-end # module PhusionPassenger