dodona

Dodona

Dodona ist eine Online -Trainingsplattform zum Code lernen . Es möchte den Schülern beibringen, wie man auf sinnvollste und effektivste Weise programmiert wird. Dodona fungiert als Online-Co-Lehrer , der jedem Schüler Zugang zu qualitativ hochwertiger Bildung gewährt. Der Fokus liegt auf automatischen Korrekturen und auf aussagekräftigem Feedback zu den eingereichten Lösungen von Studenten.

Dieses Repository enthält den Quellcode der Webanwendung. Wenn Sie nur Dodona verwenden möchten, gehen Sie bitte zu https://dodona.be.

Die Dokumentation für Endbenutzer finden Sie unter https://docs.dodona.be.

Unterstützung von Dodona

Dodona ist frei für Schulen und wir möchten es so halten! Das Aufhalten dieser Plattform in Betrieb genommen ist viel Zeit, genau wie die Unterstützung von Hunderten von Schulen und Tausenden von Schülern. Wenn Sie Dodona finanzieren möchten, finden Sie weitere Informationen unter https://dodona.be/en/support-us/ oder setzen sich mit uns in Verbindung, indem Sie uns per E-Mail an [email protected] senden.

Kontakt mit uns

Es gibt verschiedene Möglichkeiten, uns zu kontaktieren:

• Um einen Fehler zu melden, verwenden Sie bitte GitHub -Probleme.
• Wenn Sie eine Frage haben, auf die die Antwort für andere von Nutzen ist, verwenden Sie bitte GitHub -Diskussionen.
• Für spezifischere Fragen, verwenden Sie unser Kontaktformular, senden Sie eine E -Mail an [email protected] oder chatten Sie mit uns in unserem allgemeinen Chat oder in unserem Support -Chat.

Lokale Entwicklung

Wenn Sie bei der Entwicklung helfen möchten, sind Probleme mit dem Student Label ein guter Ausgangspunkt.

Entwicklungsaufbau

1. Installieren und starten Sie mysql oder mariadb .
2. Wenn Sie mysql verwenden, ändern Sie den sql-mode im Konfigurationsblock mysqld :

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

3. Erstellen Sie einen dodona -Benutzer mit Zugriff auf die Datenbanken dodona und dodona_test-N . Sie benötigen so viele Testdatenbanken, wie Sie CPU -Threads haben.

    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. Installieren Sie die richtige ruby -Version mit RVM (die derzeit verwendete Version finden Sie hier).
5. Installieren Sie die richtige node mit nvm und Garn (jede moderne Knotenversion sollte dies tun).
6. Führen Sie bundle install und yarn install
7. Erstellen und säen Sie die Datenbank mit rails db:setup . (Wenn mit der Datenbank etwas schief geht, können Sie rails db:reset , um die Datenbank zu fallen, wieder aufzubauen und neu zu erstellen.) Wenn der Fehler "Python -Richter nicht initialisieren kann" entsteht, verwenden Sie SKIP_PYTHON_JUDGE=true rails db:setup
8. Führen Sie bin/server aus, um den Server zu starten. Weitere Informationen zum Starten des Entwicklungsaufbaus finden Sie hier. Dodona wird in einer Subdomain von Localhost erhältlich sein: http: //dodona.localhost: 3000.
9. Die CAS -Authentifizierung funktioniert nicht in der Entwicklung. Stattdessen bietet die Seed -Datenbank aus Schritt 7 drei Benutzer über Login -Token. Die relevanten Anmeldelinks werden in einer Ankündigung auf der Startseite von Dodona angezeigt.

Bewertung von Übungen lokal

Diese Schritte sind nicht erforderlich, um den Server auszuführen, aber Sie müssen Docker tatsächlich bewerten.

1. Installieren und starten Sie docker .
2. Lauf docker pull dodona/dodona-python

Wenn Sie die Docker -Bilder selbst erstellen möchten:

1. Klonen Sie das Docker-Images-Repository.
2. Erstellen Sie ein Docker -Bild. Die build.sh -Skripte erstellen alle Bilder. Mit den anfänglichen Daten wird jedoch nur dodona-python benötigt. Sie können dieses Bild mit docker build --pull --force-rm -t "dodona-python" -f "dodona-python.dockerfile" . .

Laden von Visualisierungen lokal

Diese Schritte sind nicht erforderlich, um den Server auszuführen, sondern werden benötigt, um die Visualisierungen laden zu lassen.

1. memcached installieren und starten.
2. Erstellen Sie die folgende Datei tmp/caching-dev.txt im Stamm des Projekts.

Fenster

Einige Edelsteine ​​und Abhängigkeiten (z. B. Memcached) funktionieren nicht unter Windows. Sie sollten stattdessen WSL 2 verwenden und alles in WSL ausführen. Dies bedeutet, dass Sie WSL für die Datenbank, Memcached, Git, Docker usw. verwenden.

Starten eines lokalen Servers

Der einfachste Weg, um den Server zu starten, ist der Befehl rails s . Dies wird jedoch nicht die Einreichungswarteschlange verarbeiten, und JavaScript wird von WebPack im Hintergrund zusammengestellt (ohne Ausgabe, wenn etwas schief geht).

• Um die Einreichungswarteschlange zu verarbeiten, muss der verzögerte Job mit dem Befehl bin/delayed_job start gestartet werden.
• Mit yarn build:css --watch Ihr CSS wird live neu geladen (verwenden Sie ohne das Flag --watch -Flag, wenn Sie die Stylesheets erstellen müssen und das Live -Reload nicht gesucht wird).
• Mit yarn build:js --watch Ihr JavaScript wird live neu geladen (verwenden Sie ohne das Flag --watch -Flag, wenn Sie das JavaScript erstellen müssen und das Live -Reload nicht gesucht wird).

Um den Rails -Server, den verzögerten Job, den CSS -Bundling und die JS -Bündelung gleichzeitig zu starten, führen Sie einfach bin/server aus.

Dies hat eine Enttäuschung: Debugging mit byebug ist gebrochen.

Localhost Subdomain

Dodona verwendet Subdomains, um die Beschreibungen des Trainings zu sandkasten (bei denen es sich um willkürliche HTML -Seiten handelt und für böswillige Zwecke verwendet werden kann, wenn sie nicht ordnungsgemäß sandkäfig sind). Wir dienen der Hauptanwendung in der Entwicklung von http: //dodona.localhost: 3000 und Übungsbeschreibungen von http: //sandbox.localHost: 3000.

Wenn dies nicht über das Feld funktioniert, können Sie Ihre /etc/hosts -Datei die folgenden Zeilen hinzufügen:

 127.0.0.1             dodona.localhost
127.0.0.1             sandbox.localhost

Ausführen von Lintern und Tests

Um den Code zu finsen, führen Sie rubocop für Ruby und yarn lint für JavaScript aus.

Wir haben Tests in JavaScript-, Ruby- und Systemtests:

• Führen Sie für JavaScript yarn test aus
• Führen Sie für die Systemtests bundle exec rails test:system
• Führen Sie für die Ruby -Tests bundle exec rails test aus

Es gibt auch einen Typ -Scheck für Code, der in TypeScript geschrieben wurde. Dies kann mit yarn typeCheck ausgeführt werden.

Tipps

• Verwenden Sie das PARALLEL_WORKERS Env Var, um die Anzahl der zu verwendenden Threads anzugeben.
• Verwenden Sie TestProf , um die Ruby -Tests zu profilieren
• Verwenden Sie bundle exec rails test filename , um eine einzelne Testdatei auszuführen. Verwenden Sie bundle exec rails test filename:linenumber um einen bestimmten Test auszuführen