Just released klip@0.0.1 to maven central and gradle plugin portal. It's an exploration project of KSP that lets you do easy snapshot testing. Currently only works on jvm, but all code is multiplatform, so it'll support more targets as KSP expands into MPP. Give it a go!

what does it do at compile time?

Hm, why is it a gradle plugin and not just a library?

To answer both of your questions, ir needs the plugin to generate stubs and assertions for each annotated class and inject system paths.

Hm, why generate stubs, assertions and inject systems paths? I thought it could be just a function call which compares output with a file content 🤷

To avoid having to pass them in each time. There's a much better solution for java already, but keeping mpp support makes things trickier (thus the compiler plugin route).

@SnapshotName("i_can_give_custom_names_to_my_snapshots")

not sure I like that 🙈

I have to avoid reflection (js islimited). Keep in mind that this is just me learning ksp. I expect it'll serve best as an example of ksp setup rather than actual plugin to use (although it is kinda cool). Hopefully it'll mature as kotlin compiler api stabilises.

From my experience these kind of libraries need extra tooling which is often missing, e.g. finding orphaned approval/snapshot files, rename files when code is refactored, doing bulk approval, etc.

That's doable with the help of compiler plugin. Just needs work.

Hm, I think more like an IDE plugin 😅

But having everything seemleasly managed by gradle plugin gives lots of options

From my experience these kind of libraries need extra tooling which is often missing, e.g. finding orphaned approval/snapshot files, rename files when code is refactored, doing bulk approval, etc.

i think its best if they need no tooling at all. just a simple directory structure where its obvious what file you have to delete. and human readable snapshot files.

That's how it currently does it. All files are placed in src/sourceSetName/klips directory that mimics original file hierarchy from sources

if you have it in a separate source root, can you make idea show the snapshot near the source files without a plugin? maybe in package view?

Not without idea plugin. Although I could easily add a flag to gradle plugin to allow overriding this behaviour and place stuff by the test files.

idea should just do that per default in the package view imo

I agree about simple directory structure and human readable files, however, on large project obvious things become less obvious and there will be some orphaned approval files sooner or later 😅

ok but for approving the changes you can just use git

You could revert changes individually inintellij git diff view 😀