Skip to content

Running the Evaluator

Grace Tang edited this page Mar 5, 2020 · 16 revisions

Tips on running the evaluator plug-in

Install Environmental Variables

https://github.com/JorisAerts/Eclipse-Environment-Variables

Environmental Variables

Key Type Description
edu.cuny.hunter.log.evaluation.useGitHistory boolean Traverse git history to rejuvenate log levels.
edu.cuny.hunter.log.evaluation.useLogCategory boolean Treat CONFIG/WARNING/SEVERE log levels as category and not traditional levels.
edu.cuny.hunter.log.evaluation.useLogCategoryWithConfig boolean Treat CONFIG log level as a category and not a traditional level.
edu.cuny.hunter.log.evaluation.notLowerLogLevelInCatchBlock boolean Never lower the logging level of logging statements within catch blocks.
edu.cuny.hunter.log.evaluation.notLowerLogLevelInIfStatement boolean Never lower the logging level of logging statements within immediate if statements (treat if and else all the same).
edu.cuny.hunter.log.evaluation.notLowerLogLevelWithKeywords boolean Never lower logs with particular keywords in their log messages.
edu.cuny.hunter.log.evaluation.notRaiseLogLevelWithoutKeywords boolean Never raise logs without particular keywords in their log messages.
edu.cuny.hunter.log.evaluation.checkIfCondition boolean Do not change a log level in a logging statement if there exists an immediate if statement whose condition contains a log level.
edu.cuny.hunter.log.evaluation.consistentLevelInInheritance boolean Consistent log level transformations between overriding methods.
edu.cuny.hunter.log.evaluation.maxTransDistance int Adjust transformations if their transformation distance is over maximum transformation distance.

Configuration File

A file named eval.properties can be placed at the project root. The following keys are available:

Key Type Description
NToUseForCommits int The maximal number of commits the tool will analyze.