Çfarë janë *args dhe **kwargs?

Question

Accepted Answer

`*args` dhe `**kwargs` lejojnë një funksion të pranojë një **numër variabil** të argumenteve. `*args` mbledhë argumentet shtesë **pozicionale** në një tuple; `**kwargs` mbledhë argumentet shtesë të **fjalës kyçe** në një fjalor. (Emrat janë konventë — `*` dhe `**` janë ajo që ka rëndësi.)

## *args — argumentet pozicionale variabël

```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 — argumentet variabël të fjalës kyçe

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

## Kombinimi i tyre (me parametrat e zakonshëm)

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

Rendi i kërkuar është: parametrat e zakonshëm, pastaj `*args`, pastaj `**kwargs`.

## Shpaketimi — drejtimi i kundërt

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

I njëjti sintaksi shpaketizon një listë/fjalor në argumentet pozicionale/fjalë kyçe — i dobishëm për përadhënien e argumenteve.

## Rasti më i zakonshëm real use: përadhënia e argumenteve (dekoratorët, përputhësit)

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

Esti model pass-through është mënyra se si dekoratorët dhe funksionet përputhës përdorin ndonjë nënshkrim funksioni.

## Pse ka rëndësi

`*args`/`**kwargs` mundësojnë nënshkrime funksionesh fleksibël që pranojnë ndonjë numër argumentesh — thelbësor për shkrimin e mjeteve me qëllim të përgjithshëm, përputhësve dhe veçanërisht **dekoratorëve** (të cilët duhet të përputhjen funksionet e nënshkrimeve të panjohura përmes `*args, **kwargs`).

Drejtimi i shpaketimit (`*listë`, `**fjalor`) është njëlloj i dobishëm për përadhënien ose përhapin e argumenteve.

Kuptimi i mbledhjes dhe shpaketimit është kyç për shkrimin e kodit Python të rigjatshëm dhe gjenerik dhe për leximin e shumë API-ve të bibliotekave dhe dekoratorëve që mbështeten në këto veçori.