Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A framework and corresponding koans to learn the core Java language, best practices, and TDD
branch: master

This branch is 159 commits behind matyb:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


Running Instructions:
1. Download and unarchive the contents of the most recent java-koans in development from:
2. Open a terminal and cd to the 'koans' directory from within the archive (koans-lib is the source directory for the koans engine, and koans-tests is the source directory for unit tests against the koans engine - both are unnecessary for advancing through the koans)
3. Run run.bat or (whichever is applicable for your OS)

Developing a Koan:
1. Follow any of the existing koans as an example to create a new class w/ koan methods (indicated by the @Koan annotation)
2. Define the order and metadata associated with each koan in the PathToEnlightment.xml
3. If necessary - use dynamic content in your lesson, examples are located in XmlVariableInjector class (and Test) and the file
Something went wrong with that request. Please try again.