Aurala / ot-harjoitustyo

Aineopintojen harjoitustyö: ohjelmistotekniikka, kevät 2024
https://ohjelmistotekniikka-hy.github.io/
0 stars 0 forks source link

Aineopintojen harjoitustyö: ohjelmistotekniikka, kevät 2024

Kurssisivu

Harjoitustyö: Outomaatti

Outomaatti-sovellus toteuttaa soluautomaatin. Oletusarvoina sovelluksessa on John Conway'n kehittämän Game of Lifen säännöt (B3/S23), mutta sovellus tarjoaa käyttäjälle mahdollisuuden käyttää erilaisia sääntöjä.

Sovellusta voidaan käyttää viihdyttävänä ajanvietteenä tai opetuskäytössä, esimerkiksi innostamaan lapsia matematiikan opiskeluun tai jopa tuottamaan Python-koodia (omien sääntöjen kirjoittaminen).

Toimintaympäristöstä

Testatut ympäristöt:

Riippuvuuksien puolesta sovellus toimii Python-versioilla 3.8-3.11. Kehityksessä ja testauksessa on ollut käytössä pääasiassa Python 3.10.

Lataa ja kokeile

Dokumentaatio

Komentorivitoiminnot

Asennus

Kun projekti on kopioitu haluttuun paikkaan, siirrytään koodin sisältävään hakemistoon ja ajetaan komento:

poetry install

Komento virtuaaliympäristön ja lataa tarvittavat riippuvuudet.

Poetryn asennusohjeet löytyvät täältä.

Käynnistetään Poetryn shell:

poetry shell

Lopuksi alustetaan tietokanta komennolla:

poetry run invoke build

Käynnistys

Ohjelma käynnistyy komennolla:

poetry run invoke start

Testaus

Koodin laatua mittaava testi ajetaan komennolla:

poetry run invoke lint

Automaattitestit suoritetaan komennolla:

poetry run invoke test

Testiraportti generoidaan komennolla:

poetry run invoke coverage-report

Testit ajetaan tilapäistä testitietokantaa vasten.

Muuta

Erilaisten työkalujen luomat työtiedostot, cache-tiedostot yms. voidaan poistaa komennolla:

poetry run invoke clean