refactor(proxy-client): упростить установщик пакета и shell-тесты

- install.sh ставит три прямые ссылки без Stow; чужие файлы не трогает
  и перечисляет все конфликты сразу; ~/.local и ~/.config могут быть
  ссылками; блок в ~/.bashrc дописывается, если нет маркера.
- proxy_on читает вывод proxy-client env без временного файла.
- Тесты Bash-функций работают через поддельный PROXY_CLIENT_BIN.
- test_proxy_client_full.sh запускает только тесты proxy-client,
  прогон под Python 3.8 — если есть uv.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
ddadminandClaude Opus 5.5 committed 2026-09-28 09:28:07 -04:00
1 parent 502f828c6f
commit 06ca4ab0c6
5 files changed
+281 -698

No files matched your search

+85 -131
View File
@@ -1,12 +1,19 @@
#!/usr/bin/env bash
# Тесты Bash-функций proxy-client: вместо настоящего CLI — поддельный
# исполняемый файл в PROXY_CLIENT_BIN.
# Строчные proxy-переменные задаёт proxy_on, shellcheck этого не видит.
# shellcheck disable=SC2154
set -euo pipefail
REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
FUNCTIONS_FILE="$REPO_ROOT/bash/.bash_functions"
CUSTOM_FILE="$REPO_ROOT/bash/.bash_custom"
SHELL_MODULE="$REPO_ROOT/proxy-client/.config/proxy-client/shell.bash"
TEST_ROOT="$(mktemp -d /tmp/proxy-launchers-test.XXXXXX)"
trap 'rm -rf "$TEST_ROOT"' EXIT
pass_count=0
PROXY_KEYS=(HTTP_PROXY HTTPS_PROXY ALL_PROXY NO_PROXY
http_proxy https_proxy all_proxy no_proxy)
fail() {
echo "FAIL: $*" >&2
@@ -14,177 +21,124 @@ fail() {
}
ok() {
pass_count=$((pass_count + 1))
echo "ok - $*"
}
assert_eq() {
local expected="$1" actual="$2" message="$3"
[ "$expected" = "$actual" ] || fail "$message (ожидалось '$expected', получено '$actual')"
[ "$1" = "$2" ] || fail "$3 (ожидалось '$1', получено '$2')"
}
valid_env() {
cat <<'EOF'
HTTP_PROXY=http://proxy.test:1234
# Поддельный CLI: на "env" печатает $FAKE_ENV_OUTPUT, на остальное — свои
# аргументы по одному в строке; завершается с кодом $FAKE_RC.
PROXY_CLIENT_BIN="$TEST_ROOT/proxy-client"
cat > "$PROXY_CLIENT_BIN" <<'EOF'
#!/usr/bin/env bash
if [ "$1" = env ]; then
printf '%s\n' "$FAKE_ENV_OUTPUT"
else
printf '<%s>\n' "$@"
fi
exit "${FAKE_RC:-0}"
EOF
chmod +x "$PROXY_CLIENT_BIN"
export PROXY_CLIENT_BIN
VALID_ENV='HTTP_PROXY=http://proxy.test:1234
HTTPS_PROXY=http://proxy.test:1234
ALL_PROXY=socks5://proxy.test:1234
NO_PROXY=proxy.test,localhost,127.0.0.1,::1,[::1],.example.test
NO_PROXY=proxy.test,localhost,.example.test
http_proxy=http://proxy.test:1234
https_proxy=http://proxy.test:1234
all_proxy=socks5://proxy.test:1234
no_proxy=proxy.test,localhost,127.0.0.1,::1,[::1],.example.test
EOF
}
no_proxy=proxy.test,localhost,.example.test'
assert_five_proxy_commands() {
local command_name
for command_name in proxy_on proxy_off pclaude pcodex myip; do
declare -F "$command_name" >/dev/null || fail "нет функции $command_name"
# shellcheck source=/dev/null
source "$SHELL_MODULE"
# proxy_on применяет все восемь переменных.
(
unset "${PROXY_KEYS[@]}"
FAKE_ENV_OUTPUT="$VALID_ENV" proxy_on >/dev/null
assert_eq http://proxy.test:1234 "$HTTP_PROXY" HTTP_PROXY
assert_eq http://proxy.test:1234 "$https_proxy" https_proxy
assert_eq socks5://proxy.test:1234 "$ALL_PROXY" ALL_PROXY
assert_eq proxy.test,localhost,.example.test "$no_proxy" no_proxy
for key in "${PROXY_KEYS[@]}"; do
[ -n "$(printenv "$key")" ] || fail "$key не экспортирован"
done
}
)
ok "proxy_on применяет восемь переменных"
# Самостоятельный модуль предоставляет весь публичный Bash-интерфейс.
(
source "$SHELL_MODULE"
assert_five_proxy_commands
) && ok "самостоятельное подключение предоставляет пять proxy-команд"
# Обычная .bash_custom независимо подключает общие функции и proxy-модуль.
(
fixture="$(mktemp -d /tmp/proxy-bash-custom-test.XXXXXX)"
mkdir -p "$fixture/.config/proxy-client"
ln -s "$CUSTOM_FILE" "$fixture/.bash_custom"
ln -s "$FUNCTIONS_FILE" "$fixture/.bash_functions"
ln -s "$SHELL_MODULE" "$fixture/.config/proxy-client/shell.bash"
output="$(
HOME="$fixture" bash --noprofile --norc -ic '
source "$HOME/.bash_custom"
for name in proxy_on proxy_off pclaude pcodex myip update_hproxy; do
declare -F "$name" >/dev/null || exit 1
done
printf ready
' 2>/dev/null
)"
assert_eq ready "$output" ".bash_custom не подключил оба независимых модуля"
) && ok "обычное подключение предоставляет proxy-команды и update_hproxy"
# proxy_on применяет восемь известных переменных и не запрашивает IP.
(
source "$SHELL_MODULE"
_proxy_cli() {
[ "$1" = env ] || return 99
valid_env
}
curl() { fail "proxy_on не должен вызывать curl"; }
unset HTTP_PROXY HTTPS_PROXY ALL_PROXY NO_PROXY \
http_proxy https_proxy all_proxy no_proxy || true
proxy_on >/dev/null
assert_eq "http://proxy.test:1234" "$HTTP_PROXY" "HTTP_PROXY"
assert_eq "$HTTP_PROXY" "$http_proxy" "http_proxy"
assert_eq "http://proxy.test:1234" "$HTTPS_PROXY" "HTTPS_PROXY"
assert_eq "$HTTPS_PROXY" "$https_proxy" "https_proxy"
assert_eq "socks5://proxy.test:1234" "$ALL_PROXY" "ALL_PROXY"
assert_eq "$ALL_PROXY" "$all_proxy" "all_proxy"
assert_eq "proxy.test,localhost,127.0.0.1,::1,[::1],.example.test" "$NO_PROXY" "NO_PROXY"
assert_eq "$NO_PROXY" "$no_proxy" "no_proxy"
) && ok "proxy_on применяет известные ключи без запроса IP"
# Неизвестная строка в машинном выводе оставляет прежнее окружение целиком.
unknown_output="$(valid_env; printf 'EXTRA_PROXY=bad\n')"
for bad_output in \
"$unknown_output" \
"BROKEN-LINE"; do
# Ошибка CLI или непонятный вывод не меняют окружение ни на одну переменную.
for case_spec in "1|$VALID_ENV" "0|$VALID_ENV
EXTRA_PROXY=bad" "0|BROKEN-LINE"; do
(
source "$SHELL_MODULE"
export HTTP_PROXY=old-http HTTPS_PROXY=old-https ALL_PROXY=old-all NO_PROXY=old-no
export http_proxy=old-http-lower https_proxy=old-https-lower
export all_proxy=old-all-lower no_proxy=old-no-lower
_proxy_cli() { printf '%s\n' "$bad_output"; }
if proxy_on >/dev/null 2>&1; then
fail "proxy_on принял неверный вывод"
for key in "${PROXY_KEYS[@]}"; do export "$key=old"; done
if FAKE_RC="${case_spec%%|*}" FAKE_ENV_OUTPUT="${case_spec#*|}" \
proxy_on >/dev/null 2>&1; then
fail "proxy_on принял ошибочный ответ: ${case_spec#*|}"
fi
assert_eq old-http "$HTTP_PROXY" "HTTP_PROXY изменился при ошибке"
assert_eq old-https "$HTTPS_PROXY" "HTTPS_PROXY изменился при ошибке"
assert_eq old-all "$ALL_PROXY" "ALL_PROXY изменился при ошибке"
assert_eq old-no "$NO_PROXY" "NO_PROXY изменился при ошибке"
assert_eq old-http-lower "$http_proxy" "http_proxy изменился при ошибке"
assert_eq old-https-lower "$https_proxy" "https_proxy изменился при ошибке"
assert_eq old-all-lower "$all_proxy" "all_proxy изменился при ошибке"
assert_eq old-no-lower "$no_proxy" "no_proxy изменился при ошибке"
) || fail "атомарность нарушена для неверного вывода"
for key in "${PROXY_KEYS[@]}"; do
assert_eq old "${!key}" "$key изменился после ошибки"
done
)
done
ok "неизвестная env-строка отклоняется без частичного изменения окружения"
ok "неуспешный env не меняет окружение"
# Даже полный stdout не применяется, если CLI завершился с ошибкой.
# proxy_off очищает оба регистра.
(
source "$SHELL_MODULE"
export HTTP_PROXY=old HTTPS_PROXY=old ALL_PROXY=old NO_PROXY=old
export http_proxy=old https_proxy=old all_proxy=old no_proxy=old
_proxy_cli() {
valid_env
return 1
}
if proxy_on >/dev/null 2>&1; then
fail "proxy_on принял вывод неуспешного CLI"
fi
for key in HTTP_PROXY HTTPS_PROXY ALL_PROXY NO_PROXY \
http_proxy https_proxy all_proxy no_proxy; do
assert_eq old "${!key}" "$key изменился после ошибки CLI"
for key in "${PROXY_KEYS[@]}"; do export "$key=x"; done
proxy_off >/dev/null
for key in "${PROXY_KEYS[@]}"; do
[ -z "${!key+set}" ] || fail "$key не очищен"
done
) && ok "stdout неуспешного env не изменяет окружение"
)
ok "proxy_off очищает восемь переменных"
# Обёртки передают CLI команду, аргументы и код возврата без искажений.
(
source "$SHELL_MODULE"
_proxy_cli() {
printf '<%s>\n' "$@"
return 42
}
export FAKE_RC=42
set +e
output="$(pclaude "a b" -- --flag)"
rc=$?
set -e
assert_eq 42 "$rc" "pclaude не сохранил код возврата"
assert_eq $'<run>\n<-->\n<claude>\n<a b>\n<-->\n<--flag>' "$output" "pclaude исказил аргументы"
assert_eq $'<run>\n<-->\n<claude>\n<a b>\n<-->\n<--flag>' "$output" \
"pclaude исказил аргументы"
set +e
output="$(pcodex --search)"
rc=$?
set -e
assert_eq 42 "$rc" "pcodex не сохранил код возврата"
assert_eq $'<run>\n<-->\n<codex>\n<--search>' "$output" "pcodex исказил аргументы"
) && ok "pclaude и pcodex делегируют run и сохраняют аргументы/код"
assert_eq $'<run>\n<-->\n<codex>\n<--search>' "$output" \
"pcodex исказил аргументы"
)
ok "pclaude и pcodex передают аргументы и код выхода"
# proxy_off очищает оба регистра и не смешивает действие с диагностикой.
# .bash_custom подключает и общие функции, и proxy-модуль.
(
source "$SHELL_MODULE"
export HTTP_PROXY=x HTTPS_PROXY=x ALL_PROXY=x NO_PROXY=x
export http_proxy=x https_proxy=x all_proxy=x no_proxy=x
curl() { fail "proxy_off не должен вызывать curl"; }
proxy_off >/dev/null
for key in HTTP_PROXY HTTPS_PROXY ALL_PROXY NO_PROXY \
http_proxy https_proxy all_proxy no_proxy; do
[ -z "${!key+x}" ] || fail "$key не очищен"
done
) && ok "proxy_off очищает восемь переменных без запроса IP"
# Общий файл больше не владеет proxy-интерфейсом, но сохраняет update_hproxy.
(
source "$FUNCTIONS_FILE"
declare -F update_hproxy >/dev/null || fail "update_hproxy потерян"
for name in proxy_on proxy_off pclaude pcodex myip _proxy_run _proxy_cli; do
if declare -F "$name" >/dev/null; then
fail "$name всё ещё определён в bash/.bash_functions"
fi
done
) && ok "владение proxy-функциями перенесено, update_hproxy сохранён"
home="$TEST_ROOT/home"
mkdir -p "$home/.config/proxy-client"
ln -s "$CUSTOM_FILE" "$home/.bash_custom"
ln -s "$FUNCTIONS_FILE" "$home/.bash_functions"
ln -s "$SHELL_MODULE" "$home/.config/proxy-client/shell.bash"
output="$(
HOME="$home" bash --noprofile --norc -ic '
source "$HOME/.bash_custom"
declare -F proxy_on update_hproxy >/dev/null && printf ready
' 2>/dev/null
)"
assert_eq ready "$output" ".bash_custom не подключил модули"
)
ok ".bash_custom подключает общие функции и proxy-модуль"
if command -v shellcheck >/dev/null 2>&1; then
shellcheck -s bash "$FUNCTIONS_FILE" "$CUSTOM_FILE" "$SHELL_MODULE" "$0" \
shellcheck -s bash "$SHELL_MODULE" "$0" \
|| fail "shellcheck нашёл проблемы"
ok "shellcheck чист"
else
echo "skip - shellcheck не установлен"
fi
echo "PASS: $pass_count проверок пройдено"
echo "PASS: тесты Bash-функций proxy-client"