steam-backlog-enforcer/steam_installer/tests/test_cli_finish.py
Krzysztof kuhy Rudnicki a76e726e36 Merge steam-game-installer into the repo
The installer ships as the steam_installer package beside
steam_backlog_enforcer, with its tests, docs and Proton lock. The
enforcer's fast install now starts the installer from this checkout.

Both appinfo.vdf readers share one key-value decoder
(steam_installer.appinfo_kv), and the duplicated test fixtures and
helpers are folded into conftest and _cli_helpers so the whole-tree
duplicate-code check is clean. check_requirements_sync treats sibling
packages as first-party.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WzxdWZCxnNWLtpVwFLVk9w
2026-11-22 20:25:39 +01:00

174 lines
5.5 KiB
Python

"""CLI flow tests, part 2: the manifest-finishing end of a run."""
from __future__ import annotations
from typing import TYPE_CHECKING
import pytest
from steam_installer import (
appinfo,
cli,
recognize,
vdf,
)
from steam_installer.tests._cli_helpers import ARGV, _stub_download, proven_plan
if TYPE_CHECKING:
from pathlib import Path
from steam_installer.library import SteamLibrary
pytestmark = pytest.mark.usefixtures("cli_logs")
# The 15 keys Steam accepted on 2026-11-22 (A Space for the Unbound): it
# logged "Fully Installed,App Running", queued no download, and added its own
# LastOwner, UserConfig, MountedConfig, ... on exit.
FROM_SCRATCH_KEYS = [
"appid",
"universe",
"name",
"StateFlags",
"installdir",
"LastUpdated",
"SizeOnDisk",
"StagingSize",
"buildid",
"UpdateResult",
"BytesToDownload",
"BytesDownloaded",
"BytesToStage",
"BytesStaged",
"InstalledDepots",
]
def test_missing_manifest_is_written_from_scratch(
steam: tuple[SteamLibrary, Path], monkeypatch: pytest.MonkeyPatch
) -> None:
"""No steamcmd any more, so nothing else creates the manifest."""
library, install_dir = steam
manifest = library.steamapps / "appmanifest_1771300.acf"
manifest.unlink()
gid = proven_plan(monkeypatch, install_dir)
_stub_download(monkeypatch)
assert cli.main(ARGV) == 0
app_state = vdf.parse(manifest.read_text())["AppState"]
assert list(app_state) == FROM_SCRATCH_KEYS
assert app_state["appid"] == "1771300"
assert app_state["universe"] == "1"
assert app_state["name"] == "KCD2"
assert app_state["StateFlags"] == "4"
assert app_state["installdir"] == "KingdomComeDeliverance2"
assert app_state["SizeOnDisk"] == "1000"
assert app_state["buildid"] == "23914554"
for key in (
"StagingSize",
"UpdateResult",
"BytesToDownload",
"BytesDownloaded",
"BytesToStage",
"BytesStaged",
):
assert app_state[key] == "0", key
assert app_state["InstalledDepots"] == {"1771303": {"manifest": gid, "size": "0"}}
# Nothing to back up: there was no manifest before.
assert not manifest.with_suffix(".acf.bak").exists()
def test_a_shared_depot_is_recorded_under_its_owner_from_scratch(
steam: tuple[SteamLibrary, Path], monkeypatch: pytest.MonkeyPatch
) -> None:
"""Fixture-only: no shared-depot game was tested live. Steam records a
depot installed under another app as SharedDepots {depot: owner}."""
library, install_dir = steam
manifest = library.steamapps / "appmanifest_1771300.acf"
manifest.unlink()
proven_plan(monkeypatch, install_dir, shared_owner={"228989": "228980"})
_stub_download(monkeypatch)
assert cli.main(ARGV) == 0
app_state = vdf.parse(manifest.read_text())["AppState"]
assert app_state["SharedDepots"] == {"228989": "228980"}
assert "228989" not in app_state["InstalledDepots"]
def test_unproven_content_writes_no_manifest_from_scratch(
steam: tuple[SteamLibrary, Path],
monkeypatch: pytest.MonkeyPatch,
capsys: pytest.CaptureFixture[str],
) -> None:
"""Fail closed: without a proven build there is no buildid to write, and a
half-true StateFlags=4 manifest is what made Steam redownload games."""
library, _ = steam
manifest = library.steamapps / "appmanifest_1771300.acf"
manifest.unlink()
_stub_download(monkeypatch)
assert cli.main(ARGV) == 1
assert not manifest.exists()
assert "no usable buildid" in capsys.readouterr().out
@pytest.mark.usefixtures("steam")
def test_language_defaults_to_english_when_prompt_is_empty(
monkeypatch: pytest.MonkeyPatch,
) -> None:
"""Language defaults to english when prompt is empty."""
seen = {}
monkeypatch.setattr("builtins.input", lambda *a: "y" if "Proceed" in a[0] else "")
monkeypatch.setattr(
appinfo,
"get_depot_plan",
lambda appid, language: (
(seen.setdefault("language", language) and None)
or appinfo.DepotPlan({"1771303"}, set())
),
)
_stub_download(monkeypatch)
cli.main(["--appid", "1771300", "--username", "u"])
assert seen["language"] == "english"
def test_adopts_staged_content_then_clears_it(
steam: tuple[SteamLibrary, Path],
monkeypatch: pytest.MonkeyPatch,
capsys: pytest.CaptureFixture[str],
) -> None:
"""Steam's staging tree is adopted into the install dir before downloading,
and only cleared once the install is finished -- never discarded up front."""
library, install_dir = steam
staged = library.steamapps / "downloading" / "1771300"
staged.mkdir(parents=True)
(staged / "big.pak").write_bytes(b"x" * 2_000_000)
_stub_download(monkeypatch)
assert cli.main(ARGV) == 0
out = capsys.readouterr().out
assert "Hardlinking it" in out
assert "now-redundant Steam staging data" in out
# Adopted, not copied: the file is one inode with two names.
assert (install_dir / "big.pak").stat().st_size == 2_000_000
@pytest.mark.usefixtures("steam")
def test_fails_when_written_manifest_does_not_read_back_as_installed(
monkeypatch: pytest.MonkeyPatch,
capsys: pytest.CaptureFixture[str],
) -> None:
"""Claiming success without re-reading the write is the same fail-open
mistake in a different place."""
_stub_download(monkeypatch)
monkeypatch.setattr(
recognize, "manifest_reflects_real_install", lambda *a, **kw: False
)
assert cli.main(ARGV) == 1
assert "does not read back as a real install" in capsys.readouterr().out