package trace-tef

Output for tracing.

• `Stdout will enable tracing and print events on stdout
• `Stderr will enable tracing and print events on stderr
• `File "foo" will enable tracing and print events into file named "foo"

A subscriber emitting TEF traces into out.

• since 0.8

Make a collector that writes into the given output. See setup for more details.

setup () installs the collector depending on out.

• parameter out

  can take different values:

  • regular output value to specify where events go
  • `Env will enable tracing if the environment variable "TRACE" is set.
  • If it's set to "1", then the file is "trace.json".
  • If it's set to "stdout", then logging happens on stdout (since 0.2)
  • If it's set to "stderr", then logging happens on stdout (since 0.2)
  • Otherwise, if it's set to a non empty string, the value is taken to be the file path into which to write.

with_setup () f (optionally) sets a collector up, calls f(), and makes sure to shutdown before exiting. since 0.2 a () argument was added.