Utiliza las calificaciones automáticas

Puedes proporcionar retroalimentación automáticamente en las emisiones de código de tus alumnos si configuras las pruebas para que se ejecuten en el repositorio de tareas.

Acerca de las calificaciones automáticas

Puedes utilizar las calificaciones automáticas para verificar el trabajo de un alumno automáticamente para una tarea en GitHub Classroom. Configuras las pruebas para una tarea, y éstas se ejecutan automáticamente cada que un alumno las suba a un repositorio de tareas en GitHub. El alumno puede ver los resultados de la prueba, hacer cmabios y subir información para ver resultados nuevos.

Después de que un alumno acepte una tarea, en cada subida al repositorio de la misma, GitHub Actions ejecuta comandos para tu prueba de calificaciones automáticas en un ambiente Linux que contiene el código más nuevo del alumno. GitHub Classroom crea los flujos de trabajo necesarios para GitHub Actions. No necesitas tener experiencia con las GitHub Actions para utilizar las calificaciones automáticas.

Puedes utiizar un marco de trabajo de prueba, ejecutar un comando personalizado, escribir pruebas de entrada/salida, o combinar varios métodos de pruebas. El ambiente de Linux para las calificaciones automáticas contienen muchas herramientas de software populares. Para obtener más información, consulta los detalles de la última versión de Ubuntu en "Especificaciones para los ejecutores hospedados en GitHub".

Puedes ver un resumen de qué estudiantes están pasando las pruebas con calificación automática si navegas a la tarea en GitHub Classroom. Una marca verde significa que el alumno está pasando todas las pruebas, la X roja significa que el alumno falló en algunas o todas las pruebas. Si otorgas puntos para una o más pruebas, entonces una burbuja mostrará la puntuación de éstas con base en la puntuación máxima posible para la tarea.

Resumen de una tarea con resultados de calificación automática

Métodos para calificar

Hay dos métodos para calificar: pruebas de entrada/salida y pruebas de ejecución de comandos.

Prueba de entrada/salida

Una prueba de entrada/salida ejecuta un comando de configuración opcionalmente y proporciona una entrada estándar de un comando de prueba. GitHub Classroom evalúa la salida del comando de prueba contra un resultado esperado.

ParámetroDescripción
Nombre de la pruebaEl nombre de la prueba para identificarla en las bitácoras
Comando de configuraciónOpcional. Un comando a ejecutar antes de las pruebas, tal como una compilación o instalación
Comando de ejecuciónEl comando para ejecutar la prueba y generar una salida estándar para su evaluación
InputsEntrada estándar para el comando de ejecución
Salida esperadaLa salida que quieres ver como estándar para el comando de ejecución
ComparaciónEl tipo de comparación entre el la salida del comando de ejecución y la salida esperada

  • Included: Pasa cuando la salida esperada aparece
    en cualquier parte dentro de la salida estándar del comando de ejecución
  • Exact: Pasa cuando la salida esperada es completamente idéntica
    a la salida estándar del comando de ejecución
  • Regex: Pasa si la expresión regular en la salida
    esperada coincide con la salida estándar del comando de ejecución
Tiempo excedidoEn minutos, lo que tarda una prueba en ejecutarse antes de que resulte en un fallo
PuntosOpcional. La cantidad de puntos que vale la prueba contra una puntuación total

Prueba de comando de ejecución

Una prueba de comando de ejecución ejecuta un comando de configuración y luego un comando de prueba. GitHub Classroom verifica el estado de salida del comando de prueba. Un código de salida de 0 resultará en éxito y cualquier otro código de salida resultara en un fallo.

GitHub Classroom proporciona preajustes para un las pruebas de comandos de ejecución específicas de lenguaje para varios lenguajes de programación. Por ejemplo, la prueba de ejecutar nodo llena previamente el comando de configuración con npm install y el comando de prueba con npm test.

ParámetroDescripción
Nombre de la pruebaEl nombre de la prueba para identificarla en las bitácoras
Comando de configuraciónOpcional. Un comando a ejecutar antes de las pruebas, tal como una compilación o instalación
Comando de ejecuciónEl comando para ejecutar la prueba y generar un código de salida para evaluación
Tiempo excedidoEn minutos, lo que tarda una prueba en ejecutarse antes de que resulte en un fallo
PuntosOpcional. La cantidad de puntos que vale la prueba contra una puntuación total

Configurar las pruebas de calificación automática para una tarea

Puedes agregar pruebas de calificación automática durante la creación de una tarea nueva. Para obtener más información, consulta la sección "Crear una tarea individual" o "Crear una tarea grupal".

Puedes agregar, editar o borrar las pruebas de calificación automática para una tarea existente. Si cambias las pruebas de calificación automática para una tarea existente, los repositorios de tareas existentes no se verán afectados. Un alumno o equipo debe aceptar la tarea y crear un repositorio de tareas nuevo para utilizar las pruebas nuevas.

  1. Inicia sesión en GitHub Classroom.
  2. En la lista de aulas, da clic en aquella que quieras ver. Aula en la lista de aulas de una organización
  3. A la derecha de la tarea que quieras editar, da clic en . Icono de lápiz para editar una tarea en la lista de tareas
  4. En la barra lateral, da clic en Calificaciones y retroalimentación. "Calificaciones y retroalimentación" a la izquierda de los puntos básicos de la tarea
  5. Agrega, edita o borra una prueba de calificación automática.
    • Para agregar una prueba, debajo de "Agregar pruebas de calificación automática", selecciona el menú desplegable Agregar prueba y luego da clic en el método de calificación que quieras utilizar. Using the "Add test" drop-down menu to click a grading method Configura la prueba y luego da clic en Guardar caso de prueba. Botón de "Guardar caso de prueba" para una prueba de calificación automática
    • Para editar una prueba, a la derecha del nombre de ésta, da clic en . Pencil icon for editing an autograding test Configura la prueba y luego da clic en Guardar caso de prueba. Botón de "Guardar caso de prueba" para una prueba de calificación automática
    • Para borrar una prueba, a la derecha del nombre de ésta, da clic en . Icono de cesta de basura para borrar una prueba de calificación automática
  6. En la parte inferior de la página, da clic en Actualizar tarea. Botón de "Actualizar tarea" en la parte inferior de la página

Ver y descargar los resultados de las pruebas de autoevaluación

Descargar los resultados de autoevaluación

También puedes descargar un CSV de las puntuaciones de autoevaluación de tus alumnos a través del botón "Descargar". Esto generará un CSV de descarga que contiene un enlace al repositorio del alumno, a su manejador de GitHub, identificador de lista, marca de tiempo de emisión y puntuación de autoevaluación.

Botón de "Descargar" seleccionado mostrando "Descargar las calificaciones resaltadas" y una opción adicional para "Descargar repositorios"

Ver bitácoras individuales

  1. Inicia sesión en GitHub Classroom.
  2. En la lista de aulas, da clic en aquella que quieras ver. Aula en la lista de aulas de una organización
  3. En la lista de tareas, da clic en aquellaque quieras ver. Lista de tareas para las tareas de un aula
  4. A la derecha de una emisión, da clic en Ver prueba. Botón de "Ver tarea" para una emisión de una tarea
  5. Revisa la salida de la prueba. Para obtener más información, consulta la sección "Utilizar bitácoras de ejecución de flujos de trabajo".

Leer más

¿Te ayudó este documento?

Política de privacidad

¡Ayúdanos a hacer geniales estos documentos!

Todos los documentos de GitHub son de código abierto. ¿Notas algo que esté mal o que no sea claro? Emite una solicitud de cambios.

Haz una contribución

O, aprende cómo contribuir.