Koodikatselmointi 1

Lähdekoodi katselmusta varten ladattu 7.12.2020 klo 13.30

Yleistä

Arkkitehtuurikuvaus on hyvin kattava, joten sen kautta saa hyvän käsityksen rakenteesta sekä sovelluslogiikasta ja erityisesti sekvenssikaaviot oli toteutettu hyvin kattavasti.

Luokkien ja metodien nimet oli merkitty niiden toimintaa kuvaavasti, englanniksi sekä oikeaa formaattia käyttäen (camelCase ja snake_case).

Suorituksessa ohjelmistosta en löytänyt kuin yhden bugin (josta alempana). En saanut sitä kaatumaan tai tekemään mitään muutakaan erikoista, joten tämä puoli on myös hyvin hoidossa.

Ohjelmiston koodi oli mielestäni hyvää ja sain siitä muutaman hyvän idean myös omaan toteutukseeni.

Lähdekoodi

Entities/card.py

Hyvin toteutettu, ei muuta kommentoitavaa.

Entities/deck.py

Funktio generate_deck() käyttää apumuuttujaa card_deck, vaikka se voisi käyttää suoraa luokan muuttujaa self.card_deck.

Funktio draw_one_card() käyttää muuttujaa self.current_card_index ja kun se on >51 sekoitetaan uusi pakka. Mielestäni pakan sekoituksen voisi refaktoida omaksi metodiksi ja draw_one_card() "poistaa" pakasta vain yhden kortin. Tällöin metodi menee myös single responsibility laatuvaatimuksen alle.

Entities/player.py

remove_credits() kommentissa lukee:

If current amount is more than current credits, will remove remaining credits.

ja mielestäni tämä toiminnallisuus pitäisi muuttaa, sillä videopokeria ei yleensä pelata "velaksi"?

save_player() ja load_player() sijainti olisi mielestäni parempi luokassa PlayerRepository.

Repositories/player_repository.py

Hyvin toteutettu. Tänne mielestäni voisi lisätä metodin save_player() ja funktion load_player().

Services/game_manager.py

Metodeihin increase_bet() ja decrease_bet() voisi laittaa tarkistukset pelaajan krediittien saldosta ja rajata maksimipanos sen mukaan. Tästä johtuen ladatussa versiossa on bugi joka mahdollistaa pelaajan krediittien summaa suuremman panoksen asettamisen ja sillä pelaamisen.

Ehdottaisinkin, että reset_game() metodin current_bet muuttujaan voisi ajatella kutsua uuteen metodiin (esim. check_bet_size()) joka suorittaa vertailun pelaajan krediittien saldon sekä asetetun panoksen välillä ja palauttaa siten uuden maksimipanoksen.

check_player_hand() metodia voisi jakaa hieman kompaktimmaksi, nyt se on yli 60 riviä pitkä ja näin aika vaikealukuinen.

Services/game_state.py

__init__ pitää sisällään osan käyttöliittymän visuaalisesta puolesta. Voisiko sitä siirtää ui-kansion alla oleviin tiedostoihin?

__init__ ja run() ovat myös hyvin pitkiä rivimäärältään, joten niitä voisi hieman palastella.

Ui/*.py

Monien luokkien__init__ metodeissa mennään yli 20 rivin, mutta tältä ei varmaankaan voi vällttyä.

Olisiko sprites-kansion luontaisempi paikka täällä ui-kansion alla, tai jopa ui/components-kansion alla?

Tests/*.py

Testit oli jaettu samanlaiseen hakemistorakenteeseen kuin testattavat luokat ja ne olivat myös nimetty selkeästi, joten oikean testitiedoston löytäminen oli helppoa. Testit myös vaikuttivat hyödyllisiltä ja niistä jokainen testasi vain yhtä asiaa.

Projekti ladattu 8.12 kello 22.40

Hei.

Erittäin hyvää työtä! :)

Koodin funktiot ja luokat ovat nimetty selkeästi ja käytetty snake_case ja camelCase.
Koodi on jaettu hyvin eri toiminta tarkoitusten mukaisesti (entities, repositories, services, ui).

Luokat hoitavat yhtä asiaa ja ovat selkeästi tehtyjä. Luokassa Card olisi voinut kortin maasta tehdä enumin. Tämä voisi olla koodia lukiessa selkeämpi tapa kuvata maita kuin int. Muuten koodi on kyllä vakuuttava.

Testit ovat tarpeeksi kattavat, järkevästi nimetty ja jaettu.

Kiva sovellus!