Controleren met beetje check

Het commando onder elke les

Onder elke les met een lab staat welk check-commando erbij hoort, bijvoorbeeld:

beetje check python-les2

python-les2 is het les-id: de cursus plus het lesnummer. Bij de cursus Programmeerconcepten begint het id met concepten- en bij Een beetje Linux & Docker is het alleen les1, les2, enzovoort. Je hoeft het id niet te onthouden; het staat altijd bij de les.

Checken vanuit je lesmap

Sta je al in de map van de les, dan mag je het id weglaten:

cd ~/lessen/02
beetje check

beetje ziet dan aan de map (~/lessen/02) welke les je bedoelt. Sta je ergens anders, bijvoorbeeld in je thuismap, dan gebruikt het de les uit BEETJE_LESSON (les 2 van deze cursus). Twijfel je, geef dan gewoon het volledige id.

De uitvoer lezen

Een check bestaat uit een aantal controles. Elke controle krijgt een regel. Een voorbeeld (welke controles er zijn, verschilt per les):

🔎 beetje check python-les2  (werkmap: /home/student/lessen/02)
  ✅ requirements.txt bestaat
  ✅ requirements.txt noemt requests
  ❌ uitvoer bevat 'Status: 200' niet
     jouw uitvoer:
       │ Traceback (most recent call last):
       │ ...

Nog niet klaar: 1 van 3 controles niet gehaald. Pas aan en probeer opnieuw.

• ✅ deze controle is gehaald;
• ❌ deze niet, vaak met verwacht: en jouw uitvoer: eronder, zodat je ziet waar het verschil zit;
• ℹ️ extra informatie, geen fout.

Zijn alle controles gehaald, dan eindigt het met:

🎉 Alles goed (3 controles). Goed gedaan!

Gebruik de ❌-regels als aanwijzing: pas je code aan, sla op en check opnieuw. Zo vaak als je wilt; er is geen maximum.

Exitcodes

Net als elk Linux-programma geeft beetje check een exitcode terug:

Direct na de check zie je de code met echo $?. Handig als je zelf een scriptje maakt, bijvoorbeeld beetje check && echo "Door naar de volgende les!".

Les-id's vinden met beetje lijst

Wil je weten welke lessen er in het image zitten?

beetje lijst

python-les2            python/02
python-les3            python/03
...
concepten-les1         programmeerconcepten/01
...

Links staat het les-id, rechts de cursus en het lesnummer. Krijg je de melding les 'x' staat niet in dit lab-image, controleer dan je typwerk, of je het image van de goede taal gebruikt, en of je image wel recent genoeg is. Nieuwe lessen komen pas in je image als je het opnieuw downloadt (docker pull) of opnieuw bouwt.

Lesbestanden opnieuw klaarzetten

Bij het opstarten zet het image de startbestanden van alle lessen van je cursus klaar, zonder ooit iets van jou te overschrijven. Soms wil je dat zelf doen:

• Een les van een andere cursus in hetzelfde image, bijvoorbeeld concepten-les1 terwijl BEETJE_COURSE=python is:

  beetje start concepten-les1
  

  De bestanden komen dan in ~/lessen/programmeerconcepten/01. Daar werkt beetje check zonder id ook.

• Een les opnieuw beginnen. beetje start overschrijft niets. Wil je echt opnieuw beginnen, hernoem of verwijder dan eerst je lesmap en zet hem daarna opnieuw klaar:

  mv ~/lessen/02 ~/lessen/02-oud
  beetje start python-les2
  

• Werk je met een volume op je thuismap (les 3) en zit er na een update een nieuwe les in het image? Dan zet beetje start <les-id> die les klaar.

Lokaal checken en je voortgang op de site

beetje check draait helemaal op je eigen computer, in de container. Het praat niet met beetjecoderen.nl. Een geslaagde lokale check zie je dus niet terug in je account. De lessen zelf rond je op de site af, met de quiz onderaan de les. Bij betaalde cursussen kun je veel labs ook als live lab in de browser doen; daar controleert de server je lab, en een geslaagd live lab levert XP op.

Daar staat tegenover dat lokaal werken geen tijdslimiet heeft, je eigen editor kan gebruiken en ook offline werkt zodra het image eenmaal op je computer staat.