Add CLI

[jacosro]

Add support for command line interaction.

Todo list:

• [x] Add new module called cli
• [x] Implement Slicer
• [ ] Implement Graph (optional)

Two entrypoints needed:

Slicer

Entrypoint: Slicer class (cli module) Commands:

• -f <file>: the Java file for which the slicing will be performed
• -v <variable>: the name of the variable to take as slicing criterion
• -l <line>: the line in which the variable is to take as slicing criterion
• -i <directory> (Optional): directory of Java files to take into account for the analysis (this should look for Java files in subdirectories too)
• -o <directory> (Optional): directory in which output files will be stored (current directory by default)
• -d, --debug (Optional): Outputs debug files and prints debug information

Graph (Optional)

Entrypoint: Graph class (cli module) Options:

• cfg|pdg|sdg: the graph to build
• -m <method>: The method to analyse (only for cfg or pdg options)
• -d, --debug (Optional): Outputs debug files and prints debug information
• -i <directory>: The directory of Java files to be processed (only for sdg option)
• -o <directory>: Directory in which output files will be stored

@cargaji

[cargaji]

Suggestions:

1. Allow setting -i to be repeated, and even rename it to -c for "classpath" instead of -i for "include" or "input". Make it work similarly to the Java classpath: load all those folders into the Javaparser type resolver.
2. Allow a shorthand for the slicing criterion, such as file#line:var.
3. Introduce an additional (optional) parameter for the instance (in case a variable appears multiple times in the same line). The difference in handling is probably non-existent in the SDG.

[cargaji]

Underlying elements to get a working CLI:

• [x] Move project to sdg submodule
• [x] Create sdg-cli submodule
• [x] Create a slicing algorithm that is extensible and works on the SDG.
• [x] Resolve methods in MethodDeclarationSolver.
• [x] Create a SlicingCriterion that works with the SDG.
• [x] Adapt Slice#getAst() so that it can return NodeList<CompilationUnit>.
• [x] Create a CLI frontend that performs the complete slice, from source code file to sliced source code file.
• [ ] Connect all ACTUAL_IN to all ACTUAL_OUT in unresolved method calls.

See #32.