FQSoft - Tutorial Install Django di Windows

Install Python

Download disini. sesuaikan dengan sistem operasi yang digunakan. untuk memastikan bahwa python sudah terinstall jalankan perintah ini di cmd

py --version

Membuat Virtual Environment

Setiap project python akan dibungkus didalam Virtual Environment sehingga saat kita ada project baru dengan versi python yang terbaru tidak menganggu project lain yang mengggunakan python versi lama.

Pada tutorial ini kita akan membuat virtual environment dengan nama "belajar". Jalankan perintah dibawah ini pada direktori project yang akan kita buat

py -m venv belajar

Pada perintah diatas akan menghasilkan direktori dan file sebagai berikut:

belajar
  Include
  Lib
  Scripts
  pyvenv.cfg

Selanjutnya kita akan mengaktifkan virtual environment, dengan menjalankan file activate.bat yang terletak di direktori belajar\Script dibawah ini :

belajar\Scripts\activate

Jika virtual environment berhasil diaktifkan maka akan muncul seperti dibawah ini

(belajar) C:\folder\dir_project>

Install Django

Untuk install package pada python, harus menggunakan pip. untuk mengenalnya bisa kunjungi laman ini. Selanjutnya jalankan perintah di bawah ini:

(belajar) C:\folder\dir_project>py -m pip install Django

Untuk cek versi django. jalankan perintah ini :

(belajar) C:\folder\dir_project>django-admin --version

Membuat Project

Pada tutorial ini kita akan membuat project dengan nama "belajar_django". Untuk membuat project jalankan perintah dibawah ini :

django-admin startproject belajar_django

Jika berhasil maka akan muncul struktur direktori dan file seperti dibawah ini:

belajar_django/
    manage.py
    belajar_django/
        __init__.py
        asgi.py
        settings.py
        urls.py
        wsgi.py

Untuk mejalankan project django jalankan perintah di bawah ini pada direktori belajar_django yang pertama :

py manage.py runserver

Jika tidak ada kendala akan muncul di bawah ini :

Watching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).

You have 18 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions.
Run 'python manage.py migrate' to apply them.
October 27, 2022 - 13:03:14
Django version 4.1.2, using settings 'my_tennis_club.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CTRL-BREAK.

Jalankan pada browser dengan input address bar http://127.0.0.1:8000/. Jika berhasil maka akan muncul pesan "The Install Worked Successfully"

Install App

Mungkin ada yang bertanya apa perbedaan project dan app di python ? dalam terminologi yang umum hubungan project dan app sama dengan project dan modul. misal ada project bernama "Perpustakaan" maka modulnya / app-nya terdiri dari : Member, Buku, Peminjaman dst.

Namun untuk best practice-nya jika ada satu app/modul yang bisa menyelesaikan dua masalah maka lebih baik dipisahkan menjadi dua app. Tapi jika ada app/modul yang saling bergantung dan tidak bisa dipisah maka lebih baik dijadikan satu app.

Pada tutorial ini kita akan membuat app/modul members. Dan jalankan perintah di bawah ini :

py manage.py startapp members

Dan setiap app/modul memiliki struktur pendekatan MVC. Dimana file views.py adalah controller dan models.py sebagai model. lalu dimana file view-nya ? view pada django disebut templates. sehingga jika ingin membuat file view maka buat folder templates dan letakkan seluruh fil html pada folder tsb. contohnya bisa dilihat seperti di bawah ini :

belajar_django
    manage.py
    belajar_django/
    members/
        templates/
            myfirst.html

Integrasi Django dengan VS Code Untuk Running Server

Sebelum itu pastikan extension python sudah terinstall di VS Code

Pada side panel pilih Run and Debug
Klik link "create a launch.json file"
Lalu pilih Python
Selanjutnya pilih Django
Isi file launch json seperti di bawah ini

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python Debugger: Django",
            "type": "debugpy",
            "request": "launch",
            "program": "${workspaceFolder}\\manage.py",
            "args": [
                "runserver"
            ],
            "django": true,
            "justMyCode": true
        }
    ]
}

Selanjutnya untuk menjalankan server python tidak perlu menggunakan baris perintah. Cukup masuk menu Run and Debug dan klik tombol play. Untuk mematikan server klik tombol stop

Penutup

Untuk tutorial instalasi django sudah selesai. Selanjutnya kita akan melakukan setup app dan project pada tutorial selanjutnya.

Sebagai tambahan Django memiliki banyak package yang bisa digunakan. Untuk selengkapnya kunjungi webnya di https://djangopackages.org/

Terima kasih semoga bermanfaat...

Sumber :

Blog FQSoft

Tutorial Install Django di Windows