Si funksionojnë modulet, importet dhe paketat?

Question

IT Interview Practice · Accepted Answer

Një **modul** është një skedar i vetëm `.py`; një **paket** është një drejtori modulesh. **Importet** ju lejojnë të përdorni kod nga module të tjera, duke organizuar një program në pjesë të ringjellshme.

## Modulet dhe importimi

```python
# math_utils.py — a module
def add(a, b): return a + b
PI = 3.14159
```

```python
# main.py — different ways to import
import math_utils                  # import the whole module
math_utils.add(2, 3)               # access via the module name

from math_utils import add, PI     # import specific names
add(2, 3)                          # use directly

from math_utils import add as plus # import with an alias
import numpy as np                 # common aliasing convention
```

## Paketat — direktoritë e moduleve

```text
mypackage/
  __init__.py        ← marks it as a package (can be empty)
  module_a.py
  subpackage/
    __init__.py
    module_b.py
```

```python
from mypackage.module_a import something
from mypackage.subpackage.module_b import other
```

Skedari `__init__.py` shënon një drejtori si paket (dhe mund të ekzekutojë kod inicializimi të paketës ose të përcaktojë se çfarë `from package import *` ekspozon).

## Idiomu `if __name__ == "__main__"`

```python
def main():
    print("running as a script")

if __name__ == "__main__":   # True only when run directly, not when imported
    main()
```

Kjo i lejon një skedari të funksionojë si modul i importueshëm *dhe* si skript i ekzekutueshëm — kodi nën të ekzekutohet vetëm kur skedari ekzekutohet drejtpërdrejt (`python file.py`), jo kur importohet. Një idiomë pothuajse universale e Python.

## Ku Python kërkon modulet

```python
import sys
sys.path   # the list of directories Python searches for imports
# includes: the current directory, installed packages (site-packages), stdlib
```

## Biblioteka standarde dhe palë të treta

```python
import os, json, datetime    # standard library — "batteries included"
import requests              # third-party — installed via pip from PyPI
```

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

Moduleti dhe paketat janë mënyra se si ju organizoni kodin Python në njësi të ringjellshme, të mirëmbajtshme përkundrazi një skedari gjigant — themelor për ndonjë projekt jo-trivial.

Kuptimi i stileve të importit, struktura e paketës (`__init__.py`), idiomu `if __name__ == "__main__"` (sjellje e dyfishtë e skriptit/modulit) dhe si Python gjen modulet (`sys.path`) është thelbësor për strukturimin e projekteve, rikërdorimin e kodit dhe përdorimin e bibliotekës standarde të gjerë dhe ekosistemit PyPI.

Gabime në importim dhe konfuzion në strukturë janë pengesë të hershme të zakonshme që ky njohuri zgjidh.

Si funksionojnë modulet, importet dhe paketat?

Modulet dhe importimi

Paketat — direktoritë e moduleve

Idiomu `if name == "main"`

Ku Python kërkon modulet

Biblioteka standarde dhe palë të treta

Pse kjo është e rëndësishme

Pyetje të ngjashme

Modulet dhe importimi

Paketat — direktoritë e moduleve

Idiomu if __name__ == "__main__"

Ku Python kërkon modulet

Biblioteka standarde dhe palë të treta

Pse kjo është e rëndësishme

Pyetje të ngjashme

Idiomu `if name == "main"`