In other words, in which cases does a Kotlin libra...

# announcements

[pniederw]

In other words, in which cases does a Kotlin library (not) expose kotlin-stdlib in its API?

[gildor]

If Kotlin stdlib is implementation details and doesn't expose types from Kotlin stdlib, than it looks correct to use implementation instead of compile/api

[pniederw]

My question is, what exactly constitutes "exposes types from Kotlin stdlib"? What if the API uses kotlin.Boolean, kotlin.collections.List, a Kotlin lambda, etc.?

[gildor]

From mentioned only Function1-FunctionN (ala lambda) is kotlin stdlib type

[pniederw]

That would have been my guess. Is there a spec for this?

[gildor]

Boolean and list are not exist on compiled code

[pniederw]

Or even better, a tool that provides this information (yes/no).

[gildor]

I don't know such. But you can use some of tools that generate public API snapshot and check Kotlin types there (just check that you expose nothing from package kotlin)

[gildor]

For example kotlinx.coroutines uses such (custom) tool which generates text files with public API

[pniederw]

seems like essential information for every kotlin library author

[gildor]

Only if you expect also Java users, not only Kotlin

[gildor]

Also you can expose kotlin stdlib, not so big issue for most cases.

[gildor]

But sure in general sounds as cleaner approach

[gildor]

One more way: just cover library public API with integration tests on java without stdlib in dependencies

[pniederw]

I like to get my POMs right. Agreed that this only matters for libraries that expect non-Kotlin users.

[pniederw]

Alas, all my tests are written in Kotlin, even tests for Java code. 🙂

[gildor]

Yes, but if your library also targets java users it's very important test java compatibility and usability and special tests for this is good way of validation

[pniederw]

just not important enough right now

[gildor]

So I would worry than about stdlib which is not so important if you do not target java users

[pniederw]

I do target them, I just don't have time to write a Java test suite right now

[gildor]

Mmm, just create a new module with Java only and write tests in this module