Gyakorlat: Fejlesztőkörnyezet beállítása
Mielőtt hozzálátna, hogy a Pythonnal megírja a Flask-alkalmazást, be kell állítania a fejlesztési környezetet, ehhez pedig több mindent is telepítenie kell. Az itt használandó eszközök szerencsére viszonylag gyakran használhatók, és a modul elvégzése után is jó szolgálatot tehetnek. Talán már telepítve is vannak Önnél! Ezeket az eszközöket az alkalmazás helyi fejlesztéséhez és teszteléséhez fogja használni.
Ebben a leckében a Python-eszközkészlet telepítését és egy virtuális Python-környezet kialakítását sajátíthatja el. Telepíteni fogja a webhely létrehozásához használandó Flask keretrendszert.
Fontos
Ebben a modulban különböző szoftvercsomagokat kell telepítenie és konfigurálnia, és egy virtuális Python-környezetet kell létrehoznia. Miután aktiválta a virtuális környezetet a parancssori ablakban vagy a terminálon, tartsa nyitva az ablakot vagy a terminált. Ha bezárta az ablakot vagy a terminált, mindenképpen ugyanazt a virtuális Python-környezetet indítsa újra az új ablakban vagy terminálon. Fontos, hogy az összes munkát ugyanabban a modul elején létrehozott virtuális Python-környezetben végezze el.
Elsősorban az alábbi lépéseket fogja végrehajtani:
- A Visual Studio Code telepítése (ha még nincs telepítve)
- A Python telepítése (ha még nincs telepítve)
- Könyvtár létrehozása a kód számára
- Virtuális környezet létrehozása
- A Flask és más kódtárak telepítése
A Visual Studio Code telepítése
A Visual Studio Code nyílt forráskódú kódszerkesztő, amellyel szinte bármilyen típusú alkalmazást létrehozhat. Hátterében a bővítmények kiterjedt piaca áll, ahol a fejlesztők életét megkönnyítő kiegészítőket találhat.
Telepítse a Pythont
A lecke elvégzéséhez a számítógépén telepítve kell lennie a Python 3.6 vagy újabb verziójának. Lehetséges, hogy már telepítette a Pythont, főleg ha már használta is. Azt, hogy telepítve van-e, az alábbi parancsok egyikével ellenőrizheti:
python --version
Ha a Python telepítve van, a parancs kimenete a verziószámot adja meg. Ha telepítenie kell a Pythont, kövesse a Visual Studio Code Python-értelmező dokumentációjának lépéseit. A Visual Studio Code Python-bővítményt is telepítenie kell.
Fontos
Windows használata esetén győződjön meg arról, hogy a Python telepítésének helye hozzá lesz adva a PATH környezeti változóhoz. Ha ezt a lépést kihagyja, akkor a telepítés után is a „Python nem található“ hibaüzenetet fogja kapni. A probléma megoldásához kövesse az alábbi lépéseket a Python PATH környezeti változóhoz való hozzáadásához:
- Keresse meg a könyvtárat a python.exe fájllal. Beírhatja a pythont , ahol a parancssori terminálban megkeresheti a python.exe fájlt
- Másolja ki a "C:\<python path" elérési út> értékét, majd a 6. lépésben adja hozzá az Elérési út változóhoz
- Kattintson a Start menüre, és írja be a Rendszerkörnyezet változóinak szerkesztése parancsot, amely megnyitja a Rendszer Tulajdonságok ablak.
- A Speciális lapon kattintson a Környezeti változók gombra.
- A felhasználói változók alatt kattintson duplán az Elérési út nevű változóra, amely előugrik az elérési utak listájával rendelkező ablakra
- Kattintson az Új gombra, és illessze be a másolt elérési utat.
- A beszúrás után kattintson az OK gombra , és a Pythonnak mostantól elérhetőnek kell lennie a számítógép bármely helyről
Feljegyzés
Az elérési út konfigurációjának sikerességének ellenőrzéséhez nyisson meg egy új parancssori terminált, és írja be a Pythont a Python verzióinformációinak megtekintéséhez. Ha továbbra sem tud python-parancsot futtatni, indítsa újra a számítógépet a módosítások végrehajtásához.
A projektkönyvtár létrehozása
Hozzon létre egy könyvtárat egy tetszőleges helyen. Ez lesz az a projektkönyvtár, amely az összes létrehozott kódot tartalmazza. Könyvtárat az alábbi parancsok egyikével hozhat létre parancssori vagy terminálablakból:
# Windows, macOS or Linux
mkdir contoso
cd contoso
Fontos
A parancssort vagy terminálablakot hagyja megnyitva a modul végéig.
Virtuális Python-környezet létrehozása
A virtuális Python-környezet nem feltétlenül olyan bonyolult, amilyennek hangzik. Nem virtuális gép vagy tároló létrehozásáról van szó. A virtuális környezet egy könyvtár, amely az alkalmazás futtatásához szükséges összes kódtárat tartalmazza, beleértve magát a Python-futtatókörnyezetet is. Virtuális környezet használatával az alkalmazások modulárissá tehetők és elkülöníthetők egymástól, így elkerülhetők a verziókezelési problémák. Ha a Pythonnal dolgozik, mindig ajánlott virtuális környezeteket használni.
A használandó virtuális környezetet létre kell hoznia, majd aktiválnia kell. A létrehozásához itt a venv
modult használja, amelyet a Python telepítési utasításait követve korábban telepített. Az aktiválásával arra utasítja a rendszert, hogy az Ön által létrehozott könyvtárat használja mindenhez, ami a Pythonnal kapcsolatos.
# Windows, macOS or Linux
# Create the environment
python -m venv venv
A virtuális környezet létrehozásának folyamata eltarthat néhány másodpercig. A környezet aktiválása előtt várja meg, amíg a terminálüzenet ismét megjelenik.
# Windows
# Activate the environment
./venv/scripts/activate
# macOS or Linux
# Activate the environment
source ./venv/bin/activate
A Flask és más kódtárak telepítése
A virtuális környezet létrehozása és aktiválása után már telepítheti a webhelyhez szükséges Flask kódtárat. A Flask telepítését egy elterjedt konvenció követésével, egy requirements.txt fájl létrehozásával hajthatja végre. A requirements.txt fájl önmagában nem különleges, csupán egy szövegfájl, amelyben az alkalmazáshoz szükséges kódtárak vannak felsorolva. A fejlesztők általában mégis betartják ezt a konvenciót, mert megkönnyíti az olyan alkalmazások kezelését, amelyeknek sok kódtárfüggősége van.
A későbbi gyakorlatokban néhány további kódtárat is használni fog, köztük a Translator szolgáltatás hívására szolgáló requests, és a kulcsokat kezelő python-dotenv kódtárat. Bár ezekre egyelőre nincs szükség, valamivel egyszerűbb dolga lesz, ha most telepíti őket.
A parancssori vagy terminálablakban adja ki az alábbi parancsot, amellyel megnyitja a könyvtárat a Visual Studio Code-ban:
code .
A Visual Studio Code Explorer ablakában válassza az Új fájl lehetőséget a contoso könyvtár mellett
Nevezze el a fájlt requirements.txt, és adja hozzá a következő szöveget:
flask python-dotenv requests
Mentse a fájlt a Ctrl-S, illetve Mac gépen a Cmd-S billentyűkombinációval
Lépjen vissza a parancssori vagy terminálablakba, és hajtsa végre a telepítést pip használatával futtatott alábbi paranccsal:
pip install -r requirements.txt
A parancs letölti a szükséges kódtárakat és azok függőségeit.
Feljegyzés
Hibaüzenetet kaphat, ha a pip verziója nem a legfrissebb. A frissítéséhez hajtsa végre a hibaüzenetben található utasításokat. Ez a frissítés ehhez a modulhoz nem szükséges.
Gratulálunk! Beállította a fejlesztési környezetet!