This project is obsolete.
the course in the EduTools plugin or online version.
For the last version of Koans, checkhttps://github.com/Kotlin/kotlin-koans-edu.
The task content can be found atKotlin Koans
Kotlin Koans Workshop is a series of exercises to get you familiar with the Kotlin Syntax. Each exercise is created as a failing unit test and your job is to make it pass.
How to build and run tests
Working with the project using Intellij IDEA:
- Import the project as Gradle project.
- To build the project and run the tests use
test
task on the Gradle tool window (View | Tool Windows | Gradle
).
Here https://www.jetbrains.com/help/idea/gradle.html#gradle_tasks you can read how to run Gradle task from the Gradle toolbar in IntelliJ IDEA.
Note that this project isn't intended to be used in Android Studio. If you want to solve koans in Android Studio, check the course in Android Studio with EduTools plugin installed https://github.com/kotlin/kotlin-koans#other-ways-to-solve-koans.
Working with the commandline
You can also build the project and run all tests in the terminal:
./gradlew test
But since running all the tests tend to take longer and the output can be cluttered, it's more ideal to run selected tests only:
$ ./gradlew test --tests i_* # run tests in part 1
$ ./gradlew test --tests ii_* # run tests in part 2
$ ./gradlew test --tests ii_*22* # run test number 22 in part 2
How to check yourself
The repository has two branches, master
which contains the exercises for you to do and resolutions
which contains the resolved exercises. Make sure you don’t cheat!
How the tasks are organized
You have 42 tasks to do. Each task lives in its own function: from task0
to task41
. For each task, there is an associated unit test that checks your solution.
You may navigate to the corresponding test automatically when you read the task. Open the source file with the task and use the action Navigate -> Test
to open the test file. You may also use Navigate -> Test Subject
for reversed navigation.
Individual tasks generally require you to change the function taskX
by completely replacing the body of the function. Your goal is to solve the problem and allow the associated unit test to pass. If you run the unit test for a task that is not correct, the unit test results will be displayed. If you have not yet made any changes to a task, the exception will be thrown and the task's TODO message will be displayed.
In the first example, this means replacing the code
fun task0(): String {
return todoTask0()
}
with the correct, meaningful code in order to solve the problem and allow the associated unit test to pass, such as:
fun task0() = "OK"
The resolutions
branch contains all the solutions. It's a good idea to check the proposed solution after completing each task. Open the file with your solution, call the Compare with branch...
action and choose the resolutions
branch.
You can find here how to call an action.
Other ways to solve Koans
You can solve the similar tasks using Educational Plugin or in the browser:
- EduTools Plugin https://www.jetbrains.com/help/education/learner-start-guide.html?section=Kotlin%20Koans
- online version of koans https://try.kotl.in
The koans tasks for web-demo and educational plugin can be found here: https://github.com/Kotlin/kotlin-koans-edu