README.es.md

Errores, Archivos y Módulos

🇺🇸 English · 🇧🇷 Português · 🇪🇸 Español

Esta sección inicia la transición desde pequeños programas que trabajan solo en memoria hacia programas que deben afrontar fallos, datos persistentes y código organizado en varios archivos.

La Fase 7 comienza con el manejo de excepciones, continúa con la generación deliberada de excepciones, trabaja de forma segura con archivos y datos de texto estructurados y termina organizando código Python con imports, módulos y paquetes.

Ruta de aprendizaje

Capítulo	Enfoque principal	Nivel	Estado
01. try, except, else y finally	Manejar fallos esperados en runtime manteniendo explícitas las rutas normal y de limpieza	Principiante a intermedio	Disponible
02. Lanzar Excepciones y Excepciones Personalizadas	Señalar estados inválidos deliberadamente con raise, volver a lanzar o encadenar fallos de forma intencional e introducir excepciones personalizadas simples	Intermedio	Disponible
03. open() y with	Leer y escribir archivos de texto gestionando recursos de forma segura	Principiante a intermedio	Planificado
04. TXT, CSV y JSON	Trabajar con formatos comunes de datos basados en texto y sus límites	Intermedio	Planificado
05. Imports, Módulos y Paquetes	Dividir código en archivos reutilizables y comprender el modelo de importación de Python	Intermedio	Planificado

Orientación de prerrequisitos

Antes de comenzar esta fase, conviene estar cómodo con:

• condiciones y lógica booleana;
• bucles;
• funciones, parámetros y valores retornados;
• conversión básica de tipos;
• lectura conceptual de tracebacks simples;
• la diferencia entre comentarios del código fuente y comportamiento en runtime.

La ruta completa para principiantes de las Fases 1–6 proporciona todas estas bases.

Secuencia recomendada

Al seguir el currículo completo, estudia los capítulos en orden numérico:

01. Manejar excepciones
        ↓
02. Lanzar excepciones deliberadamente
        ↓
03. Abrir y gestionar archivos
        ↓
04. Leer y escribir formatos comunes de datos
        ↓
05. Organizar código con módulos y paquetes

La secuencia es intencional. Antes de que un programa empiece a depender de archivos y varios módulos, debe tener un modelo claro de lo que ocurre cuando una operación no puede terminar normalmente.

Objetivos de la sección

Al final de la Fase 7, deberías poder:

• distinguir el flujo de control normal del flujo provocado por excepciones;
• manejar excepciones específicas de runtime sin ocultar fallos no relacionados;
• usar else y finally deliberadamente;
• lanzar excepciones apropiadas cuando una función no puede cumplir su contrato;
• abrir, leer y escribir archivos usando patrones seguros de gestión de recursos;
• trabajar con texto simple, CSV y JSON a nivel introductorio;
• separar responsabilidades de parsing, validación, transformación y persistencia;
• importar código desde módulos y paquetes;
• explicar cómo archivos, excepciones, funciones y módulos se conectan en un pequeño programa real.

Capítulo actual

Continúa con Lanzar Excepciones y Crear Excepciones Personalizadas.

El Capítulo 01 establece el manejo de excepciones que ya ocurren. El Capítulo 02 añade raise deliberado, elección entre tipos built-in y personalizados, relanzamiento con raise sin expresión, encadenamiento explícito de excepciones y la distinción entre raise y assert. El próximo capítulo planificado es open() y with.

Estructura del directorio

errors-files-and-modules/
├── README.md
├── README.pt-BR.md
├── README.es.md
├── 01-try-except-else-finally/
│   ├── README.md
│   ├── README.pt-BR.md
│   ├── README.es.md
│   └── examples/
│       ├── parse_integer.py
│       ├── safe_divide.py
│       └── trace_try_else_finally.py
└── 02-raise-and-custom-exceptions/
    ├── README.md
    ├── README.pt-BR.md
    ├── README.es.md
    └── examples/
        ├── custom_exception.py
        ├── exception_chaining.py
        └── validate_score.py

Los directorios de capítulos planificados se añaden únicamente cuando su contenido se publica realmente.