DEV Community

Vebende Akademi
Vebende Akademi

Posted on

Pep 20

#programming #tutorial #python #softwaredevelopment

Executive Summary: PEP 20 ile Temiz Kodun Temelleri

Yazılım dünyasında "iyi kod", sadece çalışan kod değildir; okunabilir, sürdürülebilir ve geliştirilebilir koddur. Python'un felsefesi olan PEP 20 (The Zen of Python), kurumsal projelerde teknik borcu minimize etmek için altın bir standarttır. "Clean Code" prensipleri, doğrudan bu ilkelerin pratik uygulamalarıdır. Aşağıdaki rehber, bir geliştiricinin zihniyetini dönüştürecek teorik ve pratik bir yaklaşımdır.

Kod Örnekleriyle PEP 20

1. Basitlik ve Düz Yapı (Simple is better than complex / Flat is better than nested)

Karmaşık iç içe yapılar, hata ayıklamayı zorlaştırır.

  • Anti-Pattern (Kötü): 
def process_data(data):
    if data:
        if 'user' in data:
            if 'id' in data['user']:
                # İşlem yap...
                return True
    return False
Enter fullscreen mode Exit fullscreen mode
  • Best Practice (İyi): 
def process_data(data):
    user = data.get('user')
    if not user or 'id' not in user:
        return False
    # İşlem yap...
    return True
Enter fullscreen mode Exit fullscreen mode

Analiz: Guard clause yapısı, kodun derinliğini azaltır ve okunabilirliği artırır.

2. Belirginlik (Explicit is better than implicit)

Kodun ne yaptığı, okuyan kişi için tahmin edilemez olmamalıdır.

  • Anti-Pattern (Kötü): 
from module import * # Hangi fonksiyon nereden geldi belli değil
Enter fullscreen mode Exit fullscreen mode
  • Best Practice (İyi): 
from module import specific_function, AnotherClass
Enter fullscreen mode Exit fullscreen mode

Hands-On: Uygulamalı Laboratuvar Çalışmaları

Aşağıdaki çalışmaları kendi yerel geliştirme ortamınızda (Dockerized Gitea veya lokal kurulumlarınızda) uygulayın.

Laboratuvar 1: Cyclomatic Complexity Analizi

Görev: Yazdığınız bir modülü radon kütüphanesi ile analiz edin.

  1. pip install radon komutu ile aracı kurun.
  2. radon cc your_script.py -a komutu ile kodunuzun karmaşıklık skorunu ölçün.
  3. Hedef: Skorun A veya B seviyesinde kalmasını sağlayın. Düz ve modüler yapıya sahip kodlar düşük skor üretir.

Laboratuvar 2: Hata Yönetimi (Errors should never pass silently)

Görev: Sessiz hata yutan bir bloğu, loglama mekanizması ile değiştirin.

  • Geliştirme: 
import logging

logging.basicConfig(level=logging.ERROR)

def divide(a, b):
    try:
        return a / b
    except ZeroDivisionError as e:
        logging.error(f"Sıfıra bölme hatası: {e}")
        raise # Hatayı yukarı fırlat, sessizce bırakma
Enter fullscreen mode Exit fullscreen mode

Implementation Roadmap: Dev.to Yayın Standartları

Bu içeriği Dev.to üzerinde yayınlarken aşağıdaki yapısal şablonu kullanmanız, okuyucunun içeriği hızlı kavramasını sağlar:

Bölüm Amaç İçerik Tipi
Giriş Problem tanımlama (Spaghetti code) Hikayeleştirme
Kavramsal Bakış PEP 20'nin 19 prensibi Özet Liste
Kod Pratiği Anti-Pattern vs Best Practice Karşılaştırmalı Tablo/Kod
Araç Seti Radon, Flake8, Black Teknik Araç Rehberi
Sonuç Kurumsal Sürdürülebilirlik Aksiyon Çağrısı

Kurumsal Tavsiye

Yazılım geliştiriciler için en büyük tuzak "çalışıyorsa dokunma" mantığıdır. PEP 20'nin "Okunabilirlik önemlidir" ilkesi, projenin 2 yıl sonra da anlaşılabilir olmasını garanti eder. Quantum Holding standartlarında, bir kod bloğu geliştirildikten sonra "Bu kodu 6 ay sonra başka bir geliştiriciye anlatabilir miyim?" sorusu her zaman testin bir parçası olmalıdır.

Bu yaklaşımları uygularken, özellikle "Flat is better than nested" prensibini kendi projelerinizde en çok hangi katmanda uygulamakta zorlanıyorsunuz?

Top comments (0)