Module ya collections hutoa aina gani muhimu?

Question

Accepted Answer

Module ya **`collections`** hutoa aina maalum za container zinazopanua list/dict/tuple za kawaida kwa mbadala wenye urahisi, mara nyingi wenye ufanisi zaidi kwa patterns za kawaida. Kuzijua hukuwezesha kuandika code iliyo safi na haraka zaidi.

## defaultdict — dicts zenye thamani chaguo-msingi za kiotomatiki

```python
from collections import defaultdict

# ❌ without it — must check/initialize keys manually
groups = {}
for item in items:
    if item.category not in groups:
        groups[item.category] = []
    groups[item.category].append(item)

# ✅ defaultdict auto-creates the default for missing keys
groups = defaultdict(list)        # missing key → a new empty list
for item in items:
    groups[item.category].append(item)   # no existence check needed
```

`defaultdict(list)` (au `int`, `set`, n.k.) hutoa chaguo-msingi kwa key yoyote inayokosekana — ikiondoa pattern ya kuchosha ya kukagua-na-kuanzisha. Bora kwa grouping na counting.

## Counter — hesabu matukio

```python
from collections import Counter

c = Counter("mississippi")         # Counter({'i': 4, 's': 4, 'p': 2, 'm': 1})
c.most_common(2)                    # [('i', 4), ('s', 4)] — top 2
c["x"]                              # 0 — missing keys return 0, no error

Counter(["a", "b", "a", "c", "a"])  # count list items → {'a': 3, 'b': 1, 'c': 1}
```

`Counter` hufanya kuhesabu marudio kuwa rahisi — kuhesabu maneno, kura, matukio — na methods rahisi kama `most_common`.

## deque — appends/pops za haraka kwenye PANDE ZOTE MBILI

```python
from collections import deque

q = deque([1, 2, 3])
q.append(4)          # add to the right
q.appendleft(0)      # add to the LEFT — O(1) (a list's insert(0) is O(n)!)
q.popleft()          # remove from the left — O(1)
q = deque(maxlen=3)  # bounded — auto-drops old items (sliding window)
```

`deque` ni double-ended queue yenye appends/pops za O(1) kwenye pande zote mbili — bora kwa queues, stacks, na sliding windows (list ya kawaida ni O(n) kwa operesheni za mbele).

## namedtuple — records nyepesi, zenye majina

```python
from collections import namedtuple

Point = namedtuple("Point", ["x", "y"])
p = Point(3, 4)
p.x, p.y          # 3, 4 — access by NAME (clearer than p[0], p[1])
p                 # Point(x=3, y=4) — readable
```

`namedtuple` huipa tuples fields zenye majina — rahisi kusoma zaidi kuliko ufikiaji wa index, immutable, yenye ufanisi wa memory. (Code ya kisasa mara nyingi hutumia `@dataclass` badala yake kwa records zinazobadilika.)

## OrderedDict / ChainMap (si za kawaida sasa)

```text
OrderedDict → ordered dict (less needed since regular dicts keep order in 3.7+)
ChainMap    → search multiple dicts as one (e.g. layered config/defaults)
```

## Kwa nini ni muhimu

Module ya `collections` hutoa zana sahihi kwa patterns za kawaida, ikiongoza kwa code iliyo safi na mara nyingi yenye ufanisi zaidi. `defaultdict` na `Counter` hurahisisha sana grouping na counting (zikibadilisha mantiki ndefu ya mkono); `deque` hutoa operesheni za O(1) za pande mbili pale ambapo list ingekuwa polepole; `namedtuple` hufanya records nyepesi zinazosomeka.

Kufikia hizi badala ya kutengeneza kwa mkono patterns zilezile na dicts/lists za kawaida ni alama ya Python ya kiidiomatiki, yenye utendaji — zinatumika sana katika code halisi kwa usindikaji wa data, algoriti, na APIs safi.