Di tulisan django kemarin setidaknya sudah tiga hal yang bisa kita mulai membuat aplikasi berbasis django, di tulisan ini saya akan rekap ke 3 tulisan tadi, hingga di akhir tulisan kita akan membuat satu buah aplikasi web, tulisan ini akan berfokus di:
- Install django
- Setup django project
- Create django app
- Mode dan Migration
Note: Salah satu rekomendasi dalam membuat aplikasi python adalah menggunakan virtual env, tapi kita bahas itu nanti, fokus di seri ini lebih ke membuat aplikasi django. Salah satu rekomendasi saya menggunakan pipenv
Di rekap kali ini kita akan membuat sebuah cms untuk blog, di mana hasil akhirnya nanti kita punya satu cms untuk mengelola blog sendiri.
Install django
Untuk instal django itu seperti memasang package python lainnya menggunakan pip
pip install django
Setup django project
Kita bisa langsung membuat django project ketika sudah memasang django dengan cara
django-admin startproject cms
atau jika seperti saya sudah menyiapakan satu folder kosong untuk menampung projek django maka seperti ini
mkdir projek-django cd projek-django django-admin startproject cms .
isi dari projek kita akan sebagai berikut
├── cms │ ├── asgi.py │ ├── __init__.py │ ├── settings.py │ ├── urls.py │ └── wsgi.py ├── manage.py
Running django project
Untuk menjalankan kita kan menggunakan django command yaitu runserver, jalankan perintah ini
python manage.py runserver
Fungsi di atas ini menjalankan project django di port 8000 secara default, ingat fungsi di atas hanya dijalankan di mode development saja tidak rekomendasi dijalankan di mode prodcutions.
Saat kita akses di browser maka akan terlihat
Setelah menjalankan perintah di atas di terminal akan melihat seperti ini
Jangan takut atau khawatir dengan warning tersebut, warning di sana memberitahu bahawa kita belum memasang tabel-tabel default django yang berguna.
Note: Seperti di tulisan awal django datang dengan banyak fitur bawaan seperti auth, acl, admin dashboard dll. Warning di atas adalah kebutuhan untuk prasyarat fitur-fitur yang tadi disebut. Secara default django akan menggunakan database sqlite, untuk development kita akan menggunakan sqlite juga
Untuk menghilangkan warning itu cukup ketikan
python manage.py migrate
Create django app
Mari buat blog, kita buat blog menggunakan django. Oleh karena itu mari kita buat rencananya lebih dulu:
- Kita akan membuat blog, oleh karena kita buat app namanya blog
- Dalam blog nanti kita akan memiliki model
- Category
- Tags
- Content
Untuk membuat app kita gunakan perintah
python manage.py startapp blog
Perintah di atas akan menghasilkan satu folder app blog, sehingga sekarang folder kita strukturnya seperti ini
├── blog │ ├── admin.py │ ├── apps.py │ ├── __init__.py │ ├── migrations │ │ └── __init__.py │ ├── models.py │ ├── tests.py │ └── views.py ├── cms │ ├── asgi.py │ ├── __init__.py │ ├── settings.py │ ├── urls.py │ └── wsgi.py ├── db.sqlite3 ├── manage.py
Mari membuat kebutuhan blog dengan membuat model yang nantinya akan menjadi tabel, buat model seperti ini
from django.db import models
# Create your models here.
class Category(models.Model):
name = models.CharField(max_length=50)
slug = models.CharField(max_length=100, null=True)
date_created = models.DateTimeField(auto_now_add=True)
date_updated = models.DateTimeField(auto_now=True)
def __str__(self):
return self.name
class Tags(models.Model):
name = models.CharField(max_length=50)
slug = models.CharField(max_length=100, null=True)
date_created = models.DateTimeField(auto_now_add=True)
date_updated = models.DateTimeField(auto_now=True)
def __str__(self):
return self.name
class Content(models.Model):
title = models.CharField(max_length=100)
slug = models.CharField(max_length=200, null=True)
category = models.ForeignKey(
Category, related_name="content", on_delete=models.CASCADE
)
tags = models.ManyToManyField(Tags, related_name="content")
body = models.TextField()
publish = models.BooleanField(default=False)
date_created = models.DateTimeField(auto_now_add=True)
date_updated = models.DateTimeField(auto_now=True)
def __str__(self):
return self.title
Daftarkan app blog kita di settings, buka berkas “cms/settings.py” lalu tambahkan blog di list instaled_apps
INSTALLED_APPS = [
#default django app
"django.contrib.admin",
"django.contrib.auth",
"django.contrib.contenttypes",
"django.contrib.sessions",
"django.contrib.messages",
"django.contrib.staticfiles",
#our app
"blog",
]
Lalu buat migration untuk app blog kita
python manage.py makemigrations blog
Saat menjalankan perintah itu maka akan muncul di terminal model mana saja yang dibuatkan migration filenya
Migrations for 'blog':
blog/migrations/0001_initial.py
- Create model Category
- Create model Tags
- Create model Content
lalu kita tengok berkas migration yang dibuat, lokasinya ada di folder migrations di app blog
# Generated by Django 3.2.9 on 2021-12-14 14:06
from django.db import migrations, models
import django.db.models.deletion
class Migration(migrations.Migration):
initial = True
dependencies = [
]
operations = [
migrations.CreateModel(
name='Category',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('name', models.CharField(max_length=50)),
('slug', models.CharField(max_length=100, null=True)),
('date_created', models.DateTimeField(auto_now_add=True)),
('date_updated', models.DateTimeField(auto_now=True)),
],
),
migrations.CreateModel(
name='Tags',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('name', models.CharField(max_length=50)),
('slug', models.CharField(max_length=100, null=True)),
('date_created', models.DateTimeField(auto_now_add=True)),
('date_updated', models.DateTimeField(auto_now=True)),
],
),
migrations.CreateModel(
name='Content',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('title', models.CharField(max_length=100)),
('slug', models.CharField(max_length=200, null=True)),
('body', models.TextField()),
('publish', models.BooleanField(default=False)),
('date_created', models.DateTimeField(auto_now_add=True)),
('date_updated', models.DateTimeField(auto_now=True)),
('category', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='content', to='blog.category')),
('tags', models.ManyToManyField(related_name='content', to='blog.Tags')),
],
),
]
Itu adalah “default” kita membuat model, tapi kadangkala kita ingin saat migration itu kita juga import initial data, mari kita buat migration untuk initial datanya
python manage.py makemigrations --empty blog
perhatikan parameter –empty di sana, di sana mengartikan bahwa kita akan membuat satu file migration tapi tanpa mengubah atau menambah struktur sebuah tabel, kalau kita lihat di berkas migration “kedua” (di komputer saya migration kedua ada dengan nama 0002_auto_20211214_1414.py) isinya hanya seperti berikut
# Generated by Django 3.2.9 on 2021-12-14 14:14
from django.db import migrations
class Migration(migrations.Migration):
dependencies = [
('blog', '0001_initial'),
]
operations = [
]
Sepi bukan? hanya ada “dependencies” yang maksudnya sebelum running migration yang ini akan menjalankan atau memastikan si initial itu udah ada, dan ada “operations”.
Untuk initialnya kita bisa menggunakan orm django (untuk orm kita bahas terpisah), mari ubah migration ini jadi seperti ini
# Generated by Django 3.2.9 on 2021-12-14 14:14
from django.db import migrations
def default_data_for_category(apps, schema_editor):
# We can't import the model directly as it may be a newer
# version than this migration expects. We use the historical version.
Category = apps.get_model("blog", "Category")
data = [
{"name": "Default", "slug": "default"},
{"name": "Daily", "slug": "daily"},
{"name": "Tech", "slug": "tech"},
]
for d in data:
c = Category(**d)
c.save()
class Migration(migrations.Migration):
dependencies = [("blog", "0001_initial")]
operations = [migrations.RunPython(default_data_for_category)]
Untuk menjalankannya
python manage.py migrate blog
hasilnya akan muncul informasi berikut
Applying blog.0001_initial... OK Applying blog.0002_auto_20211214_1414... OK
Mari kita lihat di database, apakah benar tabelnya terbentuk dan data initialnya ikut terpasang.
dan datanya
Oke setup selesai, di tulisan berikutnya akan berfokus di bagian yang menurut saya menyenangkan: Orm, Admin, dan Forms. Sampai jumpa.