Lazy Import Python 3.15: Dampak dan Hal yang Perlu Diuji Tim Django

Perintah --help seharusnya bisa menampilkan bantuan tanpa harus memuat semua dependensi aplikasi. Namun, pada proyek Python yang besar, sekadar menjalankan perintah CLI kadang sudah memicu rangkaian impor panjang—termasuk modul yang baru dibutuhkan saat pengguna memilih fitur tertentu.

Python 3.15 memperkenalkan lazy import eksplisit: impor tertentu dapat ditunda sampai nama yang diimpor pertama kali digunakan. Fitur ini memberi tim kendali lebih baik atas kapan sebagian pekerjaan impor terjadi, tetapi bukan tombol ajaib untuk mempercepat seluruh aplikasi. Untuk tim Django, keputusan pentingnya adalah memilih jalur yang memang boleh ditunda, lalu mengukur dampaknya tanpa mengabaikan kompatibilitas framework.

Problem dan konteks: biaya impor yang dibayar terlalu awal

Impor Python normal bersifat eager: saat pernyataan import dieksekusi, Python memuat modul dan menjalankan kode tingkat modulnya. Ini bisa mencakup impor lanjutan, inisialisasi, atau efek samping lain. Pada CLI dengan beberapa subperintah, akibatnya pengguna dapat menunggu modul yang sebenarnya tidak diperlukan oleh perintah yang sedang dijalankan.

Lazy import mengubah waktu sebagian pekerjaan itu, bukan menghapusnya. Modul yang ditunda baru dimuat ketika nama yang diimpor pertama kali diakses. Karena itu, waktu mulai mungkin membaik sementara akses pertama ke fitur terkait menjadi lebih lambat. Jika modul tidak pernah digunakan selama proses berjalan, barulah biaya impornya mungkin tidak terjadi pada proses itu.

Python 3.15 dirilis pada 9 Oktober 2026 dan menyediakan lazy import sebagai fitur opt-in. Impor tetap eager secara default. Ada dua cara eksplisit untuk menundanya: memakai sintaks lazy import atau lazy from ... import ..., dan memakai variabel tingkat modul __lazy_modules__ untuk menandai impor reguler tertentu. Detail batasan sintaks dijelaskan dalam What’s New in Python 3.15, referensi bahasa, dan PEP 810.

Satu batas kompatibilitas perlu diperhatikan sejak awal: Python sebelum 3.15 tidak dapat mem-parsing sintaks lazy import. Jadi, jangan menaruh sintaks itu dalam modul yang harus dijalankan oleh interpreter lama. __lazy_modules__ menggunakan sintaks Python biasa dan diabaikan oleh versi lebih lama, sehingga pernyataan impor reguler tetap dapat dipakai sebagai fallback.

Walkthrough solusi: tunda hanya jalur yang tepat

1. Pilih modul yang memang tidak selalu dibutuhkan

Misalnya, sebuah utilitas CLI punya fitur ekspor CSV. Perintah --help dan subperintah lain tidak perlu memuat csv. Dengan Python 3.15, impor dapat dibuat lazy di tingkat modul:

# Python 3.15+
lazy import csv

def export_rows(rows, output_path):
    with open(output_path, "w", newline="", encoding="utf-8") as output_file:
        writer = csv.writer(output_file)
        writer.writerows(rows)

csv baru dimuat saat csv.writer pertama kali diakses. Fungsi itu sendiri boleh berada dalam blok fungsi; yang dibatasi adalah pernyataan impor lazy, yang harus berada di tingkat modul. Sintaks tersebut tidak berlaku di dalam fungsi, badan kelas, atau blok try, except, maupun finally. Impor bintang (from module import *) dan impor __future__ juga tidak bisa dibuat lazy.

Contoh berikut menunda impor nama Path dari pathlib:

# Python 3.15+
lazy from pathlib import Path

def output_path_for(filename):
    return Path("exports") / filename

Nama yang diimpor tetap bisa digunakan seperti biasa. Yang berubah adalah pemuatan modul: Python menundanya sampai Path pertama kali diakses. Lazy import juga tidak otomatis membuat semua dependensi yang diimpor oleh modul tersebut menjadi lazy. Modul yang ditunda dapat menjalankan impor eager-nya sendiri ketika akhirnya dimuat.

2. Gunakan `__lazy_modules__` bila perlu mempertahankan sintaks biasa

Jika satu berkas harus tetap bisa dibaca interpreter sebelum Python 3.15, hindari sintaks baru di berkas itu. Sebagai gantinya, versi 3.15 dapat diberi daftar modul yang impornya ingin ditunda:

# Sintaks ini kompatibel dengan Python sebelum 3.15.
# Efek lazy hanya berlaku saat dijalankan dengan Python 3.15.
__lazy_modules__ = {"csv", "pathlib"}

import csv
from pathlib import Path

def export_rows(rows, output_path):
    with open(output_path, "w", newline="", encoding="utf-8") as output_file:
        writer = csv.writer(output_file)
        writer.writerows(rows)

def output_path_for(filename):
    return Path("exports") / filename

Letakkan __lazy_modules__ sebelum impor yang ingin dipengaruhinya. Pada Python 3.15, impor reguler untuk modul yang terdaftar dapat ditunda. Pada versi lebih lama, variabel itu diabaikan dan impor reguler berperilaku seperti biasa—tetap eager. Pastikan pendekatan ini sesuai dengan pola impor dan kebutuhan kompatibilitas proyek sebelum menerapkannya secara luas.

3. Terapkan pada jalur CLI opsional, bukan seluruh aplikasi

Penerapan yang lebih aman biasanya dimulai dari modul yang hanya diperlukan oleh subperintah tertentu: misalnya ekspor, inspeksi, integrasi opsional, atau generator laporan. Jangan langsung menunda seluruh impor aplikasi. Pertahankan eager import untuk dependensi yang dibutuhkan saat startup, yang efek sampingnya memang harus berjalan saat impor, atau yang diperlukan untuk menangani jalur kesalahan dengan benar.

Untuk contoh perintah yang hanya memakai sintaks impor reguler, ukur waktu mulai sebelum dan sesudah perubahan:

python -X importtime -m myapp.cli --help

Opsi -X importtime membantu menunjukkan biaya impor selama proses berjalan. Rujuk dokumentasi opsi baris perintah Python untuk detailnya. Bandingkan hasil pada lingkungan dan versi Python yang sama, dan jalankan juga perintah yang benar-benar memakai fitur yang ditunda. Pengukuran --help saja tidak menunjukkan biaya yang dipindahkan ke akses pertama.

Saat menafsirkan hasil, pisahkan setidaknya dua hal:

Waktu startup: apakah perintah yang tidak memerlukan modul tertentu selesai lebih cepat?
Latensi akses pertama: berapa tambahan waktu ketika pengguna pertama kali menjalankan fitur yang memakai modul tertunda?

Ulangi pengukuran dan catat kondisi pengujian. Jangan menyimpulkan manfaat hanya dari satu kali eksekusi atau menganggap selisih kecil sebagai percepatan yang pasti terasa bagi pengguna.

4. Uji kegagalan impor dan efek samping

Impor eager yang gagal biasanya menggagalkan proses saat pernyataan impor dijalankan. Dengan impor lazy, kegagalan itu dapat muncul saat nama yang ditunda pertama kali diakses—mungkin jauh setelah aplikasi mulai, atau hanya pada subperintah tertentu. Tes jalur pengguna yang menggunakan modul tersebut, termasuk kondisi dependensi tidak tersedia, agar lokasi dan penanganan error tetap masuk akal.

Tinjau juga efek samping tingkat modul. Jika inisialisasi, pendaftaran handler, konfigurasi logging, atau penyiapan lain sebelumnya terjadi sebagai efek dari impor, penundaan dapat mengubah kapan efek itu terjadi. Pastikan tidak ada kode yang bergantung pada efek samping tersebut sebelum akses pertama.

5. Periksa dukungan Django sebelum memilih versi Python

Django 6.1 mencantumkan dukungan untuk Python 3.12, 3.13, dan 3.14—bukan Python 3.15. Karena itu, jangan merekomendasikan Python 3.15 untuk produksi dengan Django 6.1 hanya berdasarkan adanya fitur lazy import. Periksa catatan rilis Django 6.1 dan pengumuman rilisnya sebelum menentukan kombinasi versi. Pertimbangkan Python 3.15 untuk utilitas mandiri yang tidak bergantung pada dukungan framework tersebut, atau evaluasi kembali setelah Django secara resmi menambahkan dukungan.

Trade-off yang perlu dipertimbangkan

Lazy import membantu ketika biaya impor tertentu tidak perlu dibayar pada jalur startup yang umum. Namun, manfaatnya bergantung pada pola penggunaan:

Startup dapat lebih ringan, tetapi akses pertama dapat melambat. Total pekerjaan impor tidak otomatis berkurang; waktunya bisa berpindah.
Error dapat muncul lebih lambat. Dependensi yang hilang mungkin baru terdeteksi ketika fitur terkait digunakan.
Efek samping terjadi pada waktu berbeda. Periksa asumsi tentang registrasi dan inisialisasi saat impor.
Tidak semua impor cocok ditunda. Modul yang selalu diperlukan saat startup mungkin hanya memindahkan latensi tanpa memberi keuntungan berarti.
Kompatibilitas versi perlu dirancang. Sintaks lazy import tidak dapat dipakai pada interpreter sebelum Python 3.15. __lazy_modules__ menjaga sintaks impor tetap biasa, tetapi perilaku lazy hanya ada pada 3.15.
Dukungan framework tetap menentukan. Fitur bahasa baru tidak menggantikan matriks dukungan resmi Django maupun pustaka lain di aplikasi.

Karena itu, hindari klaim bahwa lazy import pasti mempercepat aplikasi. Ukur jalur startup dan jalur fitur yang ditunda, uji error dan efek samping, lalu putuskan berdasarkan dampak yang benar-benar terlihat.

Kesimpulan: ukur, batasi, dan uji

Lazy import Python 3.15 memberi cara eksplisit untuk menunda impor pilihan sampai nama yang diimpor diakses. Untuk tim Django, titik awal yang masuk akal adalah jalur CLI atau tooling mandiri dengan dependensi opsional—bukan mengubah seluruh aplikasi, dan bukan mengabaikan dukungan versi framework.

Mulailah dari satu modul yang jelas tidak diperlukan oleh jalur umum. Bandingkan waktu startup dan latensi akses pertamanya, uji perilaku ketika impor gagal, serta pastikan efek samping tetap terjadi pada waktu yang benar. Sebelum memakai Python 3.15 bersama Django, cek kembali matriks dukungan resmi yang berlaku.

Sudah mengidentifikasi impor mahal di CLI proyekmu? Ukur dengan -X importtime, coba tunda satu jalur opsional, lalu bagikan hasil sebelum menerapkannya lebih luas.

Sumber

Sources checked October 11, 2026.