Python yorumlar (Python Comments)

Python'da yorumlar, kodun içinde açıklamalar veya notlar eklemenizi sağlar. Python yorumları kodun çalışmasını etkilemez ve yalnızca insanlar tarafından okunur. Python'daki yorumlar iki ana türde bulunur: tek satırlı ve çok satırlı yorumlar.

1. Tek Satırlı Yorumlar

Tek satırlı yorumlar, kodun sadece bir satırında açıklama yapmak için kullanılır. Tek satırlı yorumlar # sembolü ile başlar.

# Bu bir tek satırlı yorumdur
print("Merhaba Dünya")  # Bu da bir yorum

Yukarıdaki örnekte, # işareti ile başlayan kısımlar yorum olarak kabul edilir ve Python tarafından dikkate alınmaz.

2. Çok Satırlı Yorumlar

Python'da doğrudan çok satırlı yorum için özel bir anahtar kelime yoktur. Ancak, çok satırlı yorumlar genellikle üçlü tırnak işaretleri (''' veya """) kullanılarak yapılır. Bu yöntem teknik olarak çok satırlı dize (string) olarak kabul edilir, ancak genellikle yorumlama amacıyla kullanılır.

• Üçlü Tek Tırnak (''') ile Çok Satırlı Yorum

'''
Bu birden fazla satırı kapsayan bir yorumdur.
Kodun çalışma mantığını açıklayabilirsiniz.
'''

• Üçlü Çift Tırnak (""") ile Çok Satırlı Yorum

"""
Bu da birden fazla satırı kapsayan bir yorumdur.
Python'daki belgeler ve açıklamalar için sıklıkla kullanılır.
"""

3. Yorumların Kullanım Alanları

• Kodun Açıklanması: Kodun belirli bir kısmının ne yaptığını veya neden böyle yazıldığını açıklamak için kullanılır.

# Bu döngü, listeyi yazdırır
for item in liste:
    print(item)

Geçici Olarak Kodun Devre Dışı Bırakılması: Kodun çalışmasını geçici olarak durdurmak için yorum olarak eklenebilir.

# print("Bu satır çalışmayacak")

Kodun Belgelendirilmesi: Fonksiyonlar ve sınıflar hakkında açıklama eklemek için docstring olarak bilinen çok satırlı yorumlar kullanılır.

def toplama(a, b):
    """
    İki sayıyı toplar ve sonucu döndürür.
    
    Args:
    a (int): Birinci sayı
    b (int): İkinci sayı

    Returns:
    int: Toplam
    """
    return a + b

4. Dokümantasyon (Docstrings)

Python'da fonksiyonlar, sınıflar ve modüller için açıklama eklemek için kullanılan özel bir tür yorum olan docstring'ler (""" veya ''') bulunmaktadır. Bu yorumlar, fonksiyonların veya sınıfların işlevlerini belgelendirmek için kullanılır ve genellikle fonksiyon tanımının hemen altında bulunur.

def faktoriyel(n):
    """
    Bir sayının faktöriyelini hesaplar.

    Args:
    n (int): Faktöriyeli hesaplanacak pozitif tam sayı.

    Returns:
    int: Sayının faktöriyeli.
    """
    if n == 0:
        return 1
    else:
        return n * faktoriyel(n-1)

Bu açıklamalar, kodu daha okunabilir ve anlaşılır hale getirir, özellikle de projede birden fazla kişi çalışıyorsa veya kod daha sonra gözden geçirilecekse. Python dokümantasyon araçları (örneğin, pydoc) bu docstring'leri kullanarak otomatik olarak belgeler oluşturabilir.