Penyiapan lingkungan

Seluruh latihan pada jalur ini menuntut Python versi 3.12 ke atas yang terpasang dengan benar. Topik ini membahas pemasangan Python, pengenalan pip dan PyPI, pemilihan editor, serta perkenalan virtual environment. Setelah langkah-langkahnya dijalankan, lingkungan kerja siap dipakai untuk menulis, menjalankan, dan mengelola program Python secara teratur.

Memasang Python#

Unduh installer Python dari halaman resmi python.org/downloads . Installer tersedia untuk Windows dan macOS, sedangkan sebagian besar distribusi Linux sudah membawa Python atau menyediakannya melalui pengelola paket bawaan seperti apt atau dnf. Pilih versi stabil terbaru pada seri 3.12 atau lebih baru agar seluruh fitur yang dipakai sepanjang jalur ini tersedia.

Pada Windows, proses pemasangan memiliki satu opsi yang menentukan kelancaran langkah selanjutnya. Opsi tersebut perlu dicentang pada layar pertama installer sebelum tombol Install Now ditekan.

Nama perintah Python sedikit berbeda antarsistem. Di Linux dan macOS, perintahnya python3, karena nama python pada sistem lama sering menunjuk Python 2. Di Windows, perintah yang tersedia adalah python atau py, yaitu py launcher yang otomatis memilih Python 3. Setelah pemasangan selesai, versinya diperiksa dengan perintah berikut.

# memeriksa versi Python yang terpasang
python3 --version

Python 3.12.16

Bila nomor versi tampil, pemasangan berhasil. Pemeriksaan yang lebih lengkap dilakukan dengan skrip kecil berikut. Skrip ini menampilkan implementasi interpreter, versi lengkapnya, dan ketersediaan fitur match/case yang dipakai pada jalur ini, yaitu fitur yang diperkenalkan pada Python 3.10.

import platform
import sys

print(platform.python_implementation(), platform.python_version())
print("Fitur match/case tersedia:", sys.version_info >= (3, 10))

CPython 3.12.16
Fitur match/case tersedia: True

Simpan berkas tersebut sebagai cek_lingkungan.py, lalu jalankan dari terminal.

# menjalankan skrip pemeriksaan lingkungan
python3 cek_lingkungan.py

CPython 3.12.16
Fitur match/case tersedia: True

platform.python_implementation() menampilkan CPython, yaitu implementasi acuan Python. Pernyataan sys.version_info >= (3, 10) membandingkan versi interpreter dengan pasangan angka yang menyatakan versi minimal, dan hasilnya bernilai True karena versi terpasang lebih baru. Bila keluaran serupa ini tampil, pemasangan sudah memadai untuk seluruh latihan jalur ini.

Pengenalan pip#

pip adalah pengelola package resmi Python. Package adalah kumpulan kode siap pakai yang dipublikasikan agar dapat dipasang dan dipanggil dari program lain, misalnya pustaka pengolah data atau pustaka akses web. Sumber package terbesar adalah PyPI (Python Package Index), repositori daring yang memuat ratusan ribu package dari komunitas. Package dipasang dengan pola perintah python3 -m pip install nama_package, dan prosesnya mengunduh berkas dari PyPI sehingga memerlukan koneksi internet.

Bentuk python3 -m pip dipilih secara sengaja, bukan pip yang ditulis langsung. Pada komputer dengan lebih dari satu interpreter, perintah pip yang berdiri sendiri tidak selalu milik interpreter yang sama dengan yang menjalankan program. Bentuk python3 -m pip menjamin pip yang dijalankan adalah milik python3, sehingga package terpasang pada interpreter yang benar.

Identitas pip sendiri dapat diperiksa dengan opsi --version.

# memeriksa versi pip milik python3
python3 -m pip --version

pip 26.2.2 from /home/kal/.venv/lib/python3.12/site-packages/pip (python 3.12)

Keluaran tersebut menampilkan versi pip, jalur tempat pip terpasang, dan versi Python yang menjadi induknya. Jalur pada tiap sistem berbeda, tetapi polanya sama, yaitu pip <versi> from <jalur> (python <versi>). Perintah pemasangan package yang sesungguhnya dipraktikkan pada bagian virtual environment, karena package sebaiknya dipasang ke lingkungan yang terisolasi dan bukan ke Python utama.

Memilih editor#

Kode Python dapat ditulis dengan editor teks apa pun, tetapi editor yang mendukung Python membuat pekerjaan lebih cepat melalui penyorotan sintaks (syntax highlighting), pelengkapan otomatis, dan integrasi debugger. Tiga pilihan yang umum dirangkum pada tabel berikut.

Pada tabel di atas, IDE (Integrated Development Environment) berarti lingkungan pengembangan terpadu yang menggabungkan editor, debugger, dan alat proyek dalam satu aplikasi, sedangkan linting berarti pemeriksaan otomatis atas kesalahan penulisan kode. VS Code menjadi titik awal yang umum karena gratis, ringan, dan ekstensinya cukup untuk seluruh latihan jalur ini. PyCharm lebih pas ketika proyek membesar dan membutuhkan alat yang menyatu, sedangkan IDLE cukup untuk eksperimen kecil. Apa pun editor yang dipilih, program tetap dijalankan dari terminal dengan python3 nama_berkas.py agar alur eksekusinya selalu terlihat secara langsung.

Virtual environment#

Package yang dipasang dengan pip menempel pada satu interpreter tertentu. Masalah muncul ketika dua proyek membutuhkan versi pustaka yang berbeda, atau ketika package untuk eksperimen sebaiknya tidak mencampuri Python utama. Solusinya adalah virtual environment, yaitu direktori yang berisi salinan interpreter beserta pip miliknya dan terisolasi dari Python utama. Package yang dipasang di dalamnya hanya berlaku untuk lingkungan tersebut.

Virtual environment dibuat dengan perintah python3 -m venv <direktori>. Contoh berikut membuatnya di /tmp/demo-venv, lalu memeriksa interpreter yang berada di dalamnya.

# membuat virtual environment bernama demo-venv di /tmp
python3 -m venv /tmp/demo-venv

# memeriksa interpreter di dalam virtual environment
/tmp/demo-venv/bin/python --version
/tmp/demo-venv/bin/python -c "import sys; print(sys.prefix)"

Python 3.12.16
/tmp/demo-venv

Nilai sys.prefix menunjukkan direktori akar interpreter yang sedang berjalan. Pada keluaran di atas nilainya /tmp/demo-venv, bukan direktori pemasangan Python utama, sehingga terbukti interpreter di dalam virtual environment berbeda dari interpreter utama. Selanjutnya, satu package dipasang sebagai uji coba, lalu diimpor kembali oleh interpreter yang sama.

# memasang satu package di dalam virtual environment, lalu memeriksanya
/tmp/demo-venv/bin/pip install --quiet six
/tmp/demo-venv/bin/python -c "import six; print('impor six berhasil')"

# membersihkan contoh
rm -rf /tmp/demo-venv

impor six berhasil

pip yang dipanggil pada perintah di atas adalah milik virtual environment, sehingga package six terpasang di dalam /tmp/demo-venv dan tidak mengubah Python utama. Impor six dilakukan oleh interpreter yang sama, sehingga pemasangan dan pemakaiannya berada pada satu lingkungan yang konsisten. Perintah terakhir menghapus seluruh contoh, dan penghapusannya tidak menyentuh Python utama karena isolasi justru menjadi tujuan virtual environment.

Pada pemakaian sehari-hari, virtual environment diaktifkan agar perintah python dan pip yang diketik tanpa jalur menunjuk lingkungan tersebut. Aktivasi dilakukan dengan menjalankan skrip activate yang berada di direktori bin pada Linux dan macOS, atau di direktori Scripts pada Windows. Setelah aktif, prompt terminal biasanya menampilkan nama lingkungannya, dan perintah deactivate mengembalikannya ke keadaan semula. Tanpa aktivasi, interpreter virtual environment tetap dapat dipanggil langsung melalui jalurnya, seperti yang dipraktikkan pada contoh di atas.

Kesalahan umum#

Perintah python tidak ditemukan pada Linux dan macOS. Pesannya berupa command not found, dan penyebabnya adalah nama perintah yang keliru, karena nama yang tepat di kedua sistem tersebut adalah python3. Nama python di sistem lama sering disiapkan untuk Python 2, atau bahkan tidak tersedia sama sekali. Perbaikannya cukup memanggil python3, sebagaimana dipakai di seluruh contoh jalur ini.

Package sudah terpasang tetapi impor tetap gagal. Kondisi ini terjadi ketika pip memasang package ke interpreter yang berbeda dari interpreter yang menjalankan program. Pesan yang tampil bernama ModuleNotFoundError, dan perintah berikut menunjukkan bentuknya ketika sebuah modul yang tidak ada dicoba diimpor.

# mencoba mengimpor modul yang tidak ada
python3 -c "import modul_tidak_ada"

Traceback (most recent call last):
  File "<string>", line 1, in <module>
ModuleNotFoundError: No module named 'modul_tidak_ada'

Baris terakhir traceback adalah pesannya, yaitu ModuleNotFoundError beserta nama modul yang tidak ditemukan. Perbaikannya dengan memastikan pip dan program memakai interpreter yang sama, yaitu melalui pola python3 -m pip, atau dengan memasang package di dalam virtual environment yang juga dipakai menjalankan programnya.

Ringkasan#

• Python 3.12 ke atas dipasang dari python.org, dan pemasangannya diverifikasi dengan python3 --version atau skrip pemeriksaan kecil.
• pip dipanggil melalui python3 -m pip agar package selalu terpasang pada interpreter yang sama dengan program yang menjalankannya.
• Editor dengan dukungan Python seperti VS Code mempercepat penulisan kode, sedangkan program tetap dijalankan dari terminal.
• Virtual environment mengisolasi package per proyek dan dibuat dengan perintah python3 -m venv.

Referensi#

• Python Downloads — Python Software Foundation — Halaman unduhan resmi Python yang memuat installer terbaru untuk setiap sistem operasi.
• Using Python on Windows — Python Software Foundation — Dokumentasi pemasangan Python pada Windows, termasuk opsi PATH dan py launcher.
• venv — Creation of virtual environments — Python Software Foundation — Dokumentasi modul venv untuk membuat dan memakai virtual environment.
• pip documentation — Python Packaging Authority — Dokumentasi pip yang mencakup perintah install dan opsi baris perintahnya.