Panduan Penulisan Kode Python

   

Assalamualaikum, hallo teman teman. Gimana kabarnya nih ? semoga teman teman dalam keadaan baik baik saja dan selalu diberi semangat untuk belajar. Kali ini saya akan melanjutkan series python, nah pada blog kali ini saya akan menjelaskan mengenai panduang penulisan kode pada bahasa pemogramman Python. Sebelum mulai pastikan dulu teman teman sudah menyiapkan text editornya ataupun IDE nya.

Panduan Penulisan

Untuk panduan penulisan pada bahasa pemogramman python yang baik dan benar ini mengacu pada PEP 8 yang disediakan atau dibuat oleh python itu sendiri. Dokumen ini (PEP 8) memberikan konvensi pengkodean untuk kode Python yang terdiri dari pustaka standar dalam distribusi Python utama. Silakan lihat PEP informasi pendamping yang mendeskripsikan pedoman gaya untuk kode C dalam implementasi C Python. Dokumen ini dan PEP 257 (Konvensi Docstring) diadaptasi dari esai Panduan Gaya Python asli Guido, dengan beberapa tambahan dari panduan gaya Barry. Panduan gaya ini berkembang seiring waktu karena konvensi tambahan diidentifikasi dan konvensi masa lalu menjadi usang karena perubahan bahasa itu sendiri. Banyak proyek memiliki pedoman gaya pengkodean sendiri. Jika terjadi konflik, panduan khusus proyek tersebut akan diutamakan untuk proyek itu.

Panjang Baris Maksimum

Pada pyhton panjang maksimum kode setiap baris yaitu hingga 79 karakter dan untuk komentar atau dokumentasi yaitu 72 karakter. Membatasi lebar jendela editor yang diperlukan memungkinkan beberapa file dibuka berdampingan, dan berfungsi dengan baik saat menggunakan alat peninjau kode yang menampilkan dua versi di kolom yang berdekatan. Pembungkusan default di sebagian besar alat mengganggu struktur visual kode, sehingga lebih sulit untuk dipahami. Batasan dipilih untuk menghindari pembungkusan di editor dengan lebar jendela diatur ke 80, bahkan jika alat tersebut menempatkan mesin terbang penanda di kolom terakhir saat membungkus garis. Beberapa alat berbasis web mungkin tidak menawarkan pembungkusan garis dinamis sama sekali. Beberapa tim sangat menyukai garis yang lebih panjang. Untuk kode yang dikelola secara eksklusif atau terutama oleh tim yang dapat mencapai kesepakatan tentang masalah ini, tidak masalah untuk menambah batas panjang baris hingga 99 karakter, asalkan komentar dan dokumen masih dalam 72 karakter. Pustaka standar Python adalah konservatif dan membutuhkan batasan baris hingga 79 karakter (dan docstrings / komentar hingga 72). Cara yang disukai untuk membungkus garis panjang adalah dengan menggunakan kelanjutan garis tersirat Python di dalam tanda kurung, tanda kurung dan tanda kurung. Garis panjang dapat dipecah menjadi beberapa baris dengan membungkus ekspresi dalam tanda kurung. Ini harus digunakan sebagai preferensi untuk menggunakan garis miring terbalik untuk kelanjutan garis.

Indentation (Indentasi)

Gunakan 4 spasi pada setiap tingkatan indentasi

Garis kelanjutan harus menyelaraskan elemen yang dibungkus baik secara vertikal menggunakan garis implisit Python yang bergabung di dalam tanda kurung, tanda kurung dan tanda kurung, atau menggunakan indentasi gantung. Saat menggunakan indentasi gantung, hal-hal berikut harus dipertimbangkan; tidak boleh ada argumen di baris pertama dan lekukan lebih lanjut harus digunakan untuk membedakan dirinya dengan jelas sebagai baris lanjutan:

# Benar: # Sejajar dengan pembatas pembuka. foo = long_function_name (var_one, var_two, var_three, var_four) # Tambahkan 4 spasi untuk membedakan argumen dari yang lain. def long_function_name ( var_one, var_two, var_three, var_four): print (var_one) # Indentasi gantung harus menambahkan level. foo = long_function_name ( var_one, var_two, var_three, var_four)

# Salah: # Argumen pada baris pertama dilarang jika tidak menggunakan perataan vertikal. foo = long_function_name (var_one, var_two, var_three, var_four) # Indentasi lebih lanjut diperlukan karena indentasi tidak dapat dibedakan. def long_function_name ( var_one, var_two, var_three, var_four): print (var_one)

Catatan : 4 Spasi bersifat opsional pada baris lanjutan

Teman teman juga bisa menggunakan jumlah spasi lainnya seperti 2 spasi untuk baris lanjutan. Contohnya :

foo = long_function_name ( var_one, var_two, var_three, var_four)

Kondisi (IF)

Pada bagian ini akan memberi gambaran sedikit untuk teman teman mengenai penulisan kondisi atau if pada python. Saat menulis pernyataan kondisi atau if kita juga sering menemukan keterbatasan penulisan kode karena kode terlalu panjang. Dalam kondisi seperti itu, inilah saran saran penulisan :

# Contoh kondisi visual yang tidak diubah/tanpa indentasi if (sebuah kondisi dan kondisi yang lain): lakukanSesuatu() # Tambahkan komentar if (sebuah kondisi dan kondisi yang lain): #Mengingat Keduanya Benar, lakukan hal berikut lakukanSesuatu() # Tambahkan ekstra indentasi pada baris lanjutan if (sebuah kondisi dan kondisi yang lain): lakukanSesuatu()

Kurung atau Siku Penutup

Tanda kurung kurawal / kurung siku penutup pada konstruksi multiline dapat berbaris di bawah karakter non-spasi pertama dari baris terakhir , contoh :

my_list = [ 1, 2, 3, 4, 5, 6, ] hasil = some_function_that_takes_arguments ( 'a', 'b', 'c', 'd', 'e', ​​'f', )

Atau dapat diletakkan sejajar dengan statemen utama, contoh :

my_list = [ 1, 2, 3, 4, 5, 6, ] hasil = some_function_that_takes_arguments ( 'a', 'b', 'c', 'd', 'e', ​​'f', )

Tab atau Spasi

Spasi adalah metode indentasi yang disukai. Tab harus digunakan semata-mata agar tetap konsisten dengan kode yang sudah diindentasi dengan tab. Python 3 melarang pencampuran penggunaan tab dan spasi untuk indentasi. Kode Python 2 yang diindentasi dengan campuran tab dan spasi harus diubah menjadi menggunakan spasi secara eksklusif. Saat memanggil penerjemah baris perintah Python 2 dengan opsi -t , ia mengeluarkan peringatan tentang kode yang secara ilegal mencampur tab dan spasi. Saat menggunakan -tt , peringatan ini menjadi kesalahan. Opsi ini sangat direkomendasikan!

Sekian materi yang bisa saya berikan pada blog kali ini semoga tutorialnya bermanfaat dan membuat teman teman paham. Jika teman teman merasa tutorial ini bermanfaat kalian bisa share blog ini dan jangan lupa comment jika ada yang ingin ditanyakan. Terima kasih , Wassalamualaikum.