Oletetaan että koneellesi on asennettu Ruby ja rspec. Jos ei, toimi esim. tämän ohjeen mukaan.
Tarvitset kurssin suorittamista varten käyttäjätunnuksen GitHub:iin ja pienen määrän git-osaamista. Luo tunnus esim. täällä olevan ohjeen mukaan
Kurssimateriaalin seassa olevien tehtävien nimeä klikkaamalla pääset tehtäväpohjan sisältävään GitHub-repositorioon. Voit mennä tehtävien repositorioihin myös suoraan selaimella, esim. tehtävän 1 repositorio on osoittessa https://github.com/HY-TKTL/ruby-tehtava1
Kun olet tehtäväpohjan repositoriossa forkkaa se itsellesi klikkaamalla yläreunassa olevaa painiketta:
Tehtäväpohjasta "kopioituu" nyt repositorio, joka sijoitaan oman githubtunnuksesi alle:
Seuraavaksi kloonataan repositorio omalle koneelle. Copypastaa ylläolevan kuvan oikealle merkityssä laatikossa oleva kloonausosoite (varmista, että clone url on tyyppiä ssh).
Avaa terminaali ja anna komento (käytä forkkaamasi repositorion kloonausurlia):
git clone git@github.com:mluukkai-cs/ruby-tehtava4.git
Näin syntyy hakemisto ruby-tehtava4. Mene hakemistoon komennolla
cd ruby-tehtava4
Tehtävän koodi tehdään kurssin ensimmäisen osan tehtävissä tiedostoon koodi.rb
Koodi suoritetaan antamalla terminaalista komento
ruby koodi.rb
Tehtävään liittyvät testit ovat tiedostossa test_spec.rb. Testit suoritetaan terminaalista komennolla:
rspec test_spec.rb
Jos testit eivät mene läpi, kannattaa lukea virheilmoituksia.
Kun testit menevät paikallisesti läpi, ne palautetaan pushaamalla koodi githubiin.
Ensin koodiin tekemäsi muutokset tulee commitoida versionhallintaan. Tämä tapahtuu antamalla terminaalissa komennot
git add koodi.rb
git commit -m "tähän commitviesti eli joku järkevä teksti"
git push
Nyt kirjoittamasi koodin pitäisi näkyä GitHub-profiilin alle kloonatussa versiossasi tehtävän repositoriosta (eli samassa joka avautui selaimeen painikkeen fork painamisen jälkeen).
Kun olet varmistanut että koodi näkyy GitHubissa, tulee tehdä pull request klikkaamalla new pull request.
Joudut vielä painamaan pariin kertaan hieman erilaisilla sivuilla olevaa painiketta create pull request.
Lopulta pull request on tehty:
Pull requestin tekemisen jälkeen koodisi testataan Travis-palvelun avulla. Menee hetken ennen kuin tieto testien suorituksesta on saatavilla. Klikkaamalla details näet testiraportin. Jos testit ovat menneet läpi paikallisesti, tulisi niiden mennä läpi myös Travisilla.
Tieto suorituksestasi rekisteröityy osoittessa https://ruby-scoresheet.herokuapp.com/ olevalle pistelistalle.
Jos testit eivät mennet läpi, korjaa virheet ja palaa kohtaan tehtävän palauttaminen