Belajar Python - Dependency Management & Reproducible Envs

#Pendahuluan

Di episode 7 kita mulai mencatat dependency. Episode 8 membawa pengelolaan itu ke level produksi: bagaimana memastikan project kalian berjalan identik di mesin mana pun, kapan memakai requirements.txt versus pyproject.toml, dan bagaimana mengunci versi dependency dengan lockfile.

Kita juga membahas alat modern seperti Poetry, Flit, dan pipx. Tujuannya satu: reproducible environments — fondasi penting sebelum kalian masuk ke deployment di episode 20.

#requirements.txt vs pyproject.toml

#Kapan Menggunakan requirements.txt

requirements.txt adalah daftar dependency sederhana yang sudah lama dipakai:

requests==2.32.3
fastapi>=0.110
uvicorn[standard]>=0.29

requirements.txt mudah dipahami dan sering dipakai untuk aplikasi yang bukan library. Format package==versi mengunci versi persis, sedangkan package>=versi memberi rentang. Instalasi dengan pip install -r requirements.txt.

#Keunggulan pyproject.toml

pyproject.toml lebih terstruktur dan menjadi standar untuk library modern:

[project]
name = "belajar-web"
version = "0.1.0"
requires-python = ">=3.12"
dependencies = [
    "fastapi>=0.110",
    "uvicorn[standard]>=0.29"
]
 
[project.optional-dependencies]
dev = ["pytest>=8.0", "ruff", "mypy"]

[project.optional-dependencies] memisahkan dependency pengembangan dari dependency runtime. Install dependency utama dengan pip install -e ., dan dependency dev dengan pip install -e ".[dev]". Ini lebih ekspresif daripada requirements.txt.

#Poetry dan Flit

#Poetry: Pengelola All-in-One

Poetry menggabungkan dependency management, virtual environment, dan packaging dalam satu alat:

pip install poetry
poetry new belajar_poetry
cd belajar_poetry
poetry add fastapi

poetry new belajar_poetry membuat project baru, dan poetry add fastapi menambah dependency sekaligus lockfile. Poetry membuat poetry.lock yang mengunci versi persis semua dependency — kunci reproducible environment.

#Flit: Packaging Ringan

Flit fokus pada kemudahan packaging library:

pip install flit
flit init
flit publish

flit init membuat pyproject.toml interaktif, dan flit publish membangun serta mengunggah package ke PyPI. Flit cocok untuk library sederhana yang butuh build cepat. Untuk aplikasi kompleks, Poetry atau pip-tools lebih fleksibel.

#Lockfiles dengan pip-tools

#Mengapa Perlu Lockfile

Lockfile mencatat versi persis semua dependency beserta turunannya, sehingga environment bisa direproduksi persis. pip-tools menyediakan dua alat: pip-compile untuk membuat lockfile dan pip-sync untuk memasangnya:

pip install pip-tools
pip-compile --output-file=requirements.lock pyproject.toml

pip-compile membaca dependency dari pyproject.toml dan menghasilkan requirements.lock berisi versi persis yang sudah di-resolve. Lockfile ini yang di-commit ke Git agar semua anggota tim memakai versi sama.

#Memasang dari Lockfile

Setelah lockfile ada, pasang persis versinya dengan pip-sync:

pip-sync requirements.lock

pip-sync requirements.lock menyamakan environment kalian persis dengan isi lockfile — menghapus package yang tidak ada di daftar dan memasang versi yang ditentukan. Ini menjamin konsistensi antara development, staging, dan production.

#pipx untuk CLI Tools

#Menginstall Tool dalam Isolasi

pipx menginstall tool CLI Python ke environment terisolasi agar tidak mencemari venv project:

pip install pipx
pipx install black
pipx install poetry
pipx install ruff

pipx install black memasang black ke environment khusus dan membuat perintahnya tersedia global. Berbeda dari pip install biasa, pipx mengisolasi tiap tool sehingga konflik dependency antar tool tidak terjadi.

#Manajemen Tool dengan pipx

pipx mendukung operasi penuh untuk mengelola tool:

pipx upgrade black
pipx list
pipx uninstall black

pipx list menampilkan semua tool yang terinstall, pipx upgrade black memperbarui tool tertentu, dan pipx uninstall black menghapusnya. Aturan praktis: tool CLI global dipasang dengan pipx, sedangkan library project dipasang di venv project.

#Best Practice Virtualenv

#Aturan Reproducible Environment

Beberapa praktik yang menjaga environment tetap reproducible:

• Selalu aktifkan venv sebelum bekerja.
• Commit lockfile, bukan hanya daftar dependency.
• Gunakan versi Python yang sama di semua mesin.
• Jangan pernah memakai sudo pip atau pip global.
• Perbarui dependency secara berkala, bukan menumpuk.

#Workflow Praktis

Workflow yang direkomendasikan per project:

python3 -m venv .venv
source .venv/bin/activate
pip install --upgrade pip
pip install -e ".[dev]"
pip-compile --output-file=requirements.lock
pip-sync requirements.lock

Urutan ini membangun venv, memasang dependency dev, lalu mengunci dan menyinkronkan versi. Jalankan pip-compile setiap kali ada dependency baru, dan commit lockfile-nya. Ini menjamin setiap anggota tim dan CI memakai environment yang identik.

#Penutup

Inti yang harus dibawa pulang:

• requirements.txt sederhana; pyproject.toml lebih terstruktur dan modern.
• Poetry mengelola dependency, venv, dan packaging sekaligus.
• Flit fokus pada kemudahan membangun dan mempublikasikan library.
• pip-tools membuat lockfile dengan pip-compile dan memasang dengan pip-sync.
• pipx menginstall CLI tool secara terisolasi.
• Commit lockfile untuk reproducible environment di semua mesin.

Di episode 9 selanjutnya kita akan membahas persistensi dan database — SQLAlchemy Core dan ORM, migrasi dengan Alembic, gambaran driver Redis dan MongoDB, serta pola connection pooling dan transaction. Project kalian mulai terhubung dengan data sungguhan!