Ez a bevezető Python Flask bemutató elmagyarázza, mi az a Flask, a Python telepítése, Virtualenv, Flask Hello World példa egy kódpéldákkal, hibakereséssel és teszteléssel foglalkozó résszel:
A honlapkészítés inkább művészet, mint készség. Türelmet és szorgalmat igényel, valamint kitartást, bátorságot és elhivatottságot, hogy megteremtse azt, ami ahhoz szükséges, hogy valóban sikeres legyen. Manapság elengedhetetlen, hogy a tanulók minél hamarabb felgyorsuljanak.
Ezt a Python Flask oktatóanyagot azért hoztuk létre, hogy a diákok felgyorsuljanak és egyszerű, valamint összetett webes programozást hajtsanak végre a Python 3 segítségével.
Ez a Python Flask bemutató inkább egy flask kezdő bemutató, amely a Python, a Virtualenv és más alapvető csomagok telepítésével foglalkozik. Ebben az oktatósorozatban a Flask telepítését is elvégezzük a többi szükséges Flask pluginnel együtt. A Git Actions segítségével a kód hibakeresésről, tesztelésről és folyamatos integrációról is írtunk egy részt.
A Flask sorozatban található oktatóanyagok listája
Tutorial #1: Python Flask Tutorial - Bevezetés a Flaskba kezdőknek
2. bemutató: Flask sablon, űrlap, nézet és átirányítás példákkal
Tutorial #3: Flask adatbázis-kezelés - Hogyan használjuk a Flaskot egy adatbázissal?
Tutorial #4: Flask alkalmazás és Flask projekt elrendezése Blueprint &; Bootstrap
Oktatóprogram #5: Flask tervezési minták és legjobb gyakorlatok webes alkalmazásokhoz
Tutorial #6: Flask API bemutató példával
Tutorial #7: Django Vs Flask Vs Node: Melyik keretrendszert válasszuk ki?
Oktatóprogram #8: Top 31 népszerű Python Flask interjú kérdések válaszokkal
Mi a Flask
A Flask egy webfejlesztési keretrendszer. Ez egy keretrendszer beépített fejlesztői szerverrel és hibakeresővel.
A Flask keretrendszer önmagában különbözik a többi archetípustól, mivel lehetővé teszi a webfejlesztők számára, hogy rugalmasak legyenek, és kényelmesen alkalmazkodjanak a szoftverfejlesztő közösségben gyakran megjelenő változásokhoz.
Mire használják a Flask-t
A Flask keretrendszert használjuk webes alkalmazások fejlesztésére Python programozási nyelven. Más, harmadik féltől származó szolgáltatásokkal és API-kkal integrálódik, hogy gazdagságot és értelmet adjon a fejlesztés alatt álló alkalmazásnak. A Flask alapkoncepciói egyszerűek, és apró lábnyoma van.
Kezdjük ezzel a Python Flask bemutatóval, hogy megértsük a webfejlesztést egy Flask GitHub tároló segítségével. Mielőtt azonban folytatnánk, kérjük, klónozza a projektet a Githubról, hogy könnyen nyomon követhesse a tárgyalt kódpéldákat.
Előfeltételek
Az ebben a részben említett címszavakon kívül javasoljuk egy Github fiók létrehozását. Folytassuk az alábbiakban említett lépésekkel az előfeltételek között.
1. lépés: A Python telepítése
Ellenőrizze, hogy telepítette-e a Python 3-t. Ha nem, akkor töltse le innen a Python 3-t, és telepítse az operációs rendszernek megfelelően.
2. lépés: Python virtuális környezet létrehozása
Hozzon létre egy virtuális környezetet az alábbi parancs segítségével.
python3 -m venv venv venv
Az alábbi paranccsal aktiválhatja a Python virtuális környezetet.
forrás venv/bin/activate
Az alábbiakban példát adunk a virtuális környezet aktiválására és deaktiválására.
A bemutató minden további parancsának egy aktivált virtuális környezetben kell futnia. Telepítsük a wheel csomagot, hogy a virtuális környezeten belül tudjunk kerekeket építeni.
pip install wheel
3. lépés: Flask letöltése és behelyezése
El kell végeznünk a Flask letöltési lépéseket és telepítenünk kell a Flask-ot az alábbi lépések segítségével.
Most telepítse a Flaskot.
pip install flask
Néhányan közülünk szeretnek a legújabb forráskód változásokkal együtt dolgozni. Az alábbi parancsot használhatjuk a Flask forrásainak legújabb változtatásaival való telepítéshez.
Készítsen egy ideiglenes könyvtárat.
mkdir tmp
Most telepítse a Flask-ot a Github tárolóból. Az alábbi parancs működéséhez továbbra is csatlakoznia kell az internethez.
pip3 install -e [email protected]:pallets/flask.git#egg=flask
Nézzük meg a konzol kimeneteit, hogy ellenőrizzük a sikeres telepítést. Most ellenőrizzük, hogy el tudjuk-e érni a Flask parancsokat.
flask --help
Lehet, hogy néhány kivételt láthatsz a Flask alkalmazás hiányáról. Ezeket azonban hanyagold, mivel mi nem hoztunk létre Flask alkalmazást. A mi alkalmazásunk egy Flask példány, ami egy wrapper a Werkzeug webes keretrendszerre és a Jinja templating engine-re.
Werkzeug
A Werkzeug egy WSGI eszközkészlet. A WSGI csak egy hívó konvenció a webszerverek számára, hogy továbbítsa a webes kérések Python programozási nyelven írt webes alkalmazásokhoz.
Jinja
A sablonkészítés a webfejlesztők egyik alapvető készsége. A Jinja egy teljes körű és népszerű sablonkészítő motor Pythonhoz. Elég kifejező nyelv, és robusztus eszközkészletet biztosít a sablonkészítők számára.
4. lépés: MongoDB telepítése
Kövesse az alábbi lépéseket a MongoDB telepítéséhez. Mi a Debian alapú Linuxra való telepítés lépéseit vázoltuk fel. Ha más operációs rendszert használ, akkor lépjen be a linkre, és telepítse a kívánt operációs rendszernek megfelelően.
Telepítse a gnupg-ot a MongoDB nyilvános GPG kulcsának importálásához.
sudo apt-get install gnupg
Most importálja a kulcsot az alábbi paranccsal.
wget -qO - //www.mongodb.org/static/pgp/server-4.2.asc
Készítsd el a Linux disztribúciódnak megfelelő forrásjegyzék fájlt. Mi a Debian forrásjegyzékét adtuk hozzá.
echo "deb //repo.mongodb.org/apt/debian buster/mongodb-org/4.2 main"
Frissítés parancs futtatása
sudo apt-get update
Most telepítsük a MongoDB-t az alábbi paranccsal.
sudo apt-get install -y mongodb-org
Ha a telepítés sikeres, indítsa el a MongoDB-t az alábbi paranccsal.
sudo systemctl start mongod
Ellenőrizze a MongoDB állapotát az alábbi parancs segítségével.
sudo systemctl status mongod
Most az alább látható parancs kiadásával biztosítsuk, hogy a mongod automatikusan elinduljon a rendszer újraindításakor.
sudo systemctl enable mongod
Most ellenőrizze, hogy tud-e csatlakozni a MongoDB szerverhez a mongo kliens segítségével.
mongo
A mongo shellben próbálja meg a help és a show dbs parancsokat használni.
Flask alkalmazás létrehozása
A flask-appbuilder és a mongoengine telepítéséhez használd az alábbi parancsot.
pip install flask-appbuilder pip install mongoengine pip install flask_mongoengine pip install flask_mongoengine
Hozzon létre egy vázalkalmazást az alábbi kódrészletben megjegyzésként feltüntetett értékekkel.
flask fab create-app # Adja meg a következő értékeket a parancssori kérdőívben # Application Name: flaskTutorialApp # EngineType : MongoEngine
A kimenet az alábbiakhoz hasonló lesz.
Az új alkalmazás neve: exampleApp A motor típusa, SQLAlchemy vagy MongoEngine (SQLAlchemy, MongoEngine) [SQLAlchemy]: MongoEngine Letöltöttem a vázalkalmazást, jó kódolást!
Nézzük meg a projekt és az alkalmazás elrendezését. A fa parancs kimenetét az alábbiakban mutatjuk be.
Vessünk egy pillantást a Flask config fájlra. Ez egy alapértelmezett config, amely az előző parancs eredményeként generálódott. Vegyük ki a megjegyzést Cyborg téma, ahogy az alább látható.
# Témakonfiguráció a Cybord=g számára # ezek a témák a static/appbuilder/css/themes oldalon találhatók # létrehozhatjuk a sajátjainkat és könnyen használhatjuk őket, ha ugyanabba a dir struktúrába helyezzük őket, hogy felülírjuk őket #APP_THEME = "bootstrap-theme.css" # alapértelmezett bootstrap #APP_THEME = "cerulean.css" # cerulean #APP_THEME = "amelia.css" # amelia téma #APP_THEME = "cosmo.css" # cosmo téma APP_THEME = "cyborg.css" # cyborgtéma #APP_THEME = "flatly.css" # flatly téma
A vázalkalmazás futtatásához használja az alábbi parancsot a terminálon.
lombikfutás
Flask Hello World
A flaskTutorialApp első programjának létrehozásához nyissa meg a views.py fájlt az app könyvtárban, és adja hozzá a következő kódot. Keresse meg a fájlban megadott import utasításokat. Adja hozzá ezeket az utasításokat, ha még nincsenek.
from flask_appbuilder import BaseView, expose from app import appbuilder class HelloWorld(BaseView): """" Ez a bemutató első nézete """ route_base = "/hello" @expose("/") def hello(self): return "Hello, World! from Software Testing Help" # a fájl végén appbuilder.add_view_no_menu(HelloWorld())
A fenti forráskód hozzáadása után mentsük el a fájlt. Menjünk a projekt gyökérkönyvtárába, és az alábbi paranccsal futtassuk a Flask fejlesztői szerverét.
lombikfutás
Most navigáljon a //localhost:5000/hello/ címre, hogy megnézze a kimenetet a böngészőben.
Hibakeresés
Jelenleg a fejlesztői szerver nem fut hibakeresési módban. Hibakeresési mód nélkül nehéz megtalálni a hibákat a Flask alkalmazás forráskódjában.
A Flask debug üzemmódja a következőket eredményezi:
- A hibakeresési mód aktiválja az automatikus újratöltést. Ez azt jelenti, hogy nem kell újraindítanunk a fejlesztői kiszolgálót, miután változtatásokat végeztünk az alkalmazás forráskódjában.
- A hibakeresési mód aktiválja a Python hibakeresőt. A Kivétel során megvizsgálhatjuk a változók értékeit.
- A Debug mód lehetővé teszi a Flask alkalmazás hibakeresését. A hibakeresési munkamenetekben ellenőrizhetjük a különböző változók értékeit.
Állítsa le a fejlesztői kiszolgálót, ha az már fut. Ugyanezt megteheti a CTRL + C vagy a billentyűzet megszakításával.
A következő kóddal engedélyezheti a hibakeresési módot, és ideiglenesen futtathatja a fejlesztői kiszolgálót.
FLASK_ENV=development flask futás
Keresse meg a konzolon a Debugger PIN-kódot, és jegyezze fel.
Most változtassuk meg a fent leírt HelloWorld nézetet a kódrészlet következő soraival. Vegyük észre, hogy bevezettünk egy egyéni kivételt.
@expose("/") def hello(self): raise Exception("A custom exception to learn DEBUG Mode") return "Hello, World! from Software Testing Help"
Navigáljon a //localhost:5000/hello/ címre, és látni fogja, hogy az alkalmazás kivételt generált. A böngésző megjeleníti a stack trace-t, ahogy az alább látható.
![](/wp-content/uploads/guides/iae5sr2a76-3.png)
Továbbá nézzük meg a konzolt, ahol a fejlesztői szerver fut. Azt fogjuk látni, hogy ezúttal a views.py-ban történt változtatások automatikusan felismerésre kerülnek, és a debug szerver magától újraindul. Most már nem kell manuálisan újraindítanunk.
A konzolon az alábbiakban látható sorok jelennek meg. A Debug PIN kódot fel kell jegyeznünk a későbbiekhez.
* Változást észlelt a '/work/sth/flaskTutorialApp/app/views.py' állományban, újratöltés 2020-06-02 14:59:49,354:INFO:werkzeug: * Változást észlelt a '/work/sth/flaskTutorialApp/app/views.py' állományban, újratöltés * Újraindítás stat segítségével 2020-06-02 14:59:49,592:INFO:werkzeug: * Újraindítás stat segítségével * A hibakereső aktív! * A hibakereső PIN kódja: 150-849-897.
Most ellenőrizze a stack trace-t a böngészőben, és menjen az utolsó sorra. Kattintson rá a nézet kibontásához, és kattintson a CLI ikonra a shell interaktív módban történő megnyitásához.
![](/wp-content/uploads/guides/iae5sr2a76-4.png)
Miután megnyitotta, látni fogja, hogy a böngésző megjelenik a Debug PIN-kód kérése. Adja meg a Debug PIN-kódot, és kattintson az OK gombra.
![](/wp-content/uploads/guides/iae5sr2a76-5.png)
Ha a Debug PIN-kód megadása után továbblépünk, hozzáférhetünk az interaktív héjhoz.
A böngészőből elérjük a héjat, és megvizsgálhatjuk a változók értékeit, hogy megtaláljuk a kivétel okát, és jobban kezeljük a hibát. Nézze meg az alábbi képen látható egyik példát.
![](/wp-content/uploads/guides/iae5sr2a76-6.png)
Most változtassuk meg a kódot a view.py fájlban az alábbiak szerint. Figyeljük meg, hogy kommentáltuk azt a sort, amelyikben a felvetett Exception volt.
@expose("/") def hello(self): # raise Exception("A custom exception to learn DEBUG Mode") return "Hello, World! from Software Testing Help"
A Flask alkalmazás tesztelése
Most írjuk meg az első tesztünket a Flask alkalmazáshoz, amit fejlesztünk. Először is telepítsük a PyTest-et. A PyTest egy tesztelési keretrendszer. Segít nekünk jobb kódot írni.
Ráadásul éppen azáltal, hogy az alkalmazásaink fejlesztése közben is írhatunk egységteszteket, lehetőségünk van a TDD megközelítést követni. A TDD a Test-Driven Development (tesztvezérelt fejlesztés) rövidítése. A sorozat következő oktatóanyagaiban mindig először teszteket fogunk írni, majd a nézeteinket vagy modelljeinket fogjuk fejleszteni.
PyTest telepítése
pip install pytest
Most hozzunk létre egy tests nevű könyvtárat az app könyvtáron belül, és ebben hozzunk létre egy test_hello.py nevű fájlt. Írjuk meg az első egységtesztünket a nézetünk tesztelésére.
Másolja ki az alábbi kódrészletet, és illessze be a test_hello.py fájlba.
#!/usr/bin/env python from app import appbuilder import pytest @pytest.fixture def client(): """" A pytest fixture a tesztklienshez """ appbuilder.app.config["TESTING"] = True with appbuilder.app.test_client() as client: yield client def test_hello(client): """ A tesztmódszer a hello nézet tesztelésére """ resp = client.get("/hello", follow_redirects=True) assert 200 == resp.status_code
A tesztek futtatásához használjuk az alábbi pytest parancsot. A PyTest automatikusan összegyűjti a teszteket, és az eredményeket a standard kimeneten jeleníti meg.
![](/wp-content/uploads/guides/iae5sr2a76-7.png)
GitHub munkafolyamat létrehozása
A Git Actions-t használjuk a CI/CD munkafolyamat létrehozásához a mintaalkalmazásunkhoz. Kövesse az alábbi lépéseket a projektjéhez.
1. lépés: Navigáljon a GitHub tároló oldalára. Kattintson a Git Actions gombra.
![](/wp-content/uploads/guides/iae5sr2a76-8.png)
2. lépés: Görgessen lefelé az oldalon, és keressen egy Python csomaghoz tartozó, már létező munkafolyamat-sablont.
![](/wp-content/uploads/guides/iae5sr2a76-9.png)
3. lépés: A Python csomag beállítása Munkafolyamat.
![](/wp-content/uploads/guides/iae5sr2a76-10.png)
4. lépés: Miután megnyílt a python-package.yml munkafolyamat konfiguráció, frissítse azt a megadott yaml kiegészítő tag értékek alapján.
name: flaskTutorialApp jobs: build: runs-on: ubuntu-latest strategy: matrix: python-version: [3.7, 3.8] mongodb-version: [4.2] steps: - name: Start MongoDB uses: supercharge/[email protected] with: mongodb-version: ${{ matrix.mongodb-version }} # other values
Flask alkalmazásunkat a legújabb Ubuntu Linux disztribúción szeretnénk tesztelni. Az operációs rendszeren kívül csak Python 3.7-es és Python 3.8-as verzióval szeretnénk tesztjeinket futtatni.
5. lépés: Commit a python-package.yml fájlt a frissített értékekkel.
![](/wp-content/uploads/guides/iae5sr2a76-11.png)
6. lépés: Az előző oldal commitja a GitActions munkákhoz vezet minket.
![](/wp-content/uploads/guides/iae5sr2a76-12.png)
7. lépés: [Választható]
A Github Jobs oldalán a minta oktatóalkalmazáshoz létrehozhatunk egy jelvényt, és elhelyezhetjük azt a README.md fájlban a build állapotának megjelenítéséhez.
Mostantól, amikor a változtatások a master ágba kerülnek, a python-package.yml-ben leírt Git munkafolyamatot követi és futtatja a Git Actions.
Következtetés
Ebben a bemutatóban az összes alapfogalmat lefedtük az előfeltételektől kezdve a Flask - egy Python-alapú webes fejlesztési keretrendszer - segítségével fejlesztett webes alkalmazás CI/CD munkafolyamatának beállításáig.
Ez a bemutató tartalmazza az összes szükséges lépést, mint például a Python telepítése, letöltés & Flask telepítése, munka Flask-Appbuilder, tesztelés PyTest, stb., hogy elkezdjük a webfejlesztést Python segítségével. A webfejlesztő közösség általában összehasonlítja Flask egy másik népszerű Python webfejlesztési keretrendszerrel, a Django.
A sorozat egyik bemutatójában elmagyarázzuk ezeket a különbségeket, és összehasonlítjuk ezeket a keretrendszereket.