Konversi PY menjadi PYC

Lingkungan deployment mungkin memerlukan bytecode CPython, bukan file sumber, atau developer mungkin ingin membuat cache import untuk suatu proyek. Membuat file .pyc adalah langkah kompilasi lokal yang dilakukan oleh interpreter Python yang akan menjalankannya, bukan konversi dokumen umum.

Apa itu format PY

.py adalah file sumber Python teks biasa yang berisi pernyataan, fungsi, kelas, import, komentar, dan kode program lainnya. Developer membuat dan mengedit file PY di Visual Studio Code, PyCharm, IDLE, atau editor teks apa pun. CPython mengurai sumber tersebut dan mengompilasinya menjadi bytecode di memori sebelum eksekusi; modul yang diimpor juga dapat menuliskan bytecode tersebut ke file cache PYC.

Apa itu format PYC

.pyc adalah file bytecode biner yang dihasilkan oleh CPython. Header-nya berisi identifier bytecode interpreter dan informasi validitas cache; bagian lainnya berisi bytecode Python yang diserialisasi. CPython biasanya menyimpan file yang dihasilkan di __pycache__, menggunakan nama seperti module.cpython-312.pyc.

Cache dapat menghindari kompilasi ulang modul yang diimpor dan tidak berubah, tetapi cache bukan pengganti yang dapat dieksekusi untuk seluruh aplikasi dan tidak menyembunyikan kode sumber dengan aman. Bytecode dapat diperiksa atau didekompilasi, dan file PYC tetap terikat pada implementasi serta versi Python tertentu.

Cara membuat file PYC

Instal versi CPython resmi yang diperlukan oleh sistem target, lalu buka terminal di direktori yang berisi file sumber. Perintah python milik interpreter mungkin bernama python3 di beberapa sistem.

1. Kompilasi satu file sumber ke lokasi cache normal:
   python -m py_compile script.py
2. Kompilasi semua file Python dalam sebuah direktori, termasuk subdirektori:
   python -m compileall project_folder
3. Letakkan PYC yang dihasilkan di samping file sumber, bukan di __pycache__:
   python -m compileall -b script.py
4. Tentukan nama file output yang tepat dengan standard library:
   python -c "import py_compile; py_compile.compile('script.py', cfile='output/script.pyc')"

Direktori induk untuk path cfile harus sudah ada. Gunakan perintah yang sama dengan python3 jika itu adalah nama interpreter yang terinstal. Menjalankan skrip secara langsung biasanya mengompilasinya di memori; mengimpor modul biasanya yang membuat file cache-nya. IDE yang mendukung Python menggunakan interpreter yang telah dikonfigurasikan dan mungkin menghasilkan file PYC saat menjalankan atau mengimpor modul proyek.

Gunakan CPython lokal, bukan konverter online. Layanan web akan menerima kode sumber dan mungkin mengompilasinya dengan versi Python yang salah; tidak ada layanan konversi online serbaguna yang lebih sesuai untuk pekerjaan PY-ke-PYC biasa. IDE atau terminal desktop menyediakan kompilasi yang sama melalui interpreter lokal yang dipilih.

Kompatibilitas dan keterbatasan

PYC yang dibuat oleh CPython 3.12 umumnya tidak dapat digunakan oleh CPython 3.11, Python 2, atau implementasi Python yang berbeda. Lakukan kompilasi dengan versi mayor dan minor yang sama, dan sebaiknya implementasi yang sama, seperti yang digunakan di lingkungan deployment. CPython dapat mengabaikan dan membuat ulang cache ketika data timestamp-dan-ukuran atau data validitas berbasis hash tidak lagi cocok dengan sumbernya.

Kompilasi mendeteksi kesalahan sintaksis, tetapi tidak menguji perilaku program. Dependensi runtime, path import, fitur sistem operasi, konfigurasi, dan kesalahan runtime tetap belum terselesaikan. Paket yang diimpor tetap harus diinstal kecuali aplikasi dikemas secara terpisah. Untuk distribusi, gunakan wheel, virtual environment, executable bundle, atau container jika sesuai; file PYC yang terisolasi terutama merupakan cache interpreter atau artefak deployment khusus implementasi.