Mitä ovat `*args` ja `**kwargs`?

Question

Accepted Answer

`*args` ja `**kwargs` antavat funktiolle mahdollisuuden hyväksyä **muuttuva määrä** argumentteja. `*args` kerää ylimääräiset **paikallaan olevat** argumentit tuple-ksi; `**kwargs` kerää ylimääräiset **nimetyt** argumentit dict-ksi. (Nimet ovat sopimus — `*` ja `**` ovat se, mikä on tärkeää.)

## *args — muuttuvat paikallaan olevat argumentit

```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 — muuttuvat nimetyt argumentit

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

## Yhdistäminen tavallisten parametrien kanssa

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

Vaadittava järjestys on: tavalliset parametrit, sitten `*args`, sitten `**kwargs`.

## Pakkauksen avaaminen — käänteinen suunta

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

Sama syntaksi avaa listan/dict-objektin paikallaan oleviksi/nimetyiksi argumenteiksi — kätevää argumenttien välittämiseen.

## Yleisin käytännön käyttö: argumenttien välittäminen (dekoraattorit, wrapper-funktiot)

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

Tämä läpivientikuvio on se, miten dekoraattorit ja wrapper-funktiot käsittelevät mitä tahansa funktioiden allekirjoitusta `*args, **kwargs`:n kautta.

## Miksi se on tärkeää

`*args`/`**kwargs` mahdollistavat joustavat funktioiden allekirjoitukset, jotka hyväksyvät minkä tahansa määrän argumentteja — välttämätöntä yleiskäyttöisten apuohjelmien, wrappereita ja erityisesti **dekoraattoreiden** kirjoittamiseen (joiden on kääritävä funktioita, joilla on tuntemattomia allekirjoituksia `*args, **kwargs`-syntaksin kautta).

Pakkauksen avaamisen suunta (`*list`, `**dict`) on yhtä hyödyllinen argumenttien välittämiselle tai levittämiselle.

Sekä keräämisen että pakkauksen avaamisen ymmärtäminen on avain uudelleenkäytettävän, yleisen Python-koodin kirjoittamiseen ja monien kirjasto-API:en ja dekoraattoreiden lukemiseen, jotka luottavat näihin ominaisuuksiin.