Skip to content

Koans for the Rust programming language

License

Notifications You must be signed in to change notification settings

bjarlestam/rust-koans

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

71 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Rust Koans

The Structure

The koans are broken out into areas by file, arrays are covered in arrays.rs, booleans are introduced in boolean.rs, etc. They are presented in order in the path_to_enlightenment.rs file.

Each koan builds up your knowledge of Rust and builds upon itself. By following the failures and errors presented, you will know what to work on next. As you finish one koan file, the next will be added to path_to_enlightenment.rs.

Some koans 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 __ (a double underscore) listed, it is a hint to you to supply your own code in order to make it work correctly.

Installing Rust

If you do not have Rust setup, please visit rust-lang.org for operating specific instructions. In order to run the koans you need Rust installed. To check your installations simply type:

*nix platforms from any terminal window:

$ rustc --version

Currently, a Rust version of 1.3.0 or higher is recommended.

The Path to Englightenment

In order to run the koans, Clone this repository, and from the root folder simply run:

$ cargo run

This will generate the path_to_enlightenment.rs file and populate it with the first test in the list. After supplying an answer for the first test case, entering cargo run again will continue you on your path.

Red, Green, Refactor

Red, Green, Refactor

In test-driven development the mantra has always been red, green, refactor. Write a failing test and run it (red), make the test pass (green), then look at the code and consider if you can make it any better (refactor).

While walking the path to Rust enlightenment you will need to run the koan and see it fail (red), make the test pass (green), then take a moment and reflect upon the test to see what it is teaching you and improve the code to better communicate its intent (refactor).

Other Resources

The Rust Language https://www.rust-lang.org/
Rust Playground https://play.rust-lang.org/
The Book (Rust docs) https://doc.rust-lang.org/book/

About

Koans for the Rust programming language

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Rust 100.0%