Untuk menginstal proyek Python lokal dalam mode editable di macOS, buka Terminal, navigasikan ke direktori proyek, buat dan aktifkan lingkungan virtual, lalu jalankan python -m pip install -e .. Ini akan menautkan proses impor Python ke struktur pohon sumber kerja Anda, sehingga perubahan pada berkas Python langsung tersedia dalam sesi interpreter baru tanpa perlu menginstal ulang. Proyek tetap membutuhkan metadata pengemasan, dan perilaku editable yang pasti bergantung pada build backend yang digunakan.

Apa yang dilakukan penginstalan editable

Penginstalan reguler menempatkan proyek ke dalam lingkungan Python yang dipilih sebagai paket terinstal. Sebaliknya, penginstalan editable membuat kode sumber di direktori pengembangan tersedia di jalur impor Python. Ini berguna saat Anda mengubah proyek tersebut secara lokal; ini bukan berarti setiap berkas proyek atau sumber daya non-Python secara otomatis ditangani dengan cara yang sama. Panduan penginstalan proyek lokal pip

Mode editable juga tidak menghilangkan perubahan dependensi. pip menginstal dependensi yang dideklarasikan oleh proyek dengan cara biasa, kecuali jika Anda menyertakan argumen --no-deps. Perubahan pada kode sumber Python umumnya langsung terlihat pada eksekusi berikutnya, tetapi perubahan pada metadata proyek, skrip baris perintah yang dihasilkan, atau kode terkompilasi dapat memerlukan penginstalan ulang atau pembuatan ulang (rebuilding). Panduan Pengguna Pengemasan Python: Mengemas dan mendistribusikan proyek

Menyiapkan lingkungan virtual di macOS

Di Terminal, beralihlah ke folder root proyek, yaitu direktori yang berisi pyproject.toml atau berkas warisan setup.py yang didukung. Perintah cd di bawah mengasumsikan folder tersebut berada di direktori home Anda; berikan tanda kutip pada jalur jika mengandung spasi.

cd "$HOME/path/to/my-project"
python3 --version
python3 -m venv .venv
source .venv/bin/activate
python -m pip --version

Lingkungan virtual menjaga agar paket terinstal milik proyek ini terpisah dari lingkungan Python lainnya. Setelah aktivasi, python akan merujuk ke interpreter lingkungan tersebut, sehingga penggunaan python -m pip mengikat pip ke interpreter itu. Dokumentasi Python menjelaskan bahwa venv membuat lingkungan yang terisolasi dan mendokumentasikan perintah aktivasi untuk POSIX shell, termasuk shell yang digunakan secara default pada konfigurasi Terminal macOS saat ini. Dokumentasi Python: venv

Jika python3 tidak ditemukan, instal atau cari interpreter Python 3 terlebih dahulu; macOS tidak menjamin tersedianya Python yang siap untuk pengembangan di bawah perintah tersebut. Jika proyek menentukan versi Python yang didukung, gunakan versi tersebut untuk membuat .venv. Hindari menginstal paket ke dalam Python yang dikelola sistem jika lingkungan proyek sudah mencukupi.

Menginstal proyek dalam mode editable

Dengan lingkungan yang aktif dan Terminal masih berada di root proyek, jalankan:

python -m pip install -e .

Di sini, -e berarti editable dan . berarti direktori saat ini. pip mengasumsikan bahwa direktori proyek lokal berisi pyproject.toml atau setup.py. Proyek modern biasanya mendeklarasikan build backend di pyproject.toml; pip meminta backend tersebut untuk melakukan penginstalan editable. Backend harus mendukung antarmuka editable-install agar ini berfungsi sebagaimana mestinya. Referensi pip install, Antarmuka build system pip

Untuk menginstal dari direktori yang berbeda, berikan jalurnya alih-alih ., misalnya python -m pip install -e "$HOME/path/to/my-project". Memberikan tanda kutip pada jalur akan mengamankan spasi dan karakter khusus shell. Penginstalan berlaku untuk lingkungan Python yang terkait dengan perintah python yang Anda gunakan.

Mengonfirmasi lingkungan dan mendiagnosis kesalahan

Periksa tampilan proyek terinstal di pip untuk memastikan bahwa paket tersebut beserta lokasi proyek editable-nya tercantum:

python -m pip list

Kemudian jalankan Python dari lingkungan yang telah diaktifkan dan coba impor paket menggunakan nama impor yang terdokumentasi. Nama impor dapat berbeda dari nama distribusi proyek, jadi lihat README proyek atau direktori paket daripada menebak-nebak. Jika impor hanya berfungsi dari satu folder, periksa apakah penginstalan mengarah ke root proyek yang dimaksud dan paket telah dikonfigurasi untuk penemuan (discovery) oleh backend-nya.

Jika pip menyatakan bahwa direktori tersebut tidak dapat diinstal, pastikan Anda berada di root yang benar dan direktori tersebut berisi pyproject.toml atau setup.py. Jika build backend menolak mode editable, perbarui atau konfigurasikan backend proyek sesuai dokumentasinya; tidak semua backend lama atau backend kustom mendukung penginstalan editable. Untuk proyek modern berbasis pyproject.toml, pip menggunakan kait (hook) editable PEP 660 milik backend tersebut. Antarmuka build system pip

Jika perubahan pada proyek menambahkan dependensi, entry points, atau mengubah metadata, jalankan kembali python -m pip install -e .. Untuk ekstensi yang terkompilasi, jalankan juga langkah-langkah build yang terdokumentasi pada proyek. pip mencatat bahwa penginstalan editable dan penginstalan reguler dapat berperilaku berbeda, jadi penginstalan editable ditujukan untuk pengembangan lokal; ini tidak menggantikan pengujian jalur penginstalan biasa sebelum mendistribusikan paket. Panduan penginstalan proyek lokal pip

Sumber