This is a great idea. If we want to fix this in the 1.0 series, we could introduce a new name for the version that returns a resource -- toInputStreamResource perhaps. Then have the pipe version use the toInputStreamResource method in its implementation.

There's no series/1.1 yet -- we're working on a new interpreter on the topic/fs3 branch but it's a bit early to PR stuff there yet unless the changes are related to the interpreter.

Data point: for hold, which is in a similar situation, I added holdResource.
Ideally we would just change it, but we can't break the api, as you point out.

EDIT: for the implementation you can choose to change the current code, or keep it as is and add .compile.resource to it

we could introduce a new name for the version that returns a resource -- toInputStreamResource perhaps. Then have the pipe version use the toInputStreamResource method in its implementation.

I've implemented this suggestion.

@wedens This looks ready to merge to me once we add the mima exclusion for binary compatibility of JavaInputOutputStream.

@mpilquist Done.

Thank you!