Guide - Examinationsuppgift

Här hittar du steg-för-steg-instruktioner om hur du kommer igång med examinationsuppgifterna i kursen. Förfarandet skiljer sig något från hur du jobbat med övningsuppgifterna där du själv forkat uppgifterna. Examinationsuppgifterna skapar du själv, i din egen grupp på GitLab, via ActionHub.

Kom igång med uppgiften

Det första du behöver göra är att skapa examinationsprojektet i din grupp på GitLab. Det görs via ActionHub (se GitLab-resurser) — kryssa i den aktuella uppgiften och klicka på “Create my GitLab resources”. Projektet skapas då i din grupp, i den undergrupp ActionHub anger (i den här kursen campus eller distance): (ex: https://gitlab.lnu.se/1dv025/student/en999zz/distance).

När projektet finns i din grupp, gå in i det och välj “Clone”.

På din dator navigerar du till den katalog där du vill spara uppgiften. Exempelvis:

cd kurser/1dv025/examination

Hämta sedan hem uppgiften från GitLab genom att köra:

git clone git@gitlab.lnu.se:1dv025/student/en999zz/distance/assignment-a2.git

där en999zz ersätts av ditt användarnamn — kontrollera din grupp på GitLab om undergruppen distance skulle skilja sig i ditt fall — och assignment-a2.git är namnet på examinationsuppgiften.

Byt katalog till examinationsuppgiften. Ex:

cd assignment-a2

För att komma igång behöver du installera de externa beroenden som uppgiften har. Det gör du med:

npm install

Arbetsgång med examinationsuppgiften

Nu är det dags att börja arbeta med uppgiften. Du gör detta genom att redigera befintliga filer och eventuellt skapa nya filer beroende på uppgiften. Instruktioner hittar du i uppgiftens README.md-fil.

Köra din kod

Om du vill köra ditt program gör du det med

npm start

Kodstandard

Det är viktigt att kodstandarden följs. Den verifierar att koden är läsbar och att t.ex. kommentarer har skrivits.

Testa om koden uppfyller kodstandarden genom kommandot:

npm run lint

För att försöka automatiskt korrigera vissa stilfel kan du skriva:

npm run lint:fix

Formatering

Utöver kodstandarden ska koden vara formaterad enligt projektets Prettier-konfiguration.

Testa om koden är korrekt formaterad genom kommandot:

npm run format:check

För att automatiskt formatera koden kan du skriva:

npm run format

Testning

På vissa uppgifter finns det färdigskrivna tester som du kan kontrollera din lösning mot. Om dessa finns körs testerna genom kommandot:

npm run test:run