Skip to content

Commit 00ac056

Browse files
pietervanengelenpietervanengelen
committed
refactor syllabus naar vsc.
Todo: bijlage github_pycharm
1 parent 8557490 commit 00ac056

8 files changed

Lines changed: 274 additions & 52 deletions

‎syllabus/Bijlage_Github_en_Pycharm.md‎

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,7 @@
1-
# Bijlage: GitHub en PyCharm
1+
# ~~Bijlage: GitHub en PyCharm~~
2+
3+
**DEZE MOET NOG UITGEWERKT WORDEN
4+
**
25

36
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.
47

‎syllabus/Bijlage_Installeren old.md‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# Bijlage: Python en PyCharm installeren
2+
3+
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).
4+
5+
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.
6+
7+
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.
8+
9+
Als het goed is, heb je nu Python en PyCharm geïnstalleerd en kun je aan de slag voor deze module.
10+
11+
Verdere informatie kan je hier vinden:
12+
<https://www.jetbrains.com/help/pycharm/quick-start-guide.html>
13+
14+
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.

‎syllabus/Bijlage_Installeren.md‎

Lines changed: 135 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,141 @@
1-
# Bijlage: Python en PyCharm installeren
1+
# Bijlage: Python en Visual Studio Code installeren
22

3-
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).
3+
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.
44

5-
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.
5+
---
66

7-
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.
7+
## Python installeren
88

9-
Als het goed is, heb je nu Python en PyCharm geïnstalleerd en kun je aan de slag voor deze module.
9+
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.
1010

11-
Verdere informatie kan je hier vinden:
12-
<https://www.jetbrains.com/help/pycharm/quick-start-guide.html>
11+
### Windows
1312

14-
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.
13+
1. **Download de installer**
14+
Ga naar de [officiële Python-website](https://www.python.org/downloads/) en download de nieuwste stabiele release van Python 3 voor Windows.
15+
16+
2. **Voer de installer uit**
17+
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.
18+
19+
3. **Controleer de installatie**
20+
Open een opdrachtprompt (cmd) of PowerShell en typ:
21+
```bash
22+
python --version
23+
```
24+
Je zou nu een versienummer moeten zien, bijvoorbeeld Python 3.10.9.
25+
26+
### macOS
27+
1. **Controleer of Python 3 al aanwezig is**
28+
29+
Open de *Terminal*-app en typ:
30+
31+
```bash
32+
python3 --version
33+
```
34+
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.
35+
36+
2. **Download en installeer Python 3**
37+
38+
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.
39+
3. **Controleer de installatie**
40+
41+
Open de Terminal opnieuw en typ:
42+
43+
```bash
44+
python3 --version
45+
```
46+
47+
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.
48+
49+
### Linux (optioneel)
50+
Als je op Linux werkt, heb je vaak al een recente Python-versie in je distributie. Je kunt dit controleren met:
51+
```bash
52+
python3 --version
53+
```
54+
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.
55+
56+
## Visual Studio Code installeren
57+
### Downloaden en installeren
58+
1. **Download Visual Studio Code**
59+
60+
Ga naar de [officiële Visual Studio Code-website](https://code.visualstudio.com/) en download de installer voor jouw besturingssysteem (Windows, macOS of Linux).
61+
2. **Volg de installatiestappen**
62+
63+
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.
64+
65+
### Visual Studio Code starten
66+
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).
67+
68+
## Visual Studio Code configureren voor Python
69+
Voor het schrijven en debuggen van Python-code in Visual Studio Code raden we aan om de **officiële Python-extensie** te installeren.
70+
1. **Open de extensies**.
71+
72+
Klik aan de linkerzijde in Visual Studio Code op het icoon van de **Extensions**-sidebar (de vier blokken).
73+
2. **Zoek naar 'Python'**
74+
75+
Voer in de zoekbalk `Python` in.
76+
3. **Installeer de Python-extensie**
77+
78+
Kies de extensie van **Microsoft** en klik op *Install*.
79+
80+
4. **Eventueel: linting en formatting**
81+
82+
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.
83+
84+
### Python-interpreter selecteren
85+
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.
86+
87+
1. **Command Palette openen**
88+
89+
Druk op `Ctrl + Shift + P` (Windows/Linux) of `Cmd + Shift + P` (macOS).
90+
91+
2. **Kies de interpreter**
92+
93+
Typ in de Command Palette Python: `Select Interpreter` en kies de gewenste Python-versie.
94+
95+
### PEP8 Style Checking met PyLint
96+
97+
Om je code te laten voldoen aan de PEP8-standaarden (leesbare en consistente Python-code), kun je een linter als **PyLint** installeren:
98+
1. **Installeer de PyLint-extensie**
99+
- Ga naar het **Extensions**-icoon in Visual Studio Code.
100+
- Zoek op *PyLint* en installeer de extensie (meestal ook van Microsoft).
101+
2. **PyLint configureren**
102+
- Open een `.py`-bestand in je project.
103+
- Visual Studio Code detecteert nu automatisch dat je PyLint hebt. Je krijgt eventuele opmerkingen over je code direct in de editor te zien.
104+
3. **Lint-fouten bekijken**
105+
- Als er PEP8-waarschuwingen of -fouten zijn, verschijnen deze in het **Problems**-paneel (meestal onderin het scherm).
106+
- Je kunt dubbelklikken op een waarschuwing om naar de betreffende regel in je code te springen.
107+
4. **Automatisch formatteren (optioneel)**
108+
- Voeg extensies als **Black** of **autopep8** toe om je code automatisch op te schonen.
109+
- Na installatie kun je in de Command Palette (`Ctrl+Shift+P` of `Cmd+Shift+P`) zoeken op Format Document.
110+
111+
Door PyLint te gebruiken, blijft je code consistent en overzichtelijk, wat vooral bij grotere projecten van onschatbare waarde is.
112+
113+
## Testen of alles werkt
114+
115+
Om te controleren of alles naar behoren is ingesteld:
116+
1. Maak in Visual Studio Code een nieuw bestand aan, bijvoorbeeld `hallo.py`.
117+
2. Voeg de volgende code toe:
118+
```python
119+
print("Hallo, Python!")
120+
```
121+
3. Sla het bestand op (bij voorkeur in een nieuwe map, zoals `C:\mijnproject` op Windows of in je Thuismap).
122+
4. Druk op F5 om te debuggen of gebruik de knop **Run and Debug** (links in Visual Studio Code).
123+
5. Als alles goed gaat, zie je in het Debug Console-venster `Hallo, Python!` verschijnen.
124+
125+
Is dit gelukt, dan ben je klaar om aan de slag te gaan met de rest van het lesmateriaal!
126+
127+
## Veelvoorkomende problemen en oplossingen
128+
- **Python niet gevonden**
129+
130+
Controleer of je Python correct aan je PATH hebt toegevoegd tijdens de installatie of doe dit handmatig in je systeeminstellingen.
131+
- **Oude Python-versie**
132+
133+
Verwijder (of update) oude versies, en zorg dat je in VS Code de juiste interpreter selecteert.
134+
- **Geen uitvoer**
135+
136+
Check of je het juiste bestand hebt opgeslagen en of je in de juiste directory werkt.
137+
- **Linting werkt niet**
138+
139+
Controleer of je de juiste extensie hebt geïnstalleerd en dat in je statusbalk (rechtsonder) de juiste Python-interpreter staat geselecteerd.
140+
141+
**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!

‎syllabus/Bijlage_nieuwproject old.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# Bijlage: Nieuw project in PyCharm
2+
3+
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*.
4+
5+
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.

‎syllabus/Bijlage_nieuwproject.md‎

Lines changed: 66 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,68 @@
1-
# Bijlage: Nieuw project in PyCharm
1+
# Bijlage: Nieuw project in Visual Studio Code
22

3-
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*.
3+
In deze bijlage zie je hoe je snel en eenvoudig een nieuw Python-project opzet in Visual Studio Code.
44

5-
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.
5+
---
6+
7+
## Een nieuwe map maken
8+
9+
1. **Kies een locatie**
10+
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.
11+
12+
2. **Open de map in Visual Studio Code**
13+
- Start Visual Studio Code.
14+
- Klik op *File* > *Open Folder…* (Windows/Linux) of *File* > *Open…* (macOS).
15+
- Navigeer naar de map die je net hebt gemaakt en open deze.
16+
17+
Je hebt nu de basis van je project klaargezet in Visual Studio Code.
18+
19+
---
20+
21+
## Interpreter instellen (optioneel)
22+
23+
1. **Interpreter selecteren**
24+
Rechts onderin de statusbalk van Visual Studio Code kun je de actieve Python-versie zien. Staat er geen Python-versie?
25+
- Druk op <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> (Windows/Linux) of <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> (macOS).
26+
- Typ `Python: Select Interpreter` en kies de Python 3.x-versie die je wilt gebruiken.
27+
28+
2. **Interpreter ontbreekt?**
29+
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.
30+
31+
---
32+
33+
## Eerste Python-bestand maken
34+
35+
1. **Nieuw bestand**
36+
Klik in de *Explorer*-sidebar (het eerste icoontje links in beeld) met de rechtermuisknop op je projectmap. Kies *New File*.
37+
38+
2. **Bestandsnaam**
39+
Noem het bestand bijvoorbeeld `main.py` of `hallo.py`.
40+
41+
3. **Code invoeren**
42+
Open het nieuwe bestand en voeg de volgende regel code toe:
43+
```python
44+
print("hi")
45+
```
46+
47+
4. **Bestand opslaan**
48+
Druk op <kbd>Ctrl</kbd> + <kbd>S</kbd> (Windows/Linux) of <kbd>Cmd</kbd> + <kbd>S</kbd> (macOS) om het bestand op te slaan.
49+
50+
## Code uitvoeren
51+
1. **Run and Debug**
52+
53+
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).
54+
55+
2. **Run-bestemming kiezen**
56+
57+
Visual Studio Code kan je vragen om een launch configuration aan te maken. Hiermee wordt je huidige Python-bestand uitgevoerd.
58+
59+
3. **Resultaten bekijken**
60+
61+
Zodra je het script uitvoert, verschijnt er een *Debug Console* of *Terminal*-paneel onder in beeld. Hier zou `hi` moeten verschijnen.
62+
63+
64+
Tip: Je kunt ook met <kbd>F5</kbd> (of <kbd>Fn</kbd> + <kbd>F5</kbd> op macOS) het huidige bestand starten, mits je een Python-debugconfiguratie hebt ingesteld.
65+
66+
## Projectstructuur bijhouden
67+
68+
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.

‎syllabus/Bijlage_requirements.md‎

Lines changed: 24 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -3,36 +3,36 @@
33
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.
44

55
1. Maak een bestand ‘requirements.txt’ en plaats het bij je andere .py bestanden;
6-
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:
6+
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:
77

8-
```
9-
pip freeze > .\requirements.txt
10-
```
8+
```
9+
pip freeze > .\requirements.txt
10+
```
1111
12-
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*.
12+
1313
3. Als je een nieuwe package nodig hebt, kun je ze op de volgende manier toevoegen `<packagename>==version`, bijvoorbeeld:
1414
15-
`Tensorflow==2.11.0`
15+
`Tensorflow==2.11.0`
1616
17-
5. Om de packages vervolgens te installeren open je de terminal en voer je het volgende commando uit:
17+
4. Om de packages vervolgens te installeren open je de terminal en voer je het volgende commando uit:
1818
19-
```
20-
pip install -r .\requirements.txt
21-
```
22-
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.
19+
```
20+
pip install -r .\requirements.txt
21+
```
22+
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.
2323
24-
7. Je kunt kijken of alle packages up to date zijn door middel van het commando:
24+
6. Je kunt kijken of alle packages up to date zijn door middel van het commando:
2525
26-
```
27-
pip list --outdated
28-
```
29-
8. Je kunt alle packages updaten door middel van het commando:
26+
```
27+
pip list --outdated
28+
```
29+
7. Je kunt alle packages updaten door middel van het commando:
3030
31-
```
32-
pip upgrade -r requirements.txt
33-
```
34-
Of een specifieke package door middel van het commando:
35-
```
36-
pip install -U packagename
37-
```
38-
9. Meer tips en trucks kun je hier vinden: (https://learnpython.com/blog/python-requirements-file/)
31+
```
32+
pip upgrade -r requirements.txt
33+
```
34+
Of een specifieke package door middel van het commando:
35+
```
36+
pip install -U packagename
37+
```
38+
8. Meer tips en trucks kun je hier vinden: (https://learnpython.com/blog/python-requirements-file/)

0 commit comments

Comments
 (0)