require 'spec_helper' describe 'Gitlab::Git::Popen' do let(:path) { Rails.root.join('tmp').to_s } let(:test_string) { 'The quick brown fox jumped over the lazy dog' } # The pipe buffer is typically 64K. This string is about 440K. let(:spew_command) { ['bash', '-c', "for i in {1..10000}; do echo '#{test_string}' 1>&2; done"] } let(:klass) do Class.new(Object) do include Gitlab::Git::Popen end end context 'popen' do context 'zero status' do let(:result) { klass.new.popen(%w(ls), path) } let(:output) { result.first } let(:status) { result.last } it { expect(status).to be_zero } it { expect(output).to include('tests') } end context 'non-zero status' do let(:result) { klass.new.popen(%w(cat NOTHING), path) } let(:output) { result.first } let(:status) { result.last } it { expect(status).to eq(1) } it { expect(output).to include('No such file or directory') } end context 'unsafe string command' do it 'raises an error when it gets called with a string argument' do expect { klass.new.popen('ls', path) }.to raise_error(RuntimeError) end end context 'with custom options' do let(:vars) { { 'foobar' => 123, 'PWD' => path } } let(:options) { { chdir: path } } it 'calls popen3 with the provided environment variables' do expect(Open3).to receive(:popen3).with(vars, 'ls', options) klass.new.popen(%w(ls), path, { 'foobar' => 123 }) end end context 'use stdin' do let(:result) { klass.new.popen(%w[cat], path) { |stdin| stdin.write 'hello' } } let(:output) { result.first } let(:status) { result.last } it { expect(status).to be_zero } it { expect(output).to eq('hello') } end context 'with lazy block' do it 'yields a lazy io' do expect_lazy_io = lambda do |io| expect(io).to be_a Enumerator::Lazy expect(io.inspect).to include('#(io) {}) end end end context 'with a process that writes a lot of data to stderr' do it 'returns zero' do output, status = klass.new.popen(spew_command, path) expect(output).to include(test_string) expect(status).to eq(0) end end end context 'popen_with_timeout' do let(:timeout) { 1.second } context 'no timeout' do context 'zero status' do let(:result) { klass.new.popen_with_timeout(%w(ls), timeout, path) } let(:output) { result.first } let(:status) { result.last } it { expect(status).to be_zero } it { expect(output).to include('tests') } end context 'multi-line string' do let(:test_string) { "this is 1 line\n2nd line\n3rd line\n" } let(:result) { klass.new.popen_with_timeout(['echo', test_string], timeout, path) } let(:output) { result.first } let(:status) { result.last } it { expect(status).to be_zero } # echo adds its own line it { expect(output).to eq(test_string + "\n") } end context 'non-zero status' do let(:result) { klass.new.popen_with_timeout(%w(cat NOTHING), timeout, path) } let(:output) { result.first } let(:status) { result.last } it { expect(status).to eq(1) } it { expect(output).to include('No such file or directory') } end context 'unsafe string command' do it 'raises an error when it gets called with a string argument' do expect { klass.new.popen_with_timeout('ls', timeout, path) }.to raise_error(RuntimeError) end end end context 'timeout' do context 'timeout' do it "raises a Timeout::Error" do expect { klass.new.popen_with_timeout(%w(sleep 1000), timeout, path) }.to raise_error(Timeout::Error) end it "handles processes that do not shutdown correctly" do expect { klass.new.popen_with_timeout(['bash', '-c', "trap -- '' SIGTERM; sleep 1000"], timeout, path) }.to raise_error(Timeout::Error) end it 'handles process that writes a lot of data to stderr' do output, status = klass.new.popen_with_timeout(spew_command, timeout, path) expect(output).to include(test_string) expect(status).to eq(0) end end context 'timeout period' do let(:time_taken) do begin start = Time.now klass.new.popen_with_timeout(%w(sleep 1000), timeout, path) rescue Time.now - start end end it { expect(time_taken).to be >= timeout } end context 'clean up' do let(:instance) { klass.new } it 'kills the child process' do expect(instance).to receive(:kill_process_group_for_pid).and_wrap_original do |m, *args| # is the PID, and it should not be running at this point m.call(*args) pid = args.first begin Process.getpgid(pid) raise "The child process should have been killed" rescue Errno::ESRCH end end expect { instance.popen_with_timeout(['bash', '-c', "trap -- '' SIGTERM; sleep 1000"], timeout, path) }.to raise_error(Timeout::Error) end end end end end