Palabras clave en Python: import

La palabra clave import permite incorporar módulos y objetos externos para extender las capacidades de tus programas en Python.

Los imports actúan como conexión entre tu código y el ecosistema Python. Con ella puedes acceder a funciones, clases y constantes definidas en otros módulos, ya sea de la biblioteca estándar, de terceros o propios.

Sintaxis básica

La forma más directa de cargar un módulo consiste en escribir su nombre después de la palabra clave:

import module_name

También puedes asignar un alias que resulte más corto o significativo, aprovechando la palabra clave as:

import module_name as alias

Otra opción consiste en traer símbolos concretos desde el módulo para usarlos directamente:

from module_name import name

Si lo necesitas, también puedes renombrar el símbolo importado:

from module_name import name as alias

Los imports selectivos te permiten traer únicamente los nombres que necesitas:

from math import pi, sqrt

Finalmente, los imports relativos privilegian módulos dentro de tu propio paquete:

from .helpers import parse_config

Este estilo solo funciona dentro de paquetes y ayuda a mantener rutas cortas y claras.

Ejemplos prácticos

A continuación algunos ejemplos prácticos de cómo usar la palabra clave import:

>>> import random
>>> random.choice(["🐍", "🧠", "⚙️"])
'🐍'

>>> import statistics as sts
>>> sts.mean([10, 15, 20])
15

>>> from statistics import median
>>> median([1, 9, 3, 5])
4.0

Estos ejemplos muestran cómo import activa capacidades adicionales sin necesidad de duplicar código ni copiar archivos.

Cuándo usar import

Los usos más frecuentes de la palabra clave import incluyen los siguientes:

• Acceder a paquetes y módulos de la biblioteca estándar, tales como math, datetime, pathlib o itertools.
• Usar paquetes de terceros, tales como requests, numpy, pandas o cualquier otro que instales con herramientas como pip o uv.
• Modularizar proyectos propios y dividir tu aplicación en múltiples archivos con responsabilidades específicas.
• Configurar extensiones opcionales y cargar dinámicamente módulos solo cuando se requieren, reduciendo tiempos de arranque.

Buenas prácticas

• Agrupa las importaciones al inicio de cada archivo siguiendo el orden:
  1. Librería estándar
  2. Paquetes de terceros
  3. Paquetes locales.
• Sitúa estas importaciones antes de tus definiciones de funciones y clases, manteniendo cada archivo coherente y fácil de recorrer.
• Usa alias descriptivos solo cuando aporten claridad.
• Evita from module import * (wildcard imports), pues comprometen la legibilidad del código, contaminan tu espacio de nombres y puede sobrescribir nombres sin aviso, causando bugs.

Resumiendo

La palabra clave import es la base de la modularidad en Python. Te permite incorporar funcionalidad existente, mantener el código ordenado y facilitar la colaboración entre diferentes partes de un proyecto.

Dominar sus variantes y buenas prácticas te ayuda a escribir programas limpios, escalables y fáciles de mantener.