blob: b4697e88d4208975b1474cbb14d2dd0b91a0c7c8 (
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
|
// SPDX-License-Identifier: Apache-2.0
// This file contains macros for adding source locators at the point of invocation.
//
// This is not part of coreMacros to disallow this macro from being implicitly invoked in Chisel
// frontend (and generating source locators in Chisel core), which is almost certainly a bug.
//
// Note: While these functions and definitions are not private (macros can't be
// private), these are NOT meant to be part of the public API (yet) and no
// forward compatibility guarantees are made.
// A future revision may stabilize the source locator API to allow library
// writers to append source locator information at the point of a library
// function invocation.
package chisel3.internal.sourceinfo
/** Abstract base class for generalized source information.
*/
sealed trait SourceInfo {
/** A prettier toString
*
* Make a useful message if SourceInfo is available, nothing otherwise
*/
def makeMessage(f: String => String): String
}
sealed trait NoSourceInfo extends SourceInfo {
def makeMessage(f: String => String): String = ""
}
/** For when source info can't be generated because of a technical limitation, like for Reg because
* Scala macros don't support named or default arguments.
*/
case object UnlocatableSourceInfo extends NoSourceInfo
/** For when source info isn't generated because the function is deprecated and we're lazy.
*/
case object DeprecatedSourceInfo extends NoSourceInfo
/** For FIRRTL lines from a Scala source line.
*/
case class SourceLine(filename: String, line: Int, col: Int) extends SourceInfo {
def makeMessage(f: String => String): String = f(s"@[$filename $line:$col]")
}
|
