From 00ac056f7cc0254b48c1eb5f2e8671e865a4c66d Mon Sep 17 00:00:00 2001 From: pietervanengelen Date: Wed, 26 Mar 2025 12:01:27 +0100 Subject: [PATCH] refactor syllabus naar vsc. Todo: bijlage github_pycharm --- syllabus/Bijlage_Github_en_Pycharm.md | 5 +- syllabus/Bijlage_Installeren old.md | 14 +++ syllabus/Bijlage_Installeren.md | 143 ++++++++++++++++++++++++-- syllabus/Bijlage_nieuwproject old.md | 5 + syllabus/Bijlage_nieuwproject.md | 69 ++++++++++++- syllabus/Bijlage_requirements.md | 48 ++++----- syllabus/Debuggen.md | 32 ++++-- syllabus/Lesplanning.md | 10 +- 8 files changed, 274 insertions(+), 52 deletions(-) create mode 100644 syllabus/Bijlage_Installeren old.md create mode 100644 syllabus/Bijlage_nieuwproject old.md diff --git a/syllabus/Bijlage_Github_en_Pycharm.md b/syllabus/Bijlage_Github_en_Pycharm.md index 8494904..40e362b 100644 --- a/syllabus/Bijlage_Github_en_Pycharm.md +++ b/syllabus/Bijlage_Github_en_Pycharm.md @@ -1,4 +1,7 @@ -# Bijlage: GitHub en PyCharm +# ~~Bijlage: GitHub en PyCharm~~ + +**DEZE MOET NOG UITGEWERKT WORDEN +** In deze cursus is het verplicht Git te gebruiken. Hiermee houd je online de versies van je software bij. Ook kunnen wij als begeleiders makkelijk met je meekijken en je vorderingen zien. Uiteindelijk moet je een zip-file van je software vanuit GitHub maken en deze inleveren in je Q-highschool portfolio/inleverbakje. Deze handleiding bestaat uit twee delen. Je kunt kiezen om deel 1 te volgen of deel 2 te volgen. Het resultaat van de instructie is bij allebei hetzelfde. In de les gebruiken we deel 1 van de instructie. diff --git a/syllabus/Bijlage_Installeren old.md b/syllabus/Bijlage_Installeren old.md new file mode 100644 index 0000000..e55efc4 --- /dev/null +++ b/syllabus/Bijlage_Installeren old.md @@ -0,0 +1,14 @@ +# Bijlage: Python en PyCharm installeren + +In deze module ga je het professionele gereedschap PyCharm gebruiken. Dit programma is namelijk makkelijk in gebruik en overzichtelijk, en heeft daarbij ook nog eens een ingebouwde interpreter (hetgeen je code leest en vertaalt naar computertaal). + +Installeer eerst Python. Download de installer [hier](https://www.python.org/downloads/), en volg de instructies. Verander niets qua instelling, aangezien dit niet nodig is. + +Download als dat klaar is **PyCharm Community Edition** [hier](https://www.jetbrains.com/pycharm/download/#section=windows). Bij de installatie, selecteer *Add launchers dir to the PATH*, *Create Associations - .py* en *Add “Open Folder as Project”*. Als alles gereed is kan je beginnen met het instellen. Open PyCharm, accepteer de *Terms and Conditions* en kies je favoriete theme. Plugins zijn niet nodig, sla deze over. + +Als het goed is, heb je nu Python en PyCharm geïnstalleerd en kun je aan de slag voor deze module. + +Verdere informatie kan je hier vinden: + + +Bij de module Basis van Programmeren met Python mocht je ook Replit of een andere editor gebruiken. Dat mag in deze module ook, alleen alle uitleg en instructie is gericht op het gebruik van PyCharm. Dus het meest verstandig is om PyCharm te gebruiken. \ No newline at end of file diff --git a/syllabus/Bijlage_Installeren.md b/syllabus/Bijlage_Installeren.md index e55efc4..f95d020 100644 --- a/syllabus/Bijlage_Installeren.md +++ b/syllabus/Bijlage_Installeren.md @@ -1,14 +1,141 @@ -# Bijlage: Python en PyCharm installeren +# Bijlage: Python en Visual Studio Code installeren -In deze module ga je het professionele gereedschap PyCharm gebruiken. Dit programma is namelijk makkelijk in gebruik en overzichtelijk, en heeft daarbij ook nog eens een ingebouwde interpreter (hetgeen je code leest en vertaalt naar computertaal). +In deze bijlage lees je hoe je Python installeert en hoe je Visual Studio Code gebruikt als ontwikkelomgeving (IDE) voor je Python-projecten. Met Visual Studio Code kun je eenvoudig Python-code schrijven, testen en debuggen, en dankzij de vele extensies kun je je werkomgeving op maat uitbreiden. -Installeer eerst Python. Download de installer [hier](https://www.python.org/downloads/), en volg de instructies. Verander niets qua instelling, aangezien dit niet nodig is. +--- -Download als dat klaar is **PyCharm Community Edition** [hier](https://www.jetbrains.com/pycharm/download/#section=windows). Bij de installatie, selecteer *Add launchers dir to the PATH*, *Create Associations - .py* en *Add “Open Folder as Project”*. Als alles gereed is kan je beginnen met het instellen. Open PyCharm, accepteer de *Terms and Conditions* en kies je favoriete theme. Plugins zijn niet nodig, sla deze over. +## Python installeren -Als het goed is, heb je nu Python en PyCharm geïnstalleerd en kun je aan de slag voor deze module. +Om met Python aan de slag te gaan, heb je eerst een recente versie van Python nodig. De meeste projecten in dit lesmateriaal gaan uit van Python 3.10 of hoger. -Verdere informatie kan je hier vinden: - +### Windows -Bij de module Basis van Programmeren met Python mocht je ook Replit of een andere editor gebruiken. Dat mag in deze module ook, alleen alle uitleg en instructie is gericht op het gebruik van PyCharm. Dus het meest verstandig is om PyCharm te gebruiken. \ No newline at end of file +1. **Download de installer** + Ga naar de [officiële Python-website](https://www.python.org/downloads/) en download de nieuwste stabiele release van Python 3 voor Windows. + +2. **Voer de installer uit** + Dubbelklik op het gedownloade bestand. Zorg dat je bij de eerste stap van de installer het vakje **Add Python to PATH** aanvinkt, zodat je Python straks vanaf de opdrachtprompt (cmd) of PowerShell kunt gebruiken. + +3. **Controleer de installatie** + Open een opdrachtprompt (cmd) of PowerShell en typ: + ```bash + python --version + ``` + Je zou nu een versienummer moeten zien, bijvoorbeeld Python 3.10.9. + +### macOS +1. **Controleer of Python 3 al aanwezig is** + + Open de *Terminal*-app en typ: + + ```bash + python3 --version + ``` + Het kan zijn dat je macOS standaard een oudere Python-versie bevat (zoals 2.7). Daarom is het vaak handig om de officiële installatie van Python 3 te gebruiken. + +2. **Download en installeer Python 3** + + Ga naar de [officiële Python-website](https://www.python.org/downloads/mac-osx/) en download de macOS 64-bit installer voor de meest recente Python 3-versie. Voer de installer uit en volg de stappen. +3. **Controleer de installatie** + + Open de Terminal opnieuw en typ: + + ```bash + python3 --version + ``` + + Je zou nu een bericht moeten krijgen met de door jou geïnstalleerde versie, bijvoorbeeld `Python 3.10.9`. Of in ieder geval een versie die hoger ligt dan Python 3.5. + +### Linux (optioneel) +Als je op Linux werkt, heb je vaak al een recente Python-versie in je distributie. Je kunt dit controleren met: +```bash +python3 --version +``` +Is je versie verouderd? Volg dan de instructies van je specifieke Linux-distributie (bijv. `apt-get`, `dnf`, of `pacman`) om Python 3 te installeren of te upgraden. + +## Visual Studio Code installeren +### Downloaden en installeren +1. **Download Visual Studio Code** + + Ga naar de [officiële Visual Studio Code-website](https://code.visualstudio.com/) en download de installer voor jouw besturingssysteem (Windows, macOS of Linux). +2. **Volg de installatiestappen** + + Volg de instructies van de installer. Op Windows krijg je bijvoorbeeld de optie om “*Add to PATH*” aan te vinken. Dit is handig, maar niet strikt noodzakelijk. + +### Visual Studio Code starten +Nadat de installatie is voltooid, kun je Visual Studio Code openen via het icoontje op je bureaublad of in je applicatieoverzicht (Windows Startmenu, macOS Launchpad, of Linux-menu). + +## Visual Studio Code configureren voor Python +Voor het schrijven en debuggen van Python-code in Visual Studio Code raden we aan om de **officiële Python-extensie** te installeren. +1. **Open de extensies**. + + Klik aan de linkerzijde in Visual Studio Code op het icoon van de **Extensions**-sidebar (de vier blokken). +2. **Zoek naar 'Python'** + + Voer in de zoekbalk `Python` in. +3. **Installeer de Python-extensie** + + Kies de extensie van **Microsoft** en klik op *Install*. + +4. **Eventueel: linting en formatting** + + Installeer ook de extensies voor **Pylint** of **Flake8** (linting) en bijvoorbeeld **Black** of **autopep8** (formattering) als je je code wilt laten controleren en automatisch netjes wilt laten opmaken. + +### Python-interpreter selecteren +Visual Studio Code kan met meerdere Python-versies op je systeem omgaan. Om zeker te weten dat je de juiste versie gebruikt, kun je rechtsonder in de statusbalk (of via de Command Palette) de actieve Python-interpreter kiezen. + +1. **Command Palette openen** + + Druk op `Ctrl + Shift + P` (Windows/Linux) of `Cmd + Shift + P` (macOS). + +2. **Kies de interpreter** + + Typ in de Command Palette Python: `Select Interpreter` en kies de gewenste Python-versie. + +### PEP8 Style Checking met PyLint + +Om je code te laten voldoen aan de PEP8-standaarden (leesbare en consistente Python-code), kun je een linter als **PyLint** installeren: +1. **Installeer de PyLint-extensie** + - Ga naar het **Extensions**-icoon in Visual Studio Code. + - Zoek op *PyLint* en installeer de extensie (meestal ook van Microsoft). +2. **PyLint configureren** + - Open een `.py`-bestand in je project. + - Visual Studio Code detecteert nu automatisch dat je PyLint hebt. Je krijgt eventuele opmerkingen over je code direct in de editor te zien. +3. **Lint-fouten bekijken** + - Als er PEP8-waarschuwingen of -fouten zijn, verschijnen deze in het **Problems**-paneel (meestal onderin het scherm). + - Je kunt dubbelklikken op een waarschuwing om naar de betreffende regel in je code te springen. +4. **Automatisch formatteren (optioneel)** + - Voeg extensies als **Black** of **autopep8** toe om je code automatisch op te schonen. + - Na installatie kun je in de Command Palette (`Ctrl+Shift+P` of `Cmd+Shift+P`) zoeken op Format Document. + +Door PyLint te gebruiken, blijft je code consistent en overzichtelijk, wat vooral bij grotere projecten van onschatbare waarde is. + +## Testen of alles werkt + +Om te controleren of alles naar behoren is ingesteld: +1. Maak in Visual Studio Code een nieuw bestand aan, bijvoorbeeld `hallo.py`. +2. Voeg de volgende code toe: + ```python + print("Hallo, Python!") + ``` +3. Sla het bestand op (bij voorkeur in een nieuwe map, zoals `C:\mijnproject` op Windows of in je Thuismap). +4. Druk op F5 om te debuggen of gebruik de knop **Run and Debug** (links in Visual Studio Code). +5. Als alles goed gaat, zie je in het Debug Console-venster `Hallo, Python!` verschijnen. + +Is dit gelukt, dan ben je klaar om aan de slag te gaan met de rest van het lesmateriaal! + +## Veelvoorkomende problemen en oplossingen +- **Python niet gevonden** + + Controleer of je Python correct aan je PATH hebt toegevoegd tijdens de installatie of doe dit handmatig in je systeeminstellingen. +- **Oude Python-versie** + + Verwijder (of update) oude versies, en zorg dat je in VS Code de juiste interpreter selecteert. +- **Geen uitvoer** + + Check of je het juiste bestand hebt opgeslagen en of je in de juiste directory werkt. +- **Linting werkt niet** + + Controleer of je de juiste extensie hebt geïnstalleerd en dat in je statusbalk (rechtsonder) de juiste Python-interpreter staat geselecteerd. + +**Gefeliciteerd!** Je hebt nu zowel Python als Visual Studio Code geïnstalleerd, geconfigureerd én een PEP8-style checker zoals PyLint toegevoegd. Met deze set-up kun je moeiteloos Python-code schrijven, uitvoeren, debuggen en controleren op stijl en kwaliteit. Ga nu gerust verder met het ontwikkelen van je projecten en veel plezier met programmeren! \ No newline at end of file diff --git a/syllabus/Bijlage_nieuwproject old.md b/syllabus/Bijlage_nieuwproject old.md new file mode 100644 index 0000000..6032b51 --- /dev/null +++ b/syllabus/Bijlage_nieuwproject old.md @@ -0,0 +1,5 @@ +# Bijlage: Nieuw project in PyCharm + +Klik dan op *Create New Project*. Kies de gewilde locatie op je PC waar je het project wil neerzetten en de naam van het project. Klik dan op *Project Interpreter*. Selecteer *Existing Interpreter* en kies *Python 3.x*. Als deze er niet tussen staat, klik op de drie puntjes, *System Interpreter* en selecteer de enige optie. Klik op *OK* en daarna *Create*. + +Je hebt nu je eerste project! Om een nieuw bestand te maken klik je met de rechter-muisknop op het mapje met de naam die je het project gegeven hebt, onder *Project*. Selecteer *New*, *Python File*. Copy-paste `print("hi")` in het bestand dat je net gemaakt hebt en klik bovenin op tab *Run, Run* (of klik Shift + F10). Je ziet onder in beeld een zwart scherm opkomen waar 'hi' in staat. diff --git a/syllabus/Bijlage_nieuwproject.md b/syllabus/Bijlage_nieuwproject.md index 6032b51..26315cb 100644 --- a/syllabus/Bijlage_nieuwproject.md +++ b/syllabus/Bijlage_nieuwproject.md @@ -1,5 +1,68 @@ -# Bijlage: Nieuw project in PyCharm +# Bijlage: Nieuw project in Visual Studio Code -Klik dan op *Create New Project*. Kies de gewilde locatie op je PC waar je het project wil neerzetten en de naam van het project. Klik dan op *Project Interpreter*. Selecteer *Existing Interpreter* en kies *Python 3.x*. Als deze er niet tussen staat, klik op de drie puntjes, *System Interpreter* en selecteer de enige optie. Klik op *OK* en daarna *Create*. +In deze bijlage zie je hoe je snel en eenvoudig een nieuw Python-project opzet in Visual Studio Code. -Je hebt nu je eerste project! Om een nieuw bestand te maken klik je met de rechter-muisknop op het mapje met de naam die je het project gegeven hebt, onder *Project*. Selecteer *New*, *Python File*. Copy-paste `print("hi")` in het bestand dat je net gemaakt hebt en klik bovenin op tab *Run, Run* (of klik Shift + F10). Je ziet onder in beeld een zwart scherm opkomen waar 'hi' in staat. +--- + +## Een nieuwe map maken + +1. **Kies een locatie** + Bedenk waar je je project wilt bewaren en maak daar een nieuwe map aan, bijvoorbeeld `C:\MijnProject` (Windows) of in je thuismap op macOS/Linux. + +2. **Open de map in Visual Studio Code** + - Start Visual Studio Code. + - Klik op *File* > *Open Folder…* (Windows/Linux) of *File* > *Open…* (macOS). + - Navigeer naar de map die je net hebt gemaakt en open deze. + +Je hebt nu de basis van je project klaargezet in Visual Studio Code. + +--- + +## Interpreter instellen (optioneel) + +1. **Interpreter selecteren** + Rechts onderin de statusbalk van Visual Studio Code kun je de actieve Python-versie zien. Staat er geen Python-versie? + - Druk op Ctrl + Shift + P (Windows/Linux) of Cmd + Shift + P (macOS). + - Typ `Python: Select Interpreter` en kies de Python 3.x-versie die je wilt gebruiken. + +2. **Interpreter ontbreekt?** + Als je geen optie ziet voor Python 3.x, controleer dan of je Python correct hebt geïnstalleerd (zie *Bijlage: Python en Visual Studio Code installeren*) en herstart eventueel Visual Studio Code. + +--- + +## Eerste Python-bestand maken + +1. **Nieuw bestand** + Klik in de *Explorer*-sidebar (het eerste icoontje links in beeld) met de rechtermuisknop op je projectmap. Kies *New File*. + +2. **Bestandsnaam** + Noem het bestand bijvoorbeeld `main.py` of `hallo.py`. + +3. **Code invoeren** + Open het nieuwe bestand en voeg de volgende regel code toe: + ```python + print("hi") + ``` + +4. **Bestand opslaan** + Druk op Ctrl + S (Windows/Linux) of Cmd + S (macOS) om het bestand op te slaan. + +## Code uitvoeren +1. **Run and Debug** + + Klik in Visual Studio Code links op het *Run and Debug*-icoon (play-icoon met een kever). Als je de Python-extensie hebt geïnstalleerd, kies dan de optie *Python: Current File* (of iets vergelijkbaars). + +2. **Run-bestemming kiezen** + + Visual Studio Code kan je vragen om een launch configuration aan te maken. Hiermee wordt je huidige Python-bestand uitgevoerd. + +3. **Resultaten bekijken** + + Zodra je het script uitvoert, verschijnt er een *Debug Console* of *Terminal*-paneel onder in beeld. Hier zou `hi` moeten verschijnen. + + +Tip: Je kunt ook met F5 (of Fn + F5 op macOS) het huidige bestand starten, mits je een Python-debugconfiguratie hebt ingesteld. + +## Projectstructuur bijhouden + +Je hebt nu je eerste Python-project in Visual Studio Code! Houd je bestanden en mappen netjes geordend. Wil je een extra bestand toevoegen? Klik dan simpelweg in de *Explorer*-sidebar met de rechtermuisknop op je projectmap, kies *New File* of *New Folder* en ga aan de slag. diff --git a/syllabus/Bijlage_requirements.md b/syllabus/Bijlage_requirements.md index 7cb35af..1557cd4 100644 --- a/syllabus/Bijlage_requirements.md +++ b/syllabus/Bijlage_requirements.md @@ -3,36 +3,36 @@ Een `requirements.txt` maakt het eenvoudig om op een andere machine je Pythonproject te installeren en te runnen. Het is verplicht om een `requirements.txt` te gebruiken bij deze Python Plus module. 1. Maak een bestand ‘requirements.txt’ en plaats het bij je andere .py bestanden; -2. Open `requirements.txt` en voeg alle geïnstalleerde en gebruikte python packages toe aan requirements.txt door het runnen van de volgende command in de Terminal van PyCharm: +2. Open `requirements.txt` en voeg alle geïnstalleerde en gebruikte python packages toe aan requirements.txt door het runnen van de volgende command in de Terminal van Visual Studio Code: -``` -pip freeze > .\requirements.txt -``` + ``` + pip freeze > .\requirements.txt + ``` -3. Mocht je nu in de problemen komen, omdat het commando `pip` niet herkend wordt door je computer, dan kun je alsnog een `requirements.txt` genereren in PyCharm. Klik hiervoor op het menu *Tools*. Kies vervolgens voor *Sync Python requirements*. Je komt dan in een dialoogvenster terecht. Je hoeft alleen maar op *OK* te klikken. PyCharm plaatst vervolgens een `requirements.txt` met de door jouw code gebruikte externe bibliotheken in de projectmap. Waarschijnlijk zal PyCharm dan een melding geven of je het bestand aan de Git-repo wil toevoegen. Uiteraard klik je op *Add*. + 3. Als je een nieuwe package nodig hebt, kun je ze op de volgende manier toevoegen `==version`, bijvoorbeeld: -`Tensorflow==2.11.0` + `Tensorflow==2.11.0` -5. Om de packages vervolgens te installeren open je de terminal en voer je het volgende commando uit: +4. Om de packages vervolgens te installeren open je de terminal en voer je het volgende commando uit: -``` -pip install -r .\requirements.txt -``` -6. Voor het toevoegen van nieuwe packages, update je dus de `requirements.txt` en installeer je de file. Vergeet de packages niet te importeren in je .py files. + ``` + pip install -r .\requirements.txt + ``` +5. Voor het toevoegen van nieuwe packages, update je dus de `requirements.txt` en installeer je de file. Vergeet de packages niet te importeren in je .py files. -7. Je kunt kijken of alle packages up to date zijn door middel van het commando: +6. Je kunt kijken of alle packages up to date zijn door middel van het commando: -``` -pip list --outdated -``` -8. Je kunt alle packages updaten door middel van het commando: + ``` + pip list --outdated + ``` +7. Je kunt alle packages updaten door middel van het commando: -``` -pip upgrade -r requirements.txt -``` -Of een specifieke package door middel van het commando: -``` -pip install -U packagename -``` -9. Meer tips en trucks kun je hier vinden: (https://learnpython.com/blog/python-requirements-file/) \ No newline at end of file + ``` + pip upgrade -r requirements.txt + ``` + Of een specifieke package door middel van het commando: + ``` + pip install -U packagename + ``` +8. Meer tips en trucks kun je hier vinden: (https://learnpython.com/blog/python-requirements-file/) \ No newline at end of file diff --git a/syllabus/Debuggen.md b/syllabus/Debuggen.md index dfa1f44..2bf7ba5 100644 --- a/syllabus/Debuggen.md +++ b/syllabus/Debuggen.md @@ -25,13 +25,17 @@ In dit voorbeeld gebruiken we `print`-statements om te zien wat de waarden van ` Hoewel `print`-statements nuttig zijn, kunnen ze je programma ook rommelig maken en zijn ze niet altijd de beste manier om complexe problemen op te lossen. Wanneer je de bug gevonden hebt, kan het veel werk zijn om de `print`-statements weer te verwijderen. Om het nog ingewikkelder te maken, is de waarschijnlijkheid dat je met het verwijderen van deze statements weer nieuwe bugs introduceert hoger dan je lief is. Gelukkig is er een meer geavanceerdere vorm van debuggen. Het gebruik van Breakpoints en Stepping. -## Breakpoints in PyCharm +## Breakpoints in Visual Studio Code -PyCharm is dus niet alleen handig om al je Python-files bij elkaar te houden, maar ook erg geschikt om te debuggen. Sterker nog, een van de belangrijkste functies van PyCharm is de ingebouwde debugger. Hiermee kun je breakpoints instellen en door je code stappen om te zien wat er gebeurt. Wat breakpoints zijn en hoe je hiermee om gaat, lees je hieronder. +Visual Studio Code is niet alleen geschikt om al je Python-bestanden overzichtelijk te beheren, maar ook erg handig om te debuggen. Een van de belangrijkste functies is de ingebouwde debugger. Hiermee kun je breakpoints instellen en door je code stappen om te zien wat er gebeurt. Wat breakpoints zijn en hoe je hiermee omgaat, lees je hieronder. ### Breakpoints instellen -Een breakpoint is een marker die je op een regel code plaatst waar je wilt dat je programma stopt met uitvoeren. Zeg maar een rood stoplicht. Dit geeft je de mogelijkheid om de status van je programma op dat punt te inspecteren. Om een breakpoint in PyCharm in te stellen, klik je eenvoudigweg in de linkermarge naast de regel waar je wilt stoppen. +Een breakpoint is een marker die je op een regel code plaatst waar je wilt dat je programma stopt met uitvoeren. Zie het als een rood stoplicht: op dat punt pauzeert je code en kun je precies inspecteren hoe de variabelen en functies zich gedragen. + +Om een breakpoint in Visual Studio Code in te stellen: + 1. **Open** het bestand waarin je de code wilt debuggen. + 2. Klik in de linkermarge naast de regel waar je wilt stoppen. Er verschijnt dan een rode stip, wat aangeeft dat je daar een breakpoint hebt gezet. ```python def vermenigvuldig_getallen(a, b): @@ -42,19 +46,25 @@ product = vermenigvuldig_getallen(6, 7) print(f"Hoofdprogramma: product = {product}") ``` -Stel dat we een breakpoint willen instellen op de regel `resultaat = a * b`. Klik in de linkermarge naast deze regel. Wanneer je nu je programma uitvoert in de debug-modus, zal het stoppen bij dit breakpoint. +Stel dat je een breakpoint wilt instellen op de regel `resultaat = a * b`. Klik in de linkermarge naast deze regel. Als je nu je programma uitvoert in de debug-modus van Visual Studio Code, zal het uitvoeren stoppen bij dit breakpoint. -### Stepping +### Debug-modus starten -Wanneer je programma stopt bij een breakpoint, kun je gebruik maken van stepping om je code regel voor regel uit te voeren. Dit helpt je te begrijpen hoe je programma werkt en waar het eventueel misgaat. +Om te debuggen in Visual Studio Code: +1. Ga naar de **Run and Debug**-sidebar (links in de editor, het play-icoontje met een kevertje). +2. Klik op de **Play**-knop (*Start Debugging*) of kies de juiste configuratie als je meerdere debug-instellingen hebt. +3. Je programma start, en zodra het breakpoint wordt bereikt, pauzeert de uitvoer automatisch. + +### Stepping -- **Step Over (F8)**: Voert de huidige regel uit en gaat naar de volgende regel in dezelfde functie. -- **Step Into (F7)**: Gaat de functie binnen als de huidige regel een functieaanroep is. -- **Step Out (Shift+F8)**: Voert de rest van de huidige functie uit en gaat terug naar de aanroepende functie. +Wanneer je programma stopt bij een breakpoint, kun je gebruik maken van stepping om je code regel voor regel uit te voeren. Zo kun je precies zien welke stappen je code doorloopt en waar het eventueel misgaat. +- Step Over: Voert de huidige regel uit en gaat vervolgens naar de volgende regel in dezelfde functie. (*F10 op Windows/Linux, Fn+F10 op macOS*) +- Step Into: Gaat de functie binnen als de huidige regel een functieaanroep is. Zo kun je de binnenkant van een functie stap voor stap volgen. (*F11 op Windows/Linux, Fn+F11 op macOS*) +- Step Out: Voert de resterende regels van de huidige functie in één keer uit en springt terug naar de regel waar de functie werd aangeroepen. (*Shift+F11 op Windows/Linux, Shift+Fn+F11 op macOS*) -Je ziet in het *Variables*-deel welke variabelen welke waarde hebben op dat moment van uitvoer. Dit zorgt ervoor dat je heel gedetailleerd kan nagaan hoe je code werkt. En dit helpt je weer met het opsporen en oplossen van bugs. +In het **Variables**-venster (rechts of links in beeld, afhankelijk van je layout) kun je zien welke variabelen op dat moment in je code aanwezig zijn en welke waarden ze hebben. Dit is onmisbaar bij het opsporen en oplossen van bugs. -In de volgende video zie je hoe de code van `vermenigvuldig_getallen` zich gedraagt in de debugger van PyCharm. #TODO +Meer weten? Voor meer informatie over debugging in Visual Studio Code en alle beschikbare opties (zoals conditional breakpoints en exception breakpoints), bekijk de [officiële documentatie van Visual Studio Code](https://code.visualstudio.com/docs/editor/debugging). ## Analyse van het gedrag van je programma diff --git a/syllabus/Lesplanning.md b/syllabus/Lesplanning.md index 69a6f32..fff8aaf 100644 --- a/syllabus/Lesplanning.md +++ b/syllabus/Lesplanning.md @@ -24,17 +24,17 @@ In de eerste week van deze module starten we samen met een korte kennismaking en - De syllabus tot hier - Hoe ziet de module eruit? - Hoe breng je deze module tot een goed einde? -- Installeren Python en PyCharm +- Installeren Python en Visual Studio Code - Je eerste Git-repository aanmaken -- Je Git-repo koppelen aan PyCharm +- Je Git-repo koppelen aan Visual Studio Code - En je bent klaar om code te schrijven en publiceren! ### Aan het einde van de les -- Heb je Python en PyCharm geïnstalleerd op je laptop +- Heb je Python en Visual Studio Code geïnstalleerd op je laptop - Heb je een GitHub-account - Heb je een Git-repo gemaakt en deze doorgegeven aan de docent -- Heb je je Git-repo gekoppeld aan PyCharm +- Heb je je Git-repo gekoppeld aan Visual Studio Code ### Huiswerk @@ -58,7 +58,7 @@ Maak de opdracht aan het einde van het hoofdstuk {ref}`hoofdstuk_inspiratie`. Zo ### Na de les -- Weet je hoe je Python-code volgens de PEP8 guidelines moet schrijven en hoe je dit in PyCharm doet. +- Weet je hoe je Python-code volgens de PEP8 guidelines moet schrijven en hoe je dit in Visual Studio Code doet. - Weet je hoe leesbare code eruit ziet. - Heb je een start gemaakt met je project.