Skip to main content

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.

Who can use this feature

Organization owners who are admins for a classroom can set up and use autograding on assignments in a classroom. Para obtener más información sobre los administradores de aulas, consulte "Acerca de la administración de aulas".

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.com. 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 más información, vea los detalles de la versión más reciente de Ubuntu en "Especificaciones para 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.

ConfiguraciónDescripció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
EntradasEntrada estándar para el comando de ejecución
Salida previstaLa salida que quieres ver como estándar para el comando de ejecución
De comparaciónEl tipo de comparación entre el la salida del comando de ejecución y la salida esperada

  • Incluido: se supera cuando aparece la salida esperada
    en cualquier parte de la salida estándar del comando de ejecución
  • Exacto: se supera cuando la salida esperada es completamente idéntica
    a la salida estándar del comando de ejecución
  • Expresión regular: se supera si la expresión regular de la
    salida esperada coincide con la salida estándar del comando de ejecución.
Tiempo de esperaEn 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 dará un resultado correcto y cualquier otro código de salida producirá un error.

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 Ejecutar nodo rellena previamente el comando de instalación con npm install y el comando de prueba con npm test.

ConfiguraciónDescripció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 de esperaEn 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 más información, vea "Creación de una asignación individual" o "Creación de una asignación de grupo".

Puedes agregar, editar o borrar las pruebas de calificación automática para una tarea existente. Todos los cambios que se hagan a través de la IU del aula se subirán a los repositorios existentes de los alumnos, así que edita tus pruebas con cuidado.

  1. Inicia sesión en GitHub Classroom. 1. En la lista de aulas, da clic en aquella que quieras ver. Aula en la lista de aulas de una organización 1. A la derecha de la tarea que quieras editar, da clic en . Icono de lápiz para editar una asignación en la lista de asignaciones
  2. En la barra lateral izquierda, haga clic en Calificación y comentarios. "Calificación y comentarios" a la izquierda de los aspectos básicos de la asignación
  3. Agrega, edita o borra una prueba de calificación automática.
    • Para agregar una prueba, en "Agregar pruebas de calificación automática", seleccione el menú desplegable Agregar prueba y, después, haga clic en el método de calificación que quiera usar. Uso del menú desplegable "Agregar prueba" para hacer clic en un método de calificación, configurar la prueba y, después, hacer clic en Guardar caso de prueba. Botón "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 . Icono de lápiz para editar una prueba de clasificación automática configurar la prueba y, después, hacer clic en Guardar caso de prueba. Botón "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 la papelera para borrar una prueba de calificación automática
  4. En la parte inferior de la página, haga clic en Actualizar asignación. Botón "Actualizar asignación" 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 "Descargar" seleccionado en el que se muestra "Descargar calificaciones resaltado" y una opción adicional para "Descargar repositorios"

Ver bitácoras individuales

  1. Inicia sesión en GitHub Classroom. 1. En la lista de aulas, da clic en aquella que quieras ver. Aula en la lista de aulas de una organización 1. En la lista de tareas, da clic en aquellaque quieras ver. Asignación en la lista de asignaciones de un aula
  2. A la derecha de un envío, haga clic en Ver prueba. Botón "Ver prueba" para el envío de una asignación
  3. Revisa la salida de la prueba. Para más información, vea "Uso de registros de ejecución de flujo de trabajo".

Información adicional