mirror of
https://github.com/kuhyx/steam-backlog-enforcer.git
synced 2026-11-22 23:02:19 +01:00
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
174 lines
5.5 KiB
Python
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
|