Oefening met functies ​

In deze handleiding stellen we een oefening op die gebruik maakt van functies.

We zullen een oefeningen maken waar de leerlingen een functie moeten implementeren die het kleinste getal van de twee argumenten teruggeeft. We zullen deze oefening hier volledig uitwerken voor gebruik met Dodona.

We gaan er in deze handleiding van uit dat je al een werkende oefeningenrepository hebt. Is dat niet het geval, volg dan eerst de handleiding Oefeningen opstellen.

Het resultaat van deze handleiding (de volledige oefening) kan je ook vinden in onze repository met voorbeelden.

1. Structuur ​

Elke oefening in Dodona komt overeen met een bepaalde map in de oefeningenrepository. Die map heeft een vaste structuur, die we nu zullen maken.

Maak dus eerst een nieuwe map voor de oefening, die we minimum zullen noemen. Maak daarna, in deze nieuwe map, nog twee mappen:

• description: de map waarin de opgave komt
• evaluation: map met informatie over hoe een oplossing beoordeeld moet worden
• solution: map waarin een voorbeeldoplossing komt

De map voor deze oefening moet er als volgt uitzien:

repository/
└── minimum/
   ├── evaluation/
   ├── description/
   └── solution/

repository/
└── minimum/
   ├── evaluation/
   ├── description/
   └── solution/

2. Configuratie ​

Dodona eist voor elke oefeningen ook een configuratiebestand. Dit bestand bevat metadata, die door Dodona gebruikt worden.

Maak het bestand config.json in de map hello-world met de volgende inhoud:

{
  "description": {
    "names": {
      "en": "Minimum",
      "nl": "Minimum"
    }
  },
  "programming_language": "python",
  "access": "private"
}

{
  "description": {
    "names": {
      "en": "Minimum",
      "nl": "Minimum"
    }
  },
  "programming_language": "python",
  "access": "private"
}

In dit bestand worden drie dingen gespecifieerd:

• De naam van de oefening zoals getoond door Dodona in het Nederlands en in het Engels (in dit geval zijn beide namen hetzelfde).
• De programmeertaal van de oefening: hier kies je in welke programmeertaal je de oplossingen wilt. In dit geval is dat Python.
• Het toegangsniveau: hier private. We kiezen voor een private oefening omdat dit maar een handleiding is, maar we moedigen aan om je oefeningen publiek te zetten: dan kunnen andere leerkrachten er ook gebruik van maken (net zoals jij de keuze hebt uit duizenden publieke oefeningen op Dodona).

Nadat je dit bestand gemaakt hebt, zal je repository er zo uitzien:

repository/
└── minimum/
   ├── evaluation/
   ├── description/
   ├── solution/
   └── config.json

repository/
└── minimum/
   ├── evaluation/
   ├── description/
   ├── solution/
   └── config.json

3. Opgave en voorbeeldoplossing ​

De volgende stap is de opgave van de oefening. Dit krijgen leerlingen en studenten te zien wanneer ze de oefening willen oplossen en vertelt hen wat ze moeten doen.

Maak een bestand description.nl.md aan in de map description van de oefening, met volgende inhoud:

Schrijf een functie `minimum` die twee getallen als argumenten aanvaardt.
Deze functie moet het kleinste geval van die twee teruggeven.

### Voorbeeld

```console?lang=python&prompt=>>>
>>> minimum(5, 6)
5
```

Schrijf een functie `minimum` die twee getallen als argumenten aanvaardt.
Deze functie moet het kleinste geval van die twee teruggeven.

### Voorbeeld

```console?lang=python&prompt=>>>
>>> minimum(5, 6)
5
```

De nl in de naam van de opgave kan je vervangen door en als je ook een Engelstalige opgave wilt maken. De opgave zelf wordt geschreven in Markdown, een redelijk eenvoudig opmaakformaat. Meer informatie over Markdown is hier te vinden.

We voegen ook direct een voorbeeldoplossing toe. Dit is niet verplicht, maar vaak is het wel handig om te hebben. Leerlingen kunnen deze voorbeeldoplossing niet zien (tenzij je repository publiek staat natuurlijk).

Maak een bestand solution.py aan in de map solution met volgende inhoud:

def minimum(a, b):
    if a < b:
        return a
    else:
        return b

def minimum(a, b):
    if a < b:
        return a
    else:
        return b

Nadat je deze twee bestanden gemaakt hebt, moet je repository er zo uitzien:

repository/
└── minimum/
   ├── evaluation/
   ├── description/
   |  └── description.nl.md
   ├── solution/
   |  └── solution.py
   └── config.json

repository/
└── minimum/
   ├── evaluation/
   ├── description/
   |  └── description.nl.md
   ├── solution/
   |  └── solution.py
   └── config.json

4. Een testplan maken ​

We willen dat deze oefening automatisch getest wordt. Hiervoor moeten we een testplan schrijven, waarin we Dodona vertellen welke testen we allemaal willen uitvoeren.

In dit geval houden we het testplan kort, met slechts een beperkt aantal testgevallen. In een echte oefening wil je waarschijnlijk meer testgevallen voorzien.

Maak een bestand suite.yaml aan in de map evaluation van de oefening, met volgende inhoud:

- tab: "minimum"
  testcases:
    - expression: "minimum(5, 6)"
      return: 5
    - expression: "minimum(1.2, 1.96)"
      return: 1.2
    - expression: "minimum(1000000000, -5)"
      return: -5
    - expression: "minimum(-5, -6)"
      return: -6
    - expression: "minimum(6, 6)"
      return: 6

- tab: "minimum"
  testcases:
    - expression: "minimum(5, 6)"
      return: 5
    - expression: "minimum(1.2, 1.96)"
      return: 1.2
    - expression: "minimum(1000000000, -5)"
      return: -5
    - expression: "minimum(-5, -6)"
      return: -6
    - expression: "minimum(6, 6)"
      return: 6

In dit testplan gebeuren een aantal dingen:

• De tabbladen vanop Dodona reflecteren zich ook in het testplan. Alle testgevallen zitten hier in één tabblad, met als naam "minimum".
• Er zijn 5 testgevallen.
• Voor elk testgeval definiëren we een expressie: wat er uitgevoerd moet worden. Hiervoor gebruik je de Python-syntax. In dit geval voeren we de functie die de leerlingen moeten maken uit met verschillende parameters.
• We definiëren ook de verwachte returnwaarde voor elk testgeval.

Finaal ziet de bestandsstructuur er dus als volgt uit:

repository/
└── minimum/
   ├── evaluation/
   |  └── suite.yaml 
   ├── description/
   |  └── description.nl.md
   ├── solution/
   |  └── solution.py
   └── config.json

repository/
└── minimum/
   ├── evaluation/
   |  └── suite.yaml 
   ├── description/
   |  └── description.nl.md
   ├── solution/
   |  └── solution.py
   └── config.json

5. Wijzigingen opslaan ​

Vergeet niet om je wijzigingen te committen, anders gaan ze verloren!

Een voorbeeld van hoe je dit kan doen vind je in hier.