Oefening: Een ontwikkelomgeving instellen
Om aan de slag te gaan met het schrijven van onze Flask-toepassing met Python, moeten we onze ontwikkelomgeving instellen. Hiervoor moet een aantal items worden geïnstalleerd. Gelukkig gebruiken we relatief algemene hulpprogramma's, zodat u deze ook na deze module goed kunt gebruiken. Mogelijk hebt u deze zelfs al geïnstalleerd. We gebruiken deze hulpprogramma's om uw toepassing lokaal te ontwikkelen en te testen.
In deze eenheid leert u hoe u Python-hulpprogramma's installeert en een virtuele Python-omgeving maakt. U gaat ook Flask installeren, het framework dat wordt gebruikt voor het maken van de website.
Belangrijk
In deze module installeert en configureert u een aantal softwarepakketten en maakt u een virtuele Python-omgeving. Wanneer de virtuele omgeving is geactiveerd in uw opdrachtpromptvenster of in uw terminal, moet u het venster of de terminal geopend houden. Als u het venster of de terminal sluit, moet u de dezelfde virtuele Python-omgeving opnieuw opstarten in het nieuwe venster of in de terminal. Het is belangrijk dat u al uw werkzaamheden uitvoert in dezelfde virtuele Python-omgeving die u aan het begin van deze module maakt.
Op een hoog niveau voert u de volgende stappen uit:
- Visual Studio Code installeren (als dat nog niet is geïnstalleerd)
- Python installeren (als dat nog niet is geïnstalleerd)
- Een map maken voor uw code
- Een virtuele omgeving maken
- Flask en andere bibliotheken installeren
Visual Studio Code installeren
Visual Studio Code is een opensource-code-editor waarmee u vrijwel elk gewenst type toepassing kunt maken. Ter ondersteuning is er een robuuste marketplace met uitbreidingen waar u invoegtoepassingen kunt vinden die uw werk als ontwikkelaar vereenvoudigen.
Python installeren
Voor het voltooien van deze eenheid moet Python 3.6 of hoger op uw computer zijn geïnstalleerd. Er is een kans dat u Python al hebt geïnstalleerd, met name als u Python eerder hebt gebruikt. U kunt controleren of het is geïnstalleerd door een van de volgende opdrachten uit te voeren:
python --version
Als Python is geïnstalleerd, wordt het Python-versienummer weergegeven in de uitvoer. Als u Python wilt installeren, volgt u de stappen in de documentatie voor een Python-interpreter installeren voor Visual Studio Code. U moet ook de Python-extensie van Visual Studio Code installeren.
Belangrijk
Als u Windows gebruikt, moet u ervoor zorgen dat de maplocatie waar u Python hebt geïnstalleerd, wordt toegevoegd aan de omgevingsvariabele PATH. Als u deze stap overslaat, ontvangt u de foutbericht 'Python is niet gevonden', zelfs na het uitvoeren van de installatie. U kunt dit oplossen door deze stappen uit te voeren om Python toe te voegen aan de omgevingsvariabele PATH:
- Zoek de map met uw python.exe-bestand. U kunt python typen in de opdrachtpromptterminal om het python.exe-bestand te vinden
- Kopieer de padwaarde 'C:\<python path>', u voegt deze toe aan de padvariabele in stap 6
- Klik op de Startmenu en typ De omgevingsvariabelen van het systeem bewerken, waarmee een systeem-venster Eigenschappen wordt geopend.
- Klik op het tabblad Geavanceerd op de knop Omgevingsvariabelen .
- Dubbelklik onder de gebruikersvariabelen op de variabele Path, die een venster met een lijst met paden weergeeft
- Klik op Nieuw en plak het gekopieerde pad.
- Nadat u het bestand hebt ingevoegd, klikt u op OK en moet Python nu bereikbaar zijn vanaf elke locatie op uw computer
Notitie
Als u wilt controleren of de padconfiguratie is geslaagd, opent u een nieuwe opdrachtpromptterminal en typt u Python om de python-versiegegevens te bekijken. Als u nog steeds geen Python-opdracht kunt uitvoeren, start u de computer opnieuw op om de wijzigingen door te voeren.
De projectmap maken
Maak een map op een door u gekozen locatie. Deze map is uw projectmap en bevat alle code die u maakt. U kunt een map maken vanuit een opdracht- of terminalvenster met een van de volgende opdrachten:
# Windows, macOS or Linux
mkdir contoso
cd contoso
Belangrijk
Houd uw opdracht- of terminalvenster gedurende deze hele module open.
Een virtuele Python-omgeving maken
Een virtuele Python-omgeving is niet per se zo ingewikkeld als het klinkt. In plaats van een virtuele machine of container te maken, is een virtuele omgeving een map die alle bibliotheken bevat die we nodig hebben om de toepassing uit te voeren, met inbegrip van de Python-runtime zelf. Door gebruik te maken van een virtuele omgeving zijn onze toepassingen modulair toepasbaar, zodat deze onafhankelijk van elkaar functioneren en versieproblemen worden vermeden. Als best practice moet u altijd virtuele omgevingen gebruiken wanneer u werkt met Python.
Om een virtuele omgeving te kunnen gebruiken, gaan we deze maken en activeren. We maken deze met behulp van de module venv, die u eerder hebt geïnstalleerd tijdens het uitvoeren van de installatie-instructies voor Python. Wanneer we de omgeving activeren, geven we de map op die we voor Python hebben gemaakt, zodat het systeem 'weet' welke map moet worden gebruikt.
# Windows, macOS or Linux
# Create the environment
python -m venv venv
Het proces voor het maken van een virtuele omgeving kan enkele seconden duren. Wacht tot de terminalprompt opnieuw wordt weergegeven voordat u de omgeving activeert.
# Windows
# Activate the environment
./venv/scripts/activate
# macOS or Linux
# Activate the environment
source ./venv/bin/activate
Flask en andere bibliotheken installeren
Nu de virtuele omgeving is gemaakt en geactiveerd, kunnen we Flask installeren, de bibliotheek die we nodig hebben voor onze website. We installeren Flask volgens een algemene methode, namelijk door een requirements.txt-bestand te maken. Het bestand requirements.txt is op zichzelf niet bijzonder. Het is een tekstbestand met vermeldingen van de bibliotheken die voor de toepassing zijn vereist. Deze methode wordt doorgaans door ontwikkel aars gebruikt, en maakt het eenvoudiger om toepassingen te beheren waarbij talloze bibliotheken afhankelijkheden zijn.
Tijdens latere oefeningen gebruiken we een aantal andere bibliotheken, waaronder requests (om de Translator-service aan te roepen) en python-dotenv (om onze sleutels te beheren). Hoewel we deze nog niet nodig hebben, is het makkelijk voor straks om ze nu alvast te installeren.
Voer in het opdracht- of terminalvenster de volgende opdracht uit om de map te openen in Visual Studio Code:
code .Selecteer in Visual Studio Code in het verkenner-venster Nieuw bestand naast de contoso-map
Geef het bestand een naam requirements.txt en voeg de volgende tekst toe:
flask python-dotenv requestsSla het bestand op door te klikken op Ctrl+S of Cmd+S op een Mac
Ga terug naar het opdracht- of terminalvenster en voer de installatie uit met behulp van pip door de volgende opdracht uit te voeren:
pip install -r requirements.txt
Met deze opdracht worden de benodigde bibliotheken en de bijbehorende afhankelijkheden gedownload.
Notitie
Mogelijk wordt er een foutbericht weergegeven als uw versie van pip niet de meest recente is. Volg de instructies in het foutbericht om de upgrade uit te voeren. De upgrade is niet vereist voor deze module.
Gefeliciteerd. Uw ontwikkelomgeving is nu geïnstalleerd.