Belajar Flask - Pre-Requisites Skill & Setup Environment

#Pendahuluan

Selamat datang di series Belajar Flask! Series ini akan membawa kalian menguasai Flask — micro-framework web Python yang minimalis, berbasis WSGI di atas Werkzeug dan Jinja2 — untuk membangun web app, REST API, dan internal tooling dengan fleksibilitas penuh. Total ada 27 episode yang tersusun dalam enam fase, dari fondasi konsep sampai production readiness.

Sebelum menjalankan flask --app app run, ada skill dasar dan perangkat yang wajib kalian siapkan. Mengapa prasyarat ini penting? Karena Flask sengaja tidak opinionated: ia hanya menyediakan inti routing dan templating, lalu menyerahkan pilihan database, autentikasi, dan ORM kepada kalian. Artinya, kalian harus nyaman dengan Python dan HTTP untuk mengambil keputusan itu sendiri — itulah harga dari fleksibilitas.

Episode 0 ini adalah peta jalan kalian: kita akan memastikan skill dasar terpenuhi, menyiapkan Python dan virtual environment, menginstall Flask 3.1.x, lalu memverifikasi environment untuk pertama kali. Setelah episode ini selesai, seluruh series bisa diikuti dengan nyaman.

#Skill Dasar yang Wajib Dimiliki

#Python: Decorator, Context Manager, dan Typing

Flask adalah framework Python murni, dan sintaks yang paling sering kalian lihat adalah decorator — dari @app.route() sampai @login_required dan @app.errorhandler(). Kalian wajib memahami bahwa decorator adalah fungsi yang membungkus fungsi lain:

Decorator dasar ala Flask

def route(path: str) -> callable:
    def wrapper(func: callable) -> callable:
        func.route_path = path
        return func
    return wrapper
 
 
@route("/")
def home() -> str:
    return "Halo Flask"

@route("/") di atas sama artinya dengan home = route("/")(home). Flask memakai pola ini untuk mendaftarkan handler ke URL tertentu — kita bedah penuh di episode 4.

Selain decorator, kenali context manager (with ... as ...) karena banyak operasi Flask — database session, file upload, sampai request context — memakai pola ini. Dan biasakan type hints sejak sekarang; akan sangat membantu saat membaca kode framework dan saat debugging.

#Dasar HTTP dan JSON

Flask membuat web app dan API, jadi kalian wajib paham HTTP methods (GET, POST, PUT, DELETE), status codes (200, 201, 404, 401, 500), serta struktur request dan response. Satu hal yang membedakan Flask dari framework monolitik: HTTP semantics dikendalikan lewat fungsi Python, bukan lewat konfigurasi string.

Seluruh API di series ini berbasis JSON. Kalian wajib paham struktur JSON — object, array, string, number, boolean, null — karena kalian akan memakai request.get_json() dan jsonify() sejak episode 4.

#Venv dan Package Management

Flask diinstall sebagai package Python biasa. Kalian wajib nyaman dengan virtual environment dan setidaknya salah satu dari pip, venv, atau uv — karena setiap proyek Flask butuh isolasi dependensi agar tidak saling rusak.

#Perangkat Software yang Disiapkan

#Python 3.9+ (Rekomendasi 3.12/3.13)

Flask 3.1.x membutuhkan Python 3.9 ke atas, dan di 2026 rekomendasi adalah 3.12 atau 3.13. Periksa versi kalian:

python3 --version

Jika masih di bawah 3.9, install versi terbaru lewat package manager atau uv:

curl -LsSf https://astral.sh/uv/install.sh | sh
uv python install 3.13

#Virtual Environment: venv atau uv

Selalu isolasi dependensi proyek. Dua opsi: venv bawaan Python, atau uv — manajer paket modern yang jauh lebih cepat:

python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip

uv init flask-lab
cd flask-lab
uv python pin 3.13

Kunci pemisahannya: virtual environment menjaga dependensi tiap proyek tetap terpisah, sehingga upgrade package di satu proyek tidak merusak proyek lain. Sepanjang series ini kita bekerja di dalam environment aktif.

#Flask 3.1.x

Install Flask — versi 3.1.3 adalah rilis stabil terbaru (19 Februari 2026):

pip install "flask>=3.1,<3.2"

Flask akan membawa serta Werkzeug (WSGI toolkit), Jinja2 (templating), itsdangerous (signing), dan click (CLI) sebagai dependensi otomatis. Kalian tidak perlu menginstallnya manual — cukup Flask, sisanya ikut.

#Editor dan Alat Pendukung

Flask sangat diuntungkan editor dengan IntelliSense Python. VS Code dengan ekstensi Python atau PyCharm keduanya bagus. Aktifkan juga linter dan type checker sejak awal untuk menjaga kualitas kode:

pip install ruff mypy

#Database (Opsional untuk Sekarang)

Untuk episode 10 ke atas, siapkan SQLite (tanpa server, cocok untuk lab) atau PostgreSQL untuk produksi. Kalian belum perlu menginstall sekarang — episode 10 akan menuntun langkah demi langkah.

#Struktur Proyek Lab yang Disarankan

Agar contoh di series ini langsung bisa dijalankan, susun proyek dengan struktur sederhana:

flask-lab/
  .venv/
  app.py
  requirements.txt

Catat versi dependensi ke requirements.txt supaya reproducible:

pip freeze > requirements.txt

#Verifikasi Environment

Sebelum lanjut ke episode 1, jalankan verifikasi menyeluruh:

python --version
pip show flask | head -2
python -c "import flask; print(flask.__version__)"
python -c "import jinja2, werkzeug; print(jinja2.__version__, werkzeug.__version__)"

python --version harus menampilkan 3.9+ (idealnya 3.12/3.13), flask.__version__ harus menampilkan 3.1.x, dan Werkzeug 3.1+. Jika ada yang gagal, periksa kembali virtual environment aktif dan instalasi paket.

#Ringkasan Prasyarat

Rangkuman yang sudah kalian siapkan di episode 0:

• Skill: Python tingkat menengah (decorator, context manager, typing), HTTP & REST dasar, dan JSON.
• Runtime: Python 3.9+ (rekomendasi 3.13), virtual environment aktif dengan venv/uv.
• Tool: Flask 3.1.x terinstall beserta Werkzeug/Jinja2, editor + ruff/mypy.
• Struktur: proyek flask-lab/ dengan app.py dan requirements.txt.
• Verifikasi: flask.__version__ menampilkan 3.1.x tanpa error.

Jika ada yang belum terpenuhi, berhenti dulu dan lengkapi sebelum melanjutkan. Perjalanan 26 episode ke depan akan jauh lebih lancar dengan pijakan yang kuat ini.

#Penutup

Inti yang harus dibawa pulang:

• Flask memakai decorator, HTTP, dan JSON sebagai bahasa utama — kuasai ketiganya.
• Gunakan Python 3.9+ (idealnya 3.12/3.13) di dalam virtual environment.
• Install flask>=3.1,<3.2 — Werkzeug dan Jinja2 ikut terinstall otomatis.
• Verifikasi environment dengan mencetak versi dari dalam Python.

Di episode 1 selanjutnya kita akan membahas sejarah, latar belakang, dan mengapa kalian membutuhkan Flask — dari lahirnya sebagai lelucon April Fools "Pocoo" karya Armin Ronacher pada 2010, filosofi micro-framework di atas Werkzeug + Jinja2, hingga posisinya di 2026 sebagai pilihan stabil untuk API dan small apps. Pastikan environment kalian sudah siap, karena perjalanan Belajar Flask baru saja dimulai!