Elixir koans is a fun, easy way to get started with the elixir programming language. It is a tour of the most important features and idiomatic usage of the language.
Elixir runs on the Erlang VM, so to get started with the koans you need to install both Erlang and Elixir. The official Elixir webpage has instructions for how to do this.
If you're on a Mac, you can skip this section.
To provide the best experience, koans are run automatically when you save a file. This is accomplished with a tool called
inotify which needs to be installed separately if you're not using OSX. Linux users will need to install
inotify-tools (guides), and Windows users need
Getting the koans
The next step is to get the source code of the koans so that you can run it. Assuming that you have git installed, it's as simple as:
$ git clone https://github.com/elixirkoans/elixir-koans $ cd elixir-koans
With the source code pulled, you'll also need to fetch the dependencies for this project:
$ mix deps.get
Running the koans
Now you're ready to run the koans! On your command line, type:
$ mix meditate
You should see that the first koan has failed in
lib/koans/01_equalities.ex. Open that file, and change the first koan to make the assertion true. After successfully passing the koan, you should see the next failure.
Keep making changes to satisfy the assertions in the code. When you've finished the first file, the runner will automatically run the next file until there are no more koans.
We'd like to thank all our contributors.
If you have any suggestions, feel free to open an issue or a pull request