Suppressor
Julia macros for suppressing and/or capturing output (stdout), warnings (stderr) or both streams at the same time.
Installation
julia> Pkg.add("Suppressor")Usage
julia> using Suppressor
julia> using Compat: @warn # on 0.6
julia> @suppress begin
println("This string doesn't get printed!")
@warn("This warning is ignored.")
end
julia> @suppress_out begin
println("This string doesn't get printed!")
@warn("This warning is important")
end
┌ Warning: This warning is important
└ @ Main REPL[4]:3
julia> @suppress_err begin
println("This string gets printed!")
@warn("This warning is unimportant")
end
This string gets printed!
julia> @suppress begin
println("This string doesn't get printed!")
@warn("This warning is ignored.")
error("Remember that errors are still printed!")
end
ERROR: Remember that errors are still printed!
The suppress macros return whatever the given expression returns, but Suppressor also provides @capture_out and @capture_err macros that work similiarly to their @suppress_ cousins except they return any output as a string:
julia> output = @capture_out begin
println("should get captured, not printed")
end;
julia> output == "should get captured, not printed\n"
true
julia> output = @capture_err begin
@warn("should get captured, not printed")
end;
julia> output[1:56] == "┌ Warning: should get captured, not printed\n└ @ Main"
true
NOTE: the following example only works on Julia 0.6; on later versions of Julia the color codes are never captured
Often when capturing output for test purposes it's useful to control whether
color is enabled or not, so that you can compare with or without the color
escape characters regardless of whether the julia process has colors enabled or
disabled globally. You can use the @color_output macro for this:
@color_output false begin
output = @capture_err begin
warn("should get captured, not printed")
end
end
@test output == "WARNING: should get captured, not printed\n"
@color_output true begin
output = @capture_err begin
warn("should get captured, not printed")
end
end
@test output == "\e[1m\e[33mWARNING: \e[39m\e[22m\e[33mshould get captured, not printed\e[39m\n"Variable Scope
The macros in Suppressor.jl need to wrap the given expression in a try...finally block to make sure that everything is cleaned up correctly. This means that any variables introduced within the macro expression aren't in-scope afterwards. To work around this you can use local to introduce the variable before the block, for example:
local x
output = @capture_out x = loudfunction()
println(x) # x is available here