dodona

Dodona

Dodona est une plate-forme d'exercice en ligne pour apprendre à coder . Il veut enseigner aux étudiants comment programmer de la manière la plus significative et la plus efficace possible. Dodona agit en tant que co-enseignant en ligne , conçue pour donner à chaque élève un accès à une éducation de haute qualité. L'accent est mis sur les corrections automatiques et à donner des commentaires significatifs sur les solutions soumises des étudiants.

Ce référentiel contient le code source de l'application Web. Si vous voulez simplement utiliser Dodona, veuillez vous rendre sur https://dodona.be.

La documentation des utilisateurs finaux se trouve sur https://docs.dodona.be.

Soutenir Dodona

Dodona est libre à utiliser pour les écoles et nous aimerions le garder ainsi! Garder cette plate-forme en marche prend beaucoup de temps, tout comme soutenir des centaines d'écoles et des milliers d'élèves. Si vous souhaitez financer Dodona, vous pouvez trouver plus d'informations sur https://dodona.be/en/support-us/ ou contacter en nous envoyant un e-mail à [email protected].

Nous contacter

Il existe plusieurs façons de nous contacter:

• Pour signaler un bogue, veuillez utiliser les problèmes de GitHub.
• Si vous avez une question à laquelle la réponse pourrait être utile aux autres, veuillez utiliser des discussions GitHub.
• Pour des questions plus spécifiques, utilisez notre formulaire de contact, envoyez un e-mail à [email protected] ou venez discuter avec nous dans notre chat général ou notre chat d'assistance.

Développement local

Si vous souhaitez aider avec le développement, les problèmes marqués avec l'étiquette des étudiants sont un bon point de départ.

Configuration du développement

1. Installez et démarrez mysql ou mariadb .
2. Si vous utilisez mysql , modifiez le sql-mode dans le bloc de configuration mysqld :

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

3. Créez un utilisateur dodona avec accès aux bases de données dodona et dodona_test-N . Vous aurez besoin autant de bases de données de test que de threads 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. Installez la version ruby correcte à l'aide de RVM (la version actuellement utilisée peut être trouvée ici).
5. Installez la version node correcte à l'aide nvm et du fil (toute version de nœud moderne doit faire).
6. Installation bundle install et yarn install
7. Créez et entreprenez la base de données avec rails db:setup . (Si quelque chose ne va pas avec la base de données, vous pouvez utiliser rails db:reset pour abandonner, reconstruire et réensemble la base de données.) Si l'erreur "ne pouvait pas initialiser le juge Python" survient, utilisez SKIP_PYTHON_JUDGE=true rails db:setup
8. Exécutez bin/server pour démarrer le serveur. Plus d'informations sur la façon de démarrer la configuration de développement peuvent être trouvées ici. Dodona sera disponible sur un sous-domaine de localhost: http: //dodona.localhost: 3000.
9. L'authentification CAS ne fonctionne pas dans le développement. Au lieu de cela, la base de données des semences de l'étape 7 fournit trois utilisateurs via des jetons de connexion. Les liens de connexion pertinents sont affichés dans une annonce sur la page d'accueil de Dodona.

Évaluer les exercices localement

Ces étapes ne sont pas nécessaires pour exécuter le serveur, mais vous avez besoin de Docker pour évaluer réellement les exercices.

1. Installez et démarrez docker .
2. Run docker pull dodona/dodona-python

Si vous souhaitez construire les images Docker vous-même:

1. Clone le référentiel Docker-Images.
2. Construisez une image Docker. Les scripts build.sh créent toutes les images. Mais avec les données initiales, seule dodona-python est nécessaire. Vous pouvez construire cette image avec docker build --pull --force-rm -t "dodona-python" -f "dodona-python.dockerfile" . .

Chargement des visualisations localement

Ces étapes ne sont pas nécessaires pour exécuter le serveur, mais sont nécessaires pour laisser les visualisations se charger.

1. Installez et démarrez memcached .
2. Créez le fichier suivant tmp/caching-dev.txt à la racine du projet.

Fenêtre

Certains joyaux et dépendances (comme Memcached) ne fonctionnent pas sur Windows. Vous devez utiliser WSL 2 à la place et exécuter tout à l'intérieur de WSL. Cela signifie que vous utilisez WSL pour la base de données, memcached, git, docker, etc.

Démarrage d'un serveur local

La façon la plus simple de démarrer le serveur est avec la commande rails s Mais cela ne traitera pas la file d'attente de soumission, et JavaScript sera compilé par WebPack en arrière-plan (sans sortie lorsque quelque chose ne va pas).

• Pour traiter la file d'attente de soumission, le travail retardé doit être démarré avec la commande bin/delayed_job start .
• Avec yarn build:css --watch votre CSS est rechargé en direct (utilisez sans l'indicateur --watch watch lorsque vous avez besoin de construire les feuilles de style et que le rechargement en direct n'est pas recherché).
• Avec yarn build:js --watch votre javascript est rechargé en direct (utilisez sans l'indicateur --watch watch lorsque vous avez besoin de construire le rechargement JavaScript et en direct n'est pas recherché).

Pour démarrer le serveur Rails, un travail retardé, un regroupement CSS et un regroupement JS en même temps, exécutez simplement bin/server .

Cela a une déception: le débogage avec byebug est cassé.

Sous-domaine localhost

Dodona utilise des sous-domaines pour des descriptions d'exercice de bac à sable (qui sont des pages HTML arbitraires et pourraient être utilisées à des fins malveillantes si elles ne sont pas correctement bacquées). Nous servons l'application principale en développement à partir de http: //dodona.localhost: 3000 et des descriptions d'exercice de http: //sandbox.localhost: 3000.

Si cela ne fonctionne pas dans la boîte, vous pouvez ajouter les lignes suivantes à votre fichier /etc/hosts :

 127.0.0.1             dodona.localhost
127.0.0.1             sandbox.localhost

Ligneurs et tests en cours d'exécution

Pour pelucher le code, exécutez rubocop pour Ruby et yarn lint pour JavaScript.

Nous avons des tests dans les tests JavaScript, Ruby et System:

• Pour JavaScript, exécutez yarn test
• Pour les tests du système, exécutez bundle exec rails test:system
• Pour les tests de rubis, exécutez bundle exec rails test

Il y a aussi un type de vérification du code écrit en dactylographie. Cela peut être exécuté avec yarn typeCheck .

Conseils

• Utilisez le PARALLEL_WORKERS Env var pour spécifier le nombre de threads à utiliser.
• Utilisez TestProf pour profil les tests Ruby
• Utilisez bundle exec rails test filename pour exécuter un seul fichier de test, utilisez bundle exec rails test filename:linenumber pour exécuter un test spécifique