Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Lua Koans, minus the Zen stuff

branch: master


latest commit 330d770241
Enrique García authored
Octocat-spinner-32 missions regen January 26, 2014
Octocat-spinner-32 src both typos January 25, 2014
Octocat-spinner-32 README.rdoc Updated Lua version compatibility information. April 08, 2013
Octocat-spinner-32 Rakefile added ansicolors June 06, 2011

Lua Missions

The Lua Missions help you learn Lua. The goal is to learn the Lua language, syntax, structure, and some common functions and libraries, through failing tests.

The Structure

The lessons are broken out into areas by file, strings are covered in strings.lua, nil is covered in nil.lua, etc. They are presented in order in the missions.lua file.

Each mission builds up your knowledge of Lua and builds upon itself. It will stop at the first place you need to correct.

Some missions simply need to have the correct answer substituted for an incorrect one. Some, however, require you to supply your own answer. If you see the variable __ (a double underscore) listed, it is a hint to you to supply your own code in order to make it work correctly.

Installing Lua

If you do not have Lua setup, please visit for operating specific instructions. To check the installations simply type:

*nix platforms from any terminal window:

[~] $ lua -v

Windows from the command prompt (cmd.exe)

c:\lua -v

The output should include the version of Lua that is in your path. Versions 5.0.x and 5.1.x should be fine. Version 5.2.x is not currently supported.

The Missions

In order to run the tests, you must execute the missions.lua file.

*nix platforms, from the lua_missions/missions directory:

[lua_missions] $ cd missions
[lua_missions/missions] $ lua missions.lua

Windows is the same thing

c:\> cd lua_missions\missions
c:\lua_missions\missions\> lua missions.lua

Red, Green, Refactor

In test-driven development the process has always been, red, green, refactor. Write a failing test and run it (red), make the test pass (green), then refactor it (that is look at the code and see if you can make it any better. In this case you will need to run the mission and see it fail (red), make the test pass (green), then take a moment and reflect upon the test and improve the code to better communicate its intent (refactor).

The very first time you run it you will see the following output:

[lua_missions] $ cd missions
[lua_missions/missions] $ lua missions.lua
(in /Users/person/dev/lua_missions)


*** Mission status ***

test_assert: [fail]
Assertion failed: Expected [false] to be [true]
The error happened here:
  asserts.lua:3: in function <asserts.lua:2>

It is telling you where to look for the first solution:

Assertion failed: Expected [false] to be [true]
The error happened here:
  asserts.lua:3: in function <asserts.lua:2>

We then open up the asserts.lua file and look at the first test:

function test_assert()
  assert_true(false) -- this should be true

We then change the false to true and run the test again. Ignore everything except the method name (test_assert) and the parts inside the method (everything before the end).

In this case the goal is for you to see that if you pass a value to the assert method, it will either ensure it is true and continue on, or fail if in fact the statement is false.


This is heavily inspired by the Ruby Koans project:

Go there and check it out, in case you are curious about ruby. Ruby is a great language and the Ruby Koans are a great way to learn it.

Other Resources

The Lua Language

Programming in lua

Lua-users wiki

Other stuff


Enrique García <kikito - at - gmail - dot - com>

Source & Issues


Lua 5.1 (optional: Rake for building up the files from source)


lua_missions is released under a Creative Commons, Attribution-NonCommercial-ShareAlike, Version 3.0 ( License.

Something went wrong with that request. Please try again.