Öğretici: Visual Studio'da Flask web çerçevesini kullanmaya başlama

Flask , URL yönlendirme ve sayfa işleme ile ilgili temel bilgileri sağlayan web uygulamalarına yönelik basit bir Python çerçevesidir.

Flask, form doğrulama, veritabanı soyutlaması, kimlik doğrulaması gibi özellikleri doğrudan sağlamadığından "mikro" çerçeve olarak adlandırılır. Bunun yerine bu özellikler Flask uzantıları olarak adlandırılan özel Python paketleri tarafından sağlanır. Uzantılar Flask ile sorunsuz bir şekilde tümleştirilip Flask'in bir parçası gibi görünmelerini sağlar. Örneğin, Flask'in kendisi bir sayfa şablonu altyapısı sağlamaz. Şablon oluşturma, bu öğreticide gösterildiği gibi Jinja ve Jade gibi uzantılar tarafından sağlanır.

Bu öğreticide aşağıdakilerin nasıl yapılacağını öğreneceksiniz:

• "Boş Flask Web Projesi" şablonunu (1. adım) kullanarak Git deposunda temel bir Flask projesi oluşturun.
• Tek sayfalı bir Flask uygulaması oluşturun ve bu sayfayı şablon kullanarak işleyin (2. adım).
• Statik dosyalar sunma, sayfa ekleme ve şablon devralmayı kullanma (3. adım).
• Flask Web Projesi şablonunu kullanarak birden çok sayfaya ve esnek tasarıma sahip bir uygulama oluşturun (4. adım).

Bu adımlar boyunca iki ayrı proje içeren tek bir Visual Studio çözümü oluşturursunuz. Visual Studio'ya dahil edilen farklı Flask proje şablonlarını kullanarak projeyi oluşturursunuz. Projeleri aynı çözümde tutarak, karşılaştırma için farklı dosyalar arasında kolayca geçiş yapabilirsiniz.

Önkoşullar

Flask proje şablonları tüm önceki Visual Studio için Python Araçları sürümlerine dahil edilir, ancak ayrıntılar bu öğreticide açıklananlardan farklı olabilir.

Python geliştirmesi şu anda Mac için Visual Studio'da desteklenmemektedir. Mac ve Linux'ta Visual Studio Code öğreticisinde Python uzantısını kullanın.

1-1. Adım: Visual Studio projesi ve çözümü oluşturma

1-2. Adım: Git denetimlerini inceleme ve uzak bir depoda yayımlama

Soru: Projenin başından itibaren kaynak denetimini kullanmanın bazı avantajları nelerdir?

Yanıt: Özellikle de uzak bir depo kullanıyorsanız, başlangıçtan kaynak denetimini kullanmak, projenizin düzenli bir site dışı yedeklemesini sağlar. Bir projenin yalnızca yerel bir dosya sisteminde tutulmasından farklı olarak, kaynak denetimi tam bir değişiklik geçmişi ve tek bir dosyayı veya projenin tamamını önceki bir duruma geri döndürme olanağı da sağlar. Bu değişiklik geçmişi, regresyonların (test hataları) nedenini belirlemeye yardımcı olur. Bir proje üzerinde birden çok kişi çalışıyorsa kaynak denetimi önemlidir, çünkü üzerine yazmaları yönetir ve çakışma çözümü sağlar. Kaynak denetimi temelde bir otomasyon biçimidir, derlemeleri otomatikleştirmek, test etmek ve yayın yönetimi için iyi bir şekilde ayarlamanızı sağlar. Proje için DevOps kullanmanın ilk adımıdır ve giriş engelleri çok düşük olduğundan, başlangıçtan itibaren kaynak denetimini kullanmamak için gerçekten bir neden yoktur.

Otomasyon olarak kaynak denetimi hakkında daha fazla bilgi edinmek için msdn dergisinde web uygulamaları için de geçerli olan mobil uygulamalar için yazılmış bir makale olan Gerçeğin Kaynağı: DevOps'taki Depoların Rolü makalesine bakın.

Soru: Visual Studio'nın yeni bir projeyi otomatik olarak işlemesini engelleyebilir miyim?

Yanıt: Evet. Otomatik işlemeyi devre dışı bırakmak için Takım Gezgini'ndeki Ayarlar sayfasına gidin, Git>Genel ayarları'nı seçin, Birleştirmeden sonra değişiklikleri varsayılan olarak işle etiketli seçeneği temizleyin ve güncelleştir'i seçin.

1-3. Adım: Sanal ortamı oluşturma ve kaynak denetiminden dışlama

Artık projeniz için kaynak denetimi yapılandırdığınıza göre, sanal ortamı projenin gerektirdiği gerekli Flask paketleriyle oluşturabilirsiniz. Ardından, ortamın klasörünü kaynak denetiminden dışlamak için Takım Gezgini'ni kullanabilirsiniz.

Soru: Neden sanal ortam oluşturmak istiyorum?

Yanıt: Sanal ortam, uygulamanızın tam bağımlılıklarını yalıtmak için harika bir yoldur. Bu tür bir yalıtım, genel python ortamında çakışmaları önler ve hem test hem de işbirliğine yardımcı olur. Zaman içinde, bir uygulama geliştirirken birçok yararlı Python paketi getirirsiniz. Paketleri projeye özgü bir sanal ortamda tutarak, kaynak denetimine dahil edilen ortamı açıklayan projenin requirements.txt dosyasını kolayca güncelleştirebilirsiniz. Proje derleme sunucuları, dağıtım sunucuları ve diğer geliştirme bilgisayarları da dahil olmak üzere diğer bilgisayarlara kopyalandığında, ortamı yalnızca requirements.txt kullanarak yeniden oluşturmak kolaydır (bu nedenle ortamın kaynak denetiminde olması gerekmez). Daha fazla bilgi için bkz . Sanal ortamları kullanma.

Soru: Nasıl yaparım? kaynak denetimine önceden kaydedilmiş bir sanal ortamı kaldıralım mı?

Yanıt: İlk olarak klasörü dışlamak için .gitignore dosyanızı düzenleyin: sonunda açıklamanın # Python Tools for Visual Studio (PTVS) bulunduğu bölümü bulun ve sanal ortam klasörü için gibi /BasicProject/envyeni bir satır ekleyin. (Visual Studio dosyayı Çözüm Gezgini Dosya>Aç> menü komutunu kullanarak doğrudan açın. Dosyayı Ekip Gezgini'nden de açabilirsiniz: Ayarlar sayfasında Depo Ayarlar'ı seçin, & Öznitelik Dosyalarını Yoksay bölümüne gidin ve .gitignore öğesinin yanındaki Düzenle bağlantısını seçin.)

İkinci olarak, bir komut penceresi açın, env gibi sanal ortam klasörünü içeren BasicProject gibi bir klasöre gidin ve komutunu çalıştırıngit rm -r env. Ardından bu değişiklikleri komut satırından (git commit -m 'Remove venv') veya Ekip Gezgini'nin Değişiklikler sayfasından işleyin.

1-4. Adım: Ortak kodu inceleme

1. Proje oluşturma işlemi tamamlandıktan sonra çözümü ve projeyi Çözüm Gezgini'de görürsünüz; burada proje yalnızca iki dosya içerir: app.py ve requirements.txt:

   

2. Daha önce belirtildiği gibi requirements.txt dosyası Flask paket bağımlılığını belirtir. Bu dosyanın varlığı, projeyi ilk oluştururken sizi sanal ortam oluşturmaya davet eder.

3. Tek app.py dosyası üç bölümden oluşur. İlk olarak Flask için bir import deyimdir; sınıfın Flask değişkenine appatanmış bir örneği oluşturulur ve ardından bir wsgi_app değişken atanır (bir web konağına dağıtılırken yararlıdır, ancak şimdilik kullanılmaz):

   from flask import Flask
   app = Flask(__name__)
   
   # Make the WSGI interface available at the top level so wfastcgi can get it.
   wsgi_app = app.wsgi_app
   

4. Dosyanın sonundaki ikinci bölüm, Flask geliştirme sunucusunu ortam değişkenlerinden alınan belirli konak ve bağlantı noktası değerleriyle (varsayılan olarak localhost:5555) başlatan isteğe bağlı bir koddur:

   if __name__ == '__main__':
       import os
       HOST = os.environ.get('SERVER_HOST', 'localhost')
       try:
           PORT = int(os.environ.get('SERVER_PORT', '5555'))
       except ValueError:
           PORT = 5555
       app.run(HOST, PORT)
   

5. Üçüncüsü, url yoluna işlev atayan kısa bir kod bitidir; bu da işlevin URL tarafından tanımlanan kaynağı sağladığı anlamına gelir. Flask'in @app.route dekoratörünü kullanarak, bağımsız değişkeni site kökünden göreli URL olan yolları tanımlarsınız. Kodda görebileceğiniz gibi, buradaki işlev yalnızca bir metin dizesi döndürür ve bu, tarayıcının işlemesi için yeterlidir. İzleyen adımlarda HTML ile daha zengin sayfalar oluşturursunuz.

   @app.route('/')
   def hello():
       """Renders a sample page."""
       return "Hello World!"
   

Soru: Flask sınıfı için ad bağımsız değişkeninin amacı nedir?

Yanıt: Bağımsız değişken, uygulamanın modülünün veya paketinin adıdır ve Flask'e uygulamaya ait şablonları, statik dosyaları ve diğer kaynakları nerede arayacağı bildirilir. Tek bir modülde __name__ yer alan uygulamalar için her zaman uygun değerdir. Hata ayıklama bilgilerine ihtiyaç duyan uzantılar için de önemlidir. Daha fazla bilgi ve ek bağımsız değişkenler için Flask sınıfı belgelerine (flask.pocoo.org) bakın .

Soru: bir işlevin birden fazla yol dekoratörü olabilir mi?

Yanıt: Evet, aynı işlev birden çok yola hizmet verirse istediğiniz kadar dekoratör kullanabilirsiniz. Örneğin, işlevini hem "/" hem de "/hello" için kullanmak hello için aşağıdaki kodu kullanın:

@app.route('/')
@app.route('/hello')
def hello():
    """Renders a sample page."""
    return "Hello World!"

Soru: Flask değişken URL yolları ve sorgu parametreleriyle nasıl çalışır?

Yanıt: Bir yolda, ile <variable_name>herhangi bir değişkeni işaretlersiniz ve Flask, URL yolunda adlandırılmış bir bağımsız değişken kullanarak değişkeni işleve geçirir. Örneğin, biçimindeki /hello/<name> bir yol, işlevine çağrılan name bir dize bağımsız değişkeni oluşturur. Sorgu parametreleri, özellikle yöntemi aracılığıyla request.args özelliği aracılığıyla request.args.get kullanılabilir.

# URL: /hello/<name>?message=Have%20a%20nice%20day
@app.route('/hello/<name>')
def hello(name):
    msg = request.args.get('message','')
    return "Hello " + name + "! "+ msg + "."

Türü değiştirmek için değişkenine intön ek olarak , float, path (klasör adlarının çizgisini kesmek için eğik çizgileri kabul eder) ve uuid. Ayrıntılar için Flask belgelerindeki Değişken kuralları bölümüne bakın.

Soru: Visual Studio, diğer paketleri yükledikten sonra sanal ortamdan requirements.txt dosyası oluşturabilir mi?

Yanıt: Evet. Python Ortamları düğümünü genişletin, sanal ortamınıza sağ tıklayın ve Gereksinimler oluştur.txt komutunu seçin. Ortamı değiştirirken bu komutu düzenli aralıklarla kullanmak ve requirements.txt dosyasındaki değişiklikleri kaynak denetimine ve bu ortama bağlı diğer kod değişiklikleriyle birlikte işlemek iyi olur. Bir derleme sunucusunda sürekli tümleştirme ayarlarsanız, ortamı her değiştirdiğinizde dosyayı oluşturup değişiklikleri işlemeniz gerekir.

1-5. Adım: Projeyi çalıştırma

1. Visual Studio'da Hata Ayıklama>Başlat Hata Ayıklama 'yı (F5) seçin veya araç çubuğundaki Web Sunucusu düğmesini kullanın (gördüğünüz tarayıcı farklılık gösterebilir):

   

2. Her iki komut da PORT ortam değişkenine rastgele bir bağlantı noktası numarası atar ve komutunu çalıştırır python app.py. Kod, Flask'in geliştirme sunucusundaki bu bağlantı noktasını kullanarak uygulamayı başlatır. Visual Studio başlangıç dosyası olmadığıyla ilgili bir iletiyle hata ayıklayıcı başlatılamadı iletisini veriyorsa, Çözüm Gezgini'da app.py sağ tıklayın ve Başlangıç Dosyası Olarak Ayarla'yı seçin.

3. Sunucu başlatıldığında, sunucu günlüğünü görüntüleyen bir konsol penceresi açılır. Ardından Visual Studio otomatik olarak için bir tarayıcı http://localhost:<port>açar ve burada işlevi tarafından hello işlenen iletiyi görmeniz gerekir:

   

4. İşiniz bittiğinde, konsol penceresini kapatarak veya Visual Studio'daki Hata Ayıklamayı> Durdur komutunu kullanarak sunucuyu durdurun.

Soru: Hata Ayıkla menü komutlarını ve projenin Python alt menüsündeki sunucu komutlarını kullanma arasındaki fark nedir?

Yanıt: Hata ayıklama menüsü komutlarına ve araç çubuğu düğmelerine ek olarak, projenin bağlam menüsünde python>Çalıştırma sunucusu veya Python>Çalıştırma hata ayıklama sunucusu komutlarını kullanarak da sunucuyu başlatabilirsiniz. Her iki komut da çalışan sunucunun yerel URL'sini (localhost:port) gördüğünüz bir konsol penceresi açar. Ancak, bu URL'ye sahip bir tarayıcıyı el ile açmanız gerekir ve hata ayıklama sunucusunu çalıştırmak Visual Studio hata ayıklayıcısını otomatik olarak başlatmaz. İsterseniz, İşleme Hata Ayıklama>Ekleme komutunu kullanarak çalışan işleme daha sonra bir hata ayıklayıcısı ekleyebilirsiniz.

Sonraki adımlar

Bu noktada, temel Flask projesi aynı dosyada başlangıç kodunu ve sayfa kodunu içerir. En iyisi bu iki endişeyi ayırmak ve ayrıca şablonları kullanarak HTML ve verileri ayırmaktır.