Python Yorum Satırları

Kod yazarken her şeyi adınız gibi bilirsiniz, her satırı neden yazdığınızı, nasıl çalıştığını, hangi mantıkla ilerlediğinizi. Ancak gel zaman git zaman işler değişebilir. Kodunuzu uzun bir süre sonra tekrar elinize aldığınızda ya da yeni özellikler eklemek istediğinizde, birdenbire “Bu satırı niye böyle yazmışım?” diye düşünüp durabilirsiniz. İşte tam da böyle anlarda, imdadımıza yorum satırları (comments) yetişir! Kodlama yaparken olmazsa olmazlarımızdan biri olan yorum satırları, kodun içinde yer alan ancak yorum olarak işlenen ve programın çalışma esnasında dikkate alınmayan metinlerdir.

Zaten kod yazmaya biraz olsun alışmaya başladığınızda, kodunuzu tertipli bir şekilde yazma ihtiyacı duymaya başlamışsınız demektir. Kodu niye yazdığınızı tabiri caizse kendinize açıklama ihtiyacı duyarsınız. Pek çok yazılım dilinde yorum satırları bulunmakla birlikte farklı farklı yöntemlerle yapılmaktadır. Merak etmeyin! Python’da yorum satırı yapmak çok basittir; tek yapmanız gereken, o satırın başına # işareti koymaktır. Bu işareti gördüğü an Python o satırı dikkate almaz, çalıştırmaz. Ancak o satır, kodu okuyan kişiler (ve gelecekteki siz!) için çok kıymetli bir açıklama olarak kalacaktır. Basit bir örnek üzerinden gösterelim:

# Kullanıcıdan yaş bilgisi alıyoruz
age = input("Yaşınızı giriniz: ")

Kodumuzdaki age değişkeni, her ne kadar yapmak istediğimiz işlemle alakalı bize bir ipucu verse de, işi garantiye almak adına hemen üstündeki satıra # ile başlayarak kodun ne işe yaradığını yorum satırı olarak belirttik. Böylece kodumuzu tekrar incelediğimizde, o satırdaki açıklama sayesinde ne yaptığımızı kolayca hatırlayabileceğiz. Özellikle karmaşık projelerde ya da zamanla büyüyen projelerimizde yorumlar, adeta bir can simidi gibidir. Ayrıca, kodumuzu başkaları inceleyecekse, onların da kodu anlaması çok daha kolay olacaktır.

Evet, Python’da yorum satırı bu şekilde oluşmaktadır. Adı üstünde yorum “satırı” dediğimize göre birden fazla satırı kapsayan yorumlar yazmak gerektiğinde düşüncelere dalmış olabilirsiniz :)

Böylesi durumlarda her bir satırı ayrı ayrı # işareti ile yoruma alabilirsiniz ama zamanla bu durumun sizi çileden çıkaracağından emin olabilirsiniz. Özellikle uzun açıklamalar ya da birden fazla satırdan oluşan yorumlar eklemek istediğinizde, bu yöntem pek de pratik olmayacaktır. İşte burada devreye Python’un üç tırnak işareti (''' veya """) ile yapılan çoklu satır yorumları gelir. Ancak küçük bir ayrıntı var: Teknik olarak bu, çoklu yorumdan ziyade, çok satırlı bir “string” oluşturmaktır. Neden mi?

Çünkü Python’da üç tırnak işaretiyle oluşturulan bu yapılar, aslında birer “string”dir. Eğer bu “string”i herhangi bir değişkene atamazsanız, Python onu görmezden gelir ve pratikte bir yorum satırı gibi işlev görür. Bu nedenle, birden fazla satırdan oluşan açıklamalar eklemek için alışılagelen bir yöntem olmuştur. Örneğin:

'''
Bu bölümde kullanıcıdan yaş alıyoruz.
Ancak yaş 18'den küçükse bir uyarı mesajı göstereceğiz.
'''
yas = input("Yaşınızı girin: ")
if int(yas) < 18:
    print("Yaşınız 18'den küçük, dikkatli olun!")

Yorum satırları sadece kodun işlevini açıklamak için değil, aynı zamanda belirli kod bloklarını geçici olarak devre dışı bırakmak için de kullanılabilir. Diyelim ki, bir kod parçasını test ediyorsunuz ya da o kısmı şimdilik çalıştırmak istemiyorsunuz; işte bu durumda ilgili satırları yoruma alarak geçici olarak devre dışı bırakabilirsiniz. Örnek olarak şöyle bir şeyi kafanızda canlandırabilirsiniz:

# Kullanıcıdan yaş alıyoruz
yas = input("Yaşınızı girin: ")

"""
Bu bölümde, kullanıcının yaşını kontrol eden kod bloğu var.
Şu an bu kısmı geliştirme aşamasında olduğumuz için devre dışı bırakıyoruz.
İleride yaş kontrolü yaparak kullanıcının sisteme girişine izin vereceğiz.
"""
"""
if int(yas) >= 18:
    print("Sisteme giriş yapabilirsiniz.")
else:
    print("18 yaşından küçük olduğunuz için giriş yapamazsınız.")
"""

print("Yaş kontrolü özelliği yakında aktif olacak!")

Bu örnekte, üç tırnak işareti kullanarak çok satırlı bir “yorum” oluşturduk. Yaş kontrolü yapan kod bloğu geçici olarak devre dışı bırakıldı ama açıklamalar sayesinde kodun ne yaptığını ve ileride nasıl kullanılacağını biliyoruz. İhtiyaç duyduğumuzda üç tırnak işaretlerini kaldırarak kodu tekrar aktif hale getirebiliriz.

İşte bu kadar! Python’da yorum satırları, kodun işlevini açıklamak ve belirli kod bloklarını geçici olarak devre dışı bırakmak için kullanılan, hem kodun okunabilirliğini artıran hem de hata ayıklama süreçlerinde kolaylık sağlayan bir araçtır. Basit notlar olsa yorum satırları kullanmayı alışkanlık edinin.