Kodein

> [!IMPORTANT]
> ## Kodein DI is now in maintenance mode
>
> **Kodein DI will no longer receive new features.** We will keep maintaining the current version and fix issues when necessary, but nothing more.
>
> ### What we are focusing on: Inara
>
> Our focus is now on [**Inara**](https://github.com/kosi-libs/Inara), a Kotlin Symbol Processor that brings compile-time dependency injection to Kotlin Multiplatform, with no runtime overhead.
>
> - 📖 [Inara documentation](https://kosi-libs.org/inara)
> - ✍️ [Read the announcement: Inara: Inject your dependencies at compile time](https://kodein-koders.com/en/blog/inara-inject-your-dependencies-at-compile-time/)
>
> ### Moving to Koin
>
> If you like how Kodein works, we warmly encourage you to migrate to [Koin](https://insert-koin.io). It supports everything Kodein does, and much more. See [Introducing the Koin migration skills](https://blog.insert-koin.io/introducing-the-koin-migration-skills-0b4be9c819cc) to get started.
> 

[![Maven Central](https://img.shields.io/maven-central/v/org.kodein.di/kodein-di)](https://mvnrepository.com/artifact/org.kodein.di/kodein-di)
[![Kotlin](https://img.shields.io/badge/Kotlin-1.9.21-blue.svg?style=flat&logo=kotlin)](https://kotlinlang.org)
![Github Actions](https://github.com/kosi-libs/Kodein/actions/workflows/snapshot.yml/badge.svg)
[![MIT License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/kosi-libs/Kodein/blob/master/LICENSE.txt)
[![Slack channel](https://img.shields.io/badge/Chat-Slack-green.svg?style=flat&logo=slack)](https://kotlinlang.slack.com/messages/kodein/)

KOtlin DEpendency INjection
===========================

**_KODEIN_** is a straightforward and yet very useful dependency retrieval container. it is effortless to use and configure.

**_KODEIN_** works on all Kotlin Multiplatform targets:

- JVM / Android.
- all Native platforms (iOS, macOS, Linux, Windows, WebAssembly).
- Javascript / WasmJs.

**_KODEIN_** allows you to:

- Lazily instantiate your dependencies when needed
- Stop caring about dependency initialization order
- Bind classes or interfaces to their instance or provider
- Debug your dependency bindings and recursions

**_KODEIN_** provides extensions to be integrable into:

- [Android](https://developer.android.com/)
- [Compose (Android / Desktop / Web)](https://kosi-libs.org/kodein/7.22/framework/compose.html)
- [Ktor](https://ktor.io/)

An example is always better than a thousand words:

```kotlin
val di = DI {
    bindProvider<Dice> { RandomDice(0, 5) }
    bindSingleton<DataSource> { SqliteDS.open("path/to/file") }
}

class Controller(private di: DI) {
    private val ds: DataSource by di.instance()
}
```

**_KODEIN_** is a good choice because:

- It proposes a very simple and readable declarative DSL
- It is not subject to type erasure (as Java is)
- It integrates nicely with Android
- It proposes a very kotlin-esque idiomatic API
- It is fast and optimized (makes extensive use of `inline`)

Installation