Top > Research > Tools > NestLevelMeter

NestLevelMeter

Summary

NestLevelMeter explores all lines in a Java source file, and oututs the average nesting level and the maximum nesting level.

Download

Jar file: NestLevelMeter.jar Ver. 0.2 (87KB)
Soruce file ( on GitHub ): NestLevelMeter.jj (ver.0.1) -- JavaCC grammar file.
examples/JavaGrammars/1.5/MyToken.java (in JavaCC) is also required.
NestLevelMetter.jj is developed based on examples/JavaGrammars/1.5/Java1.5.jj. , a JavaCC grammar file.

How to use

java -jar [option] NestLevelMeter.jar source_file

Options
- (none): the average nesting level (ANL) is displayed
- --max : the maximum nesting level (MNL) is displayed
- --all : both ANL and MNL are displayed
Output format (with --all):
"source_file_name,ANL,MNL"
On Unix/Linux, you can run NestLevelMeter for all Java source files in dir as follows:

find dir -name *.java -exec java -jar NestLevelMeter.jar [option] \{\} \;

API sample:

NestLevelMeter parser = new NestLevelMeter(new java.io.FileInputStream(fileName));
parser.CompilationUnit();
int max = parser.getMaxNestLevel();
double avg = parser.getAverageNestLevel();

Note: fileName is the target source file name (String), max is the maximum nest level, and avg is the average nest level.