Setelah kita belajar Python tentang Indentasi, maka kita akan melanjutkan kembali pada bagian ke 4 ini tentang komentar dan dokumentasi. Secara umum komentar pada program bertujuan untuk menjelaskan algoritma dan keterangan yang diperlukan. Dengan memberikan komentar, untuk orang lain yang ikut mengerjakan proyek tersebut dapat memahami kode yang kita buat. Dan keuntungan bagi pembuat program juga memudahkan kedepannya apabila, melakukan perubahan-perubahan.
Komentar pada bahasa pemrograman Python dan yang lainnya, merupakan baris kode yang tidak ikut dieksekusi. Apapun kode yang berada dalam block komentar, tidak mempengaruhi output dari program tersebut.
Bentuk Komentar
Pada Python, ada 3 macam bentuk komentar, yaitu single line, inline, dan multiline.
- Single line# Single line dimulai dengan tanda pagar
- Inlineprint("Hello world") # inline dimulai dengan tanda pagar juga
- Multiline""" Komentar multiline berada dalam kutip ganda 3 kali dan semua yang didalamnya tidak akan dieksekusi """
Docstring
Docstring adalah singkatan dari Documentation String. Digunakan untuk memberikan keterangan singkat atau sebagai dokumentasi pada class, function, atau modul yang dibuat.
Tidak seperti komentar yang biasa, dia berada didalam suatu fungsi dan kita bisa mengaksesnya. Seperti berikut.
Docstring dengan single line
Bagaimana kalau membuat docstring menggunakan komentar singli line?
def greet(name, greeting="Hello"): # print a greeting # Optional parameter print("{} {}".format(greeting, name)) print(greet.__doc__) None help(greet) Help on function greet in module __main__: greet(name, greeting='Hello') (END)Ternyata menggunakan macam bentuk komentar lain, tidak bisa diterapkan pada docstring.
Membuat Documentation
Docstring itu adalah komentar multiline, karena itu pada contoh di atas dengan single line menghasilkan output None. Baik, sekarang kita akan coba membuat dokumentasi sederhana.
Umumnya syntax dasar membuat docstring ada 2 bentuk yang digunakan
- One linedef hai(): """Katakan hai pada teman Anda.""" print("Hai temanku")
- Multi linedef sapa(nama, bahasa="id"): """Ucapkan Hai untuk dia. Arguments: nama: untuk menyimpan namanya. bahasa: bahasa yang digunakannya. """ print(bahasa+ " "+nama)
Menggunakan Google Python Style
Google telah merilis yang disebut dengan Google Python Style Guide termasuk didalamnya membuat komentar dokumentasi.
def hello(name, language="en"): """Say hello to a person. Args: name: the name of person as string language: the language code string Returns: A number. """ print(greeting[language]+" "+name) return 4Akhir Kata
Docstring adalah multiline comment yang bisa digunakan untuk mendokumentasikan modul, class, maupun fungsi dan method. Secara umum ada dua bentuk membuat dokumentasi yaitu one line atau hanya satu baris saja dan multiline atau banyak baris.
Demikian pada penggunaan komentar reguler yang terdiri dari 3 bentuk, ada single line, inline, dan juga multiline. Pada single line dan inline, diawali dengan tanda pagar (#) yang setiap karakter setelah tanda pagar ini tidak akan dijalankan oleh program. Perbedaan dari single line dan inline terletak pada penempatannya saja.
Penulisan Komentar Pada Python
By Muhammad Tajuddin
Penulisan Komentar Pada Python - Pada tutorial python kali ini saya akan melanjutkan materi kemaren yang membahas tentang kode pembuka hello world, disini saya akan menjelaskan bagaimana sih cara menulis komentar pada python? apakah sama dengan penulisan komentar-komentar di bahasa pemrograman yang lain?. sebelum kita masuk ke cara penulisan komentar pada python, alangkah baiknya kita harus memahami dulu apa sih komentar itu dan fungsinya dalam pengcodingan itu buat apa?
Komentar Python
Komentar (comment) adalah sebuah kode di dalam script Python yang tidak dieksekusi atau tidak dijalankan oleh mesin. Komentar hanya digunakan untuk menandai atau memberikan keterangan tertulis pada source code kalian.
Komentar biasa digunakan untuk menandai atau memberikan penjelasan tenatng script yang ditulis. atau untuk mengingatkan kepada seorang programmer itu sendiri jika suatu saat dia kembali mengedit script tersebut biar tidak lupa apa fungsi dan kegunaan source code tersebut, tak hanya itu, terkadang komentar digunakan untuk menandai antara section 1 dengan section lainnya dan bertujuan agar pencarian bisa lebih mudah dengan adanya penandaan menggunakan komentar.
Untuk menggunakan komentar, kalian cukup menulis tanda pagar #, diikuti dengan komentar yang ingin kalian tuliskan.
Dibawah ini merupakan contoh penggunaan komentar pada Python.
# Ini adalah sebuah komentar # Tulisan yang saya tulis tidak akan tampil atau di eksekusi oleh sistem #komentar dengan tanda pagar hanya bisa digunakan #untuk #satu #baris saja """ Penulisan Komentar lebih dari satu baris yaitu dengan menggunakan kutip dua 3 kali dan ditutup dengan kutip dua 3 kali juga """ print("Hello World") #ini juga komentar #print("Selamat Datang di Dunia Programming") # komentar bisa berisi spesial karakter !@#$%^&*(),./;'[]\ #mencetak nama print("Dunia Programming") #mencetak angka/integer print(123)Saat kalian menjalankan script diatas, kalian akan melihat hasil atau output berupa Hello World, Dunia Programming dan 123, karena tulisan/komentar yang ditulis tidak dieksekusi. Sekian tutorial dari saja, dan kita lanjut ke tutorial selanjutnya agar kalian bisa lebih mendalami tentang pengcodingan Python.