FocusSelection

public protocol FocusSelection

An implementation of FocusSelection is used to control what logging and debug info is currently being produced. When the focus selection is empty (reset), all the normal logging levels apply and there is no filtering.

Focusing on one or more features results in only logging related to the focused items being produced, automatically setting debug log level for those features and topic paths.

Topic Paths are used to allow control of non-Feature subsystems that have opted in to Contextual Logging. Feature identifiers are converted to Topic Paths so we have one common concept for logging hierarchy.

See

TopicPath

  • This is set to true if there is currently a non-empty focus selection, i.e. focus is being used. When false this means all debug output should be included

    Declaration

    Swift

    var isActive: Bool { get }
    Show on GitHub

  • Test if something should be suppressed from output. This exists so that we can easily write:

    guard !FlintInternal.focusSelection?.shouldSuppress(x) == true else { return }

    This way, if the selection is nil OR x is not in the focus selection, we can get out concisely.

    • return: true if the specific topic path should not be output in logs or debug UI. Returns true only if there is a selection AND the topic path is included in it

    Declaration

    Swift

    func shouldSuppress(_ topicPath: TopicPath) -> Bool
    Show on GitHub
    • return: true if the specified feature is in the current focus selection. This must be the case if any of its ancestor Features is in the focus selection. Returns false if there is no selection, or there is a selection but the topic is not in it

    Declaration

    Swift

    func isFocused(_ topicPath: TopicPath) -> Bool
    Show on GitHub

  • Called to add a feature to the focus selection

    Declaration

    Swift

    func focus(_ topicPath: TopicPath)
    Show on GitHub

  • Called to add a feature to the focus selection

    Declaration

    Swift

    func defocus(_ topicPath: TopicPath)
    Show on GitHub

  • Called to clear the focus and revert to standard behaviour

    Declaration

    Swift

    func reset()
    Show on GitHub