Módulos en Python: cómo importar y trabajar con ellos

Fundamentos del trabajo con módulos en Python

Trabajar con módulos y organizar correctamente las importaciones son aspectos clave para escribir código limpio, estructurado y escalable en Python. El potente sistema de módulos de Python permite utilizar librerías integradas, paquetes de terceros y crear tus propios módulos.

En esta guía, analizaremos en detalle el mecanismo de las importaciones. Veremos cómo usar módulos populares de Python como os y sys. También estudiaremos los principios para estructurar proyectos de manera que sea fácil usar tus propios módulos.

¿Qué es un módulo en Python?

Un módulo en Python es simplemente un archivo con extensión .py. Contiene variables, funciones, clases o código ejecutable. Los módulos se pueden incluir en otros programas para reutilizar su funcionalidad.

Usar módulos en Python permite:

• Reutilizar el código ya escrito
• Dividir el proyecto en partes lógicas
• Mejorar la legibilidad del código
• Simplificar el mantenimiento de los programas
• Crear una arquitectura de aplicaciones más estructurada

Formas de importar módulos en Python

Importación básica de un módulo

La forma más simple de importar usa la palabra clave import:

import math
print(math.sqrt(16))  # Resultado: 4.0

En este ejemplo se usa el módulo integrado math, que proporciona diversas funciones matemáticas para realizar cálculos.

Importación con alias

Importar un módulo con un alias simplifica su uso en el código:

import math as m
print(m.pi)  # Resultado: 3.141592653589793

Este enfoque es útil cuando el módulo tiene un nombre largo o cuando se usa con frecuencia en el código.

Importar funciones específicas de un módulo

Puedes importar solo las funciones que necesitas de un módulo:

from math import sqrt
print(sqrt(25))  # Resultado: 5.0

Esta forma permite llamar a la función directamente, sin necesidad de especificar el nombre del módulo.

Importar todos los objetos de un módulo

Python permite importar todos los objetos de un módulo a la vez:

from math import *
print(sin(0))  # Resultado: 0.0

No se recomienda usar este enfoque, ya que reduce la legibilidad del código y aumenta el riesgo de conflictos con nombres de variables y funciones.

Mecanismo de búsqueda de módulos en Python

Orden de búsqueda de módulos

Python busca los módulos en el siguiente orden:

• El directorio de trabajo actual
• Los directorios de la variable de entorno PYTHONPATH
• Los directorios estándar de instalación de Python
• Los directorios de site-packages

Verificar las rutas de búsqueda de módulos

Puedes ver la lista de directorios donde Python busca módulos usando el módulo sys:

import sys
print(sys.path)

Este comando muestra la lista completa de directorios en los que Python busca los módulos y paquetes que se importan.

Añadir rutas personalizadas

Si es necesario, puedes agregar rutas adicionales para la búsqueda:

import sys
sys.path.append('/ruta/personalizada/a/modulos/')

Trabajar con el módulo os en Python

Funcionalidades principales del módulo os

El módulo os proporciona herramientas potentes para interactuar con el sistema operativo. Permite realizar operaciones con archivos y directorios.

Obtener información del directorio actual

import os
print(os.getcwd())

La función getcwd() devuelve la ruta al directorio de trabajo actual.

Ver el contenido de un directorio

archivos = os.listdir('.')
print(archivos)