• Scala – the code is 100% scala
• Scala Parser Combinators – the “parser generation DSL” one might say, begind this parser. It’s very very amazing and pushing Scala to it’s best with some crazy implicit conversions flying around all the time :-)
• Scarg – a simple tool for handling command line parameters, it’s on github
• sbt – Simple Build Tool, let’s call it “what maven is for java” but with a Gradle-ish feel to it. A very nice build tool, actually my fav I’d say.
• Scalate – a template engine, which implements Mustache (which I used, as it’s a very clean lang, NO LOGIC in the view :-)) as one of it’s template languages
• and of course ScalaTest – as ‘thou shalt test thy code‘ :-)

It was a very pleasant expirience and I’m looking forward to implementing a 100% compatible Protocol Buffers parser in Scala… :-)

There is also a pdf I’ve written about this project but it’s not well written and in Polish (university requirements, bleh), but if you want to know more about Scala Parser Combinators, you can take a look at it here: doc @ github.com.

The project itself is of course Free Software and Open Source, licensed under the Apache 2 license, so feel free to fork protodoc-scala on github!

I’ll just quote the README from the github page for the rest of the description:

Oh, wait. That’s excatly what ProtoDoc is! ProtoDoc is a tool very much like JavaDoc, which scans your proto files and generates
an easily searchable and most informative website with all information about yout ProtoMessages.

It’s currently not production ready, and allows only for basic Messages to be parsed. But it should most probably be finished and fully working quite soon.

Live Demo
There is a live demo available here.

Coding notes

• ProtoDoc is build by sbt so if you want to help out hacking, first download Scala 2.8.1 and sbt :-)

Output screenshots
ProtoDoc takes this:

package pl.project13;

/**
 * This is a simple Message which has some Inner Message defined.
 * Also, note that it has a default value on the name property.
 */
message MessageWithInner {
    /**
     * A number is just a simple property
     */
    required int32 number = 1;

    /**
     * This can be a name of your likeing, the default value is "lorem ipsum" etc
     */
    required string name = 2 [default = "loremipsum"];

    /**
     * Whoa, this is a comment on an inner message!
     * ProtoDoc is so cool!
     */
    message InnerMessage {

        /**
         * This is a comment on an inner messages field, cool~
         * You may use it like this in your generated Java code:
         * setName("StringMyName");
         */
        optional string name = 3;
    }
}

and generates this:

Hooray!

Hi there, below is the (horribly trashy and chaotic – as it was hacked up in about 2/3 hours) source for my Google Gmail Contextual Gadget.

It extends Gmail by parsing all links passed in an email, and if an github commit link is found it displays the diff for this commit. With coloring etc – just as github would. It’s really fairly easy to get this kind of things going, and if your working with Google Apps (using gmail in your domain etc) you can use this, and many more gadgets (though I didn’t find much of them really useful – that’s why I’ve written this one).

The source can be downloaded, and fixed (which I hopefuly will have time to do! As it’s a mess, let’s say, “proof of concept”): http://github.com/ktoso/GitHubDiff (It’s on the MIT license).

Read the full story to see instalation instructions as well as documentation links…

HOW TO INSTALL:
It can be installed by your own into gmail, if you’re running on Google Apps -just by creating an new Application on the Market and then adding it to your Account. If you’d like me to polish and publish this to the Google Enterprise Market – you’d have to fund me the publish fee, 100$… ;-)

DOCUMENTATION:
Contextual Gadgets: http://code.google.com/apis/gmail/gadgets/contextual/

jQuery – getJSON: http://api.jquery.com/jQuery.getJSON/
GitHub API – http://develop.github.com/p/commits.html

LICENSE:
The source is MIT licensed, feel free to use it as a base for your own projects etc. It’s nothing particularly well written etc ;-)

Enjoy github in your gmail – two amazing webapps in one… :-)

I’m coding this project to get used to some of the basic JEE stuff, such as Hibernate for example (it is quite amazing and very elegant – especially HQL), and to have a good time while coding in Java…

The source is avaiable under the AGPLv3 on github: http://github.com/ktoso/gwt-crossword
At some places it is still a mess so please keep in mind that it’s still under initial development (and I’m having a tough time at the uni and can’t code gwt-crossword everyday :\), that aside, feel free to take a look on the source!