Conas a oibríonn modúil, iompórtálacha agus pacáistí?

Question

Accepted Answer

Is **modúl** ina bhfuil comhad `.py` amháin; is **pacáiste** ina bhfuil eolaire de mhodúil. Ligeann **iompórtálacha** duit cód ó mhodúil eile a úsáid, agus eagraíonn siad clár ina bpíosaí athúsáidte.

## Modúil agus iompórtáil

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

## Pacáistí — eolairí modúil

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

Markálann an comhad `__init__.py` eolaire mar phacáiste (agus is féidir leis cód tús-phacáiste a rith nó a shainmhíniú ar a dhéanann `from package import *` a nochtadh).

## An idiom `if __name__ == "__main__"`

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

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

Ligann sé seo do chomhad gníomhú mar mhodúl iompórtáilte *agus* scrípt inriththeach araon — níl an cód faoi seo ach ag rith nuair a bhíonn an comhad á fhorghníomhú go díreach (`python file.py`), ní nuair a bhíonn sé iompórtáilte. Idiom Python beagnach uilíoch.

## Áit ar lorgaíonn Python modúil

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

## Leabharlann chaighdeánach agus tríú páirtí

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

## Cén fáth a bhfuil sé tábhachtach

Is iad modúil agus pacáistí an chaoi ar eagraíonn tú cód Python ina aonáin athúsáidte, inchosúinte seachas fhéichaint amháin ollmhór — is iad seo bunúsach d'aon tionscadal nach bhfuil fánach.

Tá sé riachtanach tuiscint a bheith agat ar an stíl iompórtála, ar struchtúr pacáiste (`__init__.py`), ar an idiom `if __name__ == "__main__"` (iompar dhá scrípt/modúl), agus ar an chaoi ar aimsíonn Python modúil (`sys.path`) chun tionscadail a struchtúrú, cód a athúsáid, agus an leabharlann chaighdeánach agus an timpeallacht PyPI a úsáid.

Is earraí coitíanta tosaigh iad earráidí iompórtála agus mearbhall ar struchtúr a réitíonn an t-eolas seo.

Modúil agus iompórtáil

Pacáistí — eolairí modúil

An idiom if __name__ == "__main__"

Áit ar lorgaíonn Python modúil

Leabharlann chaighdeánach agus tríú páirtí

Cén fáth a bhfuil sé tábhachtach

An idiom `if name == "main"`