Cad iad deoir-fheidhmeanna (decorators) agus conas a scríobhann tú ceann?

Question

Accepted Answer

Is feidhm é **decorator** a **fhéachann ar fheidhm eile** chun iompar a chur leis, gan cód an bhunaidh a athrú. Cuirtear i bhfeidhm é leis an `@decorator` chomhréir os cionn feidhme — bealach geal chun imní trasnuaineacha a chur leis, ar nós logáil, am-thomhas, taiscéadh, nó rialú rochtana.

## Conas a oibríonn deoir-fheidhmeanna

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

Tá an `@my_decorator` chomhréir ar siúl do `greet = my_decorator(greet)` — cuireann sé `greet` in ionad an `wrapper`, agus ritheannn sé cód breise timpeall ar an nglaoch bunaidh. Fágann `*args, **kwargs` go n-oibríonn an wrapper do aon síniú feidhme.

## Sampla praiticiúil: am-thomhas

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

Tá `@functools.wraps(func)` tábhachtach — gan é, cailleann an fheidhm fholuain a hainm agus a teanga-dhóthanach bunaidh.

## Deoir-fheidhmeanna le hargóintí

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

Baineann decorator a raibh paraiméadair air gá a bheith ann sraith bhreise (feidhm a thillann decorator).

## Deoir-fheidhmeanna coiteanna ionsuite / leabharlainne

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

## Cén fáth a bhfuil sé tábhachtach

Tá deoir-fheidhmeanna ina gné chumhachtach, atá sainiúil do Python ar **iompar in-atúsáilte a chur leis** (logáil, am-thomhas, taiscéadh, fíordheimhniú, bailíochtú, ródú) ar fheidhmeanna ar bhealach soiléir agus dearbhaitheach — imní trasnuaineacha a scaradh ó dhúil bhunúsach.

Tá siad ann taobh thiar in Python i ndáiríre: creataí gréasáin (`@app.route`), taiscéadh (`@lru_cache`), ranganna (`@property`), agus tástáil.

Tuigbheartáil ar conas a scríobhann tú iad (feidhm fholuain, `*args/**kwargs`, `functools.wraps`) agus an fhoirm pharaiméadraithe a thugann duit an chéad dul eile agus deoir-fheidhmeanna an éadáin a úsáid go ceart agus do dhúintí in-atúsáilte féin a thógáil.