Add capturing bypass

[plexus]

When using the output-capturing plugin, it is sometimes desirable to bypass it and still print things directly.

See https://clojurians.slack.com/archives/CCY2V0U6A/p1670084873985659 for a workaround.

This applies the same logic, but provides a more generic bypass macro.

It seems FileDescriptor is not available in babashka, so until that changes this will be Clojure only.

[codecov]

Codecov Report

Base: 75.21% // Head: 75.42% // Increases project coverage by +0.20% 🎉

Coverage data is based on head (1c9ada5) compared to base (295791e).
Patch coverage: 33.33% of modified lines in pull request are covered.

❗ Current head 1c9ada5 differs from pull request most recent head 1266ab0. Consider uploading reports for the commit 1266ab0 to get more accurate results

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #366      +/-   ##
==========================================
+ Coverage   75.21%   75.42%   +0.20%     
==========================================
  Files          51       51              
  Lines        2740     2734       -6     
  Branches      256      258       +2     
==========================================
+ Hits         2061     2062       +1     
+ Misses        518      510       -8     
- Partials      161      162       +1     

Flag	Coverage Δ
integration	57.00% <0.00%> (+0.03%)	⬆️
unit	69.45% <33.33%> (+0.07%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files	Coverage Δ
src/kaocha/core_ext.clj	64.28% <ø> (ø)
src/kaocha/plugin/capture_output.cljc	96.87% <0.00%> (ø)
src/kaocha/plugin/notifier.clj	82.82% <ø> (ø)
src/kaocha/plugin/randomize.clj	95.23% <ø> (ø)
src/kaocha/runner.clj	46.80% <ø> (ø)
src/kaocha/type/var.clj	83.33% <ø> (-1.29%)	⬇️
src/kaocha/watch.clj	78.30% <ø> (+4.44%)	⬆️
src/kaocha/testable.clj	82.23% <100.00%> (ø)
src/kaocha/type/ns.clj	95.74% <0.00%> (-2.13%)	⬇️
... and 3 more

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

☔ View full report at Codecov.
📢 Do you have feedback about the report comment? Let us know in this issue.

[alysbrooks]

Yeah, I had a conversation with Michiel Borkent when there was an earlier issue with FileDescriptor, and he said FileDescriptor probably wasn't a good candidate for addition to Babashka.

[alysbrooks]

Based on the Slack conversation, it sounds like this might be intended for using in test code by users of Kaocha? In that case, I think we'd ideally have documentation for it.

[alysbrooks]

What's the rationale for using parentheses over brackets? Is it just to indicate the different semantics between requires and imports?

[alysbrooks]

To be clear, not arguing against this change, just wondering.

[plexus]

The reason is that the first item in the list is special. In this case I agree with Alessandra Sierra https://stuartsierra.com/2016/clojure-how-to-ns.html

The practical result is that you get more sensible indentation

(:import (foo.bar Klass
                  OtherKlass))

(:import [foo.bar Klass
          OtherKlass])

[plexus]

Released in v1.75.1190

[lambdaisland/kaocha "1.75.1190"]                 ;; deps.edn
{lambdaisland/kaocha {:mvn/version "1.75.1190"}}  ;; project.clj