Code Similarity Disguiser

Code similarity disguiser (CSD) is a tool to educate students about code similarity for academic integrity in programming. With the tool, learners can independently learn about the many ways that a program can be changed without affecting the underlying code similarity. It can also be used to individualise code-tracing assessments, to anonymise identifying information in student programs, and to generate data sets for the evaluation of code similarity detection that incorporates features of programming style. Further details can be seen in the corresponding paper (presented at 20th Koli Calling International Conference on Computing Education Research) or the recorded presentation. Currently, the tool covers two programming languages: Java and Python.

Four CSD Modes

disguise

Given a source code project and a list of desired disguises, this mode will disguise the project's code based on the desired disguises. Please be aware that the impact of some disguises might overlap one another. A complete list of disguise IDs can be seen via the fourth mode.
Command:

disguise <input_project_path> <programming_language> <human_language> <additional_keywords_path> <disguise_id_1> <disguise_id_2> ... <disguise_id_N>  

diagnose

Given a source code project, this mode will list any applicable disguises.
Command:

diagnose <input_project_path> <programming_language> <human_language> <additional_keywords_path> <disguise_id_1> <disguise_id_2> ... <disguise_id_N>  

disguiserandom

This mode is similar to the first one except that the disguises are randomly applied. The code project will be diagnosed first to assure the applicability of the disguises.
Command:

disguiserandom <input_project_path> <programming_language> <human_language> <additional_keywords_path> <num_comment_disguises> <num_whitespace_disguises> <num_ident_disguises> <num_constant_and_data_type_disguises>  

availabledisguises

This mode will list all available disguises.
Command:

availabledisguises  

Parameters description (sorted alphabetically):

<additional_keywords_path>

A string representing a file containing additional keywords with newline as the delimiter. Keywords with more than one token should be written by embedding spaces between the tokens. For example, 'System.out.print' should be written as 'System . out . print'. If unused, please set this to 'null'.

<disguise_id>

A number representing a code disguise. See the complete list at the end of this help.
Value: 0-59.

<human_language>

A constant depicting the human language used on the applied disguises.
Value: 'en' for English or 'id' for Indonesian.

<input_project_path>

A string representing the path of the source code projects for input. Please use quotes if the path contains spaces.

<num_comment_disguises>

A number depicting the maximum number of comment disguises that will be applied.
Value: a non-negative integer lower or equal to 27.

<num_constant_and_data_type_disguises>

A number depicting the maximum number of constant disguises that will be applied.
Value: a non-negative integer lower or equal to 15.

<num_ident_disguises>

A number depicting the maximum number of identifier disguises that will be applied.
Value: a non-negative integer lower or equal to 10.

<num_whitespace_disguises>

A number depicting the maximum number of whitespace disguises that will be applied.
Value: a non-negative integer lower or equal to 8.

<programming_language>

A constant depicting the programming language used on given source code files.
Value: 'java' (for Java) or 'py' (for Python).

Acknowledgments

This tool uses ANTLR to tokenise given program, Apache Lucene to identify common words, google-java-format to reformat Java program, and YAPF to reformat Python program.