mi-lang

Scripting language designed to communicate with java, to allow for easy plugins, addons, etc in any project, all without having to create an entire programming language for it. Plugin / Addon developers don't need to create an entire java project for small things either, making life easier for both sides. Syntactically inspired by rust (pretty much only the keywords) but structure-wise it feels like simply writing java code with less code for same output.

Wiki

To see all features explained in detail: https://github.com/crxyne/mi-lang/wiki

NOTES

Currently in ALPHA

Mi is currently in a very early testing phase and is extremely buggy, so make sure to report any bugs to help the development of Mi.

The language is bad but not horrible (ha)

While this language may be interpreted in java (which is generally a horrible idea), the purpose of this language is not to be fast. However, whenever possible, the code will be optimized to allow for a faster execution. As a sidenote, this compiles to bytecode, meaning anyone could, in theory, write an interpreter for it in another language to get a better performance.

Usage

Make sure you have java 17 or higher installed. Download the mi-lang.jar from the releases tab. To compile a .mi file, use your terminal in the directory of your code file. Alternatively, create a script that does the same for you. Command:

java -Xmx2G -Xms2G -jar mi-lang.jar compile main=yourmodule.main file='yourfile.mi'

To execute your newly generated .mib binary, type the following into your terminal (or again, your script):

java -Xmx2G -Xms2G -jar mi-lang.jar run file='yourfile.mib'

Java usage

import org.crayne.mi.bytecode.common.ByteCodeInstruction;
import org.crayne.mi.bytecode.reader.ByteCodeInterpreter;
import org.crayne.mi.log.MessageHandler;
import org.crayne.mi.stdlib.MiStandardLib;
import org.jetbrains.annotations.NotNull;

import java.io.File;
import java.io.IOException;
import java.nio.file.Files;
import java.util.List;

public class Tests {

    public static void main(@NotNull final String... args) {
        final Mi mi = new Mi(System.out, true);
        final MessageHandler messageHandler = mi.messageHandler();

        final String code = """
                module testing {
                    
                    fn main {
                        std.println("hello world!");
                    }
                    
                }
                                """;

        final List<ByteCodeInstruction> program = mi.compile(MiStandardLib.standardLib(), code, "testing", "main");
        final ByteCodeInterpreter runtime = new ByteCodeInterpreter(program, messageHandler);
        runtime.prepare();

        // or, alternatively compile from and to a file, read from that file and run the binary instead
        final File inputFile = new File("path_to_input_file/file.mi");
        try {
            mi.compile(MiStandardLib.standardLib(), Files.readString(inputFile.toPath()), new File("path_to_file/file.mib"), inputFile, "testing", "main");
        } catch (final IOException e) {
            e.printStackTrace();
        }
    }


}

helloworld

module helloworld {
    
    fn main {
        std.println("Hello, world!");
    }

}

FEATURES:

• basic strongly typed programming language features
• (currently one sided) communication with java for easy scripting in any java project

TODOS:

• structs and impls similar to rust
• macros, to insert code in front of a function
• assert, typedef and their combination for fast easy types
• operator overloading as an option for already defined functions