import os import stat import subprocess import textwrap import unittest from pathlib import Path from tempfile import TemporaryDirectory ROOT = Path(__file__).resolve().parents[1] def write_executable(path, content): path.write_text(textwrap.dedent(content).lstrip(), encoding="utf-8") path.chmod(path.stat().st_mode | stat.S_IXUSR) class CheckSteamDBTests(unittest.TestCase): def run_check(self, curl_mode, node_mode="success"): tmp = TemporaryDirectory() self.addCleanup(tmp.cleanup) tmp_path = Path(tmp.name) run_dir = tmp_path / "run" fake_bin = tmp_path / "bin" fake_bin.mkdir() log_dir = tmp_path / "logs" log_dir.mkdir() write_executable( fake_bin / "curl", """ #!/bin/sh printf '%s\\n' "$*" >> "$FAKE_LOG_DIR/curl-args.log" case "$FAKE_CURL_MODE" in success) printf '%s\\n' 'Steam Controller AppID: 4165870Coming soon prerelease' ;; challenge) printf '%s\\n' 'Just a moment...

Checking your browser...

Cloudflare' ;; fail) exit 22 ;; *) echo "unknown FAKE_CURL_MODE: $FAKE_CURL_MODE" >&2 exit 2 ;; esac """, ) write_executable( fake_bin / "node", """ #!/bin/sh printf '%s\\n' "$*" >> "$FAKE_LOG_DIR/node-args.log" output="" for arg in "$@"; do output="$arg" done case "$FAKE_NODE_MODE" in success) printf '%s\\n' 'Steam Controller AppID: 4165870Coming soon prerelease' > "$output" ;; challenge) printf '%s\\n' 'Just a moment...Checking your browser... Cloudflare' > "$output" ;; fail) exit 1 ;; *) echo "unknown FAKE_NODE_MODE: $FAKE_NODE_MODE" >&2 exit 2 ;; esac """, ) env = os.environ.copy() env.update( { "PATH": f"{fake_bin}:{env['PATH']}", "FAKE_CURL_MODE": curl_mode, "FAKE_NODE_MODE": node_mode, "FAKE_LOG_DIR": str(log_dir), "STEAMDB_PLAYWRIGHT_FALLBACK": "1", } ) result = subprocess.run( [str(ROOT / "scripts" / "check_steamdb.sh"), str(run_dir)], cwd=ROOT, env=env, text=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE, check=False, ) return result, run_dir, log_dir def test_uses_realistic_chrome_user_agent_by_default(self): result, run_dir, log_dir = self.run_check("success") self.assertEqual("", result.stderr) self.assertEqual(0, result.returncode) curl_args = (log_dir / "curl-args.log").read_text(encoding="utf-8") self.assertIn("Chrome/123.0.0.0", curl_args) self.assertNotIn("-A Mozilla/5.0 --retry", curl_args) self.assertTrue((run_dir / "api" / "steamdb" / "controller-app.html").exists()) def test_treats_cloudflare_challenge_html_as_blocked(self): result, run_dir, _ = self.run_check("challenge", node_mode="fail") self.assertEqual("", result.stderr) self.assertEqual(0, result.returncode) self.assertFalse((run_dir / "api" / "steamdb" / "controller-app.html").exists()) errors = (run_dir / "reports" / "steamdb-errors.txt").read_text(encoding="utf-8") self.assertIn("blocked or challenge page", errors) def test_uses_playwright_fallback_after_challenge_page(self): result, run_dir, log_dir = self.run_check("challenge", node_mode="success") self.assertEqual("", result.stderr) self.assertEqual(0, result.returncode) self.assertTrue((log_dir / "node-args.log").exists()) html = (run_dir / "api" / "steamdb" / "controller-app.html").read_text( encoding="utf-8" ) self.assertIn("Steam Controller", html) self.assertIn("Coming soon", html) errors = (run_dir / "reports" / "steamdb-errors.txt").read_text(encoding="utf-8") self.assertEqual("", errors) def test_records_reservation_package_update_baseline(self): tmp = TemporaryDirectory() self.addCleanup(tmp.cleanup) tmp_path = Path(tmp.name) run_dir = tmp_path / "run" fake_bin = tmp_path / "bin" fake_bin.mkdir() write_executable( fake_bin / "curl", """ #!/bin/sh for arg in "$@"; do url="$arg" done case "$url" in *sub/1629446*) printf '%s\\n' '

Steam Sub 1629446

Last Record Update27 April 2026 – 18:22:46 UTC
Last Changenumber35499151

We have no information about this package besides the fact that it exists.

Possible apps in this package

4165910GameSteam Machine35499151
' ;; *sub/1629484*) printf '%s\\n' '

Steam Sub 1629484

Last Record Update27 April 2026 – 18:21:50 UTC
Last Changenumber35499157

We have no information about this package besides the fact that it exists.

Possible apps in this package

4165890GameSteam Frame35499151
' ;; *sub/*) package="${url%/}" package="${package##*/}" printf '

Steam Sub %s

Last Record Update27 April 2026 – 18:20:00 UTC
Last Changenumber35499000

We have no information about this package besides the fact that it exists.

\\n' "$package" ;; *) printf '%s\\n' 'Steam Controller AppID: 4165870Coming soon prerelease' ;; esac """, ) env = os.environ.copy() env.update({"PATH": f"{fake_bin}:{env['PATH']}"}) result = subprocess.run( [str(ROOT / "scripts" / "check_steamdb.sh"), str(run_dir)], cwd=ROOT, env=env, text=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE, check=False, ) self.assertEqual("", result.stderr) self.assertEqual(0, result.returncode) steamdb_dir = run_dir / "api" / "steamdb" self.assertTrue((steamdb_dir / "package-1629446.html").exists()) self.assertTrue((steamdb_dir / "package-1629484.html").exists()) report = (run_dir / "reports" / "steamdb-reservation-packages.tsv").read_text( encoding="utf-8" ) self.assertIn( "Steam Machine\t1629446\t27 April 2026 - 18:22:46 UTC\t35499151\t4165910:Steam Machine\tprivate_exists_only", report, ) self.assertIn( "Steam Frame\t1629484\t27 April 2026 - 18:21:50 UTC\t35499157\t4165890:Steam Frame\tprivate_exists_only", report, ) key_lines = (run_dir / "reports" / "steamdb-key-lines.txt").read_text( encoding="utf-8" ) self.assertTrue(key_lines.startswith("Reservation package SteamDB snapshot:")) self.assertIn("Steam Machine\t1629446", key_lines)