Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/SimonMarquis/SealedObjectInstances
A Kotlin Symbol Processor to list sealed object instances.
https://github.com/SimonMarquis/SealedObjectInstances
kotlin ksp sealed-class sealed-interface
Last synced: 3 months ago
JSON representation
A Kotlin Symbol Processor to list sealed object instances.
- Host: GitHub
- URL: https://github.com/SimonMarquis/SealedObjectInstances
- Owner: SimonMarquis
- License: apache-2.0
- Created: 2022-08-21T17:33:57.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-04-14T20:53:50.000Z (10 months ago)
- Last Synced: 2024-04-16T11:22:04.330Z (10 months ago)
- Topics: kotlin, ksp, sealed-class, sealed-interface
- Language: Kotlin
- Homepage: https://simonmarquis.github.io/SealedObjectInstances/
- Size: 698 KB
- Stars: 27
- Watchers: 3
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-list - SimonMarquis/SealedObjectInstances - A Kotlin Symbol Processor to list sealed object instances. (Kotlin)
README
# Sealed Object Instances [](https://github.com/SimonMarquis/SealedObjectInstances/actions/workflows/build.yml)
> A **K**otlin **S**ymbol **P**rocessor to list sealed object instances.
## Usage
Let's say you have a similar structure of sealed classes (or interfaces):
```kotlin
// FeatureFlag.kt
sealed class FeatureFlag {
abstract val isEnabled: Boolean
}
```
```kotlin
// Debug.kt
sealed class Debug(override val isEnabled: Boolean = false) : FeatureFlag() {
data object Logs : Debug(true)
data object Traces : Debug()
data object StrictMode : Debug()
}
```
```kotlin
// UI.kt
sealed class UI(override val isEnabled: Boolean = false) : FeatureFlag() {
data object Animations : UI()
data object Framerate : UI()
}
```
And you want to automatically list all `FeatureFlag`s, then you have at least 3 options:
- 🙅 Manually keep a list of objects somewhere, but this is cumbersome and error-prone.
- 🤷 Use [Kotlin reflection](https://kotlinlang.org/docs/reflection.html) to browse the class declaration, with the following extension `FeatureFlag::class.reflectSealedObjectInstances()`, but this can become an expensive operation if you have a lot of objects and a deeply nested structure.
- 🙆 Use [Kotlin Symbol Processing](https://kotlinlang.org/docs/ksp-overview.html) (KSP) to create the list of objects at compile time.
This is exactly what this project does.
You simply need to add the `SealedObjectInstances` annotation on the sealed class:
```kotlin
@SealedObjectInstances
sealed class FeatureFlag { /*...*/ }
```
And then you'll have access to the `sealedObjectInstances()` extension on the corresponding type:
```kotlin
val flags: Set = FeatureFlag::class.sealedObjectInstances()
```
> [!NOTE]
> You can annotate the `companion object` to access a simpler extension function (no more `::class` prefix).
> ```kotlin
> sealed class FeatureFlag {
> @SealedObjectInstances companion object;
> /*...*/
> }
>
> val flags: Set = FeatureFlag.sealedObjectInstances()
> ```
## Setup
In the module's build script, apply the `com.google.devtools.ksp` plugin with the matching Kotlin version: [](https://central.sonatype.com/artifact/com.google.devtools.ksp/com.google.devtools.ksp.gradle.plugin)
```kotlin
plugins {
id("com.google.devtools.ksp") version ""
}
```
Then add the library dependencies: [](https://central.sonatype.com/artifact/fr.smarquis.sealed/sealed-object-instances) [](https://s01.oss.sonatype.org/content/repositories/snapshots/fr/smarquis/sealed/sealed-object-instances/)
```kotlin
dependencies {
implementation("fr.smarquis.sealed:sealed-object-instances:")
ksp("fr.smarquis.sealed:sealed-object-instances:")
}
```
🐙 GitHub Packages
[](https://github.com/SimonMarquis/SealedObjectInstances/packages/1674974/versions)
> [!NOTE]
> You'll need to create a personal access token (PAT) with the `read:packages` permission to be able to download from this repository.
> https://docs.github.com/en/packages/learn-github-packages
```kotlin
repositories {
maven {
url = uri("https://maven.pkg.github.com/SimonMarquis/SealedObjectInstances")
credentials {
username = System.getenv("GITHUB_USERNAME")
password = System.getenv("GITHUB_PACKAGES_READ_TOKEN")
}
}
}
dependencies {
implementation("fr.smarquis.sealed:sealed-object-instances:")
ksp("fr.smarquis.sealed:sealed-object-instances:")
}
```
🚀 JitPack.io
[](https://jitpack.io/#SimonMarquis/SealedObjectInstances)
```kotlin
repositories {
maven {
url = uri("https://jitpack.io")
}
}
dependencies {
implementation("com.github.SimonMarquis:SealedObjectInstances:")
ksp("com.github.SimonMarquis:SealedObjectInstances:")
}
```
## Make IDE aware of generated code
By default, IntelliJ IDEA or other IDEs don't know about the generated code. So it will mark references to generated symbols unresolvable. To make an IDE be able to reason about the generated symbols, mark the following paths as generated source roots:
- Android project
```kotlin
androidComponents.beforeVariants {
kotlin.sourceSets.register(it.name) {
kotlin.srcDir(file("$buildDir/generated/ksp/${it.name}/kotlin"))
}
}
```
- Kotlin JVM project
```kotlin
kotlin {
sourceSets.main {
kotlin.srcDir("build/generated/ksp/main/kotlin")
}
sourceSets.test {
kotlin.srcDir("build/generated/ksp/test/kotlin")
}
}
```
## Configuration
`SealedObjectInstances` annotation can be configured to produce different outputs, and is also repeatable:
```kotlin
@SealedObjectInstances
@SealedObjectInstances(name = "values", rawType = Array)
sealed class FeatureFlag { /*...*/ }
```
This code will produce these two extensions:
```kotlin
// The default extension
fun KClass.sealedObjectInstances(): Set
// The custom extension with different name and raw type
fun KClass.values(): Array
```
## Known issues
- Having multiple sealed classes/interfaces with the same name in the same package is currently not supported, and the KSP will fail. But this can be avoided by providing a custom generated `fileName` on the `SealedObjectInstances` annotation.
- [KT-8970](https://youtrack.jetbrains.com/issue/KT-8970/Object-is-uninitialized-null-when-accessed-from-static-context-ex-companion-object-with-initialization-loop): Using the extension from a static context (e.g. `companion object`), will return `null` values. A simple solution is to delegate to a lazy initializer: `val values by lazy(MySealedClass::class::sealedObjectInstances)`.
- Does not support non-standard (alphanumeric) class names that needs backticks like:
```kotlin
sealed class `A-B-C`
```
- [google/ksp#1651](https://github.com/google/ksp/issues/1651): KSP does not run on common multiplatform code, requiring an extra manual ["bridge" expect/actual method](https://github.com/SimonMarquis/SealedObjectInstances/blob/main/multiplatform/src/commonMain/kotlin/com/example/Entity.kt#L30).