Vipi parameters ya kazi na default arguments zinavyofanya kazi?

Question

Accepted Answer

Kazi za Python zinakubaliana na **positional** na **keyword** arguments, pamoja na **default values**. Kuelewa jinsi yanavyounganisha — na moja ya mada inayojulikana ya default-argument — ni muhimu.

## Positional, keyword, na default arguments

```python
def greet(name, greeting="Hello", punctuation="!"):
    return f"{greeting}, {name}{punctuation}"

greet("Ann")                          # positional → "Hello, Ann!"
greet("Ann", "Hi")                    # "Hi, Ann!"
greet("Ann", punctuation=".")          # keyword arg → "Hello, Ann."
greet(name="Ann", greeting="Hey")      # all by keyword
```

Parameters wenye defaults ni wa juu; unaweza kupitisha arguments kwa position au kwa jina (keyword args huboresha usomaji na kukuruhusu kusimama parametara za chaguzi za mapema).

## Njia inayojulikana: mutable default arguments

```python
# ❌ DANGER — the default list is created ONCE and SHARED across all calls
def add_item(item, items=[]):
    items.append(item)
    return items

add_item("a")   # ["a"]
add_item("b")   # ["a", "b"]  ← surprise! the SAME list persisted
```

Default values hujumuishwa **mara moja** wakati kazi inafafanuliwa, si kila kupiga simu. Mutable default (list/dict) kwa hivyo inashirikiwa kati ya kupiga simu — hitilafu ya kawaida. Suluhisho:

```python
# ✅ use None as the default and create a fresh object inside
def add_item(item, items=None):
    if items is None:
        items = []
    items.append(item)
    return items
```

## Keyword-only na positional-only parameters

```python
def f(a, b, *, key):       # `*` → `key` MUST be passed by keyword
    ...
f(1, 2, key=3)             # ✅   f(1, 2, 3) ❌

def g(a, b, /, c):         # `/` → a, b MUST be positional
    ...
```

Markers `*` na `/` zinakuruhusu kutekeleza jinsi arguments zinazopitishwa — muhimu kwa API zenye wazi na imara.

## Kwa nini iliyomo maana

Kuelewa upangaji wa parameter ni msingi wa kuandika na kumwita kazi za Python kwa usahihi.

Defaults hufanya kazi nyingi, na keyword arguments hufanya kupiga simu kuwa kujisomeza hati.

Kwenye dhahirika, **mutable-default-argument trap** ni moja ya mada ya kawaida zaidi na inayosababisha kuchanganyikiwa Python — kujua kwamba defaults hujumuishwa mara moja (kwa hivyo mutable defaults hudumu kati ya kupiga simu) na `None`-sentinel fix inazuia darasa lote la hitilafu zenye msumari.

Ujumbe huu unawasaidia kubuni API za kazi safi na zinazoweza kupeweka.