Hoe werken modules, imports en packages?

Question

Accepted Answer

A **module** is een enkel `.py` bestand; a **package** is een directory van modules. **Imports** stellen je in staat om code uit andere modules te gebruiken, waarbij een programma wordt georganiseerd in herbruikbare stukken.

## Modules en 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 — directories van 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
```

Het bestand `__init__.py` markeert een directory als een package (en kan code voor package-initialisatie uitvoeren of definiëren wat `from package import *` blootstelt).

## Het idioom `if __name__ == "__main__"`

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

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

Dit stelt een bestand in staat om zowel als importeerbare module *als* een runnable script te fungeren — de code eronder wordt alleen uitgevoerd wanneer het bestand rechtstreeks wordt uitgevoerd (`python file.py`), niet wanneer het wordt geïmporteerd. Een bijna universeel Python idioom.

## Waar Python naar modules zoekt

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

## Standaardbibliotheek en derde partijen

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

## Waarom het belangrijk is

Modules en packages zijn hoe je Python-code organiseert in herbruikbare, onderhoudbare eenheden in plaats van één reusachtig bestand — fundamenteel voor elk niet-triviaal project.

Het begrijpen van importstijlen, packagestructuur (`__init__.py`), het idioom `if __name__ == "__main__"` (dual script/module-gedrag) en hoe Python modules zoekt (`sys.path`) is essentieel voor het structureren van projecten, het hergebruiken van code en het gebruiken van de uitgebreide standaardbibliotheek en PyPI-ecosysteem.

Importfouten en structuurverwarring zijn veelvoorkomende vroege hobbels die deze kennis oplost.

Modules en importing

Packages — directories van modules

Het idioom if __name__ == "__main__"

Waar Python naar modules zoekt

Standaardbibliotheek en derde partijen

Waarom het belangrijk is

Het idioom `if name == "main"`