kotlin / workshop

JetBrains Kotlin Workshop Material

Kotlin Workshop

A Kotlin workshop intended to be taught in two days.

Structure

This workshop is divided into two parts

• Introduction to Kotlin
• Advanced Kotlin

It consists of

• Instructor Project: Used to explain concepts, with existing code samples
• Student Project: For students to complete
• Presentations: For the instructor to use
• Questions: For students to complete

Both the Instructor Project and the slides have Introduction and Advanced modules included. While the Introduction has a lot of pre-built examples, it also serves as a canvas to show more code while teaching. However, please make sure that if you're a contributing author to this project, that you do not check-in any ad-hoc code. It's also recommended to use Scratch files in IntelliJ IDEA for this purpose.

Presentations

Slides for the workshop lead by Hadi Hariri can be found here.

Presentations used for the workshop at KotlinConf:

1. Intro
2. Nullable Types
3. Object-Oriented Programming in Kotlin
4. Kotlin Types
5. Functional Programming in Kotlin
6. The Power of inline
7. Lambda With Receiver
8. Conventions
9. Intro to Coroutines

Questions

Questions can be found here. The keys to the questions are in the module instructor/quizzes.

Note that the similar material can be found explained in detail in the following Coursera course.

Authors

This workshop includes material from the following authors:

• Hadi Hariri
• Svetlana Isakova
• Dmitry Jemerov
• Roman Elizarov

License and Usage

The material provided in this repository, including but not limited to source code, presentations, notes and exercises is Copyright (c) 2017 JetBrains, and is provided as-is.

This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

JetBrains and Kotlin are Registered Trademarks of their respective trademark holders.

Contributions

We welcome all contributions to this workshop. If you feel you'd like to contribute something, create a fork and make a pull request. Bug fixes, comments, suggestions, all welcome.

If you're contributing code or samples, please send a pull request. If you'd like to update the slides or questions, please contact Hadi Hariri.

Usage and endorsements

You are welcome to use the material in this workshop provided you abide by the corresponding license agreement. Additionally

• By using this material, with or without any modification, JetBrains does not endorse any workshop or training that you may offer.
• By using this material, with or without any modification, you may not use JetBrain's name to promote your workshop or training without prior written consent.
• By using this material, provided there are no modifications, you may indicate that you are using JetBrains Kotlin Workshop Material.

If you're interested in becoming an official JetBrains Training Partner, please contact us

workshop's Issues

Compiler version incompatibility

Steps to reproduce

1. clone the project: git clone [email protected]:JetBrains/kotlin-workshop.git
2. cd into the source directory: cd kotlin-workshop/student/single
3. run gradle build: ./gradlew assemble

Error message

:compileKotlin
e: java.lang.IllegalStateException: The provided plugin org.jetbrains.kotlin.scripting.compiler.plugin.ScriptingCompilerConfigurationComponentRegistrar is not compatible with this version of compiler
        at org.jetbrains.kotlin.cli.jvm.compiler.KotlinCoreEnvironment.<init>(KotlinCoreEnvironment.kt:188)
        at org.jetbrains.kotlin.cli.jvm.compiler.KotlinCoreEnvironment.<init>(KotlinCoreEnvironment.kt:120)
        at org.jetbrains.kotlin.cli.jvm.compiler.KotlinCoreEnvironment$Companion.createForProduction(KotlinCoreEnvironment.kt:433)
        at org.jetbrains.kotlin.cli.jvm.K2JVMCompiler.createCoreEnvironment(K2JVMCompiler.kt:295)
        at org.jetbrains.kotlin.cli.jvm.K2JVMCompiler.doExecute(K2JVMCompiler.kt:147)
        at org.jetbrains.kotlin.cli.jvm.K2JVMCompiler.doExecute(K2JVMCompiler.kt:51)
        at org.jetbrains.kotlin.cli.common.CLICompiler.execImpl(CLICompiler.java:95)
        at org.jetbrains.kotlin.cli.common.CLICompiler.execImpl(CLICompiler.java:50)
        at org.jetbrains.kotlin.cli.common.CLITool.exec(CLITool.kt:88)
        at org.jetbrains.kotlin.incremental.IncrementalJvmCompilerRunner.runCompiler(IncrementalJvmCompilerRunner.kt:454)
        at org.jetbrains.kotlin.incremental.IncrementalJvmCompilerRunner.runCompiler(IncrementalJvmCompilerRunner.kt:101)
        at org.jetbrains.kotlin.incremental.IncrementalCompilerRunner.compileIncrementally(IncrementalCompilerRunner.kt:224)
        at org.jetbrains.kotlin.incremental.IncrementalCompilerRunner.access$compileIncrementally(IncrementalCompilerRunner.kt:36)
        at org.jetbrains.kotlin.incremental.IncrementalCompilerRunner$compile$2.invoke(IncrementalCompilerRunner.kt:86)
        at org.jetbrains.kotlin.incremental.IncrementalCompilerRunner.compile(IncrementalCompilerRunner.kt:98)
        at org.jetbrains.kotlin.daemon.CompileServiceImpl.execIncrementalCompiler(CompileServiceImpl.kt:545)
        at org.jetbrains.kotlin.daemon.CompileServiceImpl.access$execIncrementalCompiler(CompileServiceImpl.kt:98)
        at org.jetbrains.kotlin.daemon.CompileServiceImpl$compile$$inlined$ifAlive$lambda$2.invoke(CompileServiceImpl.kt:418)
        at org.jetbrains.kotlin.daemon.CompileServiceImpl$compile$$inlined$ifAlive$lambda$2.invoke(CompileServiceImpl.kt:98)
        at org.jetbrains.kotlin.daemon.CompileServiceImpl$doCompile$$inlined$ifAlive$lambda$2.invoke(CompileServiceImpl.kt:927)
        at org.jetbrains.kotlin.daemon.CompileServiceImpl$doCompile$$inlined$ifAlive$lambda$2.invoke(CompileServiceImpl.kt:98)
        at org.jetbrains.kotlin.daemon.common.DummyProfiler.withMeasure(PerfUtils.kt:137)
        at org.jetbrains.kotlin.daemon.CompileServiceImpl.checkedCompile(CompileServiceImpl.kt:957)
        at org.jetbrains.kotlin.daemon.CompileServiceImpl.doCompile(CompileServiceImpl.kt:926)
        at org.jetbrains.kotlin.daemon.CompileServiceImpl.compile(CompileServiceImpl.kt:417)
        at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
        at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
        at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
        at java.lang.reflect.Method.invoke(Method.java:498)
        at sun.rmi.server.UnicastServerRef.dispatch(UnicastServerRef.java:357)
        at sun.rmi.transport.Transport$1.run(Transport.java:200)
        at sun.rmi.transport.Transport$1.run(Transport.java:197)
        at java.security.AccessController.doPrivileged(Native Method)
        at sun.rmi.transport.Transport.serviceCall(Transport.java:196)
        at sun.rmi.transport.tcp.TCPTransport.handleMessages(TCPTransport.java:573)
        at sun.rmi.transport.tcp.TCPTransport$ConnectionHandler.run0(TCPTransport.java:835)
        at sun.rmi.transport.tcp.TCPTransport$ConnectionHandler.lambda$run$0(TCPTransport.java:688)
        at java.security.AccessController.doPrivileged(Native Method)
        at sun.rmi.transport.tcp.TCPTransport$ConnectionHandler.run(TCPTransport.java:687)
        at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149)
        at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624)
        at java.lang.Thread.run(Thread.java:748)
Caused by: java.lang.AbstractMethodError: org.jetbrains.kotlin.scripting.compiler.plugin.ScriptingCompilerConfigurationComponentRegistrar.registerProjectComponents(Lorg/jetbrains/kotlin/com/intellij/mock/MockProject;Lorg/jetbrains/kotlin/config/CompilerConfiguration;)V
        at org.jetbrains.kotlin.cli.jvm.compiler.KotlinCoreEnvironment.<init>(KotlinCoreEnvironment.kt:186)
        ... 41 more

:compileKotlin FAILED

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':compileKotlin'.
> Internal compiler error. See log for more details

* Try:
Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output.

BUILD FAILED

Total time: 1.442 secs

Java Version

Java 8.0.172-zulu on macOS High Sierra 10.13.5

Are the presentations included somewhere?

I see on the README, that there is a mention that there would be presentation materials. I would love to see them, as I am considering running a community workshop.

No big deal if that content doesn't exist (but you should remove the reference to it).

Presentations: For the instructor to use

Lead by example

Please forgive the provocative and overly broad title. ;)

Opening the very first examples in IDEA, we immediately get suggestions. For instance:

And you see the grey wrigglies indicating that IDEA thinks we should use isNotEmpty().

If this is not a conscious decision, maybe the examples should exhibit best practice as far as possible?

In slide 10 compiler word split to 2 lines

How do you recommend structuring the workshop material if it gets translated to other languages?

We've decided to translate the workshop material to Hungarian language. I have some questions regarding this:

• Do you have any recommendations how a translation should be done?
• If yes can you tell us how should we structure the files in the repository so we can contribute our translation to the original repository?

What is y on the timeline slide?

Could be users, projects, lines of code. See https://docs.google.com/presentation/d/1zYWyDedyf0YhnLFF3TVpUqU3C8PKTuvR5P06L99MRn8/edit#slide=id.p10

"Operator Conventions" slide issues

The "Operator Conventions" slide in the instructor use presentation (slide 15) doesn't fit on the screen, and it uses mod and modAssign instead of rem and remAssign