src/test/shell/integration/client_test.sh - bazel - Git at Google

 #!/bin/bash
 # Copyright 2018 The Bazel Authors. All rights reserved.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
 #
 #    http://www.apache.org/licenses/LICENSE-2.0
 #
 # Unless required by applicable law or agreed to in writing, software
 # distributed under the License is distributed on an "AS IS" BASIS,
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
 # Tests of the bazel client.

 CURRENT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 source "${CURRENT_DIR}/../integration_test_setup.sh" \
   || { echo "integration_test_setup.sh not found!" >&2; exit 1; }


 #### TESTS #############################################################

 function test_client_debug() {
   # Test that --client_debug sends log statements to stderr.
   bazel --client_debug version >&$TEST_log || fail "'bazel version' failed"
   expect_log "Debug logging requested"
   bazel --client_debug --batch version >&$TEST_log || fail "'bazel version' failed"
   expect_log "Debug logging requested"

   # Test that --client_debug can be disabled
   bazel --noclient_debug version >&$TEST_log || fail "'bazel version' failed"
   expect_not_log "Debug logging requested"
   bazel --noclient_debug --batch version >&$TEST_log || fail "'bazel version' failed"
   expect_not_log "Debug logging requested"

   # Test that --client_debug is off by default.
   bazel --ignore_all_rc_files version >&$TEST_log || fail "'bazel version' failed"
   expect_not_log "Debug logging requested"
   bazel  --ignore_all_rc_files --batch version >&$TEST_log || fail "'bazel version' failed"
   expect_not_log "Debug logging requested"
 }

 function test_client_debug_change_does_not_restart_server() {
   local server_pid1=$(bazel --client_debug info server_pid 2>$TEST_log)
   local server_pid2=$(bazel info server_pid 2>$TEST_log)
   assert_equals "$server_pid1" "$server_pid2"
   expect_not_log "WARNING.* Running B\\(azel\\|laze\\) server needs to be killed"
 }

 function test_server_restart_due_to_startup_options() {
   local server_pid1=$(bazel --write_command_log info server_pid 2>$TEST_log)
   local server_pid2=$(bazel --nowrite_command_log info server_pid 2>$TEST_log)
   assert_not_equals "$server_pid1" "$server_pid2" # pid changed.
   expect_log "WARNING.* Running B\\(azel\\|laze\\) server needs to be killed"
 }

 function test_multiple_requests_same_server() {
   local server_pid1=$(bazel info server_pid 2>$TEST_log)
   local server_pid2=$(bazel info server_pid 2>$TEST_log)
   assert_equals "$server_pid1" "$server_pid2"
   expect_not_log "WARNING.* Running B\\(azel\\|laze\\) server needs to be killed"
 }

 function test_no_server_restart_if_options_order_changes() {
   local server_pid1=$(bazel \
                       --host_jvm_args=-Dfoo \
                       --host_jvm_args=-Dfoo \
                       --host_jvm_args=-Dbar \
                       --client_debug info server_pid 2>$TEST_log)
   local server_pid2=$(bazel \
                       --host_jvm_args=-Dfoo \
                       --host_jvm_args=-Dbar \
                       --host_jvm_args=-Dfoo \
                       --client_debug info server_pid 2>$TEST_log)
   assert_equals "$server_pid1" "$server_pid2"
   expect_not_log "WARNING.* Running B\\(azel\\|laze\\) server needs to be killed"
 }

 function test_server_restart_if_number_of_option_instances_increases() {
   local server_pid1=$(bazel \
                       --host_jvm_args=-Dfoo \
                       --client_debug info server_pid 2>$TEST_log)
   local server_pid2=$(bazel \
                       --host_jvm_args -Dfoo \
                       --host_jvm_args -Dfoo \
                       --client_debug info server_pid 2>$TEST_log)
   assert_not_equals "$server_pid1" "$server_pid2"
   expect_log "\\[WARNING .*\\] Running B\\(azel\\|laze\\) server needs to be killed"
   expect_log "\\[INFO .*\\] Args from the current request that were not included when creating the server:"
   expect_log "\\[INFO .*\\]   --host_jvm_args=-Dfoo"
 }

 function test_server_restart_if_number_of_option_instances_decreases() {
   local server_pid1=$(bazel \
                       --host_jvm_args=-Dfoo \
                       --host_jvm_args -Dfoo \
                       --client_debug info server_pid 2>$TEST_log)
   local server_pid2=$(bazel \
                       --host_jvm_args -Dfoo \
                       --client_debug info server_pid 2>$TEST_log)
   assert_not_equals "$server_pid1" "$server_pid2"
   expect_log "\\[WARNING .*\\] Running B\\(azel\\|laze\\) server needs to be killed"
   expect_log "\\[INFO .*\\] Args from the running server that are not included in the current request:"
   expect_log "\\[INFO .*\\]   --host_jvm_args=-Dfoo"
 }

 function test_server_not_restarted_when_only_TMPDIR_changes() {
   mkdir tmp1
   mkdir tmp2
   tmp1path="$(pwd)/tmp1"
   tmp2path="$(pwd)/tmp2"
   PID1=$(export TMPDIR="$tmp1path" && bazel info server_pid 2>$TEST_log) \
      || fail "bazel info failed"
   PID2=$(export TMPDIR="$tmp2path" && bazel info server_pid 2>$TEST_log) \
      || fail "bazel info failed"
   expect_not_log "Running B\\(azel\\|laze\\) server needs to be killed."

   assert_equals "$PID1" "$PID2"
 }

 function test_server_restarted_on_explicit_heap_dump_path_change() {
   mkdir tmp1
   mkdir tmp2
   tmp1path="$(pwd)/tmp1"
   tmp2path="$(pwd)/tmp2"
   PID1=$(bazel --host_jvm_args=-XX:HeapDumpPath="$tmp1path" info server_pid \
      2>$TEST_log) || fail "bazel info failed"
   PID2=$(bazel --host_jvm_args=-XX:HeapDumpPath="$tmp2path" info server_pid \
      2>$TEST_log) || fail "bazel info failed"
   expect_log "Running B\\(azel\\|laze\\) server needs to be killed."

   assert_not_equals "$PID1" "$PID2"
 }

 function test_shutdown() {
   local server_pid1=$(bazel info server_pid 2>$TEST_log)
   bazel shutdown >& $TEST_log || fail "Expected success"
   local server_pid2=$(bazel info server_pid 2>$TEST_log)
   assert_not_equals "$server_pid1" "$server_pid2"
   expect_not_log "WARNING.* Running B\\(azel\\|laze\\) server needs to be killed"
   expect_log "Starting local B\\(azel\\|laze\\) server and connecting to it"
 }

 function test_shutdown_different_options() {
   bazel --host_jvm_args=-Di.am.a=teapot info >& $TEST_log || fail "Expected success"
   bazel shutdown >& $TEST_log || fail "Expected success"
   expect_log "WARNING.* Running B\\(azel\\|laze\\) server needs to be killed"
   expect_not_log "Starting local B\\(azel\\|laze\\) server and connecting to it"
 }

 function test_server_restart_due_to_startup_options_with_client_debug_information() {
   # Using --write_command_log for no particular reason, if that flag is removed, another startup
   # option will do just fine.
   local server_pid1=$(bazel --client_debug --write_command_log info server_pid 2>$TEST_log)
   local server_pid2=$(bazel --client_debug --nowrite_command_log info server_pid 2>$TEST_log)
   assert_not_equals "$server_pid1" "$server_pid2" # pid changed.
   expect_log "\\[WARNING .*\\] Running B\\(azel\\|laze\\) server needs to be killed"
   expect_log "\\[INFO .*\\] Args from the running server that are not included in the current request:"
   expect_log "\\[INFO .*\\]   --write_command_log"
   expect_log "\\[INFO .*\\] Args from the current request that were not included when creating the server:"
   expect_log "\\[INFO .*\\]   --nowrite_command_log"
 }

 function test_exit_code() {
   bazel query not_a_query >/dev/null &>$TEST_log &&
       fail "bazel query: expected nonzero exit"
   expect_log "'not_a_query'"
 }

 function test_output_base() {
   out=$(bazel --output_base=$TEST_TMPDIR/output info output_base 2>$TEST_log)
   assert_equals $TEST_TMPDIR/output "$out"
 }

 function test_output_base_is_file() {
   bazel --output_base=/dev/null &>$TEST_log && fail "Expected non-zero exit"
   expect_log "FATAL.* Output base directory '/dev/null' could not be created.*exists"
 }

 function test_cannot_create_output_base() {
   bazel --output_base=/foo &>$TEST_log && fail "Expected non-zero exit"
   expect_log "FATAL.* Output base directory '/foo' could not be created"
 }

 function test_nonwritable_output_base() {
   bazel --output_base=/ &>$TEST_log && fail "Expected non-zero exit"
   expect_log "FATAL.* Output base directory '/' must be readable and writable."
 }

 function test_install_base_races_dont_leave_temp_files() {
   declare -a client_pids
   for i in {1..3}; do
     bazel --install_base="$TEST_TMPDIR/race/install" \
         --output_base="$TEST_TMPDIR/out$i" info install_base &
     client_pids+=($!)
   done
   for pid in "${client_pids[@]}"; do
     wait $pid
   done
   # Expect "install" to be the only thing in the "race" directory.
   assert_equals "install" "$(ls "$TEST_TMPDIR/race/")"
 }

 function test_no_arguments() {
   bazel >&$TEST_log || fail "Expected zero exit"
   expect_log "Usage: b\\(laze\\|azel\\)"
 }

 function test_local_startup_timeout() {
   local output_base=$(bazel info output_base 2>"$TEST_log") ||
     fail "bazel info failed"

   # --host-jvm_debug will cause the server to block, forcing the client
   # into the timeout condition.
   bazel --host_jvm_args="-agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=localhost:41687" \
       --local_startup_timeout_secs=1 2>"$TEST_log" &
   local timeout=20
   while true; do
     local jobs_output=$(jobs)
     [[ $jobs_output =~ Exit ]] && break
     [[ $jobs_output =~ Done ]] && fail "bazel should have exited non-zero"

     timeout="$(( ${timeout} - 1 ))"
     [[ "${timeout}" -gt 0 ]] || {
       kill -9 %1
       wait %1
       fail "--local_startup_timeout_secs was not respected"
     }
     # Wait for the client to exit.
     sleep 1
   done

   expect_log "Starting local.*server and connecting to it"
   expect_log "FATAL: couldn't connect to server"
 }

 function test_max_idle_secs() {
   # TODO(https://github.com/bazelbuild/bazel/issues/6773): Remove when fixed.
   bazel shutdown

   local options=( --max_idle_secs=1 )

   local output_base
   output_base="$(bazel "${options[@]}" info output_base 2>"$TEST_log")" \
     || fail "bazel info failed"
   local timeout=60  # Lower than the default --max_idle_secs.
   while [[ -f "${output_base}/server/server.pid.txt" ]]; do
     timeout="$(( ${timeout} - 1 ))"
     [[ "${timeout}" -gt 0 ]] || fail "--max_idle_secs was not respected"

     # Wait for the server to go away.
     sleep 1
   done

   bazel "${options[@]}" info >"$TEST_log" 2>&1 || fail "bazel info failed"
   expect_log "Starting local.*server and connecting to it"
   # Ensure the restart was not triggered by different startup options.
   expect_not_log "WARNING: Running B\\(azel\\|laze\\) server needs to be killed"
 }

 function test_dashdash_before_command() {
   bazel -- info &>$TEST_log && "Expected failure"
   exitcode=$?
   assert_equals 2 $exitcode
   expect_log "\\[FATAL .*\\] Unknown startup option: '--'."
 }

 function test_dashdash_after_command() {
   bazel info -- &>$TEST_log || fail "info -- failed"
 }

 function test_nobatch() {
   local pid1=$(bazel --batch --nobatch info server_pid 2> $TEST_log)
   local pid2=$(bazel --batch --nobatch info server_pid 2> $TEST_log)
   assert_equals "$pid1" "$pid2"
   expect_not_log "WARNING.* Running B\\(azel\\|laze\\) server needs to be killed"
 }

 # Regression test for #1875189, "bazel client should pass through '--help' like
 # a command".
 function test_bazel_dash_dash_help_is_passed_through() {
   bazel --help >&$TEST_log
   expect_log "Usage: b\\(azel\\|laze\\) <command> <options> ..."
   expect_not_log "Unknown startup option: '--help'."
 }

 function test_bazel_dash_help() {
   bazel -help >&$TEST_log
   expect_log "Usage: b\\(azel\\|laze\\) <command> <options> ..."
 }

 function test_bazel_dash_h() {
   bazel -h >&$TEST_log
   expect_log "Usage: b\\(azel\\|laze\\) <command> <options> ..."
 }

 function test_bazel_dash_s_is_not_parsed() {
   bazel -s --help >&$TEST_log && fail "Expected failure"
   expect_log "Unknown startup option: '-s'."
 }

 function test_batch() {
   local pid1=$(bazel info server_pid 2> $TEST_log)
   local pid2=$(bazel --batch info server_pid 2> $TEST_log)
   assert_not_equals "$pid1" "$pid2"
   expect_log "WARNING.* Running B\\(azel\\|laze\\) server needs to be killed"
 }

 function test_cmdline_not_written_in_batch_mode() {
   OUTPUT_BASE=$(bazel --batch info output_base 2> $TEST_log)
   rm -f $OUTPUT_BASE/server/cmdline
   OUTPUT_BASE2=$(bazel --batch info output_base 2> $TEST_log)
   assert_equals "$OUTPUT_BASE" "$OUTPUT_BASE2"
   [[ ! -e $OUTPUT_BASE/server/cmdline ]] || fail "Command line file written."
 }

 function test_bad_command_batch() {
   bazel --batch notacommand &> $TEST_log && "Expected failure"
   exitcode=$?
   assert_equals 2 "$exitcode"
   expect_log "Command 'notacommand' not found."
 }

 function test_bad_command_nobatch() {
   bazel --nobatch notacommand &> $TEST_log && "Expected failure"
   exitcode=$?
   assert_equals 2 "$exitcode"
   expect_log "Command 'notacommand' not found."
 }

 function get_pid_environment() {
   local pid="$1"
   case "$(uname -s)" in
     Linux)
       cat "/proc/${pid}/environ" | tr '\0' '\n'
       ;;
     Darwin)
       if ! ps > /dev/null; then
         echo "Cannot use ps command, probably due to sandboxing." >&2
         return 1
       fi
       ps eww -o command "${pid}" | tr ' ' '\n'
       ;;
     *)
       false
       ;;
   esac
 }

 function test_proxy_settings() {
   # We expect that proxy settings are propagated from the client to the server
   # process, but are _not_ used for client-server communication.

   bazel shutdown  # We are changing the server process's environment variables.

   local example_no_proxy='foo.example.com'
   # A known-invalid http*_proxy value which, if not ignored, would be expected
   # to cause the client-server gRPC channel to time out or otherwise fail.
   local invalid_proxy='http://localhost:0'
   local server_pid
   server_pid="$(http_proxy="${invalid_proxy}" HTTP_PROXY="${invalid_proxy}" \
     https_proxy="${invalid_proxy}" HTTPS_PROXY="${invalid_proxy}" \
     no_proxy="${example_no_proxy}" NO_PROXY="${example_no_proxy}" \
     bazel info server_pid 2> $TEST_log)" \
     || fail "http*_proxy env variables not ignored by client-server channel."

   # Check that the server uses the *_proxy env variables set by the client.
   if get_pid_environment "${server_pid}" > "${TEST_TMPDIR}/server_env"; then
     local var
     for var in http{,s}_proxy HTTP{,S}_PROXY; do
       assert_contains "^${var}=${invalid_proxy}\$" "${TEST_TMPDIR}/server_env"
     done
     for var in no_proxy NO_PROXY; do
       assert_contains "^${var}=${example_no_proxy}\$" \
         "${TEST_TMPDIR}/server_env"
     done
   else
     echo "Cannot not test server process environment on this platform"
   fi
 }

 function test_macos_qos_class() {
   for class in utility background; do
     bazel --macos_qos_class="${class}" info >"${TEST_log}" 2>&1 \
       || fail "Unknown QoS class ${class}"
     # On macOS it'd be nice to verify that the server is indeed running at the
     # desired class... but this is very hard to do.  Common utilities do not
     # print the QoS level, and powermetrics (which requires root privileges)
     # only reports it under load -- so an "info" command is insufficient and the
     # real thing would be quite expensive.
   done

   for class in user-interactive user-initiated default ; do
     bazel --macos_qos_class="${class}" >"${TEST_log}" 2>&1 \
       && fail "Expected failure with invalid QoS class name"
     expect_log "Invalid argument.*qos_class.*${class}"
   done
 }

 function test_ignores_jdk_option_environment_variables() {
   bazel shutdown  # Environment variables are only checked on server startup
   _JAVA_OPTIONS=--wat1 JDK_JAVA_OPTIONS=--wat2 JAVA_TOOL_OPTIONS=--wat3 \
     bazel version >&$TEST_log || fail "_JAVA_OPTIONS not ignored"

   expect_log ".*ignoring _JAVA_OPTIONS"
   expect_log ".*ignoring JDK_JAVA_OPTIONS"
   expect_log ".*ignoring JAVA_TOOL_OPTIONS"
 }

 run_suite "Tests of the bazel client."
	#!/bin/bash
	# Copyright 2018 The Bazel Authors. All rights reserved.
	#
	# Licensed under the Apache License, Version 2.0 (the "License");
	# you may not use this file except in compliance with the License.
	# You may obtain a copy of the License at
	#
	# http://www.apache.org/licenses/LICENSE-2.0
	#
	# Unless required by applicable law or agreed to in writing, software
	# distributed under the License is distributed on an "AS IS" BASIS,
	# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	# See the License for the specific language governing permissions and
	# limitations under the License.
	#
	# Tests of the bazel client.

	CURRENT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
	source "${CURRENT_DIR}/../integration_test_setup.sh" \
	\|\| { echo "integration_test_setup.sh not found!" >&2; exit 1; }


	#### TESTS #############################################################

	function test_client_debug() {
	# Test that --client_debug sends log statements to stderr.
	bazel --client_debug version >&$TEST_log \|\| fail "'bazel version' failed"
	expect_log "Debug logging requested"
	bazel --client_debug --batch version >&$TEST_log \|\| fail "'bazel version' failed"
	expect_log "Debug logging requested"

	# Test that --client_debug can be disabled
	bazel --noclient_debug version >&$TEST_log \|\| fail "'bazel version' failed"
	expect_not_log "Debug logging requested"
	bazel --noclient_debug --batch version >&$TEST_log \|\| fail "'bazel version' failed"
	expect_not_log "Debug logging requested"

	# Test that --client_debug is off by default.
	bazel --ignore_all_rc_files version >&$TEST_log \|\| fail "'bazel version' failed"
	expect_not_log "Debug logging requested"
	bazel --ignore_all_rc_files --batch version >&$TEST_log \|\| fail "'bazel version' failed"
	expect_not_log "Debug logging requested"
	}

	function test_client_debug_change_does_not_restart_server() {
	local server_pid1=$(bazel --client_debug info server_pid 2>$TEST_log)
	local server_pid2=$(bazel info server_pid 2>$TEST_log)
	assert_equals "$server_pid1" "$server_pid2"
	expect_not_log "WARNING.* Running B\\(azel\\\|laze\\) server needs to be killed"
	}

	function test_server_restart_due_to_startup_options() {
	local server_pid1=$(bazel --write_command_log info server_pid 2>$TEST_log)
	local server_pid2=$(bazel --nowrite_command_log info server_pid 2>$TEST_log)
	assert_not_equals "$server_pid1" "$server_pid2" # pid changed.
	expect_log "WARNING.* Running B\\(azel\\\|laze\\) server needs to be killed"
	}

	function test_multiple_requests_same_server() {
	local server_pid1=$(bazel info server_pid 2>$TEST_log)
	local server_pid2=$(bazel info server_pid 2>$TEST_log)
	assert_equals "$server_pid1" "$server_pid2"
	expect_not_log "WARNING.* Running B\\(azel\\\|laze\\) server needs to be killed"
	}

	function test_no_server_restart_if_options_order_changes() {
	local server_pid1=$(bazel \
	--host_jvm_args=-Dfoo \
	--host_jvm_args=-Dfoo \
	--host_jvm_args=-Dbar \
	--client_debug info server_pid 2>$TEST_log)
	local server_pid2=$(bazel \
	--host_jvm_args=-Dfoo \
	--host_jvm_args=-Dbar \
	--host_jvm_args=-Dfoo \
	--client_debug info server_pid 2>$TEST_log)
	assert_equals "$server_pid1" "$server_pid2"
	expect_not_log "WARNING.* Running B\\(azel\\\|laze\\) server needs to be killed"
	}

	function test_server_restart_if_number_of_option_instances_increases() {
	local server_pid1=$(bazel \
	--host_jvm_args=-Dfoo \
	--client_debug info server_pid 2>$TEST_log)
	local server_pid2=$(bazel \
	--host_jvm_args -Dfoo \
	--host_jvm_args -Dfoo \
	--client_debug info server_pid 2>$TEST_log)
	assert_not_equals "$server_pid1" "$server_pid2"
	expect_log "\\[WARNING .*\\] Running B\\(azel\\\|laze\\) server needs to be killed"
	expect_log "\\[INFO .*\\] Args from the current request that were not included when creating the server:"
	expect_log "\\[INFO .*\\] --host_jvm_args=-Dfoo"
	}

	function test_server_restart_if_number_of_option_instances_decreases() {
	local server_pid1=$(bazel \
	--host_jvm_args=-Dfoo \
	--host_jvm_args -Dfoo \
	--client_debug info server_pid 2>$TEST_log)
	local server_pid2=$(bazel \
	--host_jvm_args -Dfoo \
	--client_debug info server_pid 2>$TEST_log)
	assert_not_equals "$server_pid1" "$server_pid2"
	expect_log "\\[WARNING .*\\] Running B\\(azel\\\|laze\\) server needs to be killed"
	expect_log "\\[INFO .*\\] Args from the running server that are not included in the current request:"
	expect_log "\\[INFO .*\\] --host_jvm_args=-Dfoo"
	}

	function test_server_not_restarted_when_only_TMPDIR_changes() {
	mkdir tmp1
	mkdir tmp2
	tmp1path="$(pwd)/tmp1"
	tmp2path="$(pwd)/tmp2"
	PID1=$(export TMPDIR="$tmp1path" && bazel info server_pid 2>$TEST_log) \
	\|\| fail "bazel info failed"
	PID2=$(export TMPDIR="$tmp2path" && bazel info server_pid 2>$TEST_log) \
	\|\| fail "bazel info failed"
	expect_not_log "Running B\\(azel\\\|laze\\) server needs to be killed."

	assert_equals "$PID1" "$PID2"
	}

	function test_server_restarted_on_explicit_heap_dump_path_change() {
	mkdir tmp1
	mkdir tmp2
	tmp1path="$(pwd)/tmp1"
	tmp2path="$(pwd)/tmp2"
	PID1=$(bazel --host_jvm_args=-XX:HeapDumpPath="$tmp1path" info server_pid \
	2>$TEST_log) \|\| fail "bazel info failed"
	PID2=$(bazel --host_jvm_args=-XX:HeapDumpPath="$tmp2path" info server_pid \
	2>$TEST_log) \|\| fail "bazel info failed"
	expect_log "Running B\\(azel\\\|laze\\) server needs to be killed."

	assert_not_equals "$PID1" "$PID2"
	}

	function test_shutdown() {
	local server_pid1=$(bazel info server_pid 2>$TEST_log)
	bazel shutdown >& $TEST_log \|\| fail "Expected success"
	local server_pid2=$(bazel info server_pid 2>$TEST_log)
	assert_not_equals "$server_pid1" "$server_pid2"
	expect_not_log "WARNING.* Running B\\(azel\\\|laze\\) server needs to be killed"
	expect_log "Starting local B\\(azel\\\|laze\\) server and connecting to it"
	}

	function test_shutdown_different_options() {
	bazel --host_jvm_args=-Di.am.a=teapot info >& $TEST_log \|\| fail "Expected success"
	bazel shutdown >& $TEST_log \|\| fail "Expected success"
	expect_log "WARNING.* Running B\\(azel\\\|laze\\) server needs to be killed"
	expect_not_log "Starting local B\\(azel\\\|laze\\) server and connecting to it"
	}

	function test_server_restart_due_to_startup_options_with_client_debug_information() {
	# Using --write_command_log for no particular reason, if that flag is removed, another startup
	# option will do just fine.
	local server_pid1=$(bazel --client_debug --write_command_log info server_pid 2>$TEST_log)
	local server_pid2=$(bazel --client_debug --nowrite_command_log info server_pid 2>$TEST_log)
	assert_not_equals "$server_pid1" "$server_pid2" # pid changed.
	expect_log "\\[WARNING .*\\] Running B\\(azel\\\|laze\\) server needs to be killed"
	expect_log "\\[INFO .*\\] Args from the running server that are not included in the current request:"
	expect_log "\\[INFO .*\\] --write_command_log"
	expect_log "\\[INFO .*\\] Args from the current request that were not included when creating the server:"
	expect_log "\\[INFO .*\\] --nowrite_command_log"
	}

	function test_exit_code() {
	bazel query not_a_query >/dev/null &>$TEST_log &&
	fail "bazel query: expected nonzero exit"
	expect_log "'not_a_query'"
	}

	function test_output_base() {
	out=$(bazel --output_base=$TEST_TMPDIR/output info output_base 2>$TEST_log)
	assert_equals $TEST_TMPDIR/output "$out"
	}

	function test_output_base_is_file() {
	bazel --output_base=/dev/null &>$TEST_log && fail "Expected non-zero exit"
	expect_log "FATAL.* Output base directory '/dev/null' could not be created.*exists"
	}

	function test_cannot_create_output_base() {
	bazel --output_base=/foo &>$TEST_log && fail "Expected non-zero exit"
	expect_log "FATAL.* Output base directory '/foo' could not be created"
	}

	function test_nonwritable_output_base() {
	bazel --output_base=/ &>$TEST_log && fail "Expected non-zero exit"
	expect_log "FATAL.* Output base directory '/' must be readable and writable."
	}

	function test_install_base_races_dont_leave_temp_files() {
	declare -a client_pids
	for i in {1..3}; do
	bazel --install_base="$TEST_TMPDIR/race/install" \
	--output_base="$TEST_TMPDIR/out$i" info install_base &
	client_pids+=($!)
	done
	for pid in "${client_pids[@]}"; do
	wait $pid
	done
	# Expect "install" to be the only thing in the "race" directory.
	assert_equals "install" "$(ls "$TEST_TMPDIR/race/")"
	}

	function test_no_arguments() {
	bazel >&$TEST_log \|\| fail "Expected zero exit"
	expect_log "Usage: b\\(laze\\\|azel\\)"
	}

	function test_local_startup_timeout() {
	local output_base=$(bazel info output_base 2>"$TEST_log") \|\|
	fail "bazel info failed"

	# --host-jvm_debug will cause the server to block, forcing the client
	# into the timeout condition.
	bazel --host_jvm_args="-agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=localhost:41687" \
	--local_startup_timeout_secs=1 2>"$TEST_log" &
	local timeout=20
	while true; do
	local jobs_output=$(jobs)
	[[ $jobs_output =~ Exit ]] && break
	[[ $jobs_output =~ Done ]] && fail "bazel should have exited non-zero"

	timeout="$(( ${timeout} - 1 ))"
	[[ "${timeout}" -gt 0 ]] \|\| {
	kill -9 %1
	wait %1
	fail "--local_startup_timeout_secs was not respected"
	}
	# Wait for the client to exit.
	sleep 1
	done

	expect_log "Starting local.*server and connecting to it"
	expect_log "FATAL: couldn't connect to server"
	}

	function test_max_idle_secs() {
	# TODO(https://github.com/bazelbuild/bazel/issues/6773): Remove when fixed.
	bazel shutdown

	local options=( --max_idle_secs=1 )

	local output_base
	output_base="$(bazel "${options[@]}" info output_base 2>"$TEST_log")" \
	\|\| fail "bazel info failed"
	local timeout=60 # Lower than the default --max_idle_secs.
	while [[ -f "${output_base}/server/server.pid.txt" ]]; do
	timeout="$(( ${timeout} - 1 ))"
	[[ "${timeout}" -gt 0 ]] \|\| fail "--max_idle_secs was not respected"

	# Wait for the server to go away.
	sleep 1
	done

	bazel "${options[@]}" info >"$TEST_log" 2>&1 \|\| fail "bazel info failed"
	expect_log "Starting local.*server and connecting to it"
	# Ensure the restart was not triggered by different startup options.
	expect_not_log "WARNING: Running B\\(azel\\\|laze\\) server needs to be killed"
	}

	function test_dashdash_before_command() {
	bazel -- info &>$TEST_log && "Expected failure"
	exitcode=$?
	assert_equals 2 $exitcode
	expect_log "\\[FATAL .*\\] Unknown startup option: '--'."
	}

	function test_dashdash_after_command() {
	bazel info -- &>$TEST_log \|\| fail "info -- failed"
	}

	function test_nobatch() {
	local pid1=$(bazel --batch --nobatch info server_pid 2> $TEST_log)
	local pid2=$(bazel --batch --nobatch info server_pid 2> $TEST_log)
	assert_equals "$pid1" "$pid2"
	expect_not_log "WARNING.* Running B\\(azel\\\|laze\\) server needs to be killed"
	}

	# Regression test for #1875189, "bazel client should pass through '--help' like
	# a command".
	function test_bazel_dash_dash_help_is_passed_through() {
	bazel --help >&$TEST_log
	expect_log "Usage: b\\(azel\\\|laze\\) <command> <options> ..."
	expect_not_log "Unknown startup option: '--help'."
	}

	function test_bazel_dash_help() {
	bazel -help >&$TEST_log
	expect_log "Usage: b\\(azel\\\|laze\\) <command> <options> ..."
	}

	function test_bazel_dash_h() {
	bazel -h >&$TEST_log
	expect_log "Usage: b\\(azel\\\|laze\\) <command> <options> ..."
	}

	function test_bazel_dash_s_is_not_parsed() {
	bazel -s --help >&$TEST_log && fail "Expected failure"
	expect_log "Unknown startup option: '-s'."
	}

	function test_batch() {
	local pid1=$(bazel info server_pid 2> $TEST_log)
	local pid2=$(bazel --batch info server_pid 2> $TEST_log)
	assert_not_equals "$pid1" "$pid2"
	expect_log "WARNING.* Running B\\(azel\\\|laze\\) server needs to be killed"
	}

	function test_cmdline_not_written_in_batch_mode() {
	OUTPUT_BASE=$(bazel --batch info output_base 2> $TEST_log)
	rm -f $OUTPUT_BASE/server/cmdline
	OUTPUT_BASE2=$(bazel --batch info output_base 2> $TEST_log)
	assert_equals "$OUTPUT_BASE" "$OUTPUT_BASE2"
	[[ ! -e $OUTPUT_BASE/server/cmdline ]] \|\| fail "Command line file written."
	}

	function test_bad_command_batch() {
	bazel --batch notacommand &> $TEST_log && "Expected failure"
	exitcode=$?
	assert_equals 2 "$exitcode"
	expect_log "Command 'notacommand' not found."
	}

	function test_bad_command_nobatch() {
	bazel --nobatch notacommand &> $TEST_log && "Expected failure"
	exitcode=$?
	assert_equals 2 "$exitcode"
	expect_log "Command 'notacommand' not found."
	}

	function get_pid_environment() {
	local pid="$1"
	case "$(uname -s)" in
	Linux)
	cat "/proc/${pid}/environ" \| tr '\0' '\n'
	;;
	Darwin)
	if ! ps > /dev/null; then
	echo "Cannot use ps command, probably due to sandboxing." >&2
	return 1
	fi
	ps eww -o command "${pid}" \| tr ' ' '\n'
	;;
	*)
	false
	;;
	esac
	}

	function test_proxy_settings() {
	# We expect that proxy settings are propagated from the client to the server
	# process, but are _not_ used for client-server communication.

	bazel shutdown # We are changing the server process's environment variables.

	local example_no_proxy='foo.example.com'
	# A known-invalid http*_proxy value which, if not ignored, would be expected
	# to cause the client-server gRPC channel to time out or otherwise fail.
	local invalid_proxy='http://localhost:0'
	local server_pid
	server_pid="$(http_proxy="${invalid_proxy}" HTTP_PROXY="${invalid_proxy}" \
	https_proxy="${invalid_proxy}" HTTPS_PROXY="${invalid_proxy}" \
	no_proxy="${example_no_proxy}" NO_PROXY="${example_no_proxy}" \
	bazel info server_pid 2> $TEST_log)" \
	\|\| fail "http*_proxy env variables not ignored by client-server channel."

	# Check that the server uses the *_proxy env variables set by the client.
	if get_pid_environment "${server_pid}" > "${TEST_TMPDIR}/server_env"; then
	local var
	for var in http{,s}_proxy HTTP{,S}_PROXY; do
	assert_contains "^${var}=${invalid_proxy}\$" "${TEST_TMPDIR}/server_env"
	done
	for var in no_proxy NO_PROXY; do
	assert_contains "^${var}=${example_no_proxy}\$" \
	"${TEST_TMPDIR}/server_env"
	done
	else
	echo "Cannot not test server process environment on this platform"
	fi
	}

	function test_macos_qos_class() {
	for class in utility background; do
	bazel --macos_qos_class="${class}" info >"${TEST_log}" 2>&1 \
	\|\| fail "Unknown QoS class ${class}"
	# On macOS it'd be nice to verify that the server is indeed running at the
	# desired class... but this is very hard to do. Common utilities do not
	# print the QoS level, and powermetrics (which requires root privileges)
	# only reports it under load -- so an "info" command is insufficient and the
	# real thing would be quite expensive.
	done

	for class in user-interactive user-initiated default ; do
	bazel --macos_qos_class="${class}" >"${TEST_log}" 2>&1 \
	&& fail "Expected failure with invalid QoS class name"
	expect_log "Invalid argument.qos_class.${class}"
	done
	}

	function test_ignores_jdk_option_environment_variables() {
	bazel shutdown # Environment variables are only checked on server startup
	_JAVA_OPTIONS=--wat1 JDK_JAVA_OPTIONS=--wat2 JAVA_TOOL_OPTIONS=--wat3 \
	bazel version >&$TEST_log \|\| fail "_JAVA_OPTIONS not ignored"

	expect_log ".*ignoring _JAVA_OPTIONS"
	expect_log ".*ignoring JDK_JAVA_OPTIONS"
	expect_log ".*ignoring JAVA_TOOL_OPTIONS"
	}

	run_suite "Tests of the bazel client."