Generate JSON docs with Gson

src/main/java/ch/njol/skript/SkriptCommand.java

@@ -21,7 +21,9 @@
 import ch.njol.skript.aliases.Aliases;
 import ch.njol.skript.command.CommandHelp;
 import ch.njol.skript.doc.Documentation;
+import ch.njol.skript.doc.DocumentationIdProvider;
 import ch.njol.skript.doc.HTMLGenerator;
+import ch.njol.skript.doc.JSONGenerator;
 import ch.njol.skript.localization.ArgsMessage;
 import ch.njol.skript.localization.Language;
 import ch.njol.skript.localization.PluralizingArgsMessage;
@@ -403,9 +405,11 @@ public boolean onCommand(CommandSender sender, Command command, String label, St
 				}
 				File outputDir = Documentation.getDocsOutputDirectory();
 				outputDir.mkdirs();
-				HTMLGenerator generator = new HTMLGenerator(templateDir, outputDir);
+				HTMLGenerator htmlGenerator = new HTMLGenerator(templateDir, outputDir);
+				JSONGenerator jsonGenerator = new JSONGenerator(templateDir, outputDir);
 				Skript.info(sender, "Generating docs...");
-				generator.generate(); // Try to generate docs... hopefully
+				htmlGenerator.generate(); // Try to generate docs... hopefully
+				jsonGenerator.generate();
 				Skript.info(sender, "Documentation generated!");
 			} else if (args[0].equalsIgnoreCase("test") && TestMode.DEV_MODE) {
 				File scriptFile;

src/main/java/ch/njol/skript/doc/DocumentationGenerator.java

@@ -0,0 +1,35 @@
+/**
+ *   This file is part of Skript.
+ *
+ *  Skript is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  Skript is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with Skript.  If not, see <http://www.gnu.org/licenses/>.
+ *
+ * Copyright Peter Güttinger, SkriptLang team and contributors
+ */
+package ch.njol.skript.doc;
+
+import java.io.File;
+
+public abstract class DocumentationGenerator {
+
+	protected File templateDir;
+	protected File outputDir;
+
+	public DocumentationGenerator(File templateDir, File outputDir) {
+		this.templateDir = templateDir;
+		this.outputDir = outputDir;
+	}
+
+	public abstract void generate();
+
+}

src/main/java/ch/njol/skript/doc/DocumentationIdProvider.java

@@ -0,0 +1,119 @@
+/**
+ *   This file is part of Skript.
+ *
+ *  Skript is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  Skript is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with Skript.  If not, see <http://www.gnu.org/licenses/>.
+ *
+ * Copyright Peter Güttinger, SkriptLang team and contributors
+ */
+package ch.njol.skript.doc;
+
+import ch.njol.skript.Skript;
+import ch.njol.skript.classes.ClassInfo;
+import ch.njol.skript.lang.Condition;
+import ch.njol.skript.lang.Effect;
+import ch.njol.skript.lang.Expression;
+import ch.njol.skript.lang.Section;
+import ch.njol.skript.lang.SkriptEventInfo;
+import ch.njol.skript.lang.SyntaxElementInfo;
+import ch.njol.skript.lang.function.Function;
+import ch.njol.skript.lang.function.Functions;
+import ch.njol.skript.registrations.Classes;
+import org.skriptlang.skript.lang.structure.Structure;
+
+import java.util.Iterator;
+import java.util.Objects;
+import java.util.function.Predicate;
+
+public class DocumentationIdProvider {
+
+	private static String addCollisionSuffix(String id, int collisionCount) {
+		if (collisionCount == 0) {
+			return id;
+		}
+		return id + "-" + (collisionCount + 1);
+	}
+
+	private static <T> int calculateCollisionCount(Iterator<? extends T> potentialCollisions, Predicate<T> collisionCriteria,
+											Predicate<T> equalsCriteria) {
+		int collisionCount = 0;
+		while (potentialCollisions.hasNext()) {
+			T potentialCollision = potentialCollisions.next();
+			if (collisionCriteria.test(potentialCollision)) {
+				if (equalsCriteria.test(potentialCollision)) {
+					break;
+				}
+				collisionCount += 1;
+			}
+		}
+		return collisionCount;
+	}
+
+	public static <T> String getId(SyntaxElementInfo<? extends T> syntaxInfo) {
+		Class<?> syntaxClass = syntaxInfo.getElementClass();
+		Iterator<? extends SyntaxElementInfo<?>> syntaxElementIterator;
+		if (Effect.class.isAssignableFrom(syntaxClass)) {
+			syntaxElementIterator = Skript.getEffects().iterator();
+		} else if (Condition.class.isAssignableFrom(syntaxClass)) {
+			syntaxElementIterator = Skript.getConditions().iterator();
+		} else if (Expression.class.isAssignableFrom(syntaxClass)) {
+			syntaxElementIterator = Skript.getExpressions();
+		} else if (Section.class.isAssignableFrom(syntaxClass)) {
+			syntaxElementIterator = Skript.getSections().iterator();
+		} else if (Structure.class.isAssignableFrom(syntaxClass)) {
+			syntaxElementIterator = Skript.getStructures().iterator();
+		} else {
+			throw new IllegalStateException("Unsupported syntax type provided");
+		}
+		int collisionCount = calculateCollisionCount(syntaxElementIterator,
+			elementInfo -> elementInfo.getElementClass() == syntaxClass,
+			elementInfo -> elementInfo == syntaxInfo);
+		DocumentationId documentationIdAnnotation = syntaxClass.getAnnotation(DocumentationId.class);
+		if (documentationIdAnnotation == null) {
+			return addCollisionSuffix(syntaxClass.getSimpleName(), collisionCount);
+		}
+		return addCollisionSuffix(documentationIdAnnotation.value(), collisionCount);
+	}
+
+	public static String getId(Function<?> function) {
+		int collisionCount = calculateCollisionCount(Functions.getJavaFunctions().iterator(),
+			javaFunction -> function.getName().equals(javaFunction.getName()),
+			javaFunction -> javaFunction == function);
+		return addCollisionSuffix(function.getName(), collisionCount);
+	}
+
+	private static String getClassInfoId(ClassInfo<?> classInfo) {
+		return Objects.requireNonNullElse(classInfo.getDocumentationID(), classInfo.getCodeName());
+	}
+
+	public static String getId(ClassInfo<?> classInfo) {
+		String classInfoId = getClassInfoId(classInfo);
+		int collisionCount = calculateCollisionCount(Classes.getClassInfos().iterator(),
+			otherClassInfo -> classInfoId.equals(getClassInfoId(otherClassInfo)),
+			otherClassInfo -> classInfo == otherClassInfo);
+		return addCollisionSuffix(classInfoId, collisionCount);
+	}
+
+	private static String getEventId(SkriptEventInfo<?> eventInfo) {
+		return Objects.requireNonNullElse(eventInfo.getDocumentationID(), eventInfo.getId());
+	}
+
+	public static String getId(SkriptEventInfo<?> eventInfo) {
+		String eventId = getEventId(eventInfo);
+		int collisionCount = calculateCollisionCount(Skript.getEvents().iterator(),
+			otherEventInfo -> eventId.equals(getEventId(otherEventInfo)),
+			otherEventInfo -> otherEventInfo == eventInfo);
+		return addCollisionSuffix(eventId, collisionCount);
+	}
+
+}