Tässä Python Flask -opasohjelmassa kerrotaan, mikä on Flask, Pythonin asennus, Virtualenv, Flask Hello World -esimerkki ja koodiesimerkkejä, virheenkorjausta ja testausta käsittelevä osio:
Verkkosivujen kehittäminen on enemmänkin taidetta kuin taitoa. Se vaatii kärsivällisyyttä ja huolellisuutta sekä sitkeyttä, rohkeutta ja omistautumista, jotta siitä tulisi todellinen menestys. Nykyään on tärkeää, että oppijat pääsevät vauhtiin mahdollisimman pian.
Olemme luoneet tämän Python Flask -oppikirjan, jotta opiskelijat pääsevät vauhtiin ja voivat toteuttaa yksinkertaista ja monimutkaista verkko-ohjelmointia Python 3:n avulla.
Tämä Python Flask -opetusohjelma on enemmänkin Flaskin aloittelijan opetusohjelma, jossa käsitellään Pythonin, Virtualenv:n ja muiden keskeisten pakettien asennusta. Tässä opetusohjelmasarjassa asennamme myös Flaskin yhdessä muiden tarvittavien Flask-liitännäisten kanssa. Olemme myös sisällyttäneet mukaan osion koodin debuggauksesta, testauksesta ja jatkuvasta integroinnista Git Actionsin avulla.
Luettelo tämän Flask-sarjan opetusohjelmista
Tutoriaali #1: Python Flask opetusohjelma - Johdatus Flaskiin aloittelijoille
Tutoriaali #2: Flask-malli, lomake, näkymä ja uudelleenohjaus esimerkkien avulla
Tutoriaali #3: Flaskin tietokantojen käsittely - Flaskin käyttö tietokannan kanssa
Ohje #4: Flask-sovellus ja Flask-projektin ulkoasu Blueprintin ja Bootstrapin avulla.
Ohje #5: Flask-suunnittelumallit ja parhaat käytännöt verkkosovelluksia varten
Ohje #6: Flask API opetusohjelma esimerkin kanssa
Ohje #7: Django Vs Flask Vs Node: Mikä kehys valita
Ohje #8: Top 31 Suosittu Python Flask haastattelukysymykset vastaukset
Mikä on Flask
Flask on web-kehityskehys. Se on kehys, jossa on sisäänrakennettu kehityspalvelin ja debuggeri.
Flask-kehys itsessään eroaa muista arkkityypeistä, sillä sen avulla web-kehittäjät voivat olla joustavia ja mukautua mukavasti ohjelmistokehitysyhteisön usein julkaisemiin muutoksiin.
Mihin Flaskia käytetään
Käytämme Flask-kehystä Web-sovellusten kehittämiseen Python-ohjelmointikielellä. Se integroituu muiden kolmansien osapuolten palveluihin ja sovellusrajapintoihin tuoden rikkautta ja merkitystä kehitettävään sovellukseen. Flaskin peruskäsitteet ovat yksinkertaisia, ja sen jalanjälki on pieni.
Aloitetaan tällä Python Flask -opetusohjelmalla ymmärtämään web-kehitystä Flask GitHub-arkiston avulla. Ennen kuin jatkat, kloonaa projekti Githubista, jotta voit helposti seurata käsiteltyjä koodiesimerkkejä.
Edellytykset
Muiden kuin tässä osiossa mainittujen otsikoiden lisäksi suosittelemme Github-tilin luomista. Jatketaan alla mainituilla vaiheilla esivaatimuksissa.
Vaihe 1: Asenna Python
Tarkista, oletko asentanut Python 3:n. Jos et ole, lataa Python 3 täältä ja asenna se käyttöjärjestelmäsi mukaan.
Vaihe 2: Luo Python-virtuaaliympäristö
Luo virtuaaliympäristö alla olevalla komennolla.
python3 -m venv venv
Aktivoi Python-virtuaaliympäristö alla olevalla komennolla.
lähde venv/bin/activate
Alla on esimerkki virtuaaliympäristön aktivoinnista ja deaktivoinnista.
Kaikkien tämän ohjeen myöhempien komentojen pitäisi toimia aktivoidussa virtuaaliympäristössä. Asenna wheel-paketti, jotta voimme rakentaa pyöriä virtuaaliympäristössä.
pip install wheel
Vaihe 3: Flaskin lataaminen ja käyttöönotto
Meidän on suoritettava Flaskin latausvaiheet ja asennettava Flask alla olevien ohjeiden avulla.
Asenna nyt Flask.
pip asentaa flask
Jotkut meistä haluavat työskennellä uusimpien lähdekoodimuutosten kanssa. Voimme käyttää alla olevaa komentoa asentaaksemme Flaskin lähdekoodin uusimmat muutokset.
Tee väliaikainen hakemisto.
mkdir tmp
Asenna nyt Flask Github-arkistosta. Sinun on oltava yhteydessä internetiin, jotta alla oleva komento toimii.
pip3 install -e [email protected]:pallets/flask.git#egg=flask
Katso konsolin tulosteet tarkistaaksesi asennuksen onnistumisen. Tarkista nyt, pääsemmekö Flask-komentoihin.
flask --help
Saatat nähdä joitakin poikkeuksia Flask-sovelluksen puuttumisesta. Älä kuitenkaan välitä niistä, sillä emme ole luoneet mitään Flask-sovellusta. Sovelluksemme on Flask-instanssi, joka on Werkzeug-verkkokehyksen ja Jinja-temppausmoottorin kääre.
Työkalu
Werkzeug on WSGI-työkalupakki. WSGI on vain kutsukäytäntö, jonka avulla web-palvelimet voivat välittää eteenpäin verkkopyynnöt Python-ohjelmointikielellä kirjoitettuihin verkkosovelluksiin.
Jinja
Templating on web-kehittäjien olennainen osaamisalue. Jinja on täysin varusteltu ja suosittu templating-moottori Pythonille. Se on varsin ilmaisuvoimainen kieli ja tarjoaa vahvan työkalupaketin templaattorien tekijöille.
Vaihe 4: Asenna MongoDB
Seuraa alla olevia ohjeita MongoDB:n asentamiseksi. Olemme esittäneet ohjeet sen asentamiseksi Debian-pohjaiseen Linuxiin. Jos käytät jotain muuta käyttöjärjestelmää, siirry linkistä ja asenna se haluamasi käyttöjärjestelmän mukaisesti.
Asenna gnupg MongoDB:n julkisen GPG-avaimen tuontia varten.
sudo apt-get install gnupg
Tuo nyt avain alla olevalla komennolla.
wget -qO - //www.mongodb.org/static/pgp/server-4.2.asc
Luo lähdeluettelotiedosto Linux-jakelusi mukaan. Olemme lisänneet Debianin lähdeluettelon.
echo "deb //repo.mongodb.org/apt/debian buster/mongodb-org/4.2 main"
Suorita päivityskomento
sudo apt-get update
Asenna nyt MongoDB alla olevalla komennolla.
sudo apt-get install -y mongodb-org
Kun asennus on onnistunut, käynnistä MongoDB alla olevalla komennolla.
sudo systemctl start mongod
Tarkista MongoDB:n tila alla olevalla komennolla.
sudo systemctl status mongod
Varmista nyt, että mongod käynnistyy automaattisesti järjestelmän uudelleenkäynnistyksen yhteydessä antamalla alla oleva komento.
sudo systemctl enable mongod
Tarkista nyt, voitko muodostaa yhteyden MongoDB-palvelimeen käyttämällä mongo-asiakasta.
mongo
Yritä käyttää mongon komentorakennossa komentoja help ja show dbs.
Flask-sovelluksen luominen
Asenna flask-appbuilder ja mongoengine alla olevalla komennolla.
pip install flask-appbuilder pip install mongoengine pip install flask_mongoengine pip install flask_mongoengine
Luo luurankosovellus, jonka arvot näkyvät alla olevan koodinpätkän kommenteissa.
flask fab create-app # Anna seuraavat arvot komentorivin kyselylomakkeessa # Application Name: flaskTutorialApp # EngineType : MongoEngine
Näemme alla olevan kaltaisen tulosteen.
Uuden sovelluksen nimi: exampleApp Moottorityyppisi, SQLAlchemy tai MongoEngine (SQLAlchemy, MongoEngine) [SQLAlchemy]: MongoEngine Latasin luurankosovelluksen, hyvää koodausta!
Katso projektin ja sovelluksen ulkoasua. Alla on esitetty tree-komennon tuloste.
Katsotaanpa Flaskin config-tiedostoa. Se on oletusconfig, joka on luotu edellisen komennon tuloksena. Poista kommentti Kyborgi teema, kuten alla näkyy.
# Teemojen konfigurointi Cybord=g # nämä teemat sijaitsevat osoitteessa static/appbuilder/css/themes # Voimme luoda omia teemoja ja käyttää niitä helposti sijoittamalla ne samaan dir-rakenteeseen ohitettavaksi #APP_THEME = "bootstrap-theme.css" # oletusarvoinen bootstrap #APP_THEME = "cerulean.css" # cerulean #APP_THEME = "amelia.css" # amelia-teema #APP_THEME = "cosmo.css" # cosmo-teema APP_THEME = "cyborg.css" # cyborgteema #APP_THEME = "flatly.css" # flatly-teema
Voit ajaa luurankosovelluksen käyttämällä alla olevaa komentoa terminaalissa.
pullonajo
Flask Hello World
Luodaksesi ensimmäisen ohjelmasi flaskTutorialApp:ssa, avaa tiedosto views.py app-hakemiston alta ja lisää seuraava koodi. Etsi tiedostossa annetut import-lausekkeet. Lisää nämä lausekkeet, jos niitä ei vielä ole.
from flask_appbuilder import BaseView, expose from app import appbuilder class HelloWorld(BaseView): """ Tämä ensimmäinen näkymä tutorialissa """ route_base = "/hello" @expose("/") def hello(self): return "Hello, World! from Software Testing Help" # tiedoston lopussa appbuilder.add_view_no_menu(HelloWorld())
Tallenna tiedosto sen jälkeen, kun olet lisännyt yllä olevan lähdekoodin. Siirry projektin juurihakemistoon ja käytä alla olevaa komentoa Flaskin kehityspalvelimen käynnistämiseksi.
pullonajo
Siirry nyt osoitteeseen //localhost:5000/hello/ nähdäksesi tuloksen selaimessa.
Vianmääritys
Tällä hetkellä kehityspalvelin ei toimi vianmääritystilassa. Ilman vianmääritystilaa on vaikea löytää virheitä Flask-sovelluksen lähdekoodista.
Flaskin debug-tila johtaa seuraavaan:
- Debug-tila aktivoi automaattisen uudelleenlatauksen. Se tarkoittaa, että meidän ei tarvitse käynnistää kehityspalvelinta uudelleen sen jälkeen, kun olemme tehneet muutoksia sovelluksen lähdekoodiin.
- Debug-tila aktivoi Pythonin debuggerin. Voimme tarkastella muuttujien arvoja Exceptionin aikana.
- Debug-tila mahdollistaa Flask-sovelluksen debuggauksen. Voimme tarkistaa eri muuttujien arvot debuggausistunnoissa.
Pysäytä kehityspalvelin, jos se on jo käynnissä. Voit tehdä saman käyttämällä CTRL + C tai näppäimistön keskeytystä.
Ota debug-tila käyttöön ja käytä kehityspalvelinta väliaikaisesti seuraavan koodin avulla.
FLASK_ENV=kehitys flask run
Etsi konsolista Debugger PIN ja merkitse se muistiin.
Nyt muutetaan yllä kirjoitettua HelloWorld-näkymää seuraavilla koodinpätkän riveillä. Huomaa, että olemme ottaneet käyttöön mukautetun poikkeuksen.
@expose("/") def hello(self): raise Exception("Mukautettu poikkeus DEBUG-tilan oppimiseksi") return "Hello, World! from Software Testing Help"
Siirry osoitteeseen //localhost:5000/hello/, ja näet, että sovellus on aiheuttanut poikkeuksen. Selain näyttää pinojäljen, kuten alla näkyy.
![](/wp-content/uploads/guides/iae5sr2a76-3.png)
Katso lisäksi konsolia, jossa kehityspalvelin on käynnissä. Huomaat, että tällä kertaa muutokset views.py:ssä havaitaan automaattisesti ja debug-palvelin käynnistyy itsestään uudelleen. Nyt meidän ei tarvitse käynnistää sitä manuaalisesti uudelleen.
Konsoliin tulee rivejä, kuten alla näkyy. Meidän on kirjattava Debug PIN-koodi myöhempää käyttöä varten.
* Havaittu muutos tiedostossa '/work/sth/flaskTutorialApp/app/views.py', uudelleenlataus 2020-06-02 14:59:49,354:INFO:werkzeug: * Havaittu muutos tiedostossa '/work/sth/flaskTutorialApp/app/views.py', uudelleenlataus * Käynnistetään uudelleen statin avulla 2020-06-02 14:59:49,592:INFO:werkzeug: * Käynnistetään uudelleen statin avulla * Debuggeri on aktiivinen! * Debuggerin PIN-koodi: 150-849-897
Tarkista nyt pinojälki selaimessa ja siirry viimeiselle riville. Laajenna näkymä klikkaamalla sitä ja avaa komentotulkki interaktiivisessa tilassa klikkaamalla CLI-kuvaketta.
![](/wp-content/uploads/guides/iae5sr2a76-4.png)
Kun avaat sen, näet, että selaimessa näytetään kehote Debug PIN. Anna Debug PIN ja klikkaa OK.
![](/wp-content/uploads/guides/iae5sr2a76-5.png)
Kun jatkamme eteenpäin annettuamme Debug PIN-koodin, pääsemme interaktiiviseen komentotulkkiin.
Pääsemme selaimesta käsiksi komentotulkkiin ja voimme tarkastaa muuttujien arvot löytääksemme poikkeuksen syyn ja käsitelläksemme virheen paremmin. Katso yhtä alla olevassa kuvassa esitetyistä esimerkeistä.
![](/wp-content/uploads/guides/iae5sr2a76-6.png)
Muuta nyt koodia view.py:ssä, kuten alla on esitetty. Huomaa, että olemme kommentoineet rivin, jossa oli poikkeus.
@expose("/") def hello(self): # raise Exception("Mukautettu poikkeus DEBUG-tilan oppimiseksi") return "Hello, World! from Software Testing Help"
Flask-sovelluksen testaus
Kirjoitetaan nyt ensimmäinen testi Flask-sovellukselle, jota kehitämme. Asenna ensin PyTest. PyTest on testauskehys. Se auttaa meitä kirjoittamaan parempaa koodia.
Koska voimme kirjoittaa yksikkötestejä samalla kun kehitämme sovelluksiamme, on mahdollista noudattaa TDD-lähestymistapaa. TDD on lyhenne sanoista Test-Driven Development (testilähtöinen kehitys). Tämän sarjan myöhemmissä opetusohjelmissa kirjoitamme aina ensin testit ja kehitämme sitten näkymät tai mallit.
Asenna PyTest
pip asentaa pytest
Luo nyt sovellus-hakemiston sisälle hakemisto nimeltä tests ja luo siihen tiedosto nimeltä test_hello.py. Kirjoitetaan ensimmäinen yksikkötesti, jolla testataan näkymäämme.
Kopioi seuraava koodinpätkä ja liitä se tiedostoon test_hello.py.
#!/usr/bin/env python from app import appbuilder import pytest @pytest.fixture def client(): """" Pytest-fixture testiasiakkaalle """ appbuilder.app.config["TESTING"] = True with appbuilder.app.test_client() as client: yield client def test_hello(client): """ Testi-metodi, jolla testataan näkymää hello """ resp = client.get("/hello", follow_redirects=True) assert 200 == resp.status_code
Käytä alla olevaa pytest-komentoa testien suorittamiseen. PyTest kerää testit automaattisesti ja näyttää tulokset standardilähdössä.
![](/wp-content/uploads/guides/iae5sr2a76-7.png)
Luo GitHub-työnkulku
Käytämme Git Actionsia CI/CD-työnkulun luomiseen esimerkkisovelluksellemme. Seuraa alla mainittuja vaiheita projektissasi.
Vaihe 1: Siirry GitHubin arkistosivulle. Napsauta Git Actions.
![](/wp-content/uploads/guides/iae5sr2a76-8.png)
Vaihe 2: Selaa sivua alaspäin ja etsi Python-paketin olemassa oleva työnkulun malli.
![](/wp-content/uploads/guides/iae5sr2a76-9.png)
Vaihe 3: Python-paketin asennus Työnkulku.
![](/wp-content/uploads/guides/iae5sr2a76-10.png)
Vaihe 4: Kun python-package.yml-työnkulun kokoonpano avautuu, päivitä se annettujen yaml-lisätunnisteiden arvojen perusteella.
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
Haluamme testata Flask-sovellustamme uusimmassa Ubuntu Linux -jakelussa. Käyttöjärjestelmän lisäksi haluamme suorittaa testit vain Python 3.7:llä ja Python 3.8:lla.
Vaihe 5: Sitoudu python-package.yml-tiedostoon päivitetyillä arvoilla.
![](/wp-content/uploads/guides/iae5sr2a76-11.png)
Vaihe 6: Edellisellä sivulla tehty sitoumus vie meidät GitActions-työtehtäviin.
![](/wp-content/uploads/guides/iae5sr2a76-12.png)
Vaihe 7: [Valinnainen]
Esimerkkisovelluksen Github Jobs -sivulla voimme luoda rintamerkin ja sijoittaa sen README.md-tiedostoon, jotta rakennustila näkyy.
Nyt aina kun muutokset siirretään master-haaraan, python-package.yml-tiedostoon kirjoitettua Git-työnkulkua noudatetaan ja se suoritetaan Git-toiminnoissa.
Päätelmä
Tässä opetusohjelmassa olemme käsitelleet kaikki peruskäsitteet ennakkoedellytyksistä CI/CD-työnkulun määrittämiseen Flaskilla - Python-pohjaisella web-kehityskehyksellä kehitetylle verkkosovellukselle.
Tämä opetusohjelma kattaa kaikki tarvittavat vaiheet, kuten Pythonin asentaminen, lataaminen & Flaskin asentaminen, työskentely Flask-sovellusrakentajan kanssa, testaaminen PyTestillä jne., jotta pääset alkuun verkkokehityksessä Pythonilla. Verkkokehitysyhteisö vertaa Flaskia yleensä toiseen suosittuun Python-verkkokehityskehykseen nimeltä Django.
Selitämme nämä erot ja vertailemme näitä kehyksiä yhdessä tämän sarjan opetusohjelmista.