Note: These instructions assume that you have downloaded all files and directories in this repo to a linux machine. This project may work on Windows, but that is not guaranteed.
GUI Option:
- Type arguments into the fields. You must enter a package name. a) See "Package Naming Instructions" below for more details.
- Press the [Run] button.
Command Line Option:
- Type "python hybridfuzzer.py" a) Pass the package name as the first argument. If you do not, then you will be prompted for it. b) (Optional) Pass the build file name as the second argument. See "Build File Instructions" below for more details. c) (Optional) If your testing source code needs args to test correctly, then pass them in as args 3-x.
- Press Enter.
Package Naming Instructions:
- Be sure to use standard java conventions when creating your source code. In particular, all package names must be dot-separated, and must represent the directory/file tree of your source code files.
- Place your source code in the 'src' directory.
- Pass the name of your root-level entry file for your source code. Treat 'src' as the root directory, but do not include it in the name.
- Example: Your root file is in 'src/building/room' and is called 'Chair.java'. Pass 'building.room.Chair'.
Build File Instructions:
- If you have your own ant build file, then simply add it to the level of the Python script. a) If your file is named 'build.xml', then you do not need to pass the name. b) Otherwise, be sure to pass the name of your ant file. c) Feel free to overwrite the 'build.xml' file that comes with this package.
- If you want your code compiled with your system's standard java compiler, then pass the command 'javac' as this argument.
- If your code is already compiled, then add that code to the 'classes' directory, and pass the command 'do_not_compile' as this argument. This may be convenient if you run this tool multiple times and do not want to recompile your code each time.