PinkiePy is a FiM++ interpreter written in Python. PinkiePy follows FiM++ 1.0 (Sparkle) language specification and also adds some OOP features it lacks.
# clone the repo
$ git clone https://github.com/ReshetnikovPavel/PinkiePy
# change the working directory to PinkiePy
$ cd PinkiePy
# install the requirements
$ python3 -m pip install -r requirements.txt
python pinkiepy.py 'full or relative path to file/File Name.fim'
python pinkiepy.py -d 'full or relative path to file/File Name.fim'
For main features read FiM++ 1.0 (Sparkle) language specification, but keep in mind that it has some inconsistencies in examples.
Unlike specification it is also allowed to write code outside of classes, so you can write Hello World program like this:
I said "Hello World"!
Or like this as it was suggested in the specification:
Dear Princess Celestia: Hello World!
Today I learned how to say Hello World!
I said “Hello World”!
That’s all about how to say Hello World!
Your faithful student, Pinkie Pie.
In addition to what's written in the specification, you can declare fields using the same syntax as variable declaration.
Dear Princess Celestia: Class Name!
Did you know that field is correct?
Today I learned main method name.
I remembered method name!
That's all about main method name.
I learned method name.
I sang field!
That's all about method name.
Your faithful student, Pinkie Pie.
You can create a new instance of a class like this:
Did you know that instance name is Class Name?
So, if you write a class name in an expression, you create a new instance of it.
Also you can use this report inside a class to get an instance of this class.
Note: constructors are not implemented, but you can declare a method called, for example, creation and call it on a new instance like so:
Dear Princess Celestia: Class Name!
I learned creation.
I said "New class instance".
That's all about creation.
Your faithful student, Pinkie Pie.
I remembered Class Name`s creation.
Use `s or ` after class instance to access it's contents.
I said instance`s field!
I remembered instance`s method name!
instance`s field is now 2!
Note: this syntax was inspired by this proposal on language wiki, but I decided to use ` instead of ' to avoid collision with Applejack's hat.
The same `s, ` syntax is used to access an element of an array with a named variable:
Did you know that cake has many names?
cake 1 is “chocolate”.
cake 2 is “apple cinnamon”.
cake 3 is “fruit”.
I said cake 2.
Did you know that apple is number 2?
I said cake`s apple.
Note: `s can be used as of in FiMSharp if you swap variable names. (of is not supported in PinkiePy)
Note: arrays start at 0
You can import a class from another file with the same name. So if you have a file called Class Name.fim somewhere in the opened directory and it has a class named Class Name you can import this class like so:
Remember when I wrote about Class Name?
Warning! Custom classes are not supported in typechecking due to ambiguity in syntax.
Resources about making interpreters: