Share via


Hızlı Başlangıç: Visual Studio'da şablondan Python projesi oluşturma

Bu hızlı başlangıçta, yerleşik Python proje şablonunu kullanarak hızla bir Flask uygulaması oluşturmak için kılavuzlu adımları izleyeceksiniz. Visual Studio, Flask, Django ve Bottle gibi çeşitli Python çerçeveleri için şablonlardaki ortak kod ve işlevlerle Python projeleri geliştirmeyi kolaylaştırır. Bu makalede açıklanan Python projesi, Hızlı Başlangıç: Flask ile web uygulaması oluşturma makalesi aracılığıyla el ile oluşturduğunuz projeye benzer.

Önkoşullar

  • Python iş yükleri desteğiyle yüklenen Visual Studio.

    Visual Studio Yükleyicisi, web projesi şablonlarına erişim için Python geliştirme iş yükünü ve Python web desteği seçeneğini belirleyin. Daha fazla bilgi için bkz . Visual Studio'da Python desteğini yükleme.

    Python geliştirme iş yükü için Visual Studio Yükleyicisi Python web desteğinin nasıl seçildiğini gösteren ekran görüntüsü.

Mac için Visual Studio desteklenmez. Daha fazla bilgi için bkz. Mac için Visual Studio neler oluyor? Windows, Mac ve Linux üzerinde Visual Studio Code, kullanılabilir uzantılar aracılığıyla Python ile iyi çalışır.

Proje oluşturma

Visual Studio çözümü ve yeni bir Flask web projesi oluşturmak için bu yordamı izleyin:

  1. Visual Studio'da Dosya>Yeni Proje'yi> seçin ve "Flask" araması yapın. Boş Flask Web Projesi şablonunu seçin ve İleri'yi seçin.

    Visual Studio 2022'de Boş Flask Web Projesi şablonunun nasıl seçildiğini gösteren ekran görüntüsü.

  2. Visual Studio, proje yapılandırma iletişim kutusunu görüntüler. Proje için bir Ad girin ve Oluştur'u seçin. Diğer alanları varsayılan olarak ayarlayabilirsiniz.

    Visual Studio 2022'de yeni bir Boş Flask Web Projesinin nasıl yapılandırıldığını gösteren ekran görüntüsü.

  3. Bir dakika sonra Visual Studio, paket bağımlılıklarının nasıl işleneceğini gösteren bir istem görüntüler. İstem, paket bağımlılıklarının zaten yüklü olup olmadığına bağlı olarak farklıdır.

    Bu proje dış paketler gerektiriyor iletişim kutusu . Seçili şablonun Flask paketindeki bağımlılıkları belirten bir requirements.txt dosyası içerdiğini gösterir. Visual Studio paketleri otomatik olarak yükleyebilir ve bu sayede paketleri sanal bir ortama yükleme seçeneği sunulur. Sanal ortamın kullanılması, genel bir ortama yüklenecek şekilde önerilir.

    Bu iletişim kutusunu alırsanız Sanal ortama yükle seçeneğini belirleyin:

    Visual Studio'da gerekli paket bağımlılıklarını bir sanal ortama yükleme isteminin ekran görüntüsü.

    Alternatif olarak, Proje <Projesi adında> "requirements.txt" Python paket belirtimi dosyasının algılandığını görebilirsiniz. Visual Studio penceresinin üst kısmında istem. Bu istem, paket bağımlılıklarının yapılandırmanızda zaten kullanılabilir olduğunu gösterir. Visual Studio, mevcut yapılandırmadan sizin için bir sanal ortam oluşturabilir.

    Bu istemi görürseniz Sanal ortam oluştur seçeneğini belirleyin:

    Visual Studio'da proje için bir gereksinim dosyasının algılandığını gösteren istemin ekran görüntüsü.

  4. Visual Studio, Ortam ekle iletişim kutusunu görüntüler. Varsayılan değerleri kabul edin ve Oluştur'u seçin, ardından yükseltme isteklerini onaylayın.

    Visual Studio 2022'de Flask projesi için sanal ortamın nasıl ekleneceğini gösteren ekran görüntüsü.

  1. Visual Studio'da Dosya>Yeni Proje'yi> seçin.

  2. Yeni Proje iletişim kutusunda "boş flask" ifadesini arayın. Ortadaki listede Boş Flask Web Projesi şablonunu seçin, bir proje Adı girin ve Tamam'ı seçin:

    Visual Studio'da yeni bir Flask uygulaması oluşturmak için Boş Flask Web Projesi şablonunun nasıl seçildiğini gösteren ekran görüntüsü.

  3. Bir dakika sonra Visual Studio bir istem görüntüler:

    Bu proje dış paketler gerektiriyor iletişim kutusu . Seçili şablonun Flask paketindeki bağımlılıkları belirten bir requirements.txt dosyası içerdiğini gösterir. Visual Studio paketleri otomatik olarak yükleyebilir ve bu sayede paketleri sanal bir ortama yükleme seçeneği sunulur. Sanal ortamın kullanılması, genel bir ortama yüklenecek şekilde önerilir.

    Bu iletişim kutusunu alırsanız Sanal ortama yükle seçeneğini belirleyin:

    Visual Studio'da gerekli paket bağımlılıklarını bir sanal ortama yükleme isteminin ekran görüntüsü.

    Alternatif olarak, Proje <Projesi adında> "requirements.txt" Python paket belirtimi dosyasının algılandığını görebilirsiniz. Visual Studio penceresinin üst kısmında istem. Bu istem, paket bağımlılıklarının yapılandırmanızda zaten kullanılabilir olduğunu gösterir. Visual Studio, mevcut yapılandırmadan sizin için bir sanal ortam oluşturabilir.

    Bu istemi görürseniz Sanal ortam oluştur seçeneğini belirleyin:

    Visual Studio'da proje için bir gereksinim dosyasının algılandığını gösteren istemin ekran görüntüsü.

  4. Visual Studio, Ortam ekle iletişim kutusunu görüntüler. Varsayılan değerleri kabul edin ve Oluştur'u seçin, ardından yükseltme isteklerini onaylayın.

    Visual Studio'da Flask projesi için sanal ortam eklemeyi gösteren ekran görüntüsü.

İpucu

Bir projeye başladığınızda, çoğu Visual Studio şablonunun sizi davet ettiğinden hemen bir sanal ortam oluşturmanız kesinlikle önerilir. Sanal ortamlar, siz kitaplık ekleyip kaldırırken projenizin zaman içinde tam gereksinimlerini korur. Daha sonra kolayca bir requirements.txt dosyası oluşturabilirsiniz. Bu bağımlılıkları diğer geliştirme bilgisayarlarına yeniden yüklemek için (kaynak denetimi kullanılırken olduğu gibi) ve projeyi bir üretim sunucusuna dağıtırken kullanabilirsiniz. Sanal ortamlar ve bunların avantajları hakkında daha fazla bilgi için bkz . Sanal ortamları kullanma ve requirements.txt ile gerekli paketleri yönetme.

Ortak kodu inceleme

Bu bölümde, Visual Studio'nun seçili şablon için oluşturduğu Flask proje dosyasındaki (.py) ortak kodu inceleyebilirsiniz.

  1. Çözümünüzü ve Flask proje dosyalarınızı görüntülemek için Çözüm Gezgini açın. İlk proje yalnızca iki dosya içerir: app.py ve requirements.txt:

    Çözüm Gezgini'daki ilk Flask proje dosyalarını gösteren ekran görüntüsü.

    requirements.txt dosyası Flask paket bağımlılıklarını belirtir. Bu dosyanın varlığı, projeyi ilk oluştururken sizi sanal ortam oluşturmaya davet eder.

    Tek app.py dosyası boş bir Flask web projesi için ortak kod içerir. Şablon, Hızlı Başlangıç - Flask ile web uygulaması oluşturma makalesindeki açıklamalara benzer bir kod sağlar ve birkaç bölüm eklenmiştir.

  2. Düzenleyicide app.py dosyasını açın ve en üstteki bölümü inceleyin.

    Kod, Flask paketi için bir import deyimle başlar. Bu deyim, değişkenine Flaskappatanan sınıfının bir örneğini oluşturur:

    from flask import Flask
    app = Flask(__name__)
    

    Ardından kod, Flask wsgi_app uygulamasını bir web konağına dağıttığınızda yararlı olan değişkenini atar:

    # Make the WSGI interface available at the top level so wfastcgi can get it.
    wsgi_app = app.wsgi_app
    
  3. Ortadaki bölüm bir URL yoluna işlev atar. Bu, işlevin URL tarafından tanımlanan kaynağı sağladığı anlamına gelir. Bu durumda, yol bir görünüm tanımlar:

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

    Flask'in @app.route dekoratörünü site kökünden göreli URL olan bir bağımsız değişkenle kullanarak yolları tanımlarsınız. Kodda görebileceğiniz gibi işlev yalnızca bir metin dizesi döndürür ve bu da tarayıcının işlemesi için yeterlidir.

  4. Alt bölümde Flask geliştirme sunucusunu başlatmak için isteğe bağlı kod bulunur. Konak ve bağlantı noktasını sabit kodlama yerine ortam değişkenleri aracılığıyla ayarlayabilirsiniz. Bu tür kod, kodu değiştirmeden hem geliştirme hem de üretim makinelerinde yapılandırmayı kolayca denetlemenizi sağlar:

    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. Flask uygulamasını çalıştırmak ve varsayılan ana bilgisayar ve bağlantı noktası değeri localhost:5555olan bir tarayıcı açmak için Hata Ayıklama Olmadan Başlat'ı seçin.>

Visual Studio'da Python şablonlarını keşfetme

Python iş yükünü yüklediğinizde Visual Studio Flask, Bottle ve Django web çerçeveleri ve Azure bulut hizmetleri için çeşitli proje şablonları sağlar. Ayrıca farklı makine öğrenmesi senaryolarına yönelik şablonlar ve Python uygulaması içeren mevcut bir klasör yapısından proje oluşturmaya yönelik bir şablon da vardır. Şablonlara, Dosya>Yeni>Proje menü seçeneğini kullanarak erişebilirsiniz. Kullanılabilir şablonları görmek için Python dil düğümünü ve alt düğümlerini seçin.

Visual Studio ayrıca hızlı bir şekilde Python sınıfı, Python paketi, Python birim testi, web.config dosyaları ve daha fazlasını oluşturmak için çeşitli dosya veya öğe şablonları sağlar. Açık bir Python projeniz olduğunda, Proje>Yeni Öğe Ekle menü seçeneğini kullanarak öğe şablonlarına erişebilirsiniz. Daha fazla bilgi için bkz . öğe şablonları başvurusu.

Şablonları kullanmak, projeyi başlatırken veya dosya oluştururken size önemli zaman kazandırabilir. Ayrıca farklı uygulama türleri ve kod yapıları hakkında bilgi edinmek için de harika bir yoldur. Sunulanlar hakkında bilgi edinmek için çeşitli şablonlardan proje ve öğe oluşturmak için birkaç dakikanızı ayırabilirsiniz.

Cookiecutter şablonlarını kullanma

Visual Studio şablonları keşfetmenize, şablon seçeneklerini girmenize ve proje ve dosya oluşturmanıza yardımcı olmak için Cookiecutter ile doğrudan tümleştirme sağlar. Daha fazla bilgi için Hızlı Başlangıç: Cookiecutter şablonundan proje oluşturma makalesine bakın.