Skip to content

Commit 3ecab69

Browse files
authored
Added application description to readme
1 parent ffa9f43 commit 3ecab69

File tree

1 file changed

+19
-2
lines changed

1 file changed

+19
-2
lines changed

README.md

Lines changed: 19 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,20 @@
11
# Source code similarity detector
2-
3-
Work in progress...
2+
## Description
3+
JavaFX application for detecting similarity between Python source code files using Levenshtein distance as a metric. Presents the results as similar clusters and pairs.
4+
## Requirements
5+
* Java JDK version 11+
6+
* Tested & working on Windows OS
7+
## Running the application
8+
Download the ***Source.code.similarity.detector.jar*** file from the latest [release](https://github.com/mikkomaran/source-code-similarity-detector/releases) and run the executable JAR. If double-clicking the JAR doesn't start the program then try running the the following commands from the command line:
9+
* ***javaw -jar "path/to/file/Source code similarity detector.jar"***
10+
* ***javaw -cp "path/to/file/Source code similarity detector.jar" ee.ut.similaritydetector.ui.App***
11+
## Input files
12+
The application takes input as a ZIP file that is generated from Moodle Virtual Programming Lab (VPL) submissions. The ZIP file contains folders for each student named by the student's name, user number and Moodle username separated with spaces (i.e. "Maran Mikko 999999 xxxx"). Inside student folders are one or multiple submission folders, named by the date and time of that submission. Each submission folder contains all submitted files (i.e. "exercise1.py", "exercise2.py",...). Only the latest submission's files are taken into the analysis.
13+
## Features
14+
* **Custom similarity threshold** - the user can select a **similarity threshold**, that is the percentage of similarity for two solutions to be considered *suspiciously similar*
15+
* **Preproccesing source code files** - all comments and empty lines will be removed from source codes before starting the analysis
16+
* **Anonymous results** - the results are presented by student user numbers rather than names
17+
* **Code review window** - allows reviewing the source codes of *suspicious solutions* with syntax highlighting
18+
* **Analysis statistics**
19+
* **Light & dark theme**
20+
* **2 languages for GUI** - Estonian & English

0 commit comments

Comments
 (0)