FiMSharp 0.3.3

🐎 FiMSharp

FiMSharp is a FiM++ interpreter library written in C#.

🖥 Usage

To use the library, simply include the library to your project:

using FiMSharp;

And create a FiMReport with the lines of your report!

FiMReport report = new FiMReport( lines );

// Run the main paragraph!
if( report.MainParagraph != null ) report.MainParagraph.Execute();

You can also build and use FiMSharp.Test.

🔃 Compiling

You'll need .NET SDK to compile the solution from source.

Most of the work can be done by the included makefile.

Included runtimes are:

• win32 - Windows x86-64
• win - Windows x64
• linux - Linux-x64
• linuxarm - Linux ARM
• darwin - OSX-64

You can use this command to build the Win32 executable of FiMSharp.Test

make win32

🏃‍♀️ Running (FiMSharp.Test)

The releases page should include a bin.zip which contains:

• A pre-built .dll for both FiMSharp and FiMSharp.Javascript
• Pre-built executables for different platforms listed in the release.

🐳 Running from Docker

FiMSharp is also available on Docker as Docker container. While it makes it easy to setup FiMSharp at many machine, it comes with a large filesize.

docker pull jaezmien/fimsharp:0.3.3

Example usage:

docker run jaezmien/fimsharp:0.3.3 Reports/hello.fim

For reports which require user inputs, you'll need to add the -i flag.

docker run -i jaezmien/fimsharp:0.3.3 Reports/input.fim

📚 External Resources

Esolangs Page

FiM++ Fandom

Language Specification

Original EQD Post

Online Interpreter using Blazor

Docker Container

📝 Notes

• FiMSharp is just a personal hobby project, seeing as FiM++ has never been updated for quite some time now.

• The syntax used here follows the proposed Sparkle 1.0 syntax, unlike what fimpp uses. You can see the difference in readability in the Brainfuck Interpreter example:

  • FiMSharp

  • fimpp

• This is my first semi-compilcated README.md, please yell at me on the issues page if I did something wrong 🙏