feat(api): add new methods for asm/disasm single mode

Author: skylot

raung-asm/src/main/java/io/github/skylot/raung/asm/api/IRaungAsm.java

@@ -24,19 +24,25 @@ public interface IRaungAsm {
 	IRaungAsm output(Path out);
 
 	/**
-	 * Preform assemble according to provided options.
+	 * Execute according to provided options.
 	 */
 	void execute();
 
 	/**
-	 * Single mode: process specified input file and return result as byte array.
+	 * Single mode: process specified input file and return result as a byte array.
 	 * Any set inputs or output will be ignored.
 	 */
 	byte[] executeForSingleClass(Path input);
 
 	/**
-	 * Single mode: process specified input stream and return result as byte array.
+	 * Single mode: process specified input stream and return result as a byte array.
 	 * Any set inputs or output will be ignored.
 	 */
 	byte[] executeForInputStream(InputStream input);
+
+	/**
+	 * Single mode: process specified input raung code and return result as a byte array.
+	 * Any set inputs or output will be ignored.
+	 */
+	byte[] executeForString(String raungCodeStr);
 }

raung-asm/src/main/java/io/github/skylot/raung/asm/impl/RaungAsmBuilder.java

@@ -1,6 +1,8 @@
 package io.github.skylot.raung.asm.impl;
 
+import java.io.ByteArrayInputStream;
 import java.io.InputStream;
+import java.nio.charset.StandardCharsets;
 import java.nio.file.Path;
 import java.util.ArrayList;
 import java.util.List;
@@ -62,6 +64,17 @@ public byte[] executeForInputStream(InputStream input) {
 		}
 	}
 
+	@Override
+	public byte[] executeForString(String code) {
+		try (InputStream input = new ByteArrayInputStream(code.getBytes(StandardCharsets.UTF_8))) {
+			return RaungAsmExecutor.processInputStream(this, input, "<input>");
+		} catch (RaungAsmException e) {
+			throw e;
+		} catch (Exception e) {
+			throw new RaungAsmException("Failed to process input code", e);
+		}
+	}
+
 	@Override
 	public String toString() {
 		return "RaungAsmArgs{input=" + inputs + ", output=" + output + '}';

raung-disasm/src/main/java/io/github/skylot/raung/disasm/api/IRaungDisasm.java

@@ -71,4 +71,10 @@ public interface IRaungDisasm {
 	 * Any set inputs or output will be ignored.
 	 */
 	String executeForInputStream(InputStream input);
+
+	/**
+	 * Single mode: process specified input class file bytes and return result as string.
+	 * Any set inputs or output will be ignored.
+	 */
+	String executeForBytes(byte[] bytes);
 }

raung-disasm/src/main/java/io/github/skylot/raung/disasm/impl/RaungDisasmBuilder.java

@@ -125,6 +125,15 @@ public String executeForInputStream(InputStream input) {
 		}
 	}
 
+	@Override
+	public String executeForBytes(byte[] bytes) {
+		try {
+			return RaungDisasmExecutor.processBytes(this, bytes);
+		} catch (Exception e) {
+			throw new RaungDisasmException("Failed to process input bytes", e);
+		}
+	}
+
 	@Override
 	public String toString() {
 		return "RaungDisasmBuilder{"

raung-disasm/src/main/java/io/github/skylot/raung/disasm/impl/RaungDisasmExecutor.java

@@ -39,6 +39,11 @@ public static String processInputStream(RaungDisasmBuilder args, InputStream in)
 		return runForInputStream(args, in).getResult();
 	}
 
+	public static String processBytes(RaungDisasmBuilder args, byte[] bytes) {
+		ValidateDisasmArgs.processOptions(args);
+		return execute(args, new ClassReader(bytes)).getResult();
+	}
+
 	private static RaungClassVisitor runForSingleClass(RaungDisasmBuilder args, Path clsFile) {
 		try (InputStream in = new BufferedInputStream(Files.newInputStream(clsFile, StandardOpenOption.READ))) {
 			return runForInputStream(args, in);
@@ -48,7 +53,10 @@ private static RaungClassVisitor runForSingleClass(RaungDisasmBuilder args, Path
 	}
 
 	private static RaungClassVisitor runForInputStream(RaungDisasmBuilder args, InputStream in) throws IOException {
-		ClassReader reader = new ClassReader(in);
+		return execute(args, new ClassReader(in));
+	}
+
+	private static RaungClassVisitor execute(RaungDisasmBuilder args, ClassReader reader) {
 		RaungClassVisitor visitor = new RaungClassVisitor(args);
 		reader.accept(visitor, 0); // TODO: add option for skip frames (if '.auto frames' will be used)
 		return visitor;