v0.15.0

🎉 This release contains work from a new contributor! 🎉

Thank you, null@brocollie08, for all your work!

Release Notes

BailHook default handler (#33)

Allows for SyncBailHook to call with a default handler for when the taps do not bail and return nothing

---

🚀 Enhancement

• BailHook default handler #33 (@brocollie08)

Authors: 1

• @brocollie08

v0.14.1

⚠️ Pushed to main

• fix ci (@sugarmanz)

Authors: 1

• Jeremiah Zucker (@sugarmanz)

v0.14.0

Release Notes

make tap info mutable (#31)

Add data class APIs to TapInfo such that it can be mutated.

scope version properties to avoid conflicts (#30)

Scope metadata b/c it was conflicting w/ another Gradle plugin

---

🚀 Enhancement

• make tap info mutable #31 (@sugarmanz)

🐛 Bug Fix

• scope version properties to avoid conflicts #30 (@sugarmanz)

Authors: 1

• Jeremiah Zucker (@sugarmanz)

v0.13.0

Release Notes

New Hooks DSL (#29)

💥 Breaking Change 💥

Relax typing specification when using the DSL. Hooks should always use the Hook superclass as the specified type and rely solely on the annotation to specify the actual constraints of the hook:

abstract class CarHooks : Hooks() {
    @Sync<() -> Unit>
    abstract val brake: Hook
    
    @Sync<(newSpeed: Int) -> Unit>
    abstract val accelerate: Hook
}

---

🚀 Enhancement

• New Hooks DSL #29 (@stabbylambda)

Authors: 1

• David Stone (@stabbylambda)

v0.12.1

🐛 Bug Fix

• Switch to KotlinPoet Code Generation #28 (@sugarmanz @stabbylambda)

Authors: 2

• David Stone (@stabbylambda)
• Jeremiah Zucker (@sugarmanz)

v0.12.0

Release Notes

Migrate from Arrow Meta to Kotlin Symbol Processor (#24)

💥 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<*, *>
}

---

🚀 Enhancement

• Migrate from Arrow Meta to Kotlin Symbol Processor #24 (@sugarmanz)

⚠️ Pushed to main

• forgot this for shot in the dark (@sugarmanz)
• more reversions (@sugarmanz)
• revert breaking build changes (@sugarmanz)
• shot in the dark (@sugarmanz)
• try to fix gradle crashing on release (@sugarmanz)

Authors: 1

• Jeremiah Zucker (@sugarmanz)

v0.11.1

Release Notes

Add explicit visibility to satisfy Kotlin explicit API check (#20)

Generated source code will adhere to Kotlin explicit API check if hooks are public.

---

🐛 Bug Fix

• Add explicit visibility to satisfy Kotlin explicit API check #20 (@sugarmanz)

Authors: 1

• Jeremiah Zucker (@sugarmanz)

v0.11.0

Release Notes

Untap support & various fixes (#19)

Small fixes

• Fix Gradle generation params
• Modify async hook strategy to not take a scope, as this is already required to call the suspend method
• Fix AsyncParallelHook to actually suspend properly until all callbacks complete
• Replace mutable list containing TapInfo with a mutable var containing an immutable list (this fixes an issue when tapping a hook that is currently being called: ConcurrentModificationException)

Untapping

In order to allow calling sites to unregister stale callbacks and prevent memory leaks, the tap API now returns a String representing the ID of the specific "tap". The ID can then be passed into the new untap API to remove the callback from the hook. This ID can be randomly generated or manually passed when tapping a hook. Manually passing an ID is useful for when the tapper wants to replace a stale callback without calling needing to untap explicitly.

---

🚀 Enhancement

Authors: 1

• Jeremiah Zucker (@sugarmanz)

0.10.4-next.2

⚠️ Pushed to next

• fix doc comment link (@sugarmanz)
• add some docs (@sugarmanz)

Authors: 1

• Jeremiah Zucker (@sugarmanz)

0.10.4-next.1

⚠️ Pushed to next

• migrate interceptors to immutable lists and enhance id strategy (@sugarmanz)
• better async parallel hook (@sugarmanz)

Authors: 1

• Jeremiah Zucker (@sugarmanz)