5.9 KiB
Testy
Uruchomienie całego zestawu z katalogu głównego:
nix develop -c cargo test --all-targets --locked
Testy korzystają z wbudowanego mechanizmu Rust, Clap i ratatui::backend::TestBackend. Nie dodano zależności. Nie wymagają terminala interaktywnego ani urządzenia audio. Test audio używa pliku soundtracks/default/calm.ogg, więc zasoby muszą być dostępne w repozytorium.
Zakres
| Plik | Liczba | Zachowania |
|---|---|---|
tests/cli.rs |
5 | Domyślne ustawienia, granice wszystkich opcji liczbowych, XP (także NaN i infinity), błędne enumy, flagi audio, uruchomienie binarki z help/version i błędnym argumentem |
tests/app.rs |
7 | Nawigacja menu, wybór ekranów, wyjście, ignorowanie zwolnienia klawisza, komendy audio i zamknięty kanał, panel, zoom, ruch, renderowanie wszystkich widoków bez mutacji stanu, wejście przed inicjalizacją |
tests/board.rs |
7 | Rozmieszczenie baz/złóż/jednostek, granice kursora i kamery, zatwierdzanie/anulowanie ścieżki, cofanie z powtórzonym polem, duży viewport, resize i zoom |
tests/tasks.rs |
7 | Przyrost i limit kopania, reset etapu, pusta ścieżka, kolejność zadań, timer MovingTask, całkowity postęp, zachowanie liczby etapów przy konwersji, formatowanie postępu aktywnych i oczekujących zadań |
tests/audio.rs |
1 | Zapętlanie rzeczywistego pliku OGG po jego końcu |
tests/digging.rs |
18 | Wykonywanie kopania i ruchu, kolejki, 3 sekundy na krok, wejście po wykopaniu, blokady i walidacja, kolory i procenty w TUI, podział trasy Moving/Digging, ochrona struktur, zmiana rodzaju zadania, panel Tab z postępem etapu i całego zadania |
Łącznie: 45 testów. Wszystkie testy znajdują się w tests/ i sprawdzają publiczne interfejsy biblioteki lub binarkę. Funkcja load_audio jest eksportowana przez app::threads, dzięki czemu test korzysta z tego samego dekodera co odtwarzanie.
Wybrane zestawy i pojedynczy przypadek:
nix develop -c cargo test --test cli
nix develop -c cargo test --test app
nix develop -c cargo test --test board
nix develop -c cargo test --test tasks
nix develop -c cargo test --test audio
nix develop -c cargo test --test digging
nix develop -c cargo test --test board large_viewport_and_zoom_keep_camera_inside_map
Kontrole uzupełniające:
nix develop -c cargo check --all-targets --locked
nix develop -c cargo fmt --all -- --check
nix develop -c cargo clippy --all-targets --locked
shellHook środowiska Nix dodatkowo wykonuje cargo run --locked -- -h. Wynik pomocy nie jest wynikiem testów; właściwy raport zawiera podsumowania test result.
CI i profile kompilacji
Osobny workflow .gitea/workflows/nix.yml (push i pull request) instaluje Nix w node:22-bookworm i wykonuje nix build .#default --no-update-lock-file --no-link --print-out-paths --print-build-logs. Atrybut .#default wywołuje pkgs.callPackage ./default.nix {} z nixpkgs przypiętym w flake.lock; nie buduje wariantu .#develop opartego na Fenix. Budowa obejmuje standardową fazę testów buildRustPackage i włączony w pakiecie versionCheckHook. Nie wymaga devShell ani uruchamiania gry. Instalator potrzebuje sudo; KVM jest wyłączone. Workflow nie konfiguruje trwałego cache magazynu Nix, więc nowy job może ponownie pobierać zależności. Kontrole Rust opisane poniżej pozostają niezależne.
Workflow .gitea/workflows/rust.yml uruchamia kontrole po pushu i dla pull requestów. Wymaga włączonych Actions w repozytorium Gitea i runnera Linux x86_64 o etykiecie ubuntu-latest, obsługującego akcje Node. Nazwy akcji zawierają pełne adresy GitHub. Konfiguracja nie rejestruje runnera ani nie włącza Actions na serwerze; zobacz instrukcję Gitea.
Workflow określa obraz zadania jawnie jako node:22-bookworm. Kontener działa jako root i instaluje pakiety potrzebne do budowania: build-essential, pkg-config i libasound2-dev oraz curl, ca-certificates i zstd. Rust 1.99.1 z rustfmt i Clippy jest instalowany przez rustup. CI nie instaluje Nix i nie wykonuje jego shellHook.
Wersję Rust w CI określa RUST_VERSION w workflow, niezależnie od lokalnego flake.lock. Formatowanie, kompilacja, testy i Clippy są oddzielnymi krokami Cargo. Polecenia kompilujące projekt mają --locked; Clippy nie używa -D warnings z powodu istniejących ostrzeżeń. actions/cache@v4 zachowuje osobno toolchain oraz rejestr Cargo, repozytoria git i target. Klucze uwzględniają wersję Rust, a dla Cargo także manifest, lockfile i kod; klucze częściowe pozwalają ponownie wykorzystać wcześniejsze kompilacje. Działanie cache wymaga dostępnego serwera cache runnera. Pierwszy przebieg wypełnia cache; błędy pobierania cache mogą spowodować ponowną instalację i kompilację.
Release ma overflow-checks = true. Ten sam zestaw 45 testów można wykonać z kontrolą przepełnień w profilu produkcyjnym:
nix develop -c cargo test --all-targets --release --locked
Manifest określa minimalną wspieraną wersję Rust jako 1.88. Potwierdzono cargo check --all-targets --locked na Rust 1.88.0 dostarczonym tymczasowo przez Fenix (toolchainOf, kanał 1.88.0) wewnątrz nix develop. Domyślny toolchain pozostaje zarządzany przez Fenix i flake.lock; nie dodano drugiego pliku przypinającego toolchain. Linty z Cargo.toml zabraniają unsafe we własnym kodzie oraz ignorowania wyników must_use; unused_unit jest dozwolony, by zachować wymagane jawne -> ().
Ograniczenia
Zestaw weryfikuje wykonywanie zadań przez ticki potyczki, ale nie pełną rozgrywkę, ekonomię ani walkę. Nie potwierdza odsłuchu, zużycia CPU, obsługi urządzeń, pakowania Nix ani wszystkich układów małych terminali. Testy renderowania są kontrolą podstawową, bez utrwalania pełnych zrzutów ekranów. Nowy workflow bez Nix wymaga przebiegu na Gitea; odczyt cache należy potwierdzić w kolejnym przebiegu.