aboutsummaryrefslogtreecommitdiff
path: root/src/main/scala/firrtl/options/OptionParser.scala
blob: 27251b009e256759a7e6b6264f85f59c820c7541 (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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
// SPDX-License-Identifier: Apache-2.0

package firrtl.options

import firrtl.AnnotationSeq

import scopt.OptionParser

case object OptionsHelpException extends Exception("Usage help invoked")

/** OptionParser mixin that causes the OptionParser to not call exit (call `sys.exit`) if the `--help` option is
  * passed
  */
trait DoNotTerminateOnExit { this: OptionParser[?] =>
  override def terminate(exitState: Either[String, Unit]): Unit = ()
}

/** OptionParser mixin that converts to [[OptionsException]]
  *
  * Scopt, by default, will print errors to stderr, e.g., invalid arguments will do this. However, a [[Stage]] uses
  * [[StageUtils.dramaticError]]. By converting this to an [[OptionsException]], a [[Stage]] can then catch the error an
  * convert it to an [[OptionsException]] that a [[Stage]] can get at.
  */
trait ExceptOnError { this: OptionParser[?] =>
  override def reportError(msg: String): Unit = throw new OptionsException(msg)
}

/** A modified OptionParser with mutable termination and additional checks
  */
trait DuplicateHandling extends OptionParser[AnnotationSeq] {

  override def parse(args: scala.collection.Seq[String], init: AnnotationSeq): Option[AnnotationSeq] = {

    /** Message for found duplicate options */
    def msg(x: String, y: String) = s"""Duplicate $x "$y" (did your custom Transform or OptionsManager add this?)"""

    val longDups = options.map(_.name).groupBy(identity).collect { case (k, v) if v.size > 1 && k != "" => k }
    val shortDups = options.map(_.shortOpt).flatten.groupBy(identity).collect { case (k, v) if v.size > 1 => k }

    if (longDups.nonEmpty) {
      throw new OptionsException(msg("long option", longDups.map("--" + _).mkString(",")), new IllegalArgumentException)
    }

    if (shortDups.nonEmpty) {
      throw new OptionsException(
        msg("short option", shortDups.map("-" + _).mkString(",")),
        new IllegalArgumentException
      )
    }

    super.parse(args, init)
  }

}