roadmap.es.md

Roadmap de Python Study Guide

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

Este roadmap acompaña tanto la ruta educativa como la base del repositorio que la sostiene. La numeración de las fases representa la secuencia de aprendizaje prevista, pero el trabajo del repositorio puede anticipar secciones posteriores cuando eso ayude a establecer estándares útiles.

Leyenda de estados

• Completada: el alcance planificado está disponible y revisado.
• En progreso: ya existe material útil, pero el alcance planificado todavía no está cerrado.
• Planificada: la fase todavía no ha comenzado como una sección completa de aprendizaje.

Progreso actual

Fase	Estado	Resultado actual
0. Base del proyecto	Completada	Base disponible, auditada y oficialmente completada
1. Fundamentos	Completada	Seis capítulos revisados cubren ejecución, entrada y salida, variables y nombres, tipos de datos incorporados, inspección de tipos y conversión de tipos
2. Textos y números	Completada	Cuatro capítulos revisados cubren creación de strings, métodos comunes, comportamiento numérico y booleano, precisión de punto flotante y funciones numéricas incorporadas
3. Colecciones	Completada	Seis capítulos revisados cubren listas, tuplas, diccionarios, conjuntos y elección de colección según la intención
4. Flujo del programa	Completada	Ocho capítulos revisados cubren condiciones, ramificaciones, coincidencia de patrones estructurales, for, ayudas de iteración, while, control de bucles y elección y combinación de herramientas de flujo según la intención
5. Funciones	Completada	Nueve capítulos revisados cubren def, llamadas, entradas obligatorias, valores retornados, alcance, type hints, valores predeterminados seguros, argumentos flexibles, composición de funciones y flujo explícito de datos
6. Comentarios, documentación y código limpio	Completada	Seis capítulos revisados están disponibles y la sección educativa piloto está oficialmente completada
7. Errores, archivos y módulos	En progreso	Los Capítulos 01–02 cubren manejo de excepciones de runtime y generación, relanzamiento, encadenamiento y definición deliberada de excepciones personalizadas
8. Biblioteca estándar	Planificada	Contenido todavía no iniciado
9. Bibliotecas externas	Planificada	Contenido todavía no iniciado
10. Proyectos prácticos	Planificada	Contenido todavía no iniciado

Las Fases 0, 1, 2, 3, 4, 5 y 6 están completadas. La Fase 7 está en progreso, ahora con manejo y lanzamiento deliberado de excepciones disponibles antes de los capítulos posteriores sobre archivos y módulos. La Fase 6 continúa proporcionando el modelo editorial y de calidad para las secciones posteriores.

Fase 0: Base del proyecto

Elementos completados

• READMEs principales multilingües
• Estructura inicial escalable
• Guías de contribución multilingües
• Plantillas de pull request e issues en GitHub
• Estándares de la comunidad y orientaciones para reportes
• Formato editorial coherente para los capítulos
• Licencia MIT
• Registros de autoría y mantenimiento
• Flujo basado en pull requests y rama main protegida
• Instrucciones del repositorio para colaboradores y agentes de IA
• Guía de desarrollo responsable asistido por IA
• Roadmap y documentación de la estructura en tres idiomas
• Verificaciones automáticas para archivos Python, ejemplos aprobados, enlaces internos y estructura
• Identidad visual original y recursos del repositorio
• Auditoría final de navegación, terminología, accesibilidad y estado
• Marcar oficialmente la Fase 0 como completada

Seguimiento planificado y no bloqueante

• Refinar y reemplazar los recursos visuales con exportaciones de alta calidad después de completar el encuadre final del logotipo.

Fase 1: Fundamentos

• Cómo Python ejecuta un programa
• print() e input()
• Variables y nombres
• Tipos de datos incorporados
• type() e isinstance()
• Conversión de tipos

Fase 2: Textos y números

• Creación e indexación de strings
• Métodos comunes de strings
• int, float y bool
• Funciones numéricas incorporadas: round(), abs(), min(), max() y sum()

Fase 3: Colecciones

• Creación, indexación y slicing de listas
• Modificar listas y métodos comunes
• Tuplas e inmutabilidad
• Diccionarios: claves y valores
• Conjuntos y valores únicos
• Elegir la colección adecuada

Fase 4: Flujo del programa

Consulta la ruta de aprendizaje de la sección.

• Condiciones, comparaciones y lógica booleana
• if, elif y else
• match y case: coincidencia de patrones estructurales
• Bucles for e iteración
• range(), enumerate() y zip()
• Bucles while y repetición guiada por estado
• break, continue y else de bucles
• Elegir y combinar el flujo del programa

La Fase 4 construye intencionalmente condiciones confiables primero, las usa para ramificaciones condicionales, introduce coincidencia de patrones estructurales, avanza hacia la repetición con for, añade ayudas para progresiones numéricas, posiciones e iteración paralela, introduce repetición guiada por estado con while, añade control deliberado de bucles con break, continue y else de bucle y cierra enseñando cómo elegir y combinar esas herramientas según la intención. Los Capítulos 01–08 están completados y la Fase 4 está oficialmente completada.

Fase 5: Funciones

Consulta la ruta de aprendizaje de la sección.

• Definir y llamar funciones
• Parámetros y argumentos
• Valores de retorno
• Alcance
• Type hints
• Valores predeterminados
• *args y **kwargs
• Funciones trabajando juntas
• Flujo de datos entre funciones

La Fase 5 está completada. El Capítulo 01 establece def, llamadas, reutilización, orden de ejecución, nombres, pass, None implícito y la conexión con el flujo del programa. El Capítulo 02 añade parámetros obligatorios, argumentos posicionales y por palabra clave básicos, expresiones como argumentos, errores de llamada y seguimiento del flujo de entrada. El Capítulo 03 añade return, resultados reutilizables, retornos por rama y anticipados, None y retornos en tupla. El Capítulo 04 añade nombres locales y globales, namespaces locales por llamada, búsqueda, sombreado, NameError, UnboundLocalError y uso cauteloso de global. El Capítulo 05 añade anotaciones de parámetros y retorno, hints de tipos incorporados y colecciones, -> None, str | None, metadatos de anotaciones y la diferencia entre información estática de tipos, validación en runtime y conversión. El Capítulo 06 añade valores predeterminados, reemplazos posicionales y por palabra clave selectivos, evaluación al definir la función, la trampa de valores mutables y el patrón seguro con None para crear objetos mutables nuevos. El Capítulo 07 añade recolección de cantidades variables de argumentos posicionales y por palabra clave con *args y **kwargs, comportamiento de tupla y diccionario dentro de la función, firmas mixtas simples, type hints básicos para los valores recogidos y la distinción entre recolección en la definición y desempaquetado posterior en la llamada. El Capítulo 08 compone funciones auxiliares y coordinadoras, pasa resultados retornados entre pasos, mantiene explícitas las dependencias mediante parámetros y retornos, combina funciones con condiciones y bucles, distingue cálculo reutilizable de presentación e introduce grafos simples de llamadas. El Capítulo 09 cierra la fase siguiendo el flujo llamador-parámetro-retorno, los vínculos locales de parámetros, reasignación frente a mutación, resultados en tupla y None, pipelines explícitos, transformaciones de colecciones y la diferencia entre grafos de llamadas y seguimientos de flujo de datos.

Fase 6: Comentarios, documentación y código limpio

Consulta la ruta de aprendizaje de la sección.

• Cuándo y por qué comentar
• Cuándo no comentar
• Comentarios útiles y perjudiciales
• Docstrings
• Nombres significativos y código autoexplicativo
• TODO, FIXME, NOTE y marcadores relacionados
• Comentarios frente a logging
• PEP 8 y legibilidad

La Fase 6 está oficialmente completada y proporciona el modelo editorial y de calidad para las demás secciones de aprendizaje.

Fase 7: Errores, archivos y módulos

Consulta la ruta de aprendizaje de la sección.

• try, except, else y finally
• raise y excepciones personalizadas
• open() y with
• TXT, CSV y JSON
• Imports, módulos y paquetes

La Fase 7 está en progreso. El Capítulo 01 establece manejo de excepciones de runtime, handlers específicos, else, finally, propagación y límites de fallo pequeños. El Capítulo 02 añade raise deliberado, elección entre excepciones built-in y personalizadas, relanzamiento con raise sin expresión, encadenamiento explícito y raise frente a assert. El próximo capítulo planificado es open() y with.

Fase 8: Biblioteca estándar

• pathlib
• datetime
• json
• csv
• logging
• collections
• itertools
• decimal
• os y shutil

Fase 9: Bibliotecas externas

• pandas
• openpyxl
• requests
• pytest

Fase 10: Proyectos prácticos

• Calculadora de calificaciones
• Registro de usuarios
• Control de gastos
• Analizador de CSV
• Generador de informes
• Organizador de archivos
• Flujo ficticio de conciliación
• Flujo simulado de automatización

Cada proyecto debe incluir:

• requisitos;
• notas de diseño;
• implementación;
• explicación;
• ideas de pruebas;
• desafíos de ampliación;
• discusión de portafolio.

Criterios continuos de calidad

Cada fase debe preservar:

• precisión técnica;
• consistencia multilingüe;
• ejemplos originales y seguros para publicación;
• datos seguros desde el punto de vista de la privacidad;
• ejemplos ejecutables de Python cuando corresponda;
• integridad de la navegación interna;
• atención a PEP 8;
• documentación de cambios estructurales relevantes;
• transparencia sobre dependencias y supuestos de versión.

El roadmap evolucionará a medida que el proyecto crezca, pero los cambios deben preservar la progresión desde los conceptos iniciales hasta el trabajo práctico integrado.