Migrate from Arrow Meta to Kotlin Symbol Processor

[sugarmanz]

What Changed

Migrate to KSP (also includes Kotlin 1.6+ upgrade and Gradle version catalog update)

Why

#16

Concerns

• Assignment based -> Annotation based.

  hooks/example-library/src/main/kotlin/com/intuit/hooks/example/library/generic/GenericHooks.kt

  Lines 7 to 19 in 0115548

  	internal abstract class GenericHooks : Hooks() {
  	@Sync<(newSpeed: Int) -> Unit> abstract val sync: SyncHook<*>
  	@SyncBail<(Boolean) -> BailResult<Int>> abstract val syncBail: SyncBailHook<*, *>
  	@SyncLoop<(foo: Boolean) -> LoopResult> abstract val syncLoop: SyncLoopHook<*, *>
  	@SyncWaterfall<(name: String) -> String> abstract val syncWaterfall: SyncWaterfallHook<*, *>
  	@ExperimentalCoroutinesApi
  	@AsyncParallelBail<suspend (String) -> BailResult<String>> abstract val asyncParallelBail: AsyncParallelBailHook<*, *>
  	@AsyncParallel<suspend (String) -> Int> abstract val asyncParallel: AsyncParallelHook<*>
  	@AsyncSeries<suspend (String) -> Int> abstract val asyncSeries: AsyncSeriesHook<*>
  	@AsyncSeriesBail<suspend (String) -> BailResult<String>> abstract val asyncSeriesBail: AsyncSeriesBailHook<*, *>
  	@AsyncSeriesLoop<suspend (String) -> LoopResult> abstract val asyncSeriesLoop: AsyncSeriesLoopHook<*, *>
  	@AsyncSeriesWaterfall<suspend (String) -> String> abstract val asyncSeriesWaterfall: AsyncSeriesWaterfallHook<*, *>
  	}

• Still would like to migrate to Kotlin poet as well!

• Gradle/Maven plugins wrappers tie to a specific version of KSP/Kotlin -- so if we keep those, we should release those independently to align with KSP/Kotlin version

• Ktlint is incompatible with Maven :(

Resolutions

Still would like to migrate to Kotlin poet as well!

Postponing for another PR

Gradle/Maven plugins wrappers tie to a specific version of KSP/Kotlin -- so if we keep those, we should release those independently to align with KSP/Kotlin version

Will release in accordance with hooks for now with explicit documentation regarding what Kotlin version it is compatible with. In the future, we will fix publishing to publish against proper versions (for 1.0)

Ktlint is incompatible with Maven :(

Swapping to Kotlin poet should help with proper formatting anyways

📦 Published PR as canary version: 0.11.2-canary.24.249-SNAPSHOT

Release Notes

💥 This is a breaking change 💥

Migration to KSP from Arrow Meta because they dropped support for source generation. This does improve the overall maturity of the codegen module (compiler-plugin -> processor). However, the KSP framework doesn't support the code typing introspection that we were doing in Arrow Meta. Instead, we have to rely strictly on typings and annotations, which changes the DSL we originally had.

internal abstract class GenericHooks : Hooks() {
    @Sync<(newSpeed: Int) -> Unit> abstract val sync: SyncHook<*>
    @SyncBail<(Boolean) -> BailResult<Int>> abstract val syncBail: SyncBailHook<*, *>
    @SyncLoop<(foo: Boolean) -> LoopResult> abstract val syncLoop: SyncLoopHook<*, *>
    @SyncWaterfall<(name: String) -> String> abstract val syncWaterfall: SyncWaterfallHook<*, *>
    @AsyncParallelBail<suspend (String) -> BailResult<String>> abstract val asyncParallelBail: AsyncParallelBailHook<*, *>
    @AsyncParallel<suspend (String) -> Int> abstract val asyncParallel: AsyncParallelHook<*>
    @AsyncSeries<suspend (String) -> Int> abstract val asyncSeries: AsyncSeriesHook<*>
    @AsyncSeriesBail<suspend (String) -> BailResult<String>> abstract val asyncSeriesBail: AsyncSeriesBailHook<*, *>
    @AsyncSeriesLoop<suspend (String) -> LoopResult> abstract val asyncSeriesLoop: AsyncSeriesLoopHook<*, *>
    @AsyncSeriesWaterfall<suspend (String) -> String> abstract val asyncSeriesWaterfall: AsyncSeriesWaterfallHook<*, *>
}

[sugarmanz]

@stabbylambda would love your opinion on the new annotation-based DSL (comes from restraints of KSP over Arrow Meta)

[sugarmanz]

🚀 PR was released in v0.12.0 🚀