Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Kotlin/kotlin-koans
Kotlin workshop
https://github.com/Kotlin/kotlin-koans
Last synced: about 2 months ago
JSON representation
Kotlin workshop
- Host: GitHub
- URL: https://github.com/Kotlin/kotlin-koans
- Owner: Kotlin
- License: mit
- Archived: true
- Created: 2014-03-20T14:41:33.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2019-07-15T09:15:04.000Z (over 5 years ago)
- Last Synced: 2024-05-09T16:49:35.026Z (7 months ago)
- Language: Kotlin
- Size: 6.38 MB
- Stars: 2,603
- Watchers: 134
- Forks: 1,419
- Open Issues: 37
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-kotlin-android - Kotlin Koans
- awesome-hacking-lists - Kotlin/kotlin-koans - Kotlin workshop (Kotlin)
- awesome-kotlin - kotlin-koans - Kotlin workshop (Libraries)
- trackawesomelist - Kotlin/kotlin-koans (⭐2.6k) - Kotlin Koans are a series of exercises to get you familiar with the Kotlin Syntax. (Recently Updated / [Oct 28, 2024](/content/2024/10/28/README.md))
README
[](https://confluence.jetbrains.com/display/ALL/JetBrains+on+GitHub)
### This project is obsolete.
### For the last version of Koans, check [the course](https://www.jetbrains.com/help/education/learner-start-guide.html?section=Kotlin%20Koans) in [the EduTools plugin](https://www.jetbrains.com/help/education/install-edutools-plugin.html?section=IntelliJ%20IDEA) or [online version](https://play.kotlinlang.org/koans/overview).
### The task content can be found at https://github.com/Kotlin/kotlin-koans-edu.
Kotlin 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:
1. Import the project as Gradle project.
2. 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
```kotlin
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:
```kotlin
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](https://www.jetbrains.com/help/idea/navigating-to-action.html) 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