aboutsummaryrefslogtreecommitdiff
path: root/src/main/scala/logger/LoggerOptions.scala
blob: bfd072df24deab64c910359a6ddc992573601668 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
// SPDX-License-Identifier: Apache-2.0

package logger

/** Internal options used to control the logging in programs that are part of the Chisel stack
  *
  * @param globalLogLevel the verbosity of logging (default: [[logger.LogLevel.None]])
  * @param classLogLevels the individual verbosity of logging for specific classes
  * @param logToFile      if true, log to a file
  * @param logClassNames  indicates logging verbosity on a class-by-class basis
  */
class LoggerOptions private[logger] (
  val globalLogLevel: LogLevel.Value = LogLevelAnnotation().globalLogLevel,
  val classLogLevels: Map[String, LogLevel.Value] = Map.empty,
  val logClassNames:  Boolean = false,
  val logFileName:    Option[String] = None) {

  private[logger] def copy(
    globalLogLevel: LogLevel.Value = globalLogLevel,
    classLogLevels: Map[String, LogLevel.Value] = classLogLevels,
    logClassNames:  Boolean = logClassNames,
    logFileName:    Option[String] = logFileName
  ): LoggerOptions = {

    new LoggerOptions(
      globalLogLevel = globalLogLevel,
      classLogLevels = classLogLevels,
      logClassNames = logClassNames,
      logFileName = logFileName
    )

  }

  /** Return the name of the log file, defaults to `a.log` if unspecified */
  def getLogFileName(): Option[String] = if (!logToFile()) None else logFileName.orElse(Some("a.log"))

  /** True if a [[Logger]] should be writing to a file */
  @deprecated("logToFile was removed, use logFileName.nonEmpty", "FIRRTL 1.2")
  def logToFile(): Boolean = logFileName.nonEmpty
}