06. Persiapan

Sebelum menulis Python, ada empat hal yang perlu ada di komputer:

File-file buku ini (bab dan kode contoh).
Interpreter Python (program yang menjalankan file .py).
Sebuah editor kode.
Terminal untuk mengetik perintah.

Bab ini memandu persiapan keempat hal tersebut di Windows 10 atau 11.

1. Dapatkan file buku

Setiap bab punya kode yang cocok di exercises/, dan mini-project ada di projects/. Untuk menjalankan kode apa pun, seluruh folder perlu ada di komputer.

Ada dua cara untuk mendapatkannya. Pakai cara yang sudah disiapkan orang tuamu.

Cara A: salin dari USB atau folder cloud bersama

Orang tuamu memberikan folder bernama Learning-Python-Book-101 di USB, di OneDrive, atau folder bersama lainnya.

Salin seluruh folder ke Documents. Path akhirnya harus seperti C:\Users\<namamu>\Documents\Learning-Python-Book-101.
Buka di File Explorer dan pastikan di dalamnya ada folder book, folder book-src, folder exercises, dan file README.md.

Cara B: clone dari GitHub dengan Git

Kalau orang tuamu sudah menaruh buku ini di GitHub dan memberikanmu URL-nya:

Install Git for Windows dari https://git-scm.com/download/win, terima semua pengaturan default.
Buka PowerShell (tekan tombol Windows, ketik PowerShell, tekan Enter).
Pindah ke folder Documents:
```
 cd $HOME\Documents
```
Clone repository-nya (gunakan URL dari orang tuamu):
```
 git clone <url-dari-orang-tuamu>
```
Sekarang file buku ada di folder di dalam Documents.

Apa pun caranya, kalau bab ini menyebut "buka folder buku", maksudnya adalah folder yang baru kamu taruh di Documents tadi.

2. Install interpreter Python

Ada lebih dari satu cara untuk install Python di Windows. Pilih salah satu dari dua cara di bawah. Kalau cara pertama gagal, coba cara kedua.

Cara A: winget (direkomendasikan)

Windows 10 dan 11 sudah punya winget, alat untuk install software dari command line. Cara pakainya:

Tekan tombol Windows, ketik PowerShell, dan buka.
Ketik:
```
 winget search Python.Python
```
Akan muncul tabel yang menampilkan paket dengan nama atau deskripsi yang mengandung "Python". Cari paket bernama Python 3 yang diterbitkan oleh Python Software Foundation. Salin nilai di kolom Id untuk baris itu (biasanya terlihat seperti Python.Python.3 atau Python.Python.3.13).
Install dengan:
```
 winget install --id <tempel-id-di-sini>
```
Misalnya, jika Id-nya adalah Python.Python.3.13, perintahnya adalah winget install --id Python.Python.3.13.
Tutup PowerShell dan buka jendela baru. Ini penting: jendela baru akan mengenali perubahan PATH yang dibuat oleh installer.
Verifikasi instalasi:
```
 python --version
```
Kamu harusnya melihat baris yang dimulai dengan Python 3. diikuti nomor versi. Kalau sudah muncul, Python sudah terinstall. Lewati ke langkah 3.

Kalau python --version menampilkan 'python' is not recognised as the name of a cmdlet, function, script file, or operable program, berarti installer tidak menambahkan Python ke PATH. Gunakan Cara B.

Cara B: unduh dari python.org

Kalau winget tidak berhasil, install Python secara manual:

Buka https://www.python.org/downloads/ dan klik tombol kuning Download Python 3 (versi terbaru dipilih otomatis).
Jalankan installer yang sudah diunduh.
Di layar pertama, centang Add Python to PATH sebelum mengklik Install Now. Langkah ini mudah terlewat tapi sangat penting.
Klik Install Now dan tunggu sampai selesai.
Buka jendela PowerShell baru dan jalankan python --version. Kamu harusnya melihat versi Python.

3. Install editor kode

Gunakan Visual Studio Code (VS Code disingkat). Gratis, berjalan di Windows, dan dipakai oleh sebagian besar programmer profesional.

Buka https://code.visualstudio.com dan unduh installer-nya.
Jalankan. Di layar Select Additional Tasks, centang Add to PATH dan Register Code as an editor for supported file types.
Buka VS Code setelah instalasi selesai.
Install ekstensi bahasa Python:
- Klik ikon Extensions di bilah kiri (atau tekan Ctrl + Shift + X).
- Ketik python di kotak pencarian.
- Temukan ekstensi bernama Python yang diterbitkan oleh Microsoft (nama penerbit terlihat di bawah judul).
- Klik Install.

Ini menambahkan pewarnaan sintaks, autocomplete, dan petunjuk error untuk file .py.

4. Terminal

VS Code punya terminal bawaan. Buka dengan **Ctrl + ** (tombol backtick, biasanya di bawah Esc`).

Di sinilah kamu mengetik python nama-file.py untuk menjalankan skrip; outputnya muncul di terminal yang sama.

5. Verifikasi semua berfungsi

Buka VS Code. Pilih File → Open Folder... dan pilih folder tempat kamu menyalin buku ini. Pohon folder muncul di sebelah kiri.

Di pohon folder, buka exercises/07/ dan klik 01-hello.py. Isinya muncul di editor.

Buka terminal (Ctrl + `) dan ketik:

python exercises/07/01-hello.py

Kamu harusnya melihat baris ini di terminal:

Hello, world!

Kalau sudah muncul, seluruh persiapan berfungsi. Lanjut ke Bab 7.

Kalau kamu melihat can't open file 'exercises/07/01-hello.py': [Errno 2] No such file or directory, berarti terminal sedang menunjuk ke folder yang salah. Terminal harus terbuka di dalam folder buku. Kalau belum, tutup terminal dan buka ulang foldernya dengan File → Open Folder....

Bagaimana kode contoh diorganisasi

Mulai dari sini, bab-bab akan memintamu untuk membuka file exercises/..., jadi penting untuk tahu bagaimana folder itu tersusun.

Setiap bab yang punya kode mendapat folder tersendiri di bawah exercises/, diberi nomor sesuai bab: kode Bab 7 ada di exercises/07/, Bab 20 ada di exercises/20/, dan seterusnya. (Bagian 1 semuanya di atas kertas, jadi kode dimulai dari Bab 7.) Mini-project ada terpisah di projects/.

Folder setiap bab menyimpan tiga jenis file:

File contoh di tingkat atas, seperti exercises/08/01-comment-styles.py. Ini adalah program kecil yang diminta oleh kotak Coba ini di setiap bab.
Folder homework/ berisi file starter untuk setiap soal pekerjaan rumah, seperti exercises/08/homework/01-annotate.py.
Folder homework/solutions/ berisi jawaban yang sudah dikerjakan untuk setiap soal pekerjaan rumah. Coba dulu sendiri — jawaban ada di sana kalau kamu stuck atau ingin mengecek pekerjaanmu.

Jadi kalau Bab 8 berkata "Buka exercises/08/homework/01-annotate.py", itu adalah file yang tepat berada di path tersebut di dalam folder buku yang kamu buka.

Apa yang tidak dicakup bab ini

pygame. Bagian terakhir buku ini membahas pygame untuk membuat game grafis. Untuk sekarang, semua berjalan sebagai program teks di terminal.
Editor lain. Editor lain juga bisa dipakai (Notepad++, Sublime Text, IDLE), tapi buku ini mengasumsikan VS Code mulai dari sini. Dengan editor berbeda, pintasan keyboard berubah, tapi kodenya identik.