FiM++

'''FiM++''' (AKA '''Friendship Reports''') is a programming language inspired by [http://mlp.wikia.com/wiki/Friendship_reports Friendship Reports], [[Wikipedia:Java (programming language)|Java]], [[Wikipedia:Shakespeare (programming language)|Shakespeare]], and [[Wikipedia:Inform 7|Inform 7]], whose syntax is not dissimilar to that of [[Wikipedia:ALGOL|ALGOL]]. The main goal of FiM++ is to be readable by humans, to the point that a well-written FiM++ program could be mistaken for being a mere letter.

== Structure ==
The general structure of a FiM++ program is [[class]]-based. That is, code is organized in individual files, called reports. Within each file, there are [[imports]] that help reference other reports, the report itself, [[methods]] (called paragraphs), [[literals]], [[variables]], and [[constants]].

== History ==
* '''Feb 23, 2011''': The first ideas of a programming language pop up in [http://code.google.com/p/pony-lang/ a Google Code repository]. This project is abandoned June 12 of that same year.
* '''Oct 4, 2012''': Cereal Velocity makes [http://www.equestriadaily.com/2012/10/editorial-fim-pony-programming-language.html a post about FiM++ on Equestria Daily].
* '''Oct 4, 2012''': DeftCrow on deviantART creates the first real program in FiM++, [http://fav.me/d5gwtse 99 Jugs of Cider and Hello World]. This works out some inconsistencies and sets the stage for a fully-fledged language.
* '''Oct 5, 2012''': An admin on Equestria Forever named Twilight Sparkle makes [http://www.equestriaforever.com/showthread.php/1854-FiM-Programming-Language a forum post] about the aforementioned posts, also detailing some more propositional features of the language.
* '''Oct 11, 2012''': Supuhstar (AKA Kyli Rouge) asks permission from DeftCrow and Cereal Velocity to make a [https://docs.google.com/document/d/1gU-ZROmZu0Xitw_pfC1ktCDvJH5rM85TxxQf5pg_xmg/edit?pli=1# formal document] fully specifying the language.
* '''Oct 15, 2012''': Cereal Velocity posts [http://www.equestriadaily.com/2012/10/fim-update.html a follow-up post on EqD]
* '''Oct 18, 2012''': This wiki is created when the document becomes too daunting to scroll through.

=== Versions ===
Currently, there is only one official version, which is '''1.0''', codename &ldquo;'''''Sparkle'''''&rdquo;. That is the version that this wiki details.

This wiki details version 1.0, ''Sparkle''. Other versions exist (linked [[#History|above]]), but they have no number or name.

== Example Programs ==
A program that simply uses one paragraph to print "Hello World" and exits:
{{codeblock|{{code|keyword|Dear}}{{code|whitespace|&nbsp;}}{{code|report|Princess Celestia}}{{code|punctuation|:}}{{code|report|Hello World}}{{code|punctuation|!}}{{code|whitespace|<BR/><BR/>}}{{code|keyword|<STRONG>Today</STRONG> I learned}}{{code|whitespace|&nbsp;}}{{code|paragraph|how to say hello world}}{{code|punctuation|!}}{{code|whitespace|<BR/>}}{{code|keyword|I said}}{{code|whitespace|&nbsp;}}{{code|literal|&ldquo;Hello, World!&rdquo;}}{{code|punctuation|!}}{{code|whitespace|<BR/>}}{{code|keyword|That's all about}}{{code|whitespace|&nbsp;}}{{code|paragraph|how to say hello world}}{{code|punctuation|.}}{{code|whitespace|<BR/><BR/>}}{{code|keyword|Your faithful student}}{{code|punctuation|,}}{{code|comment| Kyli Rouge}}{{code|punctuation|.}}}}

A program that uses two paragraphs, a [[mane paragraph]] and a utility paragraph, to add all the numbers from 1 to 100:
{{codeblock|{{code|keyword|Dear}}{{code|whitespace|&nbsp;}}{{code|report|Princess Celestia}}{{code|punctuation|:}}{{code|whitespace|&nbsp;}}{{code|report|I can add}}{{code|punctuation|!}}{{code|whitespace|<BR/><BR/>}}{{code|keyword|<STRONG>Today</STRONG> I learned}}{{code|whitespace|&nbsp;}}{{code|paragraph|how to add a lot}}{{code|punctuation|.}}{{code|whitespace|<BR/>}}{{code|keyword|Did you know that}}{{code|whitespace|&nbsp;}}{{code|type|the number}}{{code|whitespace|&nbsp;}}{{code|variable|the answer}}{{code|whitespace|&nbsp;}}{{code|keyword|was}}{{code|whitespace|&nbsp;}}{{code|paragraph|how to add}}{{code|whitespace|&nbsp;}}{{code|keyword|using}}{{code|whitespace|&nbsp;}}{{code|literal|1}}{{code|whitespace|&nbsp;}}{{code|keyword|and}}{{code|whitespace|&nbsp;}}{{code|literal|100}}{{code|punctuation|?}}{{code|whitespace|<BR/>}}{{code|keyword|I said}}{{code|whitespace|&nbsp;}}{{code|variable|the answer}}{{code|punctuation|!}}{{code|whitespace|<BR/>}}{{code|keyword|That's all about}}{{code|whitespace|&nbsp;}}{{code|paragraph|how to add a lot}}{{code|punctuation|.}}{{code|whitespace|<BR/><BR/>}}{{code|keyword|I learned}}{{code|whitespace|&nbsp;}}{{code|paragraph|how to add}}{{code|whitespace|&nbsp;}}{{code|keyword|to get}}{{code|whitespace|&nbsp;}}{{code|type|a number}}{{code|whitespace|&nbsp;}}{{code|keyword|using}}{{code|whitespace|&nbsp;}}{{code|type|the number}}{{code|whitespace|&nbsp;}}{{code|variable|first}}{{code|whitespace|&nbsp;}}{{code|keyword|and}}{{code|whitespace|&nbsp;}}{{code|type|the number}}{{code|whitespace|&nbsp;}}{{code|variable|last}}{{code|punctuation|.}}{{code|whitespace|<BR/>}}{{code|keyword|Did you know that}}{{code|whitespace|&nbsp;}}{{code|type|the number}}{{code|whitespace|&nbsp;}}{{code|variable|sum}}{{code|whitespace|&nbsp;}}{{code|keyword|was}}{{code|whitespace|&nbsp;}}{{code|literal|0}}{{code|punctuation|?}}{{code|whitespace|<BR/>}}{{code|keyword|As long as}}{{code|whitespace|&nbsp;}}{{code|variable|first}}{{code|whitespace|&nbsp;}}{{code|operator|was no more than}}{{code|whitespace|&nbsp;}}{{code|variable|last}}{{code|punctuation|,}}{{code|whitespace|<BR/>}}{{code|variable|sum}}{{code|whitespace|&nbsp;}}{{code|keyword|became}}{{code|whitespace|&nbsp;}}{{code|variable|sum}}{{code|whitespace|&nbsp;}}{{code|operator|plus}}{{code|whitespace|&nbsp;}}{{code|variable|first}}{{code|punctuation|.}}{{code|punctuation|.}}{{code|punctuation|.}}{{code|whitespace|<BR/>}}{{code|variable|first}}{{code|whitespace|&nbsp;}}{{code|operator|got one more}}{{code|punctuation|.}}{{code|whitespace|<BR/>}}{{code|keyword|That's what I did}}{{code|punctuation|!}}{{code|whitespace|<BR/>}}{{code|keyword|Then you get}}{{code|whitespace|&nbsp;}}{{code|variable|sum}}{{code|punctuation|!}}{{code|whitespace|<BR/>}}{{code|keyword|That's all about}}{{code|whitespace|&nbsp;}}{{code|paragraph|how to add}}{{code|punctuation|!}}{{code|whitespace|<BR/><BR/>}}{{code|keyword|Your faithful student}}{{code|punctuation|,}}{{code|comment| Kyli Rouge}}{{code|punctuation|.}}}}

=== Mirror in Java ===
FiM++ can be translated into [[Wikipedia:Java (programming language)|Java]] relatively easily. Here's the above Hello World example in Java:
{{codeblock|<source lang="java">
public class HelloWorld extends Object {
    public static void main(String[] args) {
        System.out.println("Hello, World!");
    }
}
</source>}}

And here's the above addition program:
{{codeblock|<source lang="java">
public class ICanAdd extends Object {
    
    public static void main(String[] args) {
        double theAnswer = howToAdd(1, 100);
        System.out.println(theAnswer);
    }
    
    public static double howToAdd(double first, double last) {
        double sum = 0;
        while (first <= last) {
            sum = sum + first;;;
            first++;
        }
        return sum;
    }
}
</source>}}

== See Also ==
* [[Program:Jugs of Cider]]