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.

¿Quién puede utilizar esta característica?

Organization owners who are admins for a classroom can set up and use autograding on assignments in a classroom. Para más información sobre los administradores de aula, consulta "Administrar 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 estas se ejecutan automáticamente cada vez que un alumno realiza una inserción en 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. Para más información sobre los flujos de trabajo y GitHub Actions, consulta "Acerca de la integración continua".

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, consulta la versión más reciente de Ubuntu en "Utilizar 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.

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, consulta "Crear una tarea individual" o "Crear una tarea 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.

  2. En la lista de aulas, da clic en aquella que quieras ver.

  3. A la derecha de la tarea que quiera editar, haga clic en .

  4. En la barra lateral izquierda, haga clic en Calificación y comentarios.

  5. 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. Configure la prueba y, a continuación, haga clic en Guardar caso de prueba.

    • Para editar una prueba, a la derecha del nombre de ésta, da clic en . Configure la prueba y, a continuación, haga clic en Guardar caso de prueba.

    • Para borrar una prueba, a la derecha del nombre de ésta, da clic en .

  6. En la parte inferior de la página, haga clic en Actualizar asignación.

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.

Ver bitácoras individuales

  1. Inicia sesión en GitHub Classroom.
  2. En la lista de aulas, da clic en aquella que quieras ver.
  3. En la lista de tareas, da clic en aquellaque quieras ver.
  4. A la derecha del envío, haga clic en .
  5. Revisa la salida de la prueba. Para obtener más información, vea «Uso de registros de ejecución de flujo de trabajo».

Información adicional