¿Qué beneficio técnico principal aporta modularizar un proyecto Python?

La modularización bien hecha separa responsabilidades, facilita pruebas y reduce impacto de cambios.

Módulos, paquetes e imports en Python: arquitectura desde el inicio

Aprende a organizar proyectos Python en módulos y paquetes, usar imports correctamente y evitar ciclos o acoplamiento innecesario.

¿Cuánto sabes de Python?

📘 Teoría

1) Módulo: unidad mínima de organización

Cada módulo debe agrupar una responsabilidad coherente.

Si tienes funciones de validación, cálculo y persistencia en un solo archivo, el acoplamiento crece muy rápido.

Separar por módulos (`validators.py`, `services.py`, `repository.py`) hace explícita la arquitectura.

No se trata de crear muchos archivos porque sí, sino de mantener cohesión interna alta y dependencias claras.

Import de módulo estándar

import math

radio = 3
area = math.pi * radio ** 2
print(round(area, 2))

2) Paquetes y jerarquía de proyecto

Un paquete agrupa módulos del mismo dominio y define fronteras lógicas.

Estructuras típicas incluyen carpeta `app/` con submódulos por dominio: `users/`, `billing/`, `shared/`.

Evita importar desde capas inferiores hacia superiores de forma caótica; define dirección de dependencias.

Una jerarquía limpia permite que nuevos miembros entiendan el proyecto sin leer todo el código.

Estructura orientativa

Ejemplo de organización mínima escalable.

Import absoluto recomendado

Más legible en proyectos medianos/grandes.

3) Buenas prácticas de imports

Importar bien es una decisión de mantenibilidad, no solo de estilo.

Agrupa imports en tres bloques: estándar, terceros y módulos propios del proyecto.

Evita `from modulo import *`: contamina namespace y complica trazabilidad de símbolos.

Si detectas import circular, probablemente hay diseño de capas acoplado: extrae contratos o mueve responsabilidades.

Prefiere imports explícitos y trazables.
Mantén dependencias en una sola dirección entre capas.
Centraliza utilidades transversales en módulos compartidos.
Documenta entrypoint principal (`main.py`, `cli.py`, etc.).

Bloques de imports recomendados

import os
from datetime import datetime

import requests

from app.users.service import crear_usuario

print(datetime.now(), os.name)
print(crear_usuario('ana@empresa.com'))

1 1) Módulo: unidad mínima de organización 2 2) Paquetes y jerarquía de proyecto 3 3) Buenas prácticas de imports

🧪 Aprende probando

Ejemplo Ejemplo: importar módulo y usar API explícita Uso correcto de `import math` para mantener contexto del origen de funciones.

⌄

🏁 Retos

Reto Reto: corrige import y llamada Repara un código que usa `sqrt` sin importar su módulo origen.

⌄

🧰 Recursos

Enlaces útiles

Python Tutorial - Modules The import system Packaging Python Projects

Test

Comprueba tus conocimientos con un test sobre Python.

Test de Python

Recursos del curso 25

📘 Glosario 🎬 Vídeos 🔗 Enlaces

‹

Lección 09

Strings y f-strings en Python: texto limpio, formateo preciso y validación

Lección 11

Excepciones en Python: manejo de errores sin esconder problemas

›