Tehtäväalusta

Kurssin tehtävät tehdään otarustlings tehtäväalustalla (docs.rs).

otarustlings tehtäviä ei tarvitse palauttaa kurssin aikana vaan kaikki palautetaan vasta lopussa. Bonus-tehtävät (B:llä alkavat) eivät ole pakollisia vaan niistä saa lisäpisteitä.

otarustlings on Rust kurssia varten käsin uudelleenkirjoitettu rustlings klooni. rustlings kirjoitettiin uudelleen koska se oli niin huonosti koodattu. Lopulta otarustlings on ihan yhtä huonoa koodia mutta ominaisuudet ovat sentään paremmat.

otarustlingsin jokainen tehtävä sisältää "testin", vaikka tehtävän ratkaisuksi riittää saada koodi kääntymään. Tämä johtuu siitä että tulostetut asiat eivät tulisi muuten näkyviin testatessa.

Asentaminen

Asenna otarustlings Cargolla:

cargo install otarustlings

otarustlingsin pystyy asentamaan manuaalisesti Linux-x86_64 tietokoneelle lataamalla uusimman binäärin repositorion julkaisuista (kohdasta Assets > Other),

Quick start

Suorita seuraavat komennot joko erillisellä komentorivillä tai VS Coden integroidulla komentorivillä

  • Asenna otarustlings (ei toimi windowsilla vielä)

    cargo install otarustlings
    
  • Luo tehtävät

    otarustlings init
    

    Huomaa: komento ei ylikirjoita vanhoja tiedostoja

  • Aloita otarustlings

    otarustlings start
    
  • Avaa tehtävät koodieditorissa, ja aloita koodaaminen. Esimerkiski, jos käytät VS Codea, voit suorittaa seuraavan komennon samasta kansiosta jossa suoritit otarustlings init

    code exercises/week1
    

Ohje

Käyttöohje löytyy otarustlings paketin dokumentaatiosta.

otarustlingsin komentoriviohjeet saat komennolla

otarustlings --help

Rust analyzerin käyttö

Rust analyzerin käyttäminen on ehdottomasti sallittua ja suositeltavaa.

Rust analyzer tarvitsee Cargo.toml pakettimanifestitiedoston, jotta sitä voi käyttää tehtävissä. Kyseinen manifesti sijaitsee sijainnissa exercises/Cargo.toml.hack, joka pitää uudelleennimetä Cargo.tomliksi, jotta Rust analyzer tunnistaa sen.

Tiedoston nimi ei voinut olla Cargo.toml, sillä muuten koko exercises kansio olisi puuttunut julkaisusta. Tulevaisuudessa otarustlings uudelleennimeää tiedoston automaattisesti.

Tehtävien palauttaminen

Otarustlings tehtäväkansio exercises palautetaan kurssin lopussa. Kansion voi arkistoida esimerkiksi zip tai tar.gz muotoon, joka lähetetään arvioitavaksi Niklakselle: telegram tai sähköposti.