Bagikan melalui


Mulai cepat: Membuat proyek Python dari templat di Visual Studio

Dalam panduan singkat ini, Anda mengikuti langkah-langkah terarah untuk membuat aplikasi Flask menggunakan templat proyek Python bawaan. Visual Studio memudahkan pengembangan proyek Python dengan kode boilerplate dan fungsionalitas dalam templat untuk beberapa kerangka kerja Python, termasuk Flask, Django, dan Bottle. Proyek Python yang dijelaskan dalam artikel ini mirip dengan proyek yang Anda buat secara manual melalui artikel Mulai Cepat: Membuat aplikasi web dengan Flask .

Prasyarat

  • Visual Studio diinstal dengan dukungan untuk beban kerja Python.

    Di Penginstal Visual Studio, pilih beban kerja pengembangan Python dan opsi dukungan web Python untuk akses ke templat proyek web. Untuk informasi selengkapnya, lihat Menginstal dukungan Python di Visual Studio.

    Cuplikan layar yang memperlihatkan cara memilih dukungan web Python di Penginstal Visual Studio untuk beban kerja pengembangan Python.

Visual Studio untuk Mac tidak didukung. Visual Studio Code di Windows, Mac, dan Linux berfungsi dengan baik dengan Python melalui ekstensi yang tersedia.

Membuat proyek

Ikuti prosedur ini untuk membuat solusi Visual Studio dan proyek web Flask baru:

  1. Di Visual Studio, pilih File>Proyek> dan cari "Flask." Pilih templat Proyek Web Flask Kosong dan pilih Berikutnya.

    Cuplikan layar yang memperlihatkan cara memilih templat Proyek Web Flask Kosong di Visual Studio 2022.

  2. Visual Studio menampilkan dialog konfigurasi proyek. Masukkan Nama untuk proyek dan pilih Buat. Anda dapat membiarkan bidang lain diatur ke default.

    Cuplikan layar yang memperlihatkan cara mengonfigurasi Proyek Web Flask Kosong baru di Visual Studio 2022.

  3. Setelah beberapa saat, Visual Studio menampilkan perintah tentang cara menangani dependensi paket. Prompt akan berbeda tergantung pada apakah Anda sudah menginstal dependensi paket.

    Dialog Proyek ini memerlukan paket eksternal. menunjukkan bahwa templat yang dipilih menyertakan file requirements.txt yang menentukan dependensi pada paket Flask. Visual Studio dapat menginstal paket secara otomatis, yang memberi Anda opsi untuk menginstal paket ke lingkungan virtual. Menggunakan lingkungan virtual disarankan daripada menginstal ke lingkungan global.

    Jika Anda menerima dialog ini, pilih opsi Instal ke lingkungan virtual :

    Cuplikan layar permintaan untuk menginstal dependensi paket yang diperlukan ke lingkungan virtual di Visual Studio.

    Atau, Anda mungkin melihat file spesifikasi paket Python "requirements.txt" terdeteksi dalam proyek <Nama>". notifikasi di bagian atas jendela Visual Studio. Perintah ini menunjukkan bahwa dependensi paket sudah tersedia dalam konfigurasi Anda. Visual Studio dapat membuat lingkungan virtual untuk Anda dari konfigurasi yang ada.

    Jika Anda melihat perintah ini, pilih opsi Buat lingkungan virtual :

    Cuplikan layar perintah yang menunjukkan file persyaratan untuk proyek terdeteksi di Visual Studio.

  4. Visual Studio menampilkan dialog Tambahkan lingkungan . Terima nilai default dan pilih Buat, lalu setujui permintaan elevasi apa pun.

    Cuplikan layar yang memperlihatkan cara menambahkan lingkungan virtual untuk proyek Flask di Visual Studio 2022.

Petunjuk / Saran

Saat Anda memulai proyek, sangat disarankan untuk segera membuat lingkungan virtual, karena sebagian besar templat Visual Studio mengundang Anda untuk melakukannya. Lingkungan virtual mempertahankan persyaratan proyek Anda yang tepat dari waktu ke waktu saat Anda menambahkan dan menghapus pustaka. Anda kemudian dapat dengan mudah menghasilkan file requirements.txt , yang Anda gunakan untuk menginstal ulang dependensi tersebut pada komputer pengembangan lain (seperti saat menggunakan kontrol sumber) dan saat menyebarkan proyek ke server produksi. Untuk informasi selengkapnya tentang lingkungan virtual dan manfaatnya, lihat Menggunakan lingkungan virtual dan Mengelola paket yang diperlukan dengan requirements.txt.

Memeriksa kode boilerplate

Di bagian ini, Anda memeriksa kode boilerplate dalam file proyek Flask (.py) yang dibuat Visual Studio untuk templat yang dipilih.

  1. Buka Penjelajah Solusi untuk melihat solusi dan file proyek Flask Anda. Proyek awal hanya berisi dua file, app.py dan requirements.txt:

    Cuplikan layar yang memperlihatkan file proyek Flask awal di Penjelajah Solusi.

    File requirements.txt menentukan dependensi paket Flask. Kehadiran file inilah yang mengundang Anda untuk membuat lingkungan virtual saat pertama kali membuat proyek.

    File app.py tunggal berisi kode boilerplate untuk proyek web Flask kosong. Templat menyediakan kode yang mirip dengan deskripsi di artikel Mulai Cepat - Membuat aplikasi web dengan Flask , dengan beberapa bagian tambahan.

  2. Buka file app.py di editor dan periksa bagian atas.

    Kode dimulai dengan import pernyataan untuk paket Flask. Pernyataan ini membuat instance kelas Flask, yang ditetapkan ke variabel app.

    from flask import Flask
    app = Flask(__name__)
    

    Selanjutnya, kode menetapkan wsgi_app variabel , yang berguna saat Anda menyebarkan aplikasi Flask ke host web:

    # Make the WSGI interface available at the top level so wfastcgi can get it.
    wsgi_app = app.wsgi_app
    
  3. Bagian tengah menetapkan fungsi ke rute URL, yang berarti fungsi menyediakan sumber daya yang diidentifikasi oleh URL. Dalam hal ini, rute menentukan tampilan:

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

    Anda menentukan rute dengan menggunakan dekorator @app.route Flask dengan argumen yang merupakan URL relatif dari akar situs. Seperti yang Anda lihat dalam kode, fungsi tersebut hanya mengembalikan string teks, yang sudah cukup untuk dirender oleh browser.

  4. Bagian bawah berisi kode opsional untuk memulai server pengembangan Flask. Anda dapat mengatur host dan port melalui variabel lingkungan daripada mengodekannya secara permanen. Kode tersebut memungkinkan Anda untuk dengan mudah mengontrol konfigurasi pada mesin pengembangan dan produksi tanpa mengubah kode:

    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. Pilih Debug>Mulai tanpa Debugging untuk menjalankan aplikasi Flask dan buka browser ke nilai host dan port default, localhost:5555.

Menjelajahi templat Python di Visual Studio

Saat Anda menginstal beban kerja Python, Visual Studio menyediakan berbagai templat proyek untuk kerangka kerja web Flask, Bottle, dan Django dan layanan cloud Azure. Ada juga templat untuk skenario pembelajaran mesin yang berbeda dan templat untuk membuat proyek dari struktur folder yang ada yang berisi aplikasi Python. Anda dapat mengakses templat dengan menggunakan opsi menuProyek>>. Pilih simpul bahasa Python dan simpul anak untuk melihat semua templat yang tersedia.

Visual Studio juga menyediakan berbagai templat file atau item untuk membuat sebuah kelas Python dengan cepat, sebuah paket Python, sebuah pengujian unit Python, web.config file, dan banyak lagi. Saat Anda membuka proyek Python, Anda mengakses templat item dengan menggunakan opsi menuTambahkan Item Baru>. Untuk informasi selengkapnya, lihat referensi templat item .

Menggunakan templat dapat menghemat waktu yang signifikan saat memulai proyek atau membuat file. Ini juga merupakan cara yang bagus untuk mempelajari berbagai jenis aplikasi dan struktur kode. Sangat membantu untuk membutuhkan waktu beberapa menit untuk membuat proyek dan item dari berbagai templat untuk membiasakan diri dengan apa yang mereka tawarkan.

Menggunakan templat Cookiecutter

Visual Studio menyediakan integrasi langsung dengan Cookiecutter untuk membantu Anda menemukan templat, opsi templat input, dan membuat proyek dan file. Untuk informasi selengkapnya, lihat artikel Mulai Cepat: Membuat proyek dari templat Cookiecutter .