Debug

Object Hierarchy:

Description:

public class Debug : Object

Manage debug output and status reporting for all folks objects. All GLib debug logging calls are passed through a log handler in this class, which allows debug domains to be outputted according to whether they've been enabled by being passed to Debug.dup.

Since:

0.5.1

Namespace: Folks

Package: folks

Content:

Constants:

public const unowned string STATUS_LOG_DOMAIN
Log domain for the status messages logged as a result of calling Debug.emit_print_status.

Properties:

public bool colour_enabled { set; get; }
public bool debug_output_enabled { set; get; }
Whether debug output is enabled. This is orthogonal to the set of enabled debug domains; filtering of debug output as a whole is done after filtering by enabled domains.

Static methods:

public static Debug dup ()
Create or return the singleton Debug class instance. If the instance doesn't exist already, it will be created with no debug domains enabled.
public static Debug dup_with_flags (string? debug_flags, bool colour_enabled)
Create or return the singleton Debug class instance. If the instance doesn't exist already, it will be created with the given set of debug domains enabled. Otherwise, the existing instance will have its set of enabled domains changed to the provided set.

Methods:

public void emit_print_status ()
Causes all significant objects in the library to print their current status to standard output, obeying the options set on this Debug instance for colouring and other formatting.
public void indent ()
Increment the indentation level used when printing output through the object.
public void unindent ()
Decrement the indentation level used when printing output through the object.
public void print_line (string domain, LogLevelFlags level, string format, ...)
Print a debug line with the current indentation level for the specified debug domain.
public void print_heading (string domain, LogLevelFlags level, string format, ...)
Print a debug line as a heading. It will be coloured according to the current indentation level so that different levels of headings stand out.
public void print_key_value_pairs (string domain, LogLevelFlags level, ...)
Print a set of key–value pairs in a table. The width of the key column is automatically set to the width of the longest key. The keys and values must be provided as a null-delimited list of alternating key–value varargs. Values may be null but keys may not.

Signals:

public signal void print_status ()
Signal emitted in the main thread whenever objects should print their current status. All significant objects in the library should connect to this and print their current status in some suitable format when it's emitted.