Use LineSpan.Path instead of SourceTree?.FilePath when trimming Location

[ivarne]

If the Location is created without referencing the SourceTree, the previous implementation of GetLocationTrimmed lost the file path resulting in diagnostic messages without clickable file paths.

This might not be relevant for this project (yet), but I'm copying the code for my own SourceGenerator and ran into this issue when adding diagnostics for AdditionalFiles where created the location using Location.Create instead of getting it from syntax.

PS: I'm pretty new to Roslyn, so I don't know whether the lineSpan always have the path, but the implementation of Location.GetDebuggerDisplay seems to indicate that it usually does.

[eiriktsarpalis]

The fact that diagnostics are not clickable is due to a known issue with Roslyn not supporting incremental Location values. I'm curious about your fix though, does LineSpan.Path return something different compared to SourceTree.FilePath and does that address the issue in question?

[ivarne]

The problem arrises when I use Location.Create before instantiating the EquatableDiagnostic, because Location.Create leaves SourceTree set to null and thus the filePath is not propagated through GetLocationTrimmed.

Eg:

new EquatableDiagnostic(
    diagnosticDescriptor,
    Location.Create(
        filePath,
        new TextSpan(startIndex, endIndex.HasValue ? endIndex.Value - startIndex : 0),
        new LinePositionSpan(
            GetLinePosition(startIndex, fileContent),
            GetLinePosition(endIndex ?? startIndex, fileContent)
        )
    )
)

the filePath i provide gets wiped out because it is stored in the span and not in the SourceTree (which is null)

[eiriktsarpalis]

I see, does this address the issue of diagnostics not being clickable though? I'm not sure that it does, because fundamentally the issue is with Location.Create producing external locations that are not clickable.

[ivarne]

Not sure what you mean by "clickable". The important part for me is that the path I provide is visible in the terminal output. It's probably the VSCode terminal that makes the location clickable for me.

Are you talking about the diagnostic issues not showing up inline in the IDE editor?

[eiriktsarpalis]

I was referring to this issue: dotnet/runtime#92509. Generally speaking, diagnostics pointing to locations created via Location.Create suffer from issues such as them not being suppressible.