Delva/app.oreshkov.delva/DelvaImplementationApi

DelvaImplementationApi

@RequiresOptIn(message = "Delva adds members to this interface in minor releases, which an implementation has to follow; opt in with @OptIn(DelvaImplementationApi::class).", level = RequiresOptIn.Level.ERROR)

@Target(allowedTargets = [AnnotationTarget.CLASS])

annotation class DelvaImplementationApi(source)

Marks the interfaces that are Delva's to implement: ReadableJsonStore, JsonStore, SecondaryJsonStore, their blocking faces (BlockingReadableJsonStore, BlockingJsonStore, BlockingSecondaryJsonStore), SearchResult, SearchHit, SelectResult and SelectedNode. Calling them needs no opt-in. Implementing one, typically as a fake in a test, requires @OptIn(DelvaImplementationApi::class) and accepts that later minor releases add members to it, which an implementation then has to add too.