B0_cli.B0_std
Fragments for setting up B0_std
.
Configure colored output and log verbosity and the B0_std.Os.Cmd.spawn_tracer
.
val get_tty_cap : B0_std.Tty.cap option option -> B0_std.Tty.cap
get_tty_cap cap
determines cap
with B0_std.Tty.cap
and B0_std.Tty.of_fd
on Unix.stdout
if cap
is None
or Some
None
.
val get_log_level : B0_std.Log.level option -> B0_std.Log.level
get_log_level level
determines level
with B0_std.Log.Warning
if level
is None
.
val setup :
B0_std.Tty.cap ->
B0_std.Log.level ->
log_spawns:B0_std.Log.level ->
unit
setup tty_cap log_level ~log_spawns
sets:
B0_std.Fmt.set_tty_styling_cap
with tty_cap
.B0_std.Log.set_level
with log_level
.B0_std.Os.Cmd.set_spawn_tracer
with B0_std.Log.spawn_tracer
log_spawns
iff level >= log_spawn
.Warning. If level < log_spawn
but B0_std.Log.level
is increased after this call, the spawns won't be traced (most cli programs do not change after the initial setup). Do your own setup if that is a problem for you.
val tty_cap_of_string : string -> (B0_std.Tty.cap option, string) Stdlib.result
tty_cap_of_string v
parses:
""
, "auto"
into None
"always"
into Some `Ansi
"never"
into Some `None
val tty_cap :
?docs:string ->
?env:Cmdliner.Cmd.Env.info ->
unit ->
B0_std.Tty.cap option option Cmdliner.Term.t
tty_cap ~docs ~env ()
is a cli interface for specifiying a TTY capability with a --color
option. docs
is where the options are documented (defaults to Cmdliner.Manpage.s_common_options
). env
, if provided, is an environment variable to set the value (use something like "MYPROGRAM_COLOR"
). None
is returned if the value is not set on the cli or via the env var.
val log_level :
?none:B0_std.Log.level ->
?docs:string ->
?env:Cmdliner.Cmd.Env.info ->
unit ->
B0_std.Log.level option Cmdliner.Term.t
log_level ~none ~docs ~env ()
is a cli interface for specifiying a logging level with various options. docs
is where the options are documented (defaults to Cmdliner.Manpage.s_common_options
). env
, if provided, is an environment variable to set the value (use something like "MYPROGRAM_VERBOSITY"
). none
is used to document the level when the log level is unspecified (defaults to Log.Warning
). None
is returned if the value is not set on the cli or via the env var.