Berikut adalah draf artikel panduan manajemen proyek Python yang lebih terstruktur, profesional, dan mudah dipahami untuk referensi tim atau dokumentasi pribadi Anda.

Panduan Manajemen Proyek Python: Isolasi Lingkungan dengan venv & requirements.txt

Dalam pengembangan perangkat lunak menggunakan Python, menjaga "kebersihan" ruang kerja adalah standar praktik profesional. Mengandalkan pustaka (library) global sering kali memicu konflik versi antar proyek. Artikel ini akan membahas cara mengisolasi dependensi menggunakan Virtual Environment (venv) dan mengelola daftar pustaka melalui requirements.txt.

1. Virtual Environment (venv): Ruang Isolasi Mandiri

Virtual Environment adalah sebuah direktori terisolasi yang berisi instalasi Python versi spesifik dan beberapa paket tambahan. Tujuannya sederhana: memastikan pustaka di Proyek A tidak akan merusak fungsi di Proyek B.

Langkah-langkah Penggunaan

1. Membuat Environment:

   Buka terminal pada direktori proyek Anda, lalu jalankan:

   python -m venv .venv

2. Aktivasi (Masuk ke Lingkungan):

   Agar sistem menggunakan Python dari dalam folder isolasi, Anda perlu mengaktifkannya:

   • Windows (CMD): .venv\Scripts\activate

   • Windows (PowerShell): .\.venv\Scripts\Activate.ps1

   • macOS/Linux: source .venv/bin/activate

   • Ciri Berhasil: Muncul indikator (.venv) di depan baris perintah terminal.

3. Deaktivasi (Keluar):

   Jika sudah selesai, cukup ketik deactivate untuk kembali ke lingkungan sistem global.

2. Mengelola Dependensi dengan requirements.txt

File requirements.txt berfungsi sebagai manifest atau "daftar belanja" yang mencatat semua pustaka yang diperlukan agar aplikasi dapat berjalan di lingkungan lain dengan identik.

Cara Menginstal (Replikasi Proyek)

Jika Anda baru menyalin proyek atau bekerja dalam tim, instal semua kebutuhan sekaligus dengan:

pip install -r requirements.txt

Cara Membuat (Dokumentasi Proyek)

Setelah menginstal pustaka baru dan memastikan aplikasi berjalan lancar, simpan daftar tersebut agar orang lain bisa menjalankan kode Anda:

pip freeze > requirements.txt

3. Tabel Ringkasan Alur Kerja

4. Studi Kasus: Implementasi Multi-Environment

Dalam pengembangan sistem yang kompleks (seperti aplikasi deteksi wajah yang terhubung ke backend), seringkali kita memerlukan dua lingkungan berbeda untuk menjaga performa dan kompatibilitas. Berikut adalah contoh alur kerja pada direktori lokal:

A. Lingkungan Face Detector

Fokus pada pemrosesan gambar yang memerlukan versi pustaka spesifik (contoh: NumPy).

cd d:\laragon\www\cctvabsen\face_detectorpython -m venv venv_detector.\venv_detector\Scripts\activatepip install -r requirements.txtpip install "numpy<2"deactivate

B. Lingkungan Backend

Fokus pada manajemen data dan API.

cd d:\laragon\www\cctvabsen\backendpython -m venv venv_backend.\venv_backend\Scripts\activatepip install -r requirements.txtdeactivate

Catatan Penting: Selalu pastikan Anda berada di direktori yang tepat sebelum membuat virtual environment agar struktur folder proyek tetap rapi dan mudah dikelola.

Untuk mengotomatiskan aktivasi virtual environment saat berpindah folder di terminal VS Code, cara yang paling elegan adalah menggunakan fitur Terminal Profiles atau memanfaatkan Environment Variables melalui file konfigurasi lokal.

Berikut adalah dua metode yang bisa kamu gunakan:

Metode 1: Menggunakan Workspace Settings (Paling Direkomendasikan)

VS Code memungkinkan kita mengatur pengaturan spesifik per folder. Kita bisa memanfaatkan "Python Interpreter" setting agar setiap kali terminal dibuka, venv yang sesuai langsung aktif.

1. Buka folder utama project kamu di VS Code.

2. Tekan Ctrl + Shift + P, ketik "Preferences: Open Workspace Settings (JSON)".

3. Masukkan konfigurasi berikut:

{
    "python.terminal.activateEnvInCurrentTerminal": true,
    "python.defaultInterpreterPath": "${workspaceFolder}/face_detector/venv_detector/Scripts/python.exe",
    "files.exclude": {
        "**/venv_detector": true,
        "**/venv_backend": true
    }
}

Namun, karena kamu ingin venv yang berbeda untuk tiap subfolder, cara terbaik adalah membuka masing-masing subfolder tersebut sebagai Multiple Root Workspaces (File > Add Folder to Workspace).