dolos

Dolos

Dolos est un outil de détection de plagiat de code source pour les exercices de programmation. Dolos aide les enseignants à découvrir que les élèves partagent des solutions, même s'ils sont modifiés. En fournissant des visualisations interactives, les Dolos peuvent également être utilisés pour sensibiliser les élèves à prévenir le plagiat.

Dolos vise à être:

• Facile à utiliser en offrant une application Web avec une interface utilisateur intuitive
• Flexible pour prendre en charge de nombreux langages de programmation
• Puissant en utilisant des algorithmes de pointe pour vous aider à découvrir le plagiat

Dolos est une application Web qui analyse les fichiers de code source pour les similitudes entre eux. De plus, il propose une interface de ligne de commande pour exécuter une analyse localement, affichant l'interface utilisateur interactive dans votre navigateur en lançant un serveur Web local. Les résultats de l'analyse sont disponibles dans les fichiers CSV lisibles par la machine et les Dolos peuvent être intégrés en tant que bibliothèque JavaScript dans d'autres applications permettant aux utilisateurs d'intégrer la détection du plagiat dans leur flux de travail personnel.

Vous pouvez utiliser notre instance gratuite pour utiliser des Dolos sur https://dolos.ugent.be.

Dolos d'auto-hébergement

Comme Dolos est open source, il est également possible d'héberger l'application Web Dolos.

Suivez nos instructions sur https://dolos.ugent.be/docs.

Installation locale avec Dolos CLI

Si vous souhaitez exécuter la CLI Dolos au lieu d'utiliser l'application Web, vous pouvez installer Dolos CLI votre système à l'aide de NPM:

npm install -g @dodona/dolos

Voir les instructions d'installation sur notre site Web pour des instructions plus complètes.

Usage

Les Dolos peuvent être lancés à l'aide de l'interface de ligne de commande, mais il est capable d'afficher les résultats de votre navigateur.

Lancez Dolos en utilisant la commande suivante dans votre terminal:

dolos run -f web path/to/your/files/ *

Cela lancera une interface Web avec les résultats de l'analyse sur http: // localhost: 3000.

Des instructions plus élaborées sur la façon d'utiliser des Dolos.

Documentation

Visitez notre page Web à https://dolos.ugent.be/docs.

Construire et développer

Pour développer les analyseurs, la bibliothèque ou les composants CLI, vous devrez cloner ce référentiel récursivement pour inclure ses sous-modules (les analyseurs d'arbres-itters):

git clone --recursive git://github.com/dodona-edu/dolos.git

# or, if you have cloned the repository already:
git submodule update --init --recursive

Il vous suffit d'exécuter l'installation des dépendances une fois dans la racine du référentiel en exécutant npm install . Cela installera toutes les dépendances et les liera dans node_modules de chaque projet. Vous ne devez pas exécuter npm install dans le répertoire de chaque projet séparément.

Cela liera également le dossier dist des projets Core, Lib et Web car leurs versions correspondent dans le fichier package.json . Cela vous permet de développer simultanément la CLI, la LIB et le projet Web ensemble.

Chaque composant a ses propres instructions de construction dans son propre répertoire.

Composants

• CLI: l'interface de ligne de commande
• Core: la bibliothèque JavaScript avec seulement les algorithmes de base
• Analyseurs: les analyseurs d'arbre-sitter vendus par des Dolos
• LIB: la bibliothèque Node.js qui peut analyser et analyser les fichiers
• Web: l'interface utilisateur graphique dans votre navigateur qui peut être lancé à l'aide de la CLI
• Docs: le code source de https://dolos.ugent.be
• API: le serveur API exécutant l'application Web Dolos à https://dolos.ugent.be/server

Qui a fait ce logiciel?

Dolos est un projet de recherche actif de Team Dodona à l'Université de Gand. Si vous utilisez ce logiciel pour vos recherches, veuillez citer:

• Maertens et. al. (2024) Softwarex DOI: 10.1016 / j.softx.2024.101755