Dekoratörler nedir ve nasıl yazarsınız?

Question

Accepted Answer

Bir **dekoratör**, başka bir işlevi **saran** ve orijinal kodu değiştirmeden davranış ekleyen bir işlevdir. Bir işlevin üstüne `@decorator` sözdizimi ile uygulanır — günlüğe kaydetme, zamanlama, önbelleğe alma veya erişim denetimi gibi çapraz kesişen endişeleri eklemenin temiz bir yolu.

## Dekoratörler nasıl çalışır

```python
def my_decorator(func):
    def wrapper(*args, **kwargs):       # wraps the original function
        print("before")
        result = func(*args, **kwargs)  # call the original
        print("after")
        return result
    return wrapper                       # return the wrapped version

@my_decorator
def greet(name):
    print(f"Hello {name}")

greet("Ann")
# Output: before / Hello Ann / after
```

`@my_decorator` sözdizimi `greet = my_decorator(greet)` için şekerleme — `greet` yerine `wrapper`'ı koyar, bu da orijinal çağrının etrafında ekstra kod çalıştırır. `*args, **kwargs` wrapper'ı herhangi bir işlev imzası için çalışır hale getirir.

## Pratik bir örnek: zamanlama

```python
import time, functools

def timed(func):
    @functools.wraps(func)        # preserves func's name/docstring (important!)
    def wrapper(*args, **kwargs):
        start = time.perf_counter()
        result = func(*args, **kwargs)
        print(f"{func.__name__} took {time.perf_counter() - start:.3f}s")
        return result
    return wrapper

@timed
def slow_task():
    time.sleep(1)
```

`@functools.wraps(func)` önemlidir — bunu olmadan sarılı işlev orijinal adını ve docstring'ini kaybeder.

## Argümanlarla dekoratörler

```python
def repeat(times):               # outer takes the decorator's argument
    def decorator(func):
        @functools.wraps(func)
        def wrapper(*args, **kwargs):
            for _ in range(times):
                func(*args, **kwargs)
        return wrapper
    return decorator

@repeat(times=3)
def hello(): print("hi")  # prints "hi" three times
```

Parametreli bir dekoratör ek bir katman gerektirir (bir dekoratör döndüren bir işlev).

## Yaygın yerleşik / kütüphane dekoratörleri

```text
@property            → turn a method into a computed attribute
@staticmethod / @classmethod → method types
@functools.lru_cache → memoize results
@app.route("/")      → web framework routing (Flask)
@pytest.fixture      → test fixtures
```

## Neden önemli

Dekoratörler, işlevlere temiz ve bildirimsel olarak **yeniden kullanılabilir davranış** (günlüğe kaydetme, zamanlama, önbelleğe alma, kimlik doğrulama, doğrulama, yönlendirme) eklemek için güçlü, benzersiz Python özelliğidir — çapraz kesişen endişeleri temel mantıktan ayırmak.

Gerçek Python'da her yerde bulunurlar: web çerçeveleri (`@app.route`), önbelleğe alma (`@lru_cache`), sınıflar (`@property`) ve test etme.

Bunları nasıl yazacağınızı (bir wrapper işlevi, `*args/**kwargs`, `functools.wraps`) ve parametreli formu anlamak, hem ekosistemin dekoratörlerini doğru şekilde kullanmanıza hem de kendi yeniden kullanılabilir soyutlamalarınızı oluşturmanıza olanak tanır.