Planesweeper on mukaeltu toteutus klassisesta Minesweeper -pelistä, jossa on tarkoitus etsiä tutkapinnalta l. maailmankartalta lentokoneita ja merkitä niitä tutkahavaintoina kunnes kaikki lentokoneet on tunnistetty.
Pelialue koostuu vaikeustason mukaan kooltaan kasvavista ruudukoista, joista pelaaja avaa yksi kerrallaan ruutuja vasemmalla hiirennapilla ja saa numerovihjeitä kuinka monessa viereisessä ruudussa on lentokone tai -koneita. Mikäli pelaaja avaa ruudun jossa on lentokone, peli päättyy. Numeroruutujen vihjeiden mukaan päättelemällä pelaaja voi merkitä oletetut lentokoneruudut painamalla oikealla hiirennapilla, jolloin ruutu lukittuu tutkakontaktiksi. Pelin voittaa merkitsemällä kaikki lentokoneruudut tutkakontaktilla ja avaamalla kaikki muut ruudut.
Peli toteutetaan harjoitustyönä osana Helsingin yliopiston kevään 2023 tietojenkäsittelytieteen Ohjelmistotekniikka -kurssia ajalla maaliskuu-toukokuu 2023.
Pelisovellus on toteutettu Python ohjelmointikielen 3.10 versiolla ja se edellyttää Pythonin Poetry kirjaston version 1.4.0 (tai uudempi) asennusta em. Pythonin version osalta koneelle pelin paketinhallintaa varten.
Viimeisin vakaa versio lähdekoodista löytyy Release / loppupalautus kohdan alta.
Kun repository on kloonattu haluamaasi hakemistoon, suorita pakettien asentaminen (tai päivittäminen ajantasalle) Poetry:a käyttäen seuraavalla komennolla planesweeper -hakemistossa:
poetry installKun Poetry on onnistuneesti asentanut tarvittavat paketit, voi pelin käynnistää seuraavalla komennolla:
poetry run invoke startVaihtoehtoisesti voit siirtyä terminaalista Poetryn kontekstiin ja käynnistää pelin suoraan ajamalla srv/game.py tiedoston seuraavilla komennoilla (korvaa tarvittaessa python3 -> python riippuen koneesi Python asennuksesta):
poetry shell
python3 src/game.pyLisää komentoja löytyy käyttöohjeesta.
Mikäli haluat tehdä muutoksia, Pytestilla toteutetut automaattiset testit löytyvät repositoryn src/tests hakemistosta. Testikattavuusraportti on konfiguroitu Coveragen avulla. Molemmat paketit ovat projektissa hallittu edelläkuvatun Poetryn avulla.
Voi ajaa testit planesweeper -hakemistosta käsin seuraavalla komennolla:
poetry run invoke testCoverage -raportin voi generoida htmlcov -hakemistoon seuraavalla komennolla:
poetry run invoke coverage-reportHuom: automaattisten testien määrä ja testikattavuus repositoryssa ei toistaiseksi ole kovin korkealla tasolla! Testejä ja testikattavuutta lisätään kurssin kuluessa.
Voit ottaa yhteyttä tekijään sähköpostilla kalle.saunamaki@helsinki.fi.
Game background image: Image by starline on Freepik