https://github.com/yashaka/nim_koans

Practical way to Learn Nim language
https://github.com/yashaka/nim_koans

Last synced: about 1 month ago
JSON representation

Practical way to Learn Nim language

• Host: GitHub
• URL: https://github.com/yashaka/nim_koans
• Owner: yashaka
• Created: 2015-11-14T22:38:56.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2015-11-15T15:13:10.000Z (about 9 years ago)
• Last Synced: 2024-10-12T18:32:04.561Z (2 months ago)
• Language: Nimrod
• Homepage:
• Size: 0 Bytes
• Stars: 11
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

README

        
# This is a nim versions of [Koans](http://www.lauradhamilton.com/learn-a-new-programming-language-today-with-koans) - practical way to learn new language

Koans are tests that fails unless you fix them.

These tests cover main features of a programming language.

Via fixing tests you learn the language.

Usually the fix is around replacement of some "replace variables". The process (being pretty simple itself) needs an understanding of how language features works.

Go ahead and run nim koans, find the next "failing" one, go to the code, understand it and replace the "wrong parts" with a proper fix  ;) On the way to "ALL PASSED" you will achieve enlightenment ;)

This version of koans is inspired by original [ruby koans](https://github.com/neo/ruby_koans), their [python version](https://github.com/gregmalcolm/python_koans), and [learnxinyminutes nim tutorial](http://learnxinyminutes.com/docs/nim/)

## Howto

* clone it

* `$ cd nim_koans`

* `$ nim c -r path_to_enlightenment.nim`

* Read output, find the part like:

```text

Traceback (most recent call last)

about_asserts.nim(5)

```

* open indicated file (in this case - `about_asserts.nim`), find the indicated line (in this case - `5`)

* meditate on problem & fix it

* rerun `$ nim c -r path_to_enlightenment.nim`

* and so on... untill you make all koans PASSED.

## What next?

Once you are familiar with basic nim syntax, it is recommended to improve your skills at real coding tasks (not just 'fixing tests').

The most close to koans in context of "working in real local code environment" style is [exercism.io](http://exercism.io) project. Install it and execute `exercism fetch nimrod` to get available nim problems to be solved.

## Configuration

In case you want to see the full list of failed koans, change:

```nim

unittest.abortOnError = true

```

to

```nim

unittest.abortOnError = false

```

in `path_to_enlightenment.nim`

## Status

Nim koans development is "in progress" and still needs more koans to be added to cover main nim features.