Ce sunt *args și **kwargs?

Question

Accepted Answer

`*args` și `**kwargs` permit unei funcții să accepte un **număr variabil** de argumente. `*args` colectează argumentele **poziționale** suplimentare într-un tuple; `**kwargs` colectează argumentele de **cuvânt cheie** suplimentare într-un dict. (Numele sunt convenție — `*` și `**` sunt ceea ce contează.)

## *args — argumente poziționale variabile

```python
def total(*args):           # collects all positional args into a tuple
    print(args)             # e.g. (1, 2, 3)
    return sum(args)

total(1, 2, 3)              # 6
total(1, 2, 3, 4, 5)        # 15 — any number of args
```

## **kwargs — argumente de cuvânt cheie variabile

```python
def configure(**kwargs):    # collects keyword args into a dict
    print(kwargs)           # e.g. {"host": "localhost", "port": 8080}
    for key, value in kwargs.items():
        print(f"{key} = {value}")

configure(host="localhost", port=8080, debug=True)
```

## Combinarea lor (cu parametri obișnuiți)

```python
def func(a, b, *args, **kwargs):
    # a, b → required positional
    # args → extra positional (tuple)
    # kwargs → extra keyword (dict)
    ...

func(1, 2, 3, 4, x=5, y=6)
# a=1, b=2, args=(3, 4), kwargs={"x": 5, "y": 6}
```

Ordinea obligatorie este: parametri obișnuiți, apoi `*args`, apoi `**kwargs`.

## Despachetare — direcția inversă

```python
# `*` and `**` also UNPACK collections INTO arguments at the call site
numbers = [1, 2, 3]
total(*numbers)              # same as total(1, 2, 3)

settings = {"host": "x", "port": 80}
configure(**settings)         # same as configure(host="x", port=80)
```

Aceeași sintaxă despachetează o listă/dict în argumente poziționale/cuvânt cheie — util pentru redirecționarea argumentelor.

## Cel mai comun caz de utilizare real: redirecționarea argumentelor (decoratori, wrappere)

```python
def wrapper(*args, **kwargs):
    # accept ANY arguments and pass them through unchanged
    return original_func(*args, **kwargs)
```

Acest model de transfer este modul în care decoratorii și funcțiile wrapper gestionează orice semnătură de funcție.

## De ce contează

`*args`/`**kwargs` permit semnături de funcție flexibile care acceptă orice număr de argumente — esențial pentru scrierea utilităților cu scop general, wrappere și în special **decoratori** (care trebuie să înfășoare funcții cu semnături necunoscute via `*args, **kwargs`).

Direcția de despachetare (`*listă`, `**dict`) este la fel de utilă pentru redirecționarea sau distribuirea argumentelor.

Înțelegerea atât a colectării, cât și a despachetării este cheia pentru scrierea codului Python reutilizabil și generic și pentru citirea multor API-uri de bibliotecă și decoratori care se bazează pe aceste caracteristici.