Co to są *args i **kwargs?

Question

Accepted Answer

`*args` i `**kwargs` pozwalają funkcji przyjąć **zmienną liczbę** argumentów. `*args` zbiera dodatkowe argumenty **pozycyjne** w krotkę; `**kwargs` zbiera dodatkowe argumenty **słów kluczowych** w słownik. (Nazwy to konwencja — ważne są `*` i `**`.)

## *args — zmienne argumenty pozycyjne

```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 — zmienne argumenty słów kluczowych

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

## Łączenie ich (ze zwykłymi parametrami)

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

Wymagana kolejność to: zwykłe parametry, potem `*args`, potem `**kwargs`.

## Rozpakowywanie — kierunek odwrotny

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

Ta sama składnia rozpakowuje listę/słownik na argumenty pozycyjne/słów kluczowych — przydatne do przekazywania argumentów.

## Najczęstszy praktyczny przypadek: przekazywanie argumentów (dekoratory, wrappery)

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

Ten wzorzec pass-through to sposób, w jaki dekoratory i funkcje opakowujące obsługują dowolną sygnaturę funkcji.

## Dlaczego to ważne

`*args`/`**kwargs` umożliwiają elastyczne sygnatury funkcji, które akceptują dowolną liczbę argumentów — niezbędne do pisania uniwersalnych narzędzi, wrapperów i szczególnie **dekoratorów** (które muszą zawinąć funkcje o nieznanej sygnaturze za pośrednictwem `*args, **kwargs`).

Kierunek rozpakowywania (`*lista`, `**słownik`) jest równie przydatny do przekazywania lub rozkładania argumentów.

Zrozumienie zarówno zbierania, jak i rozpakowywania jest kluczem do pisania wielokrotnego użytku, generycznego kodu Python oraz do czytania wielu interfejsów bibliotek i dekoratorów, które opierają się na tych funkcjach.