Python con Copiloto IA

Este repositorio contiene el material del curso en una versión local para Visual Studio Code, pensado para que el estudiante avance con el apoyo de una IA como guía. Las lecciones se encuentran en lecciones/, mientras que los metadatos de los ejercicios locales y los scripts de validación se encuentran junto a ellas.

Origen del proyecto

Este proyecto está basado en el repositorio original rage/programming-25. Esta adaptación local reconoce explícitamente ese origen y mantiene el mismo esquema de licencias del proyecto base para el material derivado.

Flujo de trabajo local

1. Abra el repositorio en Visual Studio Code.
2. Lea la lección actual en lecciones/.
3. Prepare o edite su solución en soluciones-estudiante/.
4. Ejecute el verificador local del ejercicio que está resolviendo.
5. Pídale a GitHub Copilot sugerencias, ayuda para la depuración o explicaciones conceptuales.

Estados del verificador local:

• APROBADO: la salida coincide con lo esperado.
• CASI CORRECTO: la lógica parece cercana, pero todavía hay diferencias de formato, prompts, signos o espacios.
• FALLO: hay una diferencia sustancial o un error de ejecución.

Comandos útiles del verificador local:

• python3 scripts/check_exercise.py --list muestra los ejercicios locales implementados.
• python3 scripts/check_exercise.py --init <exercise_id> crea el archivo estándar en soluciones-estudiante/ si todavía no existe. En los ejercicios de Corregir el código, puede incluir una plantilla inicial con errores para arreglar.
• python3 scripts/check_exercise.py <exercise_id> verifica usando automáticamente soluciones-estudiante/<exercise_id>.py.

Ejercicios locales implementados

Ejecute python3 scripts/check_exercise.py --list para ver la lista actual desde la fuente de verdad del repositorio. La parte 1 ya está completa en local. Las partes posteriores todavía no replican todo el curso original; si una lección no tiene ejercicio local, continúe con la lectura y use --list para elegir el siguiente ejercicio disponible.

Estructura de la lección

• Comience en lecciones/00-indice-del-curso.md
• lecciones/01-primeros-pasos
• lecciones/02-condiciones-y-bucles
• lecciones/03-cadenas-bucles-funciones
• lecciones/04-vscode-funciones-listas
• lecciones/05-mas-listas-diccionarios
• lecciones/06-archivos-errores-alcance
• lecciones/07-modulos-y-procesamiento-de-datos

Consulte GUIA-DE-CONFIGURACION.md para conocer la configuración y los comandos locales.

Uso recomendado para alumnado

Si va a utilizar este repositorio como alumna o alumno, el recorrido mínimo recomendado es este:

1. Abra lecciones/00-indice-del-curso.md y entre en la parte que esté estudiando.
2. Elija uno de los ejercicios locales ya implementados.
3. Cree el archivo con python3 scripts/check_exercise.py --init <exercise_id> o use la tarea Preparar archivo de ejercicio. Este paso crea también la carpeta soluciones-estudiante/ si todavía no existe.
4. Ejecute el verificador local con la tarea de Visual Studio Code o con python3 scripts/check_exercise.py <exercise_id>.
5. Si aparece CASI CORRECTO, revise primero prompts, mayúsculas, signos y espacios antes de tocar la lógica.
6. Si falla, compare la salida esperada con la actual y corrija una diferencia cada vez.

La guía GUIA-DE-CONFIGURACION.md incluye ahora una sección de primer uso pensada para este flujo.

Licencia

Este repositorio hereda el esquema de licencias del proyecto original:

• El material del curso derivado de rage/programming-25, incluidas las lecciones adaptadas en lecciones/, se distribuye bajo la licencia Creative Commons BY-NC-SA 4.0.
• El código y la estructura de apoyo inspirados en la plantilla original se distribuyen bajo la licencia Apache License 2.0.

Consulte LICENSE.md para el detalle de atribución y alcance.