dodona

Dodona

Dodona es una plataforma de ejercicio en línea para aprender a codificar . Quiere enseñar a los estudiantes cómo programar de la manera más significativa y efectiva posible. Dodona actúa como co-maestro en línea , diseñado para dar a cada estudiante acceso a una educación de alta calidad. La atención se centra en las correcciones automáticas y en dar comentarios significativos sobre las soluciones presentadas de los estudiantes.

Este repositorio contiene el código fuente de la aplicación web. Si simplemente desea usar Dodona, vaya a https://dodona.be.

La documentación para usuarios finales se puede encontrar en https://docs.dodona.be.

Apoyando a Dodona

¡Dodona es gratuita para las escuelas y nos gustaría mantenerlo así! Mantener esta plataforma en funcionamiento lleva mucho tiempo, al igual que apoyar a cientos de escuelas y miles de estudiantes. Si desea financiar Dodona, puede encontrar más información sobre https://dodona.be/en/support-us/ o ponerse en contacto enviándonos un correo electrónico a [email protected].

Contactándonos

Hay varias formas de contactarnos:

• Para informar un error, utilice los problemas de GitHub.
• Si tiene una pregunta a la que la respuesta podría ser útil para los demás, utilice las discusiones de GitHub.
• Para obtener preguntas más específicas, use nuestro formulario de contacto, envíe un correo electrónico a [email protected] o venga a chatear con nosotros en nuestro chat general o en nuestro chat de soporte.

Desarrollo local

Si desea ayudar con el desarrollo, los problemas etiquetados con la etiqueta del estudiante son un buen punto de partida.

Configuración de desarrollo

1. Instale e inicie mysql o mariadb .
2. Si usa mysql , cambie el sql-mode en el bloque de configuración mysqld :

    sql-mode='STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION'
   

3. Cree un usuario dodona con acceso a las bases de datos dodona y dodona_test-N . Necesitará tantas bases de datos de prueba como en hilos de CPU.

    CREATE USER ' dodona '@ ' localhost ' IDENTIFIED BY ' dodona ' ;
   GRANT ALL ON dodona. * TO ' dodona ' @ ' localhost ' ;
   GRANT ALL ON dodona_test. * TO ' dodona ' @ ' localhost ' ;
   GRANT ALL ON ` dodona_test-0 ` . * TO ' dodona ' @ ' localhost ' ;
   ...
   GRANT ALL ON ` dodona_test-N ` . * TO ' dodona ' @ ' localhost ' ;

4. Instale la versión ruby correcta con RVM (la versión utilizada actualmente se puede encontrar aquí).
5. Instale la versión node correcta con nvm e hilo (cualquier versión de nodo moderna debería hacer).
6. Ejecutar bundle install e yarn install
7. Crear y sembrar la base de datos con rails db:setup . (Si algo sale mal con la base de datos, puede usar rails db:reset para soltar, reconstruir y volver a crecer la base de datos). Si el error "no podría inicializar el juez de Python" surge, use SKIP_PYTHON_JUDGE=true rails db:setup
8. Ejecute bin/server para iniciar el servidor. Puede encontrar más información sobre cómo iniciar la configuración de desarrollo aquí. Dodona estará disponible en un subdominio de localhost: http: //dodona.localhost: 3000.
9. La autenticación CAS no funciona en el desarrollo. En su lugar, la base de datos de semillas del paso 7 proporciona tres usuarios a través de tokens de inicio de sesión. Los enlaces de inicio de sesión relevantes se muestran en un anuncio en la página de inicio de Dodona.

Evaluación de ejercicios localmente

No se requieren estos pasos para ejecutar el servidor, pero necesita Docker para evaluar realmente los ejercicios.

1. Instalar e iniciar docker .
2. Corre docker pull dodona/dodona-python

Si quieres construir las imágenes de Docker tú mismo:

1. Clon el repositorio de imágenes de Docker.
2. Construye una imagen Docker. El build.sh scripts crea todas las imágenes. Pero con los datos iniciales, solo se necesita dodona-python . Puede construir esta imagen con docker build --pull --force-rm -t "dodona-python" -f "dodona-python.dockerfile" . .

Cargando visualizaciones localmente

No se requieren estos pasos para ejecutar el servidor, pero son necesarios para dejar que se carguen las visualizaciones.

1. Instale e inicie memcached .
2. Cree el siguiente archivo tmp/caching-dev.txt en la raíz del proyecto.

Windows

Algunas gemas y dependencias (como Memcached) no funcionan en Windows. Debería usar WSL 2 en su lugar y ejecutar todo dentro de WSL. Esto significa que usa WSL para la base de datos, Memcached, Git, Docker, etc.

Iniciar un servidor local

La forma más sencilla de iniciar el servidor es con el comando rails s Pero esto no procesará la cola de envío, y JavaScript será compilado por Webpack en segundo plano (sin salida cuando algo salga mal).

• Para procesar la cola de envío, el trabajo retrasado debe iniciarse con el comando bin/delayed_job start .
• Con yarn build:css --watch Su CSS se vuelve a cargar en vivo (use sin la bandera --watch cuando necesite construir las hojas de estilo y no se busca la recarga en vivo).
• Con yarn build:js --watch su JavaScript se vuelve a cargar en vivo (use sin el indicador --watch cuando necesite construir el JavaScript y no se busca la recarga en vivo).

Para iniciar el servidor Rails, el trabajo retrasado, la agrupación de CSS y la agrupación JS al mismo tiempo, simplemente ejecute bin/server .

Esto tiene una decepción: la depuración con byebug está rota.

Subdominio localhost

Dodona usa subdominios para las descripciones de ejercicio de sandbox (que son páginas HTML arbitrarias y podrían usarse para fines maliciosos si no se sandan correctamente). Servimos la aplicación principal en el desarrollo de http: //dodona.localhost: 3000 y descripciones de ejercicio de http: //sandbox.localhost: 3000.

Si esto no funciona fuera de la caja, puede agregar las siguientes líneas a su archivo /etc/hosts :

 127.0.0.1             dodona.localhost
127.0.0.1             sandbox.localhost

Ejecutando de revestimiento y pruebas

Para pellar el código, ejecute rubocop para Ruby and yarn lint para JavaScript.

Tenemos pruebas en pruebas de JavaScript, Ruby y System:

• Para JavaScript, ejecute yarn test
• Para las pruebas del sistema, ejecute bundle exec rails test:system
• Para las pruebas de Ruby, ejecute bundle exec rails test

También hay una verificación de tipo para el código escrito en TypeScript. Esto se puede ejecutar con yarn typeCheck .

Consejos

• Use el PARALLEL_WORKERS env var para especificar el número de subprocesos a usar.
• Use TestProf para perfilar las pruebas de Ruby
• Use bundle exec rails test filename para ejecutar un solo archivo de prueba, use bundle exec rails test filename:linenumber para ejecutar una prueba específica