Mod provided javadoc (#627)

src/main/java/net/fabricmc/loom/util/ModUtils.java

@@ -1,7 +1,7 @@
 /*
  * This file is part of fabric-loom, licensed under the MIT License (MIT).
  *
- * Copyright (c) 2016-2021 FabricMC
+ * Copyright (c) 2016-2022 FabricMC
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -25,12 +25,42 @@
 package net.fabricmc.loom.util;
 
 import java.io.File;
+import java.io.IOException;
+import java.io.UncheckedIOException;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Path;
+
+import com.google.gson.JsonObject;
+import org.jetbrains.annotations.Nullable;
+
+import net.fabricmc.loom.LoomGradlePlugin;
 
 public final class ModUtils {
 	private ModUtils() {
 	}
 
-	public static boolean isMod(File input) {
-		return ZipUtils.contains(input.toPath(), "fabric.mod.json");
+	public static boolean isMod(File file) {
+		return isMod(file.toPath());
+	}
+
+	public static boolean isMod(Path input) {
+		return ZipUtils.contains(input, "fabric.mod.json");
+	}
+
+	@Nullable
+	public static JsonObject getFabricModJson(Path path) {
+		final byte[] modJsonBytes;
+
+		try {
+			modJsonBytes = ZipUtils.unpackNullable(path, "fabric.mod.json");
+		} catch (IOException e) {
+			throw new UncheckedIOException("Failed to extract fabric.mod.json from " + path, e);
+		}
+
+		if (modJsonBytes == null) {
+			return null;
+		}
+
+		return LoomGradlePlugin.GSON.fromJson(new String(modJsonBytes, StandardCharsets.UTF_8), JsonObject.class);
 	}
 }