rush3 3.0.0

data/spec/entry_spec.rb

@@ -0,0 +1,162 @@
+require_relative 'base'
+
+describe Rush::Entry do
+  before do
+    @sandbox_dir = "/tmp/rush_spec.#{Process.pid}/"
+    system "rm -rf #{@sandbox_dir}; mkdir -p #{@sandbox_dir}"
+
+    @filename = "#{@sandbox_dir}/test_file"
+    system "touch #{@filename}"
+
+    @entry = Rush::Entry.new(@filename)
+  end
+
+  after do
+    system "rm -rf #{@sandbox_dir}"
+  end
+
+  it 'knows its name' do
+    expect(@entry.name).to eq File.basename(@filename)
+  end
+
+  it 'knows its parent dir' do
+    expect(@entry.parent).to be_kind_of(Rush::Dir)
+    expect(@entry.parent.name).to eq File.basename(@sandbox_dir)
+    expect(@entry.parent.full_path).to eq @sandbox_dir
+  end
+
+  it 'cleans its pathname' do
+    expect(Rush::Entry.new('/a//b//c').full_path).to eq '/a/b/c'
+    expect(Rush::Entry.new('/1/2/../3').full_path).to eq '/1/3'
+  end
+
+  it 'knows its changed_at time' do
+    expect(@entry.changed_at).to eq File.stat(@filename).ctime
+  end
+
+  it 'knows its last_modified time' do
+    expect(@entry.last_modified).to eq File.stat(@filename).mtime
+  end
+
+  it 'knows its last_accessed time' do
+    expect(@entry.last_accessed).to eq File.stat(@filename).atime
+  end
+
+  it 'considers itself equal to other instances with the same full path' do
+    expect(Rush::Entry.new('/not/the/same')).to_not eq @entry
+    expect(Rush::Entry.new(@entry.full_path)).to eq @entry
+  end
+
+  it 'can rename itself' do
+    new_file = 'test2'
+
+    @entry.rename(new_file)
+
+    expect(File.exist?(@filename)).to eq false
+    expect(File.exist?("#{@sandbox_dir}/#{new_file}")).to eq true
+  end
+
+  it 'rename returns the renamed file' do
+    expect(@entry.rename('file2')).to eq @entry.parent['file2']
+  end
+
+  it 'can\'t rename itself if another file already exists with that name' do
+    new_file = 'test3'
+    system "touch #{@sandbox_dir}/#{new_file}"
+
+      expect { @entry.rename(new_file) }.to raise_error(Rush::NameAlreadyExists, /#{new_file}/)
+  end
+
+  it "can't rename itself to something with a slash in it" do
+    expect { @entry.rename('has/slash') }.to raise_error(Rush::NameCannotContainSlash, /slash/)
+  end
+
+  it 'can duplicate itself within the directory' do
+    expect(@entry.duplicate('newfile')).to eq Rush::File.new("#{@sandbox_dir}/newfile")
+  end
+
+  it 'can move itself to another dir' do
+    newdir = "#{@sandbox_dir}/newdir"
+    system "mkdir -p #{newdir}"
+
+    dst = Rush::Dir.new(newdir)
+    @entry.move_to(dst)
+
+    expect(File.exist?(@filename)).to eq false
+    expect(File.exist?("#{newdir}/#{@entry.name}")).to eq true
+  end
+
+  it 'can copy itself to another directory' do
+    newdir = "#{@sandbox_dir}/newdir"
+    system "mkdir -p #{newdir}"
+
+    dst = Rush::Dir.new(newdir)
+    @copied_dir = @entry.copy_to(dst)
+
+    expect(File.exist?(@filename)).to eq true
+    expect(File.exist?("#{newdir}/#{@entry.name}")).to eq true
+
+      expect(@copied_dir.full_path).to eq "#{@sandbox_dir}newdir/#{@entry.name}"
+  end
+
+  it 'can symlink itself as file' do
+    newdir = "#{@sandbox_dir}newdir"
+    system "mkdir -p #{newdir}"
+
+    dst  = newdir + "/link"
+    link = @entry.symlink(dst)
+
+    expect(File.exist?(dst)).to eq true
+    expect(File.symlink?(dst)).to eq true
+    expect(link.symlink?).to eq true
+
+    expect(link.full_path).to eq dst
+  end
+
+  it 'can symlink itself as directory' do
+    newdir = "#{@sandbox_dir}newdir"
+    system "mkdir -p #{newdir}"
+    dir = Rush::Dir.new( newdir + "/direct/")
+    dir.create
+
+    dst  = newdir + "/linked"
+    link = dir.symlink(dst)
+
+    expect(Dir.exist?(dst)).to eq true
+    expect(File.symlink?(dst)).to eq true
+
+    expect(link.full_path).to eq dst + '/'
+  end
+
+  it 'considers dotfiles to be hidden' do
+    expect(Rush::Entry.new("#{@sandbox_dir}/show")).to_not be_hidden
+    expect(Rush::Entry.new("#{@sandbox_dir}/.dont_show")).to be_hidden
+  end
+
+  it 'is considered equal to entries with the same full path and on the same box' do
+    same = Rush::Entry.new(@entry.full_path, @entry.box)
+    expect(@entry).to eq same
+  end
+
+  it 'is considered not equal to entries with the same full path on a different box' do
+    same = Rush::Entry.new(@entry.full_path, Rush::Box.new('dummy'))
+    expect(@entry).to_not eq same
+  end
+
+  it 'can mimic another entry' do
+    copy = Rush::Entry.new('abc', :dummy)
+    copy.mimic(@entry)
+    expect(copy.path).to eq @entry.path
+  end
+
+  it 'can update the read access permission' do
+    system "chmod 666 #{@filename}"
+    @entry.access = { :user_can => :read }
+    expect(`ls -l #{@filename}`).to match(/^-r--------/)
+  end
+
+  it 'reads the file permissions in the access hash' do
+    system "chmod 640 #{@filename}"
+    expect(@entry.access).to eq({ user_can_read: true, user_can_write: true, group_can_read: true })
+  end
+end

data/spec/file_spec.rb

@@ -0,0 +1,95 @@
+require_relative 'base'
+
+describe Rush::File do
+  before do
+    @sandbox_dir = "/tmp/rush_spec.#{Process.pid}"
+    system "rm -rf #{@sandbox_dir}; mkdir -p #{@sandbox_dir}"
+
+    @filename = "#{@sandbox_dir}/test_file"
+    @contents = '1234'
+    system "echo #{@contents} > #{@filename}"
+    @contents += "\n"
+
+    @file = Rush::File.new(@filename)
+  end
+
+  after do
+    system "rm -rf #{@sandbox_dir}"
+  end
+
+  it 'is a child of Rush::Entry' do
+    expect(@file).to be_kind_of(Rush::Entry)
+  end
+
+  it 'is not a dir' do
+    expect(@file).to_not be_dir
+  end
+
+  it 'can create itself as a blank file, and return itself' do
+    create_me = Rush::File.new("#{@sandbox_dir}/create_me")
+    expect(create_me.create).to eq create_me
+    expect(File.exist?("#{@sandbox_dir}/create_me")).to eq true
+  end
+
+  it 'can hardlink itself' do
+    newdir = "#{@sandbox_dir}newdir"
+    system "mkdir -p #{newdir}"
+
+    dst  = newdir + "/link"
+    link = @file.link(dst)
+
+    expect(File.exist?(dst)).to eq true
+
+    expect(link.full_path).to eq dst
+  end
+
+  it 'knows its size in bytes' do
+    expect(@file.size).to eq @contents.length
+  end
+
+  it 'can read its contents' do
+    expect(@file.contents).to eq @contents
+  end
+
+  it 'read is an alias for contents' do
+    expect(@file.read).to eq @contents
+  end
+
+  it 'can write new contents' do
+    @file.write('write test')
+    expect(@file.contents).to eq 'write test'
+  end
+
+  it 'can count the number of lines it contains' do
+    @file.write("1\n2\n3\n")
+    expect(@file.line_count).to eq 3
+  end
+
+  it 'searches its contents for matching lines' do
+    @file.write("a\n1\nb\n2\n")
+    expect(@file.search(/\d/)).to eq %w(1 2)
+  end
+
+  it 'search returns nil if no lines match' do
+    @file.write("a\nb\nc\n")
+    expect(@file.search(/\d/)).to eq nil
+  end
+
+  it 'find-in-file replace' do
+    @file.replace_contents!(/\d/, 'x')
+    expect(@file.contents).to eq "xxxx\n"
+  end
+
+  it 'can destroy itself' do
+    @file.destroy
+    expect(::File.exist?(@filename)).to eq false
+  end
+
+  it "can fetch contents or blank if doesn't exist" do
+    expect(Rush::File.new('/does/not/exist').contents_or_blank).to eq ''
+  end
+
+  it 'can fetch lines, or empty if doesn\'t exist' do
+    expect(Rush::File.new('/does/not/exist').lines_or_empty).to eq []
+  end
+end

data/spec/find_by_spec.rb

@@ -0,0 +1,58 @@
+require_relative 'base'
+
+describe Rush::FindBy do
+	before do
+		class Foo
+			attr_accessor :bar
+
+			def initialize(bar)
+				@bar = bar
+			end end
+
+		@one = Foo.new('one')
+		@two = Foo.new('two')
+		@three = Foo.new('three')
+
+		@list = [ @one, @two, @three ]
+	end
+
+	it "compare_or_match exact match success" do
+		expect(@list.compare_or_match('1', '1')).to eq true
+	end
+
+	it "compare_or_match exact match failure" do
+		expect(@list.compare_or_match('1', '2')).to eq false
+	end
+
+	it "compare_or_match regexp match success" do
+		expect(@list.compare_or_match('123', /2/)).to eq true
+	end
+
+	it "compare_or_match regexp match failure" do
+		expect(@list.compare_or_match('123', /x/)).to eq false
+	end
+
+	it "find_by_ extact match" do
+		expect(@list.find_by_bar('two')).to eq @two
+	end
+
+	it "find_by_ regexp match" do
+		expect(@list.find_by_bar(/.hree/)).to eq @three
+	end
+
+	it "find_all_by_ exact match" do
+		expect(@list.find_all_by_bar('one')).to eq [ @one ]
+	end
+
+	it "find_all_by_ regexp match" do
+		expect(@list.find_all_by_bar(/^...$/)).to eq [ @one, @two ]
+	end
+
+	it "find_by_ with field not recognized by objects raises no errors" do
+		@list.find_by_nothing('x')
+	end
+
+	it "raises NoMethodError for things other than find_by" do
+		expect { @list.does_not_exist }.to raise_error(NoMethodError)
+	end
+end

data/spec/integer_ext_spec.rb

@@ -0,0 +1,19 @@
+require_relative 'base'
+
+describe Integer do
+	before do
+		@num = 2
+	end
+
+	it "counts kb" do
+		expect(@num.kb).to eq 2*1024
+	end
+
+	it "counts mb" do
+		expect(@num.mb).to eq 2*1024*1024
+	end
+
+	it "counts gb" do
+		expect(@num.gb).to eq 2*1024*1024*1024
+	end
+end

data/spec/local_spec.rb

@@ -0,0 +1,363 @@
+require_relative 'base'
+
+describe Rush::Connection::Local do
+  before do
+    @sandbox_dir = "/tmp/rush_spec.#{Process.pid}"
+    system "rm -rf #{@sandbox_dir}; mkdir -p #{@sandbox_dir}"
+
+    @con = Rush::Connection::Local.new
+  end
+
+  after do
+    system "rm -rf #{@sandbox_dir}"
+  end
+
+  it "receive -> write_file(file, contents)" do
+    expect(@con).to receive(:write_file).with('file', 'contents')
+    @con.receive(:action => 'write_file', :full_path => 'file', :payload => 'contents')
+  end
+
+  it "receive -> append_to_file(file, contents)" do
+    expect(@con).to receive(:append_to_file).with('file', 'contents')
+    @con.receive(:action => 'append_to_file', :full_path => 'file', :payload => 'contents')
+  end
+
+  it "receive -> file_contents(file)" do
+    expect(@con).to receive(:file_contents).with('file').and_return('the contents')
+    expect(@con.receive(:action => 'file_contents', :full_path => 'file')).to eq 'the contents'
+  end
+
+  it "receive -> destroy(file or dir)" do
+    expect(@con).to receive(:destroy).with('file')
+    @con.receive(:action => 'destroy', :full_path => 'file')
+  end
+
+  it "receive -> purge(dir)" do
+    expect(@con).to receive(:purge).with('dir')
+    @con.receive(:action => 'purge', :full_path => 'dir')
+  end
+
+  it "receive -> create_dir(path)" do
+    expect(@con).to receive(:create_dir).with('dir')
+    @con.receive(:action => 'create_dir', :full_path => 'dir')
+  end
+
+  it "receive -> rename(path, name, new_name)" do
+    expect(@con).to receive(:rename).with('path', 'name', 'new_name')
+    @con.receive(:action => 'rename', :path => 'path', :name => 'name', :new_name => 'new_name')
+  end
+
+  it "receive -> copy(src, dst)" do
+    expect(@con).to receive(:copy).with('src', 'dst')
+    @con.receive(:action => 'copy', :src => 'src', :dst => 'dst')
+  end
+
+  it "receive -> read_archive(full_path)" do
+    expect(@con).to receive(:read_archive).with('full_path').and_return('archive data')
+    expect(@con.receive(:action => 'read_archive', :full_path => 'full_path')).to eq 'archive data'
+  end
+
+  it "receive -> write_archive(archive, dir)" do
+    expect(@con).to receive(:write_archive).with('archive', 'dir')
+    @con.receive(:action => 'write_archive', :dir => 'dir', :payload => 'archive')
+  end
+
+  it "receive -> index(base_path, glob)" do
+    expect(@con).to receive(:index).with('base_path', '*').and_return(%w(1 2))
+    expect(@con.receive(:action => 'index', :base_path => 'base_path', :glob => '*')).to eq "1\n2\n"
+  end
+
+  it "receive -> stat(full_path)" do
+    expect(@con).to receive(:stat).with('full_path').and_return(1 => 2)
+    expect(@con.receive(:action => 'stat', :full_path => 'full_path')).to eq YAML.dump(1 => 2)
+  end
+
+  it "receive -> set_access(full_path, user, group, permissions)" do
+    access = double("access")
+    expect(Rush::Access).to receive(:from_hash).with(:action => 'set_access', :full_path => 'full_path', :user => 'joe').and_return(access)
+
+    expect(@con).to receive(:set_access).with('full_path', access)
+    @con.receive(:action => 'set_access', :full_path => 'full_path', :user => 'joe')
+  end
+
+  it "receive -> size(full_path)" do
+    expect(@con).to receive(:size).with('full_path').and_return("1024")
+    expect(@con.receive(:action => 'size', :full_path => 'full_path')).to eq "1024"
+  end
+
+  it "receive -> chown(full_path, user, group, options)" do
+    options = { noop: true }
+    expect(@con).to receive(:chown).with('full_path', 'username', 'groupname', options )
+    @con.receive(:action => 'chown', :full_path => 'full_path', user: 'username', group: 'groupname', options: options)
+  end
+
+  it "receive -> processes" do
+    expect(@con).to receive(:processes).with(no_args).and_return([ { :pid => 1 } ])
+    expect(@con.receive(:action => 'processes')).to eq YAML.dump([ { :pid => 1 } ])
+  end
+
+  it "receive -> process_alive" do
+    expect(@con).to receive(:process_alive).with(123).and_return(true)
+    expect(@con.receive(:action => 'process_alive', :pid => 123)).to eq '1'
+  end
+
+  it "receive -> kill_process" do
+    expect(@con).to receive(:kill_process).with(123, :wait => 10).and_return(true)
+    @con.receive(:action => 'kill_process', :pid => '123', :payload => YAML.dump(:wait => 10))
+  end
+
+  it "receive -> bash (reset environment)" do
+    expect(@con).to receive(:bash).with('cmd', 'user', false, true).and_return('output')
+    expect(@con.receive(:action => 'bash', :payload => 'cmd', :user => 'user', :background => 'false', :reset_environment => 'true')).to eq 'output'
+  end
+
+  it "receive -> bash (foreground)" do
+    expect(@con).to receive(:bash).with('cmd', 'user', false, false).and_return('output')
+    expect(@con.receive(:action => 'bash', :payload => 'cmd', :user => 'user', :background => 'false')).to eq 'output'
+  end
+
+  it "receive -> bash (background)" do
+    expect(@con).to receive(:bash).with('cmd', 'user', true, false).and_return('output')
+    expect(@con.receive(:action => 'bash', :payload => 'cmd', :user => 'user', :background => 'true')).to eq 'output'
+  end
+
+  it "receive -> unknown action exception" do
+    expect { @con.receive(:action => 'does_not_exist') }.to raise_error(Rush::Connection::Local::UnknownAction)
+  end
+
+  it "write_file writes contents to a file" do
+    fname = "#{@sandbox_dir}/a_file"
+    data = "some data"
+    @con.write_file(fname, data)
+    expect(File.read(fname)).to eq data
+  end
+
+  it "append_to_file appends contents to a file" do
+    fname = "#{@sandbox_dir}/a_file"
+    system "echo line1 > #{fname}"
+    @con.append_to_file(fname, 'line2')
+    expect(File.read(fname)).to eq "line1\nline2"
+  end
+
+  it "file_contents reads a file's contents" do
+    fname = "#{@sandbox_dir}/a_file"
+    system "echo stuff > #{fname}"
+    expect(@con.file_contents(fname)).to eq "stuff\n"
+  end
+
+  it "file_contents raises DoesNotExist if the file does not exist" do
+    fname = "#{@sandbox_dir}/does_not_exist"
+    expect { @con.file_contents(fname) }.to raise_error(Rush::DoesNotExist, fname)
+  end
+
+  it "destroy to destroy a file or dir" do
+    fname = "#{@sandbox_dir}/delete_me"
+    system "touch #{fname}"
+    @con.destroy(fname)
+    expect(File.exists?(fname)).to eq false
+  end
+
+  it "purge to purge a dir" do
+    system "cd #{@sandbox_dir}; touch {1,2}; mkdir 3; touch 3/4"
+    @con.purge(@sandbox_dir)
+    expect(File.exists?(@sandbox_dir)).to eq true
+    expect(Dir.glob("#{@sandbox_dir}/*")).to eq([])
+  end
+
+  it "purge kills hidden (dotfile) entries too" do
+    system "cd #{@sandbox_dir}; touch .killme"
+    @con.purge(@sandbox_dir)
+    expect(File.exist?(@sandbox_dir)).to eq true
+    expect(`cd #{@sandbox_dir}; ls -lA | grep -v total | wc -l`.to_i).to eq 0
+  end
+
+  it "create_dir creates a directory" do
+    fname = "#{@sandbox_dir}/a/b/c/"
+    @con.create_dir(fname)
+    expect(File.directory?(fname)).to eq true
+  end
+
+  it "rename to rename entries within a dir" do
+    system "touch #{@sandbox_dir}/a"
+    @con.rename(@sandbox_dir, 'a', 'b')
+    expect(File.exists?("#{@sandbox_dir}/a")).to eq false
+    expect(File.exists?("#{@sandbox_dir}/b")).to eq true
+  end
+
+  it "copy to copy an entry to another dir on the same box" do
+    system "mkdir #{@sandbox_dir}/subdir"
+    system "touch #{@sandbox_dir}/a"
+    @con.copy("#{@sandbox_dir}/a", "#{@sandbox_dir}/subdir")
+    expect(File.exists?("#{@sandbox_dir}/a")).to eq true
+    expect(File.exists?("#{@sandbox_dir}/subdir/a")).to eq true
+  end
+
+  it "copy raises DoesNotExist with source path if it doesn't exist or otherwise can't be accessed" do
+    expect { @con.copy('/does/not/exist', '/tmp') }.to raise_error(Rush::DoesNotExist, '/does/not/exist')
+  end
+
+  it "copy raises DoesNotExist with destination path if it can't access the destination" do
+    expect { @con.copy('/tmp', '/does/not/exist') }.to raise_error(Rush::DoesNotExist, '/does/not')
+  end
+
+  it "read_archive to pull an archive of a dir into a byte stream" do
+    system "touch #{@sandbox_dir}/a"
+    expect(@con.read_archive(@sandbox_dir).size).to be > 50
+  end
+
+  it "read_archive works for paths with spaces" do
+    system "mkdir -p #{@sandbox_dir}/with\\ space; touch #{@sandbox_dir}/with\\ space/a"
+    expect(@con.read_archive("#{@sandbox_dir}/with space").size).to be > 50
+  end
+
+  it "write_archive to turn a byte stream into a dir" do
+    system "cd #{@sandbox_dir}; mkdir -p a; touch a/b; tar cf xfer.tar a; mkdir dst"
+    archive = File.read("#{@sandbox_dir}/xfer.tar")
+    @con.write_archive(archive, "#{@sandbox_dir}/dst")
+    expect(File.directory?("#{@sandbox_dir}/dst/a")).to eq true
+    expect(File.exist?("#{@sandbox_dir}/dst/a/b")).to eq true
+  end
+
+  it "write_archive works for paths with spaces" do
+    system "cd #{@sandbox_dir}; mkdir -p a; touch a/b; tar cf xfer.tar a; mkdir with\\ space"
+    archive = File.read("#{@sandbox_dir}/xfer.tar")
+    @con.write_archive(archive, "#{@sandbox_dir}/with space")
+    expect(File.directory?("#{@sandbox_dir}/with space/a")).to eq true
+    expect(File.exists?("#{@sandbox_dir}/with space/a/b")).to eq true
+  end
+
+  it "index fetches list of all files and dirs in a dir when pattern is empty" do
+    system "cd #{@sandbox_dir}; mkdir dir; touch file"
+    expect(@con.index(@sandbox_dir, '')).to eq([ 'dir/', 'file' ])
+  end
+
+  it "index fetches only files with a certain extension with a flat pattern, *.rb" do
+    system "cd #{@sandbox_dir}; touch a.rb; touch b.txt"
+    expect(@con.index(@sandbox_dir, '*.rb')).to eq [ 'a.rb' ]
+  end
+
+  it "index raises DoesNotExist when the base path is invalid" do
+    expect { @con.index('/does/not/exist', '*') }.to raise_error(Rush::DoesNotExist, '/does/not/exist')
+  end
+
+  it "stat gives file stats like size and timestamps" do
+    expect(@con.stat(@sandbox_dir)).to have_key(:ctime)
+    expect(@con.stat(@sandbox_dir)).to have_key(:size)
+  end
+
+  it "stat fetches the octal permissions" do
+    expect(@con.stat(@sandbox_dir)[:mode]).to be_kind_of(Integer)
+  end
+
+  it "stat raises DoesNotExist if the entry does not exist" do
+    fname = "#{@sandbox_dir}/does_not_exist"
+    expect { @con.stat(fname) }.to raise_error(Rush::DoesNotExist, fname)
+  end
+
+  it "set_access invokes the access object" do
+    access = double("access")
+    expect(access).to receive(:apply).with('/some/path')
+    @con.set_access('/some/path', access)
+  end
+
+  it "size gives size of a directory and all its contents recursively" do
+    system "mkdir -p #{@sandbox_dir}/a/b/; echo 1234 > #{@sandbox_dir}/a/b/c"
+    expect(@con.size(@sandbox_dir)).to eq (::File.stat(@sandbox_dir).size*3 + 5)
+  end
+
+  it "parses ps output on os x" do
+    expect(@con.parse_ps("21712   501   21711   1236   0 /usr/bin/vi somefile.rb")).to eq({
+      :pid => "21712",
+      :uid => "501",
+      :parent_pid => 21711,
+      :mem => 1236,
+      :cpu => 0,
+      :command => '/usr/bin/vi',
+      :cmdline => '/usr/bin/vi somefile.rb',
+    })
+  end
+
+  it "gets the list of processes on os x via the ps command" do
+    expect(@con).to receive(:os_x_raw_ps).and_return <<EOPS
+PID UID   PPID  RSS  CPU COMMAND
+1     0      1 1111   0 cmd1 args
+2   501      1  222   1 cmd2
+EOPS
+    expect(@con.os_x_processes).to eq [
+      { :pid => "1", :uid => "0", :parent_pid => 1, :mem => 1111, :cpu => 0, :command => "cmd1", :cmdline => "cmd1 args" },
+      { :pid => "2", :uid => "501", :parent_pid => 1, :mem => 222, :cpu => 1, :command => "cmd2", :cmdline => "cmd2" },
+    ]
+  end
+
+  it "the current process should be alive" do
+    expect(@con.process_alive(Process.pid)).to eq true
+  end
+
+  it "a made-up process should not be alive" do
+    expect(@con.process_alive(99999)).to eq false
+  end
+
+  it "kills a process by pid sending a TERM" do
+    allow(@con).to receive(:process_alive).and_return(false)
+    expect(::Process).to receive(:kill).with('TERM', 123).once
+    @con.kill_process(123)
+  end
+
+  it "kills a process by pid sending a KILL signal if TERM doesn't work" do
+    allow(@con).to receive(:process_alive).and_return(true)
+    expect(::Process).to receive(:kill).with('TERM', 123).at_least(:twice)
+    expect(::Process).to receive(:kill).with('KILL', 123)
+    @con.kill_process(123)
+  end
+
+  it "kills a process by pid without sending TERM if :wait is zero" do
+    expect(::Process).to_not receive(:kill).with('TERM', 123)
+    expect(::Process).to receive(:kill).with('KILL', 123)
+    @con.kill_process(123, :wait => 0)
+  end
+
+  it "does not raise an error if the process is already dead" do
+    expect(::Process).to receive(:kill).and_raise(Errno::ESRCH)
+    expect { @con.kill_process(123) }.to_not raise_error
+  end
+
+  it "executes a bash command, returning stdout when successful" do
+    expect(@con.bash("echo test")).to eq "test\n"
+  end
+
+  it "executes a bash command, raising and error (with stderr as the message) when return value is nonzero" do
+    expect { @con.bash("no_such_bin") }.to raise_error(Rush::BashFailed, /command not found/)
+  end
+
+  it "executes a bash command as another user using sudo" do
+    expect(@con.bash("echo test2", ENV['USER'])).to eq "test2\n"
+  end
+
+  it "executes a bash command in the background, returning the pid" do
+    expect(@con.bash("true", nil, true)).to be > 0
+  end
+
+  it "ensure_tunnel to match with remote connection" do
+    @con.ensure_tunnel
+  end
+
+  it "always returns true on alive?" do
+    expect(@con).to be_alive
+  end
+
+  it "resolves a unix uid to a user" do
+    expect(@con.resolve_unix_uid_to_user(0)).to eq "root"
+    expect(@con.resolve_unix_uid_to_user('0')).to eq "root"
+  end
+
+  it "returns nil if the unix uid does not exist" do
+    expect(@con.resolve_unix_uid_to_user(9999)).to eq nil
+  end
+
+  it "iterates through a process list and resolves the unix uid for each" do
+    list = [ { :uid => 0, :command => 'pureftpd' }, { :uid => 9999, :command => 'defunk' } ]
+    expect(@con.resolve_unix_uids(list))
+      .to eq([{ :uid => 0, :user => 'root', :command => 'pureftpd' },
+              { :uid => 9999, :command => 'defunk', :user => nil }])
+  end
+end