Ahora que hemos aprendido qué son los módulos y los paquetes, veamos las diferentes formas en que podemos incorporarlos a nuestros programas.

Recuerda:

• Un módulo es un solo archivo de Python (.py) que contiene código que puedes reutilizar.
• Un paquete es una colección de módulos relacionados en una carpeta que contiene un archivo __init__.py.

El objetivo principal de importar es organizar el código y facilitar su reutilización sin copiar y pegar.

Importar un paquete o módulo completo

La forma más común de importar es con la palabra clave import. Ejemplo — importar el módulo integrado math de Python:

import math

Una vez importado, accedes a sus funciones con la sintaxis:

nombre_modulo.nombre_funcion()

Ejemplo:

print(math.sqrt(25))  # devuelve 5.0

Aquí, math.sqrt() significa “usar la función sqrt del módulo math”.

CONSEJO: Este enfoque mantiene tu código claro porque muestra exactamente de dónde viene cada función.

Importar una función o variable específica

También puedes importar solo lo que necesitas de un módulo usando from ... import ....

Ejemplo — importar solo la función sqrt:

from math import sqrt

print(sqrt(25))  # devuelve 5.0

Ahora podemos llamar a sqrt() directamente sin poner math. delante.

Nota: Esto puede hacer el código más corto, pero si importas muchas cosas así, se vuelve más difícil saber de dónde viene cada función.

Importar todo de un módulo (No recomendado)

Puedes importar todas las funciones y variables de un módulo de una vez usando *:

from math import *
print(sqrt(25))  # devuelve 5.0

Por qué se desaconseja esto:

• Puede sobrescribir variables o funciones existentes sin aviso.
• Hace que no quede claro de qué módulo proviene una función.
• Puede ralentizar tu programa si el módulo es grande.

IMPORTANTE: Evita from módulo import * a menos que tengas una muy buena razón y controles todo el código.

Importar con un alias

A veces el nombre de un módulo es largo o se usa muy a menudo en tu código. Puedes darle un alias más corto usando as.

Ejemplo — importar NumPy con el alias np:

import numpy as np

x = np.array([1, 2, 3])

Ahora puedes llamar a las funciones de NumPy con np. en lugar de numpy.. Esta es una convención común en la comunidad Python.

Resumen de estilos de importación

• import módulo — Claro y explícito; usa el nombre completo cada vez.
• from módulo import función — Llamadas más cortas, pero menos explícitas.
• from módulo import * — Evitar a menos que sea absolutamente necesario.
• import módulo as alias — Acorta nombres largos manteniendo claridad.

En la próxima lección, avanzaremos a manejo de archivos — leer y escribir datos en archivos para que tus programas puedan recordar información incluso después de dejar de ejecutarse.