Script-managing syntax.

Author: Moderocky

src/main/java/org/byteskript/skript/compiler/SkriptLangSpec.java

@@ -52,9 +52,7 @@
 import org.byteskript.skript.lang.syntax.map.KeyInMap;
 import org.byteskript.skript.lang.syntax.map.MapCreator;
 import org.byteskript.skript.lang.syntax.maths.*;
-import org.byteskript.skript.lang.syntax.script.CurrentScriptExpression;
-import org.byteskript.skript.lang.syntax.script.LoadScriptEffect;
-import org.byteskript.skript.lang.syntax.script.UnloadScriptEffect;
+import org.byteskript.skript.lang.syntax.script.*;
 import org.byteskript.skript.lang.syntax.timing.*;
 import org.byteskript.skript.lang.syntax.type.*;
 import org.byteskript.skript.lang.syntax.type.property.FinalEntry;
@@ -212,6 +210,8 @@ private SkriptLangSpec() {
             new ExternalFunctionExpression(),
             new PropertyFunctionExpression(),
             new FunctionExpression(),
+            new CompilerExpression(),
+            new LoadedScriptsExpression(),
             new CurrentScriptExpression(),
             new CurrentEventExpression(),
             new NoArgsFunctionExpression(),

src/main/java/org/byteskript/skript/lang/syntax/script/CompilerExpression.java

@@ -0,0 +1,50 @@
+/*
+ * Copyright (c) 2021 ByteSkript org (Moderocky)
+ * View the full licence information and permissions:
+ * https://github.com/Moderocky/ByteSkript/blob/master/LICENSE
+ */
+
+package org.byteskript.skript.lang.syntax.script;
+
+import mx.kenzie.foundation.Type;
+import org.byteskript.skript.api.note.Documentation;
+import org.byteskript.skript.api.syntax.SimpleExpression;
+import org.byteskript.skript.compiler.CommonTypes;
+import org.byteskript.skript.compiler.SkriptLangSpec;
+import org.byteskript.skript.lang.element.StandardElements;
+import org.byteskript.skript.lang.handler.StandardHandlers;
+import org.byteskript.skript.runtime.internal.ExtractedSyntaxCalls;
+
+@Documentation(
+    name = "Compiler",
+    description = """
+        Obtains the current compiler. This may not exist.
+        This can be used to check whether this installation is able to load scripts.
+        If the compiler is `null`, the load effect will be unavailable.
+        """,
+    examples = {
+        """
+            set {var} to the compiler
+            if the compiler exists:
+                print "can load scripts :)"
+                """
+    }
+)
+public class CompilerExpression extends SimpleExpression {
+    
+    public CompilerExpression() {
+        super(SkriptLangSpec.LIBRARY, StandardElements.EXPRESSION, "[the] compiler");
+        handlers.put(StandardHandlers.GET, findMethod(ExtractedSyntaxCalls.class, "getCompiler"));
+    }
+    
+    @Override
+    public Type getReturnType() {
+        return CommonTypes.OBJECT;
+    }
+    
+    @Override
+    public boolean allowAsInputFor(Type type) {
+        return CommonTypes.OBJECT.equals(type) || super.allowAsInputFor(type);
+    }
+    
+}

src/main/java/org/byteskript/skript/lang/syntax/script/LoadScriptEffect.java

@@ -23,6 +23,7 @@
     name = "Load Script",
     description = """
         Loads a script from the given file or string source code.
+        Not all installations can load scripts after start-up: check whether the compiler exists first.
         """,
     examples = {
         """

src/main/java/org/byteskript/skript/lang/syntax/script/LoadedScriptsExpression.java

@@ -0,0 +1,49 @@
+/*
+ * Copyright (c) 2021 ByteSkript org (Moderocky)
+ * View the full licence information and permissions:
+ * https://github.com/Moderocky/ByteSkript/blob/master/LICENSE
+ */
+
+package org.byteskript.skript.lang.syntax.script;
+
+import mx.kenzie.foundation.Type;
+import org.byteskript.skript.api.note.Documentation;
+import org.byteskript.skript.api.syntax.SimpleExpression;
+import org.byteskript.skript.compiler.CommonTypes;
+import org.byteskript.skript.compiler.SkriptLangSpec;
+import org.byteskript.skript.lang.element.StandardElements;
+import org.byteskript.skript.lang.handler.StandardHandlers;
+import org.byteskript.skript.runtime.internal.ExtractedSyntaxCalls;
+
+@Documentation(
+    name = "Loaded Scripts",
+    description = """
+        A list of the main classes for all loaded scripts.
+        Storing these will prevent them being unloaded safely.
+        """,
+    examples = {
+        """
+            set {list} to the loaded scripts
+            loop {script} in {list}:
+                print name of {script}
+                """
+    }
+)
+public class LoadedScriptsExpression extends SimpleExpression {
+    
+    public LoadedScriptsExpression() {
+        super(SkriptLangSpec.LIBRARY, StandardElements.EXPRESSION, "[(the|all)] loaded scripts");
+        handlers.put(StandardHandlers.GET, findMethod(ExtractedSyntaxCalls.class, "getLoadedScripts"));
+    }
+    
+    @Override
+    public Type getReturnType() {
+        return CommonTypes.LIST;
+    }
+    
+    @Override
+    public boolean allowAsInputFor(Type type) {
+        return CommonTypes.LIST.equals(type) || super.allowAsInputFor(type);
+    }
+    
+}

src/main/java/org/byteskript/skript/lang/syntax/script/UnloadScriptEffect.java

@@ -28,7 +28,7 @@
         """
             unload script skript/myscript
             """
-    } // todo
+    }
 )
 public class UnloadScriptEffect extends Effect {
 

src/main/java/org/byteskript/skript/runtime/Skript.java

@@ -160,6 +160,20 @@ public static void runOnAsyncThread(final Runnable runnable) {
     //endregion
 
     //region Script Control
+    
+    /**
+     * Gets a copy of the handles for all loaded scripts.
+     * Storing a strong reference to these will prevent them being unloaded safely.
+     * These can be graveyarded (annulled in memory) without warning.
+     * <p>
+     * This is designed for looping and discarding.
+     *
+     * @return the scripts owned by this instance
+     */
+    public Script[] getScripts() {
+        return scripts.toArray(new Script[0]);
+    }
+    
     public Collection<OperationController> getProcesses() {
         return processes;
     }

src/main/java/org/byteskript/skript/runtime/UnsafeAccessor.java

@@ -12,7 +12,7 @@
 import java.security.PrivilegedActionException;
 import java.security.PrivilegedExceptionAction;
 
-@SuppressWarnings("removal")
+@SuppressWarnings({"removal"})
 class UnsafeAccessor {
 
     private static final Unsafe UNSAFE;

src/main/java/org/byteskript/skript/runtime/internal/ExtractedSyntaxCalls.java

@@ -8,8 +8,10 @@
 
 import mx.kenzie.mirror.MethodAccessor;
 import org.byteskript.skript.error.ScriptRuntimeError;
+import org.byteskript.skript.runtime.Script;
 import org.byteskript.skript.runtime.Skript;
 import org.byteskript.skript.runtime.threading.ScriptThread;
+import org.byteskript.skript.runtime.type.DataList;
 
 import java.io.BufferedReader;
 import java.io.InputStreamReader;
@@ -21,6 +23,18 @@
 
 public class ExtractedSyntaxCalls {
 
+    public static ModifiableCompiler getCompiler() {
+        return Skript.currentInstance().getCompiler();
+    }
+    
+    public static DataList getLoadedScripts() {
+        final DataList list = new DataList();
+        for (final Script script : Skript.currentInstance().getScripts()) {
+            list.add(script.mainClass());
+        }
+        return list;
+    }
+    
     public static String getSystemInput() throws Throwable {
         final Instruction<String> instruction = new Instruction<>() {
             private String value;

src/test/java/org/byteskript/skript/test/InlineTest.java renamed to src/test/java/org/byteskript/skript/test/ScriptsTest.java

@@ -13,15 +13,15 @@
 import org.junit.BeforeClass;
 import org.junit.Test;
 
-public class InlineTest extends SkriptTest {
+public class ScriptsTest extends SkriptTest {
 
     private static final Skript skript = new Skript();
     private static Script script;
 
     @BeforeClass
     public static void start() throws Throwable {
-        final PostCompileClass cls = skript.compileScript(InlineTest.class.getClassLoader()
-            .getResourceAsStream("inline.bsk"), "skript.inline");
+        final PostCompileClass cls = skript.compileScript(ScriptsTest.class.getClassLoader()
+            .getResourceAsStream("scripts_test.bsk"), "skript.scripts_test");
         script = skript.loadScript(cls);
     }
 
@@ -32,4 +32,11 @@ public void simple() throws Throwable {
         function.invoke();
     }
 
+    @Test
+    public void test_load() throws Throwable {
+        final Member function = script.getFunction("test_load");
+        assert function != null;
+        function.invoke();
+    }
+    
 }