Cilat lloje të dobishme ofron moduli collections?

Question

Accepted Answer

Moduli **`collections`** ofron lloje të kontejnerëve të specializuar që zgjerohen në list/dict/tuple-t e ndërtuar me alternativa të përshtatshme, shpesh më efikase për modelet e zakonshme. Njohja e tyre ju lejon të shkruani kod më të pastruar dhe më të shpejtë.

## defaultdict — fjalloret me vlera parazgjedhje automatike

```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)` (ose `int`, `set`, etj.) furnizon një parazgjedhje për çdo çelës që mungon — duke eleminuar modelin e lodhshëm të kontrollit dhe inicializimit. Shkëlqyeshëm për grupim dhe numërim.

## Counter — numërimi i dukuriveve

```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` bën numërimin e frekuencës të parëndësishëm — numërim fjalësh, votash, dukurivesh — me metoda të dobishme si `most_common`.

## deque — append/pop të shpejtë në TË DY skajet

```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` është një radhë me dy skaje me O(1) append/pop në të dy skajet — ideale për radha, grumbuj dhe dritare rrëshqitëse (një listë e zakonshme është O(n) për operacione përpara).

## namedtuple — regjistrime të lehta të emëruara

```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` i jep tuple-ve fusha të emëruara — më të lexueshme sesa qasja sipas indeksit, të pandryshoren, efikase në memorie. (Kodi modern shpesh përdor `@dataclass` në vend të kësaj për regjistrime të ndryshueshme.)

## OrderedDict / ChainMap (më pak i zakonshëm tani)

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

## Pse është e rëndësishme

Moduli `collections` ofron mjetin e duhur për modelet e zakonshme, duke çuar në kod më të pastruar dhe shpesh më efikas. `defaultdict` dhe `Counter` thjeshtojnë ndjeshëm grupimin dhe numërimin (duke zëvendësuar logjikën manuale të verbose); `deque` jep operacione O(1) me dy skaje ku një listë do të ishte e ngadaltë; `namedtuple` krijon regjistrime të lehta të lexueshme.

Zgjedhja e këtyre në vend të rikompilimit manual të të njëjtave modele me dict/lista të zakonshme është shenjë e Pythonit idiomatik dhe përfitues — përdoren gjerësisht në kodin real për përpunimin e të dhënave, algoritme dhe API të pastra.