qw

README.md

@@ -0,0 +1,75 @@
+# Download and Run JPlag
+Download a released version - all releases are single-JAR releases.
+
+Type `java -jar jplag-yourVersion.jar` in a console to see the command line options.
+The options as of 2016/02/29 are:
+
+```
+JPlag (Version 2.11.8-SNAPSHOT), Copyright (c) 2004-2015 KIT - IPD Tichy, Guido Malpohl, and others.
+Usage: JPlag [ options ] <root-dir>
+ <root-dir>        The root-directory that contains all submissions
+
+options are:
+ -v[qlpd]        (Verbose)
+                 q: (Quiet) no output
+                 l: (Long) detailed output
+                 p: print all (p)arser messages
+                 d: print (d)etails about each submission
+ -d              (Debug) parser. Non-parsable files will be stored.
+ -S <dir>        Look in directories <root-dir>/*/<dir> for programs.
+                 (default: <root-dir>/*)
+ -s              (Subdirs) Look at files in subdirs too (default: deactivated)
+
+ -p <suffixes>   <suffixes> is a comma-separated list of all filename suffixes
+                 that are included. ("-p ?" for defaults)
+
+ -o <file>       (Output) The Parserlog will be saved to <file>
+ -x <file>       (eXclude) All files named in <file> will be ignored
+ -t <n>          (Token) Tune the sensitivity of the comparison. A smaller
+                 <n> increases the sensitivity.
+ -m <n>          (Matches) Number of matches that will be saved (default:20)
+ -m <p>%         All matches with more than <p>% similarity will be saved.
+ -r <dir>        (Result) Name of directory in which the web pages will be
+                 stored (default: result)
+ -bc <dir>       Name of the directory which contains the basecode (common framework)
+ -l <language>   (Language) Supported Languages:
+                 java17 (default), java15, java15dm, java12, java11, c/c++, c#-1.2, char, text, scheme
+```
+
+## Example
+Assume that we want to check students' solutions that are written in Java 1.7.
+
+Each student solution is in its own directory, say `student1`, `student2`, and so on.
+All solutions are in a common directory, say `exercise1`.
+
+To run JPlag, simply type `java -jar jplag-yourVersion.jar -l java17 -r /tmp/jplag_results_exercise1/ -s /path/to/exercise1`
+
+- `-l java17` tells JPlag to use the frontend for Java 1.7
+- `-s` tells JPlag to recurse into subdirectories; as we assume Java projects, we'll very likely encounter subdirectories such as `student1/src/`
+- `-r /tmp/jplag_results_exercise1` tells JPlag to store the results in the directory `/tmp/jplag_results_exercise1`
+
+**Note:** You have to specify the language exactly as they are printed by JPlag (running JPlag without command line arguments prints all available languages - and other options).
+E.g., if you want to process C++ files, you have specify `-l c/c++` as language option.
+
+## Options
+### `-x <file>`   (eXclude) All files named in `<file>` will be ignored
+The option `-x` requires an exclusion list saved as `<file>`.
+The exclusion list contains a  number of suffixes.
+JPlag will ignore all files that end with one of the suffixes.
+
+
+# Building JPlag
+To build and run a local installation of JPlag, you can use the pom.xml in this directory (aggregator). It builds JPlag and the available frontends. 
+
+To generate single modules run `mvn clean generate-sources package` in the base directory; if you want a single file then run `mvn clean generate-sources assembly:assembly` inside the `jplag` directory. You will find the JARs in the respective `target` directories. If you build a single JAR, it will be generated in `jplag/target`.
+
+## Web Service
+Installing, running and maintaining a local web service is not recommended as the web service uses outdated libraries and (really) needs polishing.
+
+If you want to do it anyway: `atujplag` is the client, `webservice` is the - yepp - web service.
+
+# Improving JPlag
+We're happy to incorporate all improvements to JPlag into this code base. Feel free to fork the project and send pull requests.
+
+## Adding new languages
+Adding a new language frontend is quite simple. Have a look at one of the `jplag.frontend` projects. All you need is a parser for the language (e.g., for ANTLR or for JavaCC) and a few lines of code that sends the tokens (that are generated by the parser) to JPlag.

jplag.adminTool/pom.xml

@@ -8,6 +8,7 @@
 		<groupId>edu.kit.ipd.jplag</groupId>
 		<artifactId>parent</artifactId>
 		<version>0.3-SNAPSHOT</version>
+		<relativePath>../jplag.parent/pom.xml</relativePath>
 	</parent>
 
 	<repositories>
@@ -19,7 +20,7 @@
 		<repository>
 			<id>projectLocal</id>
 			<name>Local Repository</name>
-			<url>file://${project.basedir}/../../maven-libs</url>
+			<url>file://${project.basedir}/../maven-libs</url>
 		</repository>
 	</repositories>
 

jplag.atujplag/pom.xml

@@ -8,6 +8,7 @@
 		<groupId>edu.kit.ipd.jplag</groupId>
 		<artifactId>parent</artifactId>
 		<version>0.3-SNAPSHOT</version>
+		<relativePath>../jplag.parent/pom.xml</relativePath>
 	</parent>
 
 	<repositories>
@@ -19,7 +20,7 @@
 		<repository>
 			<id>projectLocal</id>
 			<name>Local Repository</name>
-			<url>file://${project.basedir}/../../maven-libs</url>
+			<url>file://${project.basedir}/../maven-libs</url>
 		</repository>
 	</repositories>
 

jplag.frontend-utils/pom.xml

@@ -6,6 +6,7 @@
   	<groupId>edu.kit.ipd.jplag</groupId>
   	<artifactId>parent</artifactId>
   	<version>0.3-SNAPSHOT</version>
+  	<relativePath>../jplag.parent/pom.xml</relativePath>
   </parent>
 
   	<repositories>

jplag.frontend.chars/pom.xml

@@ -38,6 +38,7 @@
 		<groupId>edu.kit.ipd.jplag</groupId>
 		<artifactId>parent</artifactId>
 		<version>0.3-SNAPSHOT</version>
+		<relativePath>../jplag.parent/pom.xml</relativePath>
 	</parent>
 	<artifactId>chars</artifactId>
 </project>

jplag.frontend.cpp/pom.xml

@@ -110,5 +110,6 @@
 		<groupId>edu.kit.ipd.jplag</groupId>
 		<artifactId>parent</artifactId>
 		<version>0.3-SNAPSHOT</version>
+		<relativePath>../jplag.parent/pom.xml</relativePath>
 	</parent>
 </project>

jplag.frontend.cpp/src/main/java/jplag/cpp/Language.java

@@ -22,8 +22,8 @@ public int errorsCount() {
 	}
 
 	public String[] suffixes() {
-		String[] res = { ".cpp", ".CPP", "c++", "C++", ".c", ".C", ".h", ".H",
-				".hpp", ".HPP" };
+		String[] res = { ".cpp", ".CPP", ".cxx", ".CXX", ".c++", ".C++", ".c", ".C", ".cc", ".CC", ".h", ".H",
+				".hpp", ".HPP", ".hh", ".HH" };
 		return res;
 	}
 

jplag.frontend.cpp/src/main/java/jplag/cpp/Scanner.java

@@ -20,7 +20,7 @@ public static void main(String args[]) {
 		Scanner scanner = new Scanner();
 		scanner.setProgram(new StrippedProgram());
 
-		jplag.Structure s = scanner.scan(new File("."), args);
+		scanner.scan(new File("."), args);
 	}
 
 	public jplag.Structure scan(File dir, String files[]) {

jplag.frontend.cpp/src/main/javacc/CPP.jj

@@ -248,7 +248,7 @@ TOKEN :
              ["n","t","v","b","r","f","a","\\","?","'","\""]
            | "0" (["0"-"7"])*
            | ["1"-"9"] (["0"-"9"])*
-           | ("0x" | "0X") (["0"-"9","a"-"f","A"-"F"])+
+           | ("X" | "x" | "U" | "u") (["0"-"9","a"-"f","A"-"F"])+
            )
      )
    )
@@ -260,7 +260,7 @@ TOKEN :
              ["n","t","v","b","r","f","a","\\","?","'","\""]
            | "0" (["0"-"7"])*
            | ["1"-"9"] (["0"-"9"])*
-           | ("0")? ("X" | "x" | "u") (["0"-"9","a"-"f","A"-"F"])+
+           | ("X" | "x" | "U" | "u") (["0"-"9","a"-"f","A"-"F"])+
 	   | "\n"
            )
      )

jplag.frontend.csharp-1.2/pom.xml

@@ -82,5 +82,6 @@
 		<groupId>edu.kit.ipd.jplag</groupId>
 		<artifactId>parent</artifactId>
 		<version>0.3-SNAPSHOT</version>
+		<relativePath>../jplag.parent/pom.xml</relativePath>
 	</parent>
 </project>

jplag.frontend.java-1.1exp/pom.xml

@@ -112,5 +112,6 @@
 		<groupId>edu.kit.ipd.jplag</groupId>
 		<artifactId>parent</artifactId>
 		<version>0.3-SNAPSHOT</version>
+		<relativePath>../jplag.parent/pom.xml</relativePath>
 	</parent>
 </project>

jplag.frontend.java-1.2/pom.xml

@@ -84,5 +84,6 @@
 		<groupId>edu.kit.ipd.jplag</groupId>
 		<artifactId>parent</artifactId>
 		<version>0.3-SNAPSHOT</version>
+		<relativePath>../jplag.parent/pom.xml</relativePath>
 	</parent>
 </project>

jplag.frontend.java-1.5/.gitignore

@@ -0,0 +1,6 @@
+src/main/java/jplag/java15/grammar/CharStream.java
+src/main/java/jplag/java15/grammar/JavaParser.java
+src/main/java/jplag/java15/grammar/JavaParserConstants.java
+src/main/java/jplag/java15/grammar/JavaParserTokenManager.java
+src/main/java/jplag/java15/grammar/ParseException.java
+src/main/java/jplag/java15/grammar/TokenMgrError.java

jplag.frontend.java-1.5/pom.xml

@@ -41,7 +41,7 @@
 					<grammarEncoding>${project.build.sourceEncoding}</grammarEncoding>
 					<debugparser>false</debugparser>
 					<isStatic>false</isStatic>
-					<outputDirectory>src/main/java/jplag/java15/grammar</outputDirectory>
+					<outputDirectory>${project.basedir}/src/main/java/jplag/java15/grammar</outputDirectory>
 				</configuration>
 				<executions>
 					<execution>
@@ -78,6 +78,7 @@
 		<groupId>edu.kit.ipd.jplag</groupId>
 		<artifactId>parent</artifactId>
 		<version>0.3-SNAPSHOT</version>
+		<relativePath>../jplag.parent/pom.xml</relativePath>
 	</parent>
 	<artifactId>java-1.5</artifactId>
 </project>

jplag.frontend.java-1.7/pom.xml

@@ -95,5 +95,6 @@
 		<groupId>edu.kit.ipd.jplag</groupId>
 		<artifactId>parent</artifactId>
 		<version>0.3-SNAPSHOT</version>
+		<relativePath>../jplag.parent/pom.xml</relativePath>
 	</parent>
 </project>

jplag.frontend.java-1.7/src/main/java/jplag/java17/Language.java

@@ -42,7 +42,7 @@ public boolean errors() {
 	}
 
 	public boolean supportsColumns() {
-		return false; // was true - should be true :/
+		return true;
 	}
 
 	public boolean isPreformated() {

jplag.frontend.java-1.7/src/main/java/jplag/java17/Parser.java

@@ -18,12 +18,12 @@
 import org.antlr.v4.runtime.tree.ParseTreeWalker;
 
 public class Parser extends jplag.Parser implements JavaTokenConstants {
-	private Structure struct = new Structure();;
+	private Structure struct = new Structure();
 	private String currentFile;
 
 	public static void main(String args[]) {
 		if (args.length < 1) {
-			System.out.println("Only one ore more files as parameter allowed.");
+			System.out.println("Only one or more files as parameter allowed.");
 			System.exit(-1);
 		}
 		Parser parser = new Parser();
@@ -113,7 +113,7 @@ public boolean parseFile(File dir, String file) {
 	//	}
 
 	public void add(int type, org.antlr.v4.runtime.Token tok) {
-		struct.addToken(new JavaToken(type, (currentFile == null ? "null" : currentFile), tok.getLine(), tok.getStartIndex(), 
+		struct.addToken(new JavaToken(type, (currentFile == null ? "null" : currentFile), tok.getLine(), tok.getCharPositionInLine() + 1, 
 				tok.getText().length()));
 	}
 }

jplag.frontend.python-3/pom.xml

@@ -0,0 +1,94 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+	<modelVersion>4.0.0</modelVersion>
+	<artifactId>python-3</artifactId>
+	<version>0.0.1-SNAPSHOT</version>
+
+	<repositories>
+		<repository>
+			<id>ipdNexus</id>
+			<name>Recaa Repository</name>
+			<url>http://bob.ipd.kit.edu/nexus/content/repositories/public/</url>
+		</repository>
+	</repositories>
+
+	<build>
+		<plugins>
+			<plugin>
+				<groupId>org.codehaus.mojo</groupId>
+				<artifactId>build-helper-maven-plugin</artifactId>
+				<version>1.7</version>
+				<configuration>
+					<sources>
+						<source>target/generated-sources/antlr4</source>
+					</sources>
+				</configuration>
+				<executions>
+					<execution>
+						<id>generate-antlr-sources</id>
+						<phase>generate-sources</phase>
+						<goals>
+							<goal>add-source</goal>
+						</goals>
+					</execution>
+					<execution>
+						<id>compile-with-antlr-sources</id>
+						<phase>compile</phase>
+						<goals>
+							<goal>add-source</goal>
+						</goals>
+					</execution>
+				</executions>
+			</plugin>
+			<plugin>
+				<groupId>org.antlr</groupId>
+				<artifactId>antlr4-maven-plugin</artifactId>
+				<version>4.2</version>
+				<configuration>
+					<!-- Comma separated list of grammar files or pattern grammar files
+						By default, grammar file(s) is in ${basedir}/src/main/antlr -->
+					<!-- <grammars>*.g</grammars> -->
+					<grammars>Python3.g4</grammars>
+				</configuration>
+				<executions>
+					<execution>
+						<goals>
+							<goal>antlr4</goal>
+						</goals>
+					</execution>
+				</executions>
+			</plugin>
+
+			<plugin>
+				<groupId>org.apache.maven.plugins</groupId>
+				<artifactId>maven-jar-plugin</artifactId>
+				<configuration>
+					<archive>
+						<manifest>
+							<mainClass>jplag.python3.Parser</mainClass>
+							<packageName>jplag.python3</packageName>
+						</manifest>
+					</archive>
+				</configuration>
+			</plugin>
+
+		</plugins>
+	</build>
+
+	<dependencies>
+		<dependency>
+			<groupId>edu.kit.ipd.jplag</groupId>
+			<artifactId>frontend-utils</artifactId>
+		</dependency>
+		<dependency>
+			<groupId>org.antlr</groupId>
+			<artifactId>antlr4-runtime</artifactId>
+		</dependency>
+	</dependencies>
+	<parent>
+		<groupId>edu.kit.ipd.jplag</groupId>
+		<artifactId>parent</artifactId>
+		<version>0.3-SNAPSHOT</version>
+		<relativePath>../jplag.parent/pom.xml</relativePath>
+	</parent>
+</project>