T-106.1210 Ohjelmoinnin peruskurssi, osa 1

Kierros 4, tehtävä 5

Taso ja pistearvo:A 120
Lyhyesti:Luodaan käynnistysmoduuli, jonka avulla koekäytetään annettuja elokuvatilastoihin liittyviä luokkia.
Mitä opitaan:Lukemaan Epydoc-dokumentteja, kirjoittamaan käynnistysmoduuli aiempaa itsenäisemmin, käyttämään metodien palauttamia olioita.
Toteuttamisen vapaus:Aika vähäinen edelleen. Ihan yhtä tarkkaa vaihe vaiheelta -ohjetta ei tosin ole annettu kuin aiemmin.
Realistisuus:Korkea. Annetun luokan tarjoamien palvelujen käyttäminen jonkin kiinnostavan(?) ongelman ratkaisemiseen on modernissa ohjelmoinnissa tärkeä taito. Annetun dokumentaation lukutaito on aivan keskeisen tärkeä taito. Ohjelmoijat käyttävät usein valmiita komponentteja, jotta vältytään keksimästä pyörää uudestaan.
Haastavuus:Ei kovin hankala, jos pohjatyö (eli edelliset tehtävät) on tehty ajatuksella.
Työläys:Varsin kevyt tehtävä. Useimmat selviävät tästä varmasti n. parissa tunnissa.

Tehtävänanto

Kirjoittakaa pääohjelma, jonka avulla voi koekäyttää annettuja luokkia TopMovies ja Movie. Näistä edellinen kuvaa "parhaiksi arvioitujen elokuvien listoja" (esim. "Kaikkien aikojen Top 250") ja jälkimmäinen yksittäisiä elokuvia.

Tehtävä on kaksiosainen:

Muistakaan kutsua main-funktiota ohjelman lopussa.

Epydoc-dokumenteista

Python-luokkien keskeiset piirteet kuvataan usein ns. Epydoc-dokumentteina eli webisivuina, jotka generoidaan automaattisesti Python-koodiin kirjoitettujen kommenttien perusteella. Epydoc-dokumentteja käytetään tälläkin kurssilla laajasti, melkein kaikissa tulevissa tehtävissä, ja on erittäin tärkeää osata lukea niitä.

Tämän kurssin projektien Epydoc-dokumentaatiot löytyvät projektin alihakemistosta doc/.

Kun luette Epydoc-dokumentteja, huomatkaa miten ne kuvaavat nimenomaan luokkien "julkiset osat" -- siis tiedot, joita luokkien käyttäjä tarvitsee: luokkien perusajatus, niiden alustusmetodit (miten luokista luodaan olioita) ja muut metodit (miten luotuja olioita käytetään). Luokkien sisäisen toteutuksen yksityiskohdat puolestaan eivät selviä näistä dokumenteista.

Palauttaminen

Palauttakaa luomanne tiedosto movie_test.py arvosteltavaksi Goblin-järjestelmään. Jos tarvitsette apua palautuksen tekemisessä, katsokaa lisätietoja kurssisivujen Goblin-ohjeesta.

Ohjeita ja vinkkejä