Apakah itu decorator dan bagaimana cara menulisnya?

Question

Accepted Answer

**Decorator** ialah fungsi yang **membalut fungsi lain** untuk menambah tingkah laku, tanpa mengubah kod asal. Ia digunakan dengan sintaks `@decorator` di atas sesuatu fungsi — cara yang kemas untuk menambah kebimbangan rentas-keliling (cross-cutting) seperti logging, pemasaan, caching, atau kawalan akses.

## Bagaimana decorator berfungsi

```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
```

Sintaks `@my_decorator` ialah gula sintaks bagi `greet = my_decorator(greet)` — ia menggantikan `greet` dengan `wrapper`, yang menjalankan kod tambahan di sekeliling panggilan asal. `*args, **kwargs` membolehkan wrapper berfungsi untuk sebarang tandatangan fungsi.

## Contoh praktikal: pemasaan

```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)` adalah penting — tanpanya, fungsi yang dibalut akan kehilangan nama asal dan docstring-nya.

## Decorator dengan argumen

```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
```

Decorator berparameter memerlukan satu lapisan tambahan (sebuah fungsi yang memulangkan decorator).

## Decorator terbina dalam / pustaka yang biasa

```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
```

## Mengapa ia penting

Decorator ialah ciri yang berkuasa dan amat ber-Python untuk **menambah tingkah laku boleh guna semula** (logging, pemasaan, caching, pengesahihan, pengesahan, routing) kepada fungsi dengan cara yang kemas dan deklaratif — memisahkan kebimbangan rentas-keliling daripada logik teras.

Ia terdapat di mana-mana dalam Python sebenar: rangka kerja web (`@app.route`), caching (`@lru_cache`), kelas (`@property`), dan pengujian.

Memahami cara menulisnya (fungsi wrapper, `*args/**kwargs`, `functools.wraps`) serta bentuk berparameter membolehkan anda menggunakan decorator ekosistem dengan betul dan membina abstraksi boleh guna semula anda sendiri.