rockdog-passenger 0.0.1

data/test/ruby/rails/minimal_spawner_spec.rb

@@ -0,0 +1,74 @@
+shared_examples_for "a minimal spawner" do
+	it "can spawn our stub application" do
+		use_rails_stub('foobar') do |stub|
+			app = spawn_stub_application(stub)
+			app.pid.should_not == 0
+			app.app_root.should_not be_nil
+			app.close
+		end
+	end
+	
+	it "can spawn an arbitary number of applications" do
+		use_rails_stub('foobar') do |stub|
+			last_pid = 0
+			4.times do
+				app = spawn_stub_application(stub)
+				app.pid.should_not == last_pid
+				app.app_root.should_not be_nil
+				last_pid = app.pid
+				app.close
+			end
+		end
+	end
+	
+	it "respects ENV['RAILS_ENV']= in environment.rb" do
+		use_rails_stub('foobar') do |stub|
+			File.prepend(stub.environment_rb, "ENV['RAILS_ENV'] = 'development'\n")
+			File.append(stub.environment_rb, %q{
+				File.open('environment.txt', 'w') do |f|
+					f.write(RAILS_ENV)
+				end
+			})
+			spawn_stub_application(stub).close
+			environment = File.read("#{stub.app_root}/environment.txt")
+			environment.should == "development"
+		end
+	end
+	
+	it "does not conflict with models in the application that are named 'Passenger'" do
+		use_rails_stub('foobar') do |stub|
+			if !File.directory?("#{stub.app_root}/app/models")
+				Dir.mkdir("#{stub.app_root}/app/models")
+			end
+			File.open("#{stub.app_root}/app/models/passenger.rb", 'w') do |f|
+				f.write(%q{
+					class Passenger
+						def name
+							return "Gourry Gabriev"
+						end
+					end
+				})
+			end
+			File.append(stub.environment_rb, %q{
+				# We explicitly call 'require' here because we might be
+				# using a stub Rails framework (that doesn't support automatic
+				# loading of model source files).
+				require 'app/models/passenger'
+				File.open('passenger.txt', 'w') do |f|
+					f.write(Passenger.new.name)
+				end
+			})
+			spawn_stub_application(stub).close
+			passenger_name = File.read("#{stub.app_root}/passenger.txt")
+			passenger_name.should == 'Gourry Gabriev'
+		end
+	end
+	
+	it "loads application_controller.rb instead of application.rb, if the former exists" do
+		use_rails_stub('foobar') do |stub|
+			File.rename("#{stub.app_root}/app/controllers/application.rb",
+				"#{stub.app_root}/app/controllers/application_controller.rb")
+			lambda { spawn_stub_application(stub).close }.should_not raise_error
+		end
+	end
+end

data/test/ruby/rails/spawner_error_handling_spec.rb

@@ -0,0 +1,52 @@
+shared_examples_for "handling errors in application initialization" do
+	before :each do
+		@stub = setup_rails_stub('foobar')
+		@stub.use_vendor_rails('minimal')
+	end
+	
+	after :each do
+		teardown_rails_stub
+	end
+
+	it "raises an AppInitError if the spawned app raises a standard exception during startup" do
+		File.prepend(@stub.environment_rb, "raise 'This is a dummy exception.'\n")
+		begin
+			spawn_stub_application(@stub)
+			violated "Spawning the application should have raised an InitializationError."
+		rescue AppInitError => e
+			e.child_exception.message.should == "This is a dummy exception."
+		end
+	end
+	
+	it "raises an AppInitError if the spawned app raises a custom-defined exception during startup" do
+		File.prepend(@stub.environment_rb, %{
+			class MyError < StandardError
+			end
+			
+			raise MyError, "This is a custom exception."
+		})
+		begin
+			spawn_stub_application(@stub)
+			violated "Spawning the application should have raised an InitializationError."
+		rescue AppInitError => e
+			e.child_exception.message.should == "This is a custom exception. (MyError)"
+		end
+	end
+	
+	it "raises an AppInitError if the spawned app calls exit() during startup" do
+		File.prepend(@stub.environment_rb, "exit\n")
+		begin
+			spawn_stub_application(@stub)
+			violated "Spawning the application should have raised an InitializationError."
+		rescue AppInitError => e
+			e.child_exception.class.should == SystemExit
+		end
+	end
+end
+
+shared_examples_for "handling errors in framework initialization" do
+	include Utils
+	it "raises FrameworkInitError if the framework could not be loaded" do
+		lambda { load_nonexistant_framework }.should raise_error(FrameworkInitError)
+	end
+end

data/test/ruby/rails/spawner_privilege_lowering_spec.rb

@@ -0,0 +1,97 @@
+require 'support/config'
+require 'etc'
+require 'yaml'
+
+shared_examples_for "a spawner that supports lowering of privileges" do
+	before :each do
+		@stub = setup_rails_stub('foobar')
+		@environment_rb = @stub.environment_rb
+		@original_uid = File.stat(@environment_rb).uid
+		File.append(@environment_rb, %q{
+			require 'yaml'
+			info = {
+				:username => `whoami`.strip,
+				:user_id  => `id -u`.strip.to_i,
+				:group_id => `id -g`.strip.to_i,
+				:groups   => `groups "#{`whoami`.strip}"`.strip,
+				:home     => ENV['HOME']
+			}
+			File.open("#{RAILS_ROOT}/dump.yml", 'w') do |f|
+				YAML::dump(info, f)
+			end
+		})
+	end
+	
+	after :each do
+		@stub.destroy
+	end
+	
+	it "lowers its privileges to the owner of environment.rb" do
+		File.chown(uid_for('normal_user_1'), nil, @environment_rb)
+		spawn_stub_application do |app|
+			read_dumped_info[:username].should == CONFIG['normal_user_1']
+		end
+	end
+	
+	it "switches the group to environment.rb's owner's primary group, after lowering privileges" do
+		File.chown(uid_for('normal_user_1'), nil, @environment_rb)
+		spawn_stub_application do |app|
+			expected_gid = Etc.getpwnam(CONFIG['normal_user_1']).gid
+			read_dumped_info[:group_id].should == expected_gid
+		end
+	end
+	
+	it "switches supplementary groups to environment.rb's owner's default supplementary groups" do
+		File.chown(uid_for('normal_user_1'), nil, @environment_rb)
+		spawn_stub_application do |app|
+			default_groups = `groups "#{CONFIG['normal_user_1']}"`.strip
+			read_dumped_info[:groups].should == default_groups
+		end
+	end
+	
+	it "lowers its privileges to 'lowest_user' if environment.rb is owned by root" do
+		File.chown(ApplicationSpawner::ROOT_UID, nil, @environment_rb)
+		spawn_stub_application do |app|
+			read_dumped_info[:username].should == CONFIG['lowest_user']
+		end
+	end
+	
+	it "lowers its privileges to 'lowest_user' if environment.rb is owned by a nonexistant user" do
+		File.chown(CONFIG['nonexistant_uid'], nil, @environment_rb)
+		spawn_stub_application do |app|
+			read_dumped_info[:username].should == CONFIG['lowest_user']
+		end
+	end
+	
+	it "doesn't switch user if environment.rb is owned by a nonexistant user, and 'lowest_user' doesn't exist either" do
+		File.chown(CONFIG['nonexistant_uid'], nil, @environment_rb)
+		spawn_stub_application("lowest_user" => CONFIG['nonexistant_user']) do |app|
+			read_dumped_info[:username].should == my_username
+		end
+	end
+	
+	it "doesn't switch user if 'lower_privilege' is set to false" do
+		File.chown(uid_for('normal_user_2'), nil, @environment_rb)
+		spawn_stub_application("lower_privilege" => false) do |app|
+			read_dumped_info[:username].should == my_username
+		end
+	end
+	
+	it "sets $HOME to the user's home directory, after privilege lowering" do
+		spawn_stub_application("lowest_user" => CONFIG['normal_user_1']) do |app|
+			read_dumped_info[:home].should == Etc.getpwnam(CONFIG['normal_user_1']).dir
+		end
+	end
+	
+	def read_dumped_info
+		return YAML.load_file("#{@stub.app_root}/dump.yml")
+	end
+	
+	def my_username
+		return `whoami`.strip
+	end
+	
+	def uid_for(name)
+		return Etc.getpwnam(CONFIG[name]).uid
+	end
+end

data/test/ruby/spawn_manager_spec.rb

@@ -0,0 +1,189 @@
+require 'support/config'
+require 'support/test_helper'
+require 'phusion_passenger/spawn_manager'
+
+require 'ruby/abstract_server_spec'
+require 'ruby/rails/minimal_spawner_spec'
+require 'ruby/rails/spawner_privilege_lowering_spec'
+require 'ruby/rails/spawner_error_handling_spec'
+include PhusionPassenger
+include PhusionPassenger::Utils
+
+# TODO: test whether SpawnManager restarts FrameworkSpawner if it crashed
+
+describe SpawnManager do
+	include TestHelper
+	
+	before :each do
+		@manager = SpawnManager.new
+		@stub = setup_rails_stub('foobar')
+		@stub.use_vendor_rails('minimal')
+		@server = @manager
+		@server.start
+	end
+	
+	after :each do
+		@manager.cleanup
+		@stub.destroy
+	end
+	
+	describe "smart spawning" do
+		before :each do
+			@spawn_method = "smart"
+		end
+		
+		it_should_behave_like "AbstractServer"
+	end
+	
+	describe "conservative spawning" do
+		before :each do
+			@spawn_method = "conservative"
+		end
+		
+		it_should_behave_like "AbstractServer"
+	end
+	
+	def spawn_arbitrary_application
+		@manager.spawn_application(@stub.app_root, true, "nobody",
+			"production", @spawn_method)
+	end
+end
+
+describe SpawnManager do
+	include TestHelper
+	
+	before :each do
+		@manager = SpawnManager.new
+		@stub = setup_rails_stub('foobar')
+		@stub.use_vendor_rails('minimal')
+	end
+	
+	after :each do
+		@manager.cleanup
+		@stub.destroy
+	end
+	
+	it "can spawn when the server's not running" do
+		app = @manager.spawn_application("app_root" => @stub.app_root)
+		app.close
+	end
+	
+	it "can spawn when the server's running synchronously" do
+		a, b = UNIXSocket.pair
+		pid = fork do
+			begin
+				a.close
+				sleep(1) # Give @manager the chance to start.
+				channel = MessageChannel.new(b)
+				channel.write("spawn_application", "app_root", @stub.app_root)
+				channel.read
+				pid, listen_socket = channel.read
+				channel.recv_io.close
+				channel.close
+			rescue Exception => e
+				print_exception("child", e)
+			ensure
+				exit!
+			end
+		end
+		b.close
+		@manager.start_synchronously(a)
+		a.close
+		Process.waitpid(pid) rescue nil
+	end
+	
+	it "doesn't crash upon spawning an application that doesn't specify its Rails version" do
+		File.write(@stub.environment_rb) do |content|
+			content.sub(/^RAILS_GEM_VERSION = .*$/, '')
+		end
+		@stub.dont_use_vendor_rails
+		@manager.spawn_application("app_root" => @stub.app_root).close
+	end
+	
+	it "properly reloads applications that do not specify a Rails version" do
+		File.write(@stub.environment_rb) do |content|
+			content.sub(/^RAILS_GEM_VERSION = .*$/, '')
+		end
+		@stub.dont_use_vendor_rails
+		@manager.reload(@stub.app_root)
+		spawners = @manager.instance_eval { @spawners }
+		spawners.synchronize do
+			spawners.should be_empty
+		end
+	end
+end
+
+describe SpawnManager do
+	include TestHelper
+
+	it "can spawn a Rack application" do
+		use_stub('rack') do |stub|
+			@manager = SpawnManager.new
+			app = @manager.spawn_application(
+				"app_root" => stub.app_root,
+				"app_type" => "rack")
+			app.close
+		end
+	end
+end
+
+describe SpawnManager do
+	include TestHelper
+	
+	before :each do
+		@spawn_method = "smart"
+	end
+	
+	describe "smart spawning" do
+		it_should_behave_like "a minimal spawner"
+	end
+	
+	describe "smart-lv2 spawning" do
+		before :each do
+			@spawn_method = "smart-lv2"
+		end
+		
+		it_should_behave_like "a minimal spawner"
+	end
+	
+	describe "conservative spawning" do
+		before :each do
+			@spawn_method = "conservative"
+		end
+		
+		it_should_behave_like "a minimal spawner"
+	end
+	
+	it_should_behave_like "handling errors in application initialization"
+	it_should_behave_like "handling errors in framework initialization"
+	
+	def spawn_stub_application(stub)
+		spawner = SpawnManager.new
+		begin
+			return spawner.spawn_application(
+				"app_root" => stub.app_root,
+				"spawn_method" => @spawn_method)
+		ensure
+			spawner.cleanup
+		end
+	end
+	
+	def load_nonexistant_framework
+		# Prevent detect_framework_version from raising VersionNotFound
+		Application.instance_eval do
+			alias orig_detect_framework_version detect_framework_version
+			def detect_framework_version(app_root)
+				return "1.9.827"
+			end
+		end
+		begin
+			File.write(@stub.environment_rb, "RAILS_GEM_VERSION = '1.9.827'")
+			@stub.dont_use_vendor_rails
+			return spawn_stub_application(@stub)
+		ensure
+			Application.instance_eval do
+				alias detect_framework_version orig_detect_framework_version
+			end
+		end
+	end
+end

data/test/ruby/spawn_server_spec.rb

@@ -0,0 +1,26 @@
+require 'support/config'
+
+require 'ruby/abstract_server_spec'
+
+shared_examples_for "a spawn server" do
+	it_should_behave_like "AbstractServer"
+	
+	it "raises an AbstractServer::ServerError if the server was killed" do
+		Process.kill('SIGABRT', @spawner.server_pid)
+		spawning = lambda { spawn_arbitrary_application }
+		spawning.should raise_error(AbstractServer::ServerError)
+	end
+	
+	it "works correctly after a restart, if something went wrong" do
+		Process.kill('SIGABRT', @spawner.server_pid)
+		spawning = lambda { spawn_arbitrary_application }
+		spawning.should raise_error(AbstractServer::ServerError)
+		
+		@spawner.stop
+		@spawner.start
+		app = spawn_arbitrary_application
+		app.pid.should_not == 0
+		app.app_root.should_not be_nil
+		app.close
+	end
+end

data/test/ruby/utils_spec.rb

@@ -0,0 +1,67 @@
+require 'support/config'
+
+require 'tempfile'
+require 'phusion_passenger/utils'
+
+include PhusionPassenger
+
+describe Utils do
+	include Utils
+	
+	specify "#close_all_io_objects_for_fds closes all IO objects that are associated with the given file descriptors" do
+		filename = "#{Dir.tmpdir}/passenger_test.#{Process.pid}.txt"
+		begin
+			pid = fork do
+				begin
+					a, b = IO.pipe
+					close_all_io_objects_for_fds([0, 1, 2])
+					File.open(filename, "w") do |f|
+						f.write("#{a.closed?}, #{b.closed?}")
+					end
+				rescue Exception => e
+					print_exception("utils_spec", e)
+				ensure
+					exit!
+				end
+			end
+			Process.waitpid(pid) rescue nil
+			File.read(filename).should == "true, true"
+		ensure
+			File.unlink(filename) rescue nil
+		end
+	end
+	
+	describe "#passenger_tmpdir" do
+		before :each do
+			ENV.delete('PHUSION_PASSENGER_TMP')
+		end
+		
+		after :each do
+			ENV.delete('PHUSION_PASSENGER_TMP')
+		end
+		
+		it "returns Dir.tmpdir if ENV['PHUSION_PASSENGER_TMP'] is nil" do
+			passenger_tmpdir(false).should == Dir.tmpdir
+		end
+		
+		it "returns Dir.tmpdir if ENV['PHUSION_PASSENGER_TMP'] is an empty string" do
+			ENV['PHUSION_PASSENGER_TMP'] = ''
+			passenger_tmpdir(false).should == Dir.tmpdir
+		end
+		
+		it "returns ENV['PHUSION_PASSENGER_TMP'] if it's set" do
+			ENV['PHUSION_PASSENGER_TMP'] = '/foo'
+			passenger_tmpdir(false).should == '/foo'
+		end
+		
+		it "creates the directory if it doesn't exist, if the 'create' argument is true" do
+			ENV['PHUSION_PASSENGER_TMP'] = 'utils_spec.tmp'
+			passenger_tmpdir
+			begin
+				File.directory?('utils_spec.tmp').should be_true
+			ensure
+				Dir.rmdir('utils_spec.tmp') rescue nil
+			end
+		end
+	end
+end