Πώς λειτουργούν τα modules, τα imports και τα packages;

Question

Accepted Answer

Ένα **module** είναι ένα μόνο αρχείο `.py`· ένα **package** είναι ένας κατάλογος modules. Τα **imports** σας επιτρέπουν να χρησιμοποιήσετε κώδικα από άλλα modules, οργανώνοντας ένα πρόγραμμα σε επαναχρησιμοποιήσιμα κομμάτια.

## Modules και importing

```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 — κατάλογοι modules

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

Το αρχείο `__init__.py` σηματοδοτεί έναν κατάλογο ως package (και μπορεί να εκτελέσει κώδικα αρχικοποίησης του package ή να ορίσει τι εκθέτει το `from package import *`).

## Το `if __name__ == "__main__"` idiom

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

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

Αυτό επιτρέπει σε ένα αρχείο να λειτουργεί ταυτόχρονα ως importable module *και* ως εκτελέσιμο script — ο κώδικας κάτω από αυτό εκτελείται μόνο όταν το αρχείο εκτελείται απευθείας (`python file.py`), όχι όταν εισάγεται. Ένα σχεδόν καθολικό Python idiom.

## Όπου η Python αναζητά modules

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

## Τυπική βιβλιοθήκη και τρίτα μέρη

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

## Γιατί είναι σημαντικό

Τα modules και τα packages είναι ο τρόπος με τον οποίο οργανώνετε τον κώδικα Python σε επαναχρησιμοποιήσιμες, διατηρήσιμες μονάδες αντί για ένα γιγάντιο αρχείο — θεμελιώδες για κάθε μη τετριμμένο project.

Η κατανόηση των στυλ import, της δομής package (`__init__.py`), του `if __name__ == "__main__"` idiom (διπλή συμπεριφορά script/module) και του πώς η Python βρίσκει modules (`sys.path`) είναι απαραίτητη για τη δόμηση projects, την επαναχρησιμοποίηση κώδικα και τη χρήση του τεράστιου standard library και του PyPI οικοσυστήματος.

Τα σφάλματα import και η σύγχυση δομής είναι συνηθισμένα αρχικά εμπόδια που αυτή η γνώση λύνει.

Modules και importing

Packages — κατάλογοι modules

Το if __name__ == "__main__" idiom

Όπου η Python αναζητά modules

Τυπική βιβλιοθήκη και τρίτα μέρη

Γιατί είναι σημαντικό

Το `if name == "main"` idiom