mirror of
https://github.com/kuhyx/testsAndMisc.git
synced 2026-11-11 22:14:01 +01:00
Krzysztof kuhy Rudnicki
2c95425a60
Grouped by the state each function touches rather than by size:
steam_requirements.sh 199 requirement parsing, scoring, and the hardware
detection that feeds it
steam_report.sh 156 the run loop and the cache it reads
steam_api.sh 124 library discovery, Steam and ProtonDB calls
steam_credentials.sh 103 credentials, usage text, presentation helpers
The grouping was forced by the SC2034 writer/reader rule, not chosen. Two
arrangements were discarded: detect_system alone in a lib writes the three
SYSTEM_* globals without reading them, and load_cache_map alone writes
CACHE_MAP without reading it. Both were fixed by putting the writer next to
its reader - detect_system beside score_game, load_cache_map beside main.
Verified: all 33 functions verbatim; every lib passes shellcheck standalone
with no suppression; and the script actually runs - `--help` prints the usage
block and exits 0, which is what proves the four source lines resolve and
main still dispatches.
Over-cap files 26 -> 25.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011w2Pj4Ek3ZNMQVYcFHgXDY
54 lines
3.2 KiB
JSON
54 lines
3.2 KiB
JSON
{
|
|
"intent": "Split steam_compatibility.sh (663 lines) into an entry script and four sourced libraries, all under the 250-line cap, moving every function verbatim.",
|
|
"scope": [
|
|
"steam_compatibility.sh 663 -> 140",
|
|
"New: lib/steam_requirements.sh 199, lib/steam_report.sh 156, lib/steam_api.sh 124, lib/steam_credentials.sh 103",
|
|
"Non-goal: any behaviour change"
|
|
],
|
|
"changes": [
|
|
"Grouped by what each function touches rather than by size: requirement parsing and scoring with the hardware detection that feeds it, the Steam/ProtonDB API calls, credential and presentation helpers, and the run loop with the cache it reads.",
|
|
"The grouping was driven by the SC2034 writer/reader rule rather than chosen freely. Two arrangements were discarded first: detect_system alone in a lib writes SYSTEM_CPU_CLASS, SYSTEM_GPU_VENDOR and SYSTEM_RAM_GB without reading them, and load_cache_map alone writes CACHE_MAP without reading it. Both were fixed by moving the writer next to its reader - detect_system beside score_game, load_cache_map beside main.",
|
|
"The entry script is now colours, defaults, the four source lines, parse_args, the tiny log/die/vlog helpers, and `main \"$@\"`."
|
|
],
|
|
"verification": [
|
|
{
|
|
"command": "bash meta/scripts/verify_shell_split.sh HEAD <entry> <four libs> <entry>",
|
|
"result": "pass",
|
|
"evidence": "IDENTICAL: all 33 top-level functions moved verbatim, re-checked after each regrouping."
|
|
},
|
|
{
|
|
"command": "bash linux_configuration/scripts/single_use/utils/steam_compatibility.sh --help",
|
|
"result": "pass",
|
|
"evidence": "Prints the full usage block and exits 0. This is a real run of the split script: it proves all four source lines resolve and that main dispatches, which no static check can show."
|
|
},
|
|
{
|
|
"command": "shellcheck on each of the four libraries standalone",
|
|
"result": "pass",
|
|
"evidence": "All clean, with no suppression added. The pre-commit hook runs shellcheck without -x, so each file has to stand on its own."
|
|
},
|
|
{
|
|
"command": "Sourcing each library in a subshell",
|
|
"result": "pass",
|
|
"evidence": "All four source with no side effects."
|
|
},
|
|
{
|
|
"command": "pre-commit run --files <all five>",
|
|
"result": "pass",
|
|
"evidence": "shellcheck and shfmt both pass."
|
|
},
|
|
{
|
|
"command": "bash ~/utils/scripts/check_file_length.sh --all",
|
|
"result": "pass",
|
|
"evidence": "25 files over cap, down from 26. The five files are 140, 199, 156, 124 and 103 lines."
|
|
}
|
|
],
|
|
"risks": [
|
|
"--help exits before any network call, so the run exercises argument parsing and the source graph but not the API paths. Those need Steam credentials and a network round-trip, which is not something to trigger from a split verification.",
|
|
"Four libraries is more indirection than three would be, but the writer/reader rule fixed the grouping: merging any two would either put a writer away from its reader or push a file back over the cap."
|
|
],
|
|
"rollback": [
|
|
"git revert the commit; the entry script returns to 663 lines and the four libraries disappear.",
|
|
"After rollback, confirm steam_compatibility.sh --help still prints usage and exits 0."
|
|
]
|
|
}
|