Módulos en Python: Creación, importación y uso avanzado

Módulos en Python

Descubra cómo construir, importar y gestionar módulos en Python. Aprenda mejores prácticas, técnicas avanzadas de importación y rutas de búsqueda de módulos.

Video: Módulos en Python

Vea un tutorial en profundidad sobre fundamentos de módulos.

¿Qué son los módulos en Python?

Un módulo es simplemente un archivo que contiene sentencias y definiciones de Python. Por ejemplo, ejemplo.py es un módulo llamado ejemplo. Los módulos le ayudan a dividir programas grandes en piezas manejables y reutilizables. Defina funciones comunes una vez e impórtelas donde sea necesario.

Creemos un pequeño módulo. Guarde lo siguiente como ejemplo.py:

# ejemplo.py – un módulo simple de adición
def sumar(a, b):
    """Devuelve la suma de dos números."""
    return a + b

Cómo importar módulos en Python

Use la palabra clave import para traer un módulo al espacio de nombres actual. Por ejemplo:

>>> import ejemplo

Acceda a su contenido vía operador punto:

>>> ejemplo.sumar(4, 5.5)
9.5

Python viene con una rica biblioteca estándar. Puede explorar todos los módulos en Python Standard Library.

Sentencia import de Python

# Importar el módulo math estándar
import math
print("El valor de pi es", math.pi)

El valor de pi es 3.141592653589793

Importar con renombrado

# Importar math como alias más corto
import math as m
print("El valor de pi es", m.pi)

Renombrar ahorra escritura, pero recuerde que el nombre original (math) ya no está disponible.

Sentencia from…import de Python

# Importar solo la constante pi desde math
from math import pi
print("El valor de pi es", pi)

Múltiples nombres pueden importarse en una línea:

from math import pi, e
print(pi, e)

Importar todos los nombres

from math import *
print("El valor de pi es", pi)

Usar * está desaconsejado porque contamina el espacio de nombres y puede ocultar de dónde vino un nombre.

Ruta de búsqueda de módulos en Python

Cuando Python importa un módulo, verifica:

• El directorio actual.
• Directorios listados en la variable de entorno PYTHONPATH.
• Directorios por defecto específicos de la instalación de Python.

Inspeccione la lista de rutas con sys.path:

import sys
print(sys.path)
# ['', 'C:\Python33\Lib\idlelib', 'C:\Windows\system32\python33.zip', ...]

Recarga de un módulo

Los módulos se cargan solo una vez por sesión del intérprete. Para re-evaluar un módulo cambiado, use importlib.reload() (el módulo imp está deprecado en Python 3). Ejemplo:

# mi_modulo.py
print("Este código se ejecutó")

>>> import mi_modulo
Este código se ejecutó
>>> importlib.reload(mi_modulo)
Este código se ejecutó

La función integrada dir()

Use dir() para listar todos los atributos de un módulo:

import ejemplo
print(dir(ejemplo))
# ['__builtins__', '__cached__', '__doc__', '__file__', '__name__', 'sumar']

Atributos especiales como __name__ revelan metadatos del módulo:

print(ejemplo.__name__)
# 'ejemplo'

Llamar a dir() sin argumentos muestra todos los nombres en el espacio de nombres actual.