Skip to content
a whimsical compiler framework
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
.travis.yml configure build using maven Mar 25, 2017
logo.png update logo Jun 30, 2017

The Whimsy Compiler Framework

build jitpack

Whimsy is a research project that aims to make writing compilers, transpilers and source analysis tools easier by supplying easy to use facilities embedded in a general programming language.

Whimsy currently comprises two parts:

  • Autumn: a parsing library.
  • Uranium: a middle-end compiler library.
    Uranium annotates ASTs and computes over them, using a reactive architecture.

It also comes with a few examples:


Autumn is a Kotlin parser combinator library written in with an unmatched feature set:

  • Bundles pre-defined parsers and combinators for most common use cases
  • Write your own parsers with regular Kotlin/Java code
  • Scannerless, but with tokenization support
  • Associativity & precedence support for operators
  • Left-recursion support
  • Context-sensitive parsing !!
  • Pluggable error-reporting mechanism
  • Reasonably fast (3x slower than ANTLR)
  • Thoroughly documented
  • Small & clean codebase



Uranium is currently a work in progress.


In all cases, you will still need Kotlin installed, either as part of IntelliJ IDEA or on the command line.

Using Maven

In your pom.xml, add the following inside <project><repositories>:


and the following inside <project><dependencies>:


Using Gradle

In your build.gradle, add the following inside allprojects { repositories {:

maven { url '' }

and the following inside dependencies {:

compile 'com.github.norswap:whimsy:-SNAPSHOT'

Other Build Systems



Download the latest release kotlin-fatjar and add it on your project's classpath.

The release bundles Whimsy's only dependency: the Apache BCEL library, but renames its packages to avoid any possibility of conflict.

The fatjar also includes test fixtures to help you build your own tests. Those depend on the TestNG library (built with version 6.11 but should be more broadly compatible), which is not bundled in.

From Sources

See the Developer Guide.

You can’t perform that action at this time.