Changelog

0.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

Authors: 1



0.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



0.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



0.10.2

Release Notes

Format generated source with KtLint (#18)

What Changed

Format generated source with KtLint


0.10.1

Release Notes

manually bump version snapshot (#17)


🐛 Bug Fix

Authors: 1



0.10.0

Release Notes

upgrade to arrow 1.0.0 and fix generated sources root (#15)

  • Upgrade to Arrow 1.0.0
  • Fixed issue where JAR bundling was somehow causing the plugin options to be dropped

🚀 Enhancement

  • upgrade to arrow 1.0.0 and fix generated sources root #15 (@sugarmanz)

Authors: 1



0.9.1

🐛 Bug Fix

⚠️ Pushed to main

  • rename master to main (jeremiah_zucker@intuit.com)

🏠 Internal

  • Upgrade binary compatibility tool to 0.5.0 #14 (jeremiah_zucker@intuit.com)
  • Setup Auto for Canary and Next #12 (jeremiah_zucker@intuit.com)

Authors: 2



0.9.0

:tada: This release contains work from a new contributor! :tada:

Thank you, David Stone (@stabbylambda), for all your work!

Release Notes

Hooks with type parameters (#8)

Enhance DSL to adds the ability to generate Hooks with type parameters. The use case for this is when some piece of data is known only to the consumer of a library and the consumers of the taps, but not necessarily the library itself. As an example:

class FooHooks<T> : Hooks() {
    open val beforeCalc = syncHook<(T) -> Unit>()
}

data class Foo<T>(val t: T)  {
    public val hooks = FooHooksImpl<T>()

    fun calc() {
        hooks.beforeCalc.call(t)
        // ...
    }
}

fun runCalcsWithLog() {
    val f = Foo<String>("hi")
    f.hooks.beforeCalc.tap("hi") { x -> println(x) }
}

🚀 Enhancement

🐛 Bug Fix

📝 Documentation

Authors: 2



0.8.2

🐛 Bug Fix

Authors: 1



0.8.1

⚠️ Pushed to master

Authors: 1



0.8.0

🚀 Enhancement

Authors: 1



0.7.4

:tada: This release contains work from new contributors! :tada:

Thanks for all your work!

:heart: Jeremiah Zucker (@sugarmanz)

:heart: Andrew Lisowski (@hipstersmoothie)

🐛 Bug Fix

⚠️ Pushed to master

Authors: 2



0.7.0

Release Notes

From #38


🚀 Enhancement

Authors: 1



0.6.0

Release Notes

From #36

Implement Kotlin Maven Plugin Extension


🚀 Enhancement

  • [PLAYA-7426] Implement Kotlin Maven Plugin Extension #36 (@JZUCKER)

Authors: 1



0.5.0

🚀 Enhancement

Authors: 1



0.4.0

Release Notes

From #31

Gradle Plugin

Implement Gradle plugin for the compiler plugin. When added to a project, it will automatically include the correct dependencies.

Renaming

Remove all tapable references from the package name.


🚀 Enhancement

Authors: 2



0.3.0

Release Notes

From #33


🚀 Enhancement

🐛 Bug Fix

📝 Documentation

Authors: 2



0.2.0

🚀 Enhancement

Authors: 1



0.1.4

🐛 Bug Fix

Authors: 1



0.1.3

🐛 Bug Fix

Authors: 1



0.1.2

🐛 Bug Fix

Authors: 1



0.1.1

🐛 Bug Fix

Authors: 1



0.1.0

🚀 Enhancement

Authors: 1



0.0.2

Release Notes

From #7

First published alpha release of Intuit Tapable for the JVM. This includes the complete set of working hooks, as well as a compiler plugin to help generate specific hook implementations. This project as a whole is based on Webpack's Tapable for JS.


🐛 Bug Fix

⚠️ Pushed to master

Authors: 2


Why

To make generated source more readable for consumers


🐛 Bug Fix

Authors: 1