Kif jaħdmu l-moduli, l-imports u l-packages?

Question

Accepted Answer

A **module** huwa file `.py` wieħed; a **package** huwa direttorju ta' moduli. **Imports** jippermettulek tuża kodiċi minn moduli oħrajn, u torganizza programm f'biċċiet li jistgħu jintużaw mill-ġdid.

## Moduli u import

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

## Packages — direttorji ta' moduli

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

Il-file `__init__.py` jimmarkax direttorju bħala package (u jista' jaħdem kodiċi ta' inizjalizzazzjoni ta' package jew jiddefinisċi x'inhu `from package import *` jesponi).

## L-idioma `if __name__ == "__main__"`

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

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

Da jippermettu file jiaħdem kemm module importabbli *u* skript li jista' jaħdem — il-kodiċi taħtu jaħdem biss meta l-file jiġi esegwit direttament (`python file.py`), mhux meta jiġi importat. Idioma Python li hemmx universali.

## Fejn ifittex Python moduli

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

## Il-librerija standard u parts terza

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

## Għaliex dan hu importanti

Moduli u packages huma kif torganizza kodiċi Python f'unitajiet li jistgħu jintużaw mill-ġdid u faċli għad-dħul, minflok file wieħed ħamsa — fundamentali għal kwalunkwe proġett mhux trivjali.

L-għarfien tal-istili ta' import, l-istruttura ta' package (`__init__.py`), l-idioma `if __name__ == "__main__"` (imġieba doppja ta' skrip/module), u kif Python ifittex moduli (`sys.path`) huwa essenzjali għall-istrutturar tal-proġetti, ir-riuż ta' kodiċi, u l-użu tal-librerija standard estesa u l-ekosistema PyPI.

L-iżbalji tal-import u l-konfużjoni tal-istruttura huma ostakli bikrija komuni li dan il-għarfien jsolvi.

Moduli u import

Packages — direttorji ta' moduli

L-idioma if __name__ == "__main__"

Fejn ifittex Python moduli

Il-librerija standard u parts terza

Għaliex dan hu importanti

L-idioma `if name == "main"`