licence_audit/progress

Types

pub type Event {
  Event(kind: EventKind, message: String)
}

Constructors

pub type EventKind {
  Phase
  Detail
  PackageCount
  Success
  Failure
  Warning
  Error
}

Constructors

  • Phase
  • Detail
  • PackageCount
  • Success
  • Failure
  • Warning
  • Error
pub type Level {
  DebugLevel
  InfoLevel
  WarnLevel
  ErrorLevel
  FatalLevel
}

Constructors

  • DebugLevel
  • InfoLevel
  • WarnLevel
  • ErrorLevel
  • FatalLevel
pub type LogEntry {
  LogEntry(
    level: Level,
    logger_name: String,
    message: String,
    metadata: List(#(String, String)),
  )
}

Constructors

  • LogEntry(
      level: Level,
      logger_name: String,
      message: String,
      metadata: List(#(String, String)),
    )
pub type Reporter {
  Reporter(
    enabled: Bool,
    verbosity: Verbosity,
    emit: Bool,
    events: List(Event),
    deferred: List(Event),
    command: String,
    color: color.Mode,
  )
}

Constructors

pub type Verbosity {
  Quiet
  Normal
  Verbose
}

Constructors

  • Quiet
  • Normal
  • Verbose

Values

pub fn capturing(
  verbosity: Verbosity,
  command: String,
) -> Reporter
pub fn defer_error(
  reporter: Reporter,
  message: String,
) -> Reporter

Record a fatal audit error and queue its log emission until flush is called. Mirrors error in that it records even when verbosity is Quiet.

pub fn defer_success(
  reporter: Reporter,
  message: String,
) -> Reporter

Record a success event and queue its log emission until flush is called. Use this for end-of-run status messages that should appear after report output has been printed to stdout.

pub fn defer_warn(
  reporter: Reporter,
  message: String,
) -> Reporter

Record a warning event and queue its log emission until flush is called.

pub fn detail(reporter: Reporter, message: String) -> Reporter
pub fn disabled() -> Reporter
pub fn enabled(
  verbosity: Verbosity,
  command: String,
  color: color.Mode,
) -> Reporter
pub fn events(reporter: Reporter) -> List(Event)
pub fn fail(reporter: Reporter, message: String) -> Reporter
pub fn flush(reporter: Reporter) -> Reporter

Emit any deferred log entries (in the order they were deferred) and clear the deferred queue. Safe to call on capturing or disabled reporters.

pub fn format_level(level: Level, use_color: Bool) -> String
pub fn format_standard_record(
  record: LogEntry,
  use_color: Bool,
) -> String
pub fn format_tty_record(
  record: LogEntry,
  use_color: Bool,
) -> String
pub fn package_count(reporter: Reporter, count: Int) -> Reporter
pub fn phase(reporter: Reporter, message: String) -> Reporter
pub fn stderr_color_enabled(
  mode: color.Mode,
  level: tty.ColorLevel,
) -> Bool
pub fn success(reporter: Reporter, message: String) -> Reporter
pub fn warn(reporter: Reporter, message: String) -> Reporter
✨ Search Document