Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

LVA: Add CfgSerializer.RoslynLvaWalker #9529

Merged
merged 4 commits into from
Jul 18, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -21,161 +21,160 @@
using System.Text;
using SonarAnalyzer.CFG.Roslyn;

namespace SonarAnalyzer.CFG
namespace SonarAnalyzer.CFG;

public static partial class CfgSerializer
{
public partial class CfgSerializer
private class RoslynCfgWalker
{
private class RoslynCfgWalker
protected readonly DotWriter writer;
private readonly HashSet<BasicBlock> visited = [];
private readonly RoslynCfgIdProvider cfgIdProvider;
private readonly int cfgId;

public RoslynCfgWalker(DotWriter writer, RoslynCfgIdProvider cfgIdProvider)
{
private readonly DotWriter writer;
private readonly HashSet<BasicBlock> visited = new();
private readonly RoslynCfgIdProvider cfgIdProvider;
private readonly int cfgId;
this.writer = writer;
this.cfgIdProvider = cfgIdProvider;
cfgId = cfgIdProvider.Next();
}

public RoslynCfgWalker(DotWriter writer, RoslynCfgIdProvider cfgIdProvider)
public void Visit(ControlFlowGraph cfg, string title)
{
writer.WriteGraphStart(title);
VisitContent(cfg, title);
writer.WriteGraphEnd();
}

protected virtual void WriteEdges(BasicBlock block)
{
foreach (var predecessor in block.Predecessors)
{
this.writer = writer;
this.cfgIdProvider = cfgIdProvider;
cfgId = cfgIdProvider.Next();
var condition = string.Empty;
if (predecessor.Source.ConditionKind != ControlFlowConditionKind.None)
{
condition = predecessor == predecessor.Source.ConditionalSuccessor ? predecessor.Source.ConditionKind.ToString() : "Else";
}
var semantics = predecessor.Semantics == ControlFlowBranchSemantics.Regular ? null : predecessor.Semantics.ToString();
writer.WriteEdge(BlockId(predecessor.Source), BlockId(block), $"{semantics} {condition}".Trim());
}

public void Visit(ControlFlowGraph cfg, string title)
if (block.FallThroughSuccessor is { Destination: null })
{
writer.WriteGraphStart(title);
VisitContent(cfg, title);
writer.WriteGraphEnd();
writer.WriteEdge(BlockId(block), "NoDestination_" + BlockId(block), block.FallThroughSuccessor.Semantics.ToString());
}
}

protected string BlockId(BasicBlock block) =>
$"cfg{cfgId}_block{block.Ordinal}";

private void VisitSubGraph(ControlFlowGraph cfg, string title)
{
writer.WriteSubGraphStart(cfgIdProvider.Next(), title);
VisitContent(cfg, title);
writer.WriteSubGraphEnd();
}

private void VisitSubGraph(ControlFlowGraph cfg, string title)
private void VisitContent(ControlFlowGraph cfg, string titlePrefix)
{
foreach (var region in cfg.Root.NestedRegions)
{
writer.WriteSubGraphStart(cfgIdProvider.Next(), title);
VisitContent(cfg, title);
writer.WriteSubGraphEnd();
Visit(cfg, region);
}

private void VisitContent(ControlFlowGraph cfg, string titlePrefix)
foreach (var block in cfg.Blocks.Where(x => !visited.Contains(x)).ToArray())
{
foreach (var region in cfg.Root.NestedRegions)
{
Visit(cfg, region);
}
foreach (var block in cfg.Blocks.Where(x => !visited.Contains(x)).ToArray())
{
Visit(block);
}
foreach (var localFunction in cfg.LocalFunctions)
{
var localFunctionCfg = cfg.GetLocalFunctionControlFlowGraph(localFunction, default);
new RoslynCfgWalker(writer, cfgIdProvider).VisitSubGraph(localFunctionCfg, $"{titlePrefix}.{localFunction.Name}");
}
foreach (var anonymousFunction in AnonymousFunctions(cfg))
{
var anonymousFunctionCfg = cfg.GetAnonymousFunctionControlFlowGraph(anonymousFunction, default);
new RoslynCfgWalker(writer, cfgIdProvider).VisitSubGraph(anonymousFunctionCfg, $"{titlePrefix}.anonymous");
}
Visit(block);
}

private void Visit(ControlFlowGraph cfg, ControlFlowRegion region)
foreach (var localFunction in cfg.LocalFunctions)
{
writer.WriteSubGraphStart(cfgIdProvider.Next(), SerializeRegion(region));
foreach (var nested in region.NestedRegions)
{
Visit(cfg, nested);
}
foreach (var block in cfg.Blocks.Where(x => x.EnclosingRegion == region))
{
Visit(block);
}
writer.WriteSubGraphEnd();
var localFunctionCfg = cfg.GetLocalFunctionControlFlowGraph(localFunction, default);
new RoslynCfgWalker(writer, cfgIdProvider).VisitSubGraph(localFunctionCfg, $"{titlePrefix}.{localFunction.Name}");
}

private void Visit(BasicBlock block)
foreach (var anonymousFunction in AnonymousFunctions(cfg))
{
visited.Add(block);
WriteNode(block);
WriteEdges(block);
var anonymousFunctionCfg = cfg.GetAnonymousFunctionControlFlowGraph(anonymousFunction, default);
new RoslynCfgWalker(writer, cfgIdProvider).VisitSubGraph(anonymousFunctionCfg, $"{titlePrefix}.anonymous");
}
}

private void WriteNode(BasicBlock block)
private void Visit(ControlFlowGraph cfg, ControlFlowRegion region)
{
writer.WriteSubGraphStart(cfgIdProvider.Next(), SerializeRegion(region));
foreach (var nested in region.NestedRegions)
{
var header = block.Kind.ToString().ToUpperInvariant() + " #" + block.Ordinal;
writer.WriteNode(BlockId(block), header, block.Operations.SelectMany(SerializeOperation).Concat(SerializeBranchValue(block.BranchValue)).ToArray());
Visit(cfg, nested);
}
foreach (var block in cfg.Blocks.Where(x => x.EnclosingRegion == region))
{
Visit(block);
}
writer.WriteSubGraphEnd();
}

private static IEnumerable<string> SerializeBranchValue(IOperation operation) =>
operation == null ? Enumerable.Empty<string>() : new[] { "## BranchValue ##" }.Concat(SerializeOperation(operation));
private void Visit(BasicBlock block)
{
visited.Add(block);
WriteNode(block);
WriteEdges(block);
}

private static IEnumerable<string> SerializeOperation(IOperation operation) =>
SerializeOperation(0, null, operation).Concat(new[] { "##########" });
private void WriteNode(BasicBlock block)
{
var header = block.Kind.ToString().ToUpperInvariant() + " #" + block.Ordinal;
writer.WriteNode(BlockId(block), header, block.Operations.SelectMany(SerializeOperation).Concat(SerializeBranchValue(block.BranchValue)).ToArray());
}

private static IEnumerable<string> SerializeBranchValue(IOperation operation) =>
operation is null ? [] : new[] { "## BranchValue ##" }.Concat(SerializeOperation(operation));

private static IEnumerable<string> SerializeOperation(int level, string prefix, IOperation operation)
private static IEnumerable<string> SerializeOperation(IOperation operation) =>
SerializeOperation(0, null, operation).Concat(new[] { "##########" });

private static IEnumerable<string> SerializeOperation(int level, string prefix, IOperation operation)
{
var prefixes = operation.GetType().GetProperties()
.GroupBy(x => x.GetValue(operation) as IOperation, x => x.Name)
.Where(x => x.Key is not null)
.ToDictionary(x => x.Key, x => string.Join(", ", x));
var ret = new List<string> { $"{level}#: {prefix}{operation.Serialize()}" };
foreach (var child in operation.ToSonar().Children)
{
var prefixes = operation.GetType().GetProperties()
.GroupBy(x => x.GetValue(operation) as IOperation, pi => pi.Name)
.Where(x => x.Key is not null)
.ToDictionary(x => x.Key, x => string.Join(", ", x));
var ret = new List<string> { $"{level}#: {prefix}{operation.Serialize()}" };
foreach (var child in operation.ToSonar().Children)
{
ret.AddRange(SerializeOperation(level + 1, prefixes.TryGetValue(child, out var childPrefix) ? $"{level}#.{childPrefix}: " : null, child));
}
return ret;
ret.AddRange(SerializeOperation(level + 1, prefixes.TryGetValue(child, out var childPrefix) ? $"{level}#.{childPrefix}: " : null, child));
}
return ret;
}

private static string SerializeRegion(ControlFlowRegion region)
private static string SerializeRegion(ControlFlowRegion region)
{
var sb = new StringBuilder();
sb.Append(region.Kind.ToString()).Append(" region");
if (region.ExceptionType is not null)
{
var sb = new StringBuilder();
sb.Append(region.Kind.ToString()).Append(" region");
if (region.ExceptionType is not null)
{
sb.Append(": ").Append(region.ExceptionType);
}
if (region.Locals.Any())
{
sb.Append(", Locals: ").Append(string.Join(", ", region.Locals.Select(x => x.Name ?? "N/A")));
}
if (region.CaptureIds.Any())
{
sb.Append(", Captures: ").Append(string.Join(", ", region.CaptureIds.Select(x => x.Serialize()))); // Same as IOperationExtension.SerializeSuffix
}
return sb.ToString();
sb.Append(": ").Append(region.ExceptionType);
}

private void WriteEdges(BasicBlock block)
if (region.Locals.Any())
{
foreach (var predecessor in block.Predecessors)
{
var condition = string.Empty;
if (predecessor.Source.ConditionKind != ControlFlowConditionKind.None)
{
condition = predecessor == predecessor.Source.ConditionalSuccessor ? predecessor.Source.ConditionKind.ToString() : "Else";
}
var semantics = predecessor.Semantics == ControlFlowBranchSemantics.Regular ? null : predecessor.Semantics.ToString();
writer.WriteEdge(BlockId(predecessor.Source), BlockId(block), $"{semantics} {condition}".Trim());
}
if (block.FallThroughSuccessor is { Destination: null })
{
writer.WriteEdge(BlockId(block), "NoDestination_" + BlockId(block), block.FallThroughSuccessor.Semantics.ToString());
}
sb.Append(", Locals: ").Append(string.Join(", ", region.Locals.Select(x => x.Name ?? "N/A")));
}

private string BlockId(BasicBlock block) =>
$"cfg{cfgId}_block{block.Ordinal}";

private static IEnumerable<IFlowAnonymousFunctionOperationWrapper> AnonymousFunctions(ControlFlowGraph cfg) =>
cfg.Blocks
.SelectMany(x => x.Operations)
.Concat(cfg.Blocks.Select(x => x.BranchValue).Where(x => x != null))
.SelectMany(x => x.DescendantsAndSelf())
.Where(IFlowAnonymousFunctionOperationWrapper.IsInstance)
.Select(IFlowAnonymousFunctionOperationWrapper.FromOperation);
if (region.CaptureIds.Any())
{
sb.Append(", Captures: ").Append(string.Join(", ", region.CaptureIds.Select(x => x.Serialize()))); // Same as IOperationExtension.SerializeSuffix
}
return sb.ToString();
}

private class RoslynCfgIdProvider
{
private int value;
private static IEnumerable<IFlowAnonymousFunctionOperationWrapper> AnonymousFunctions(ControlFlowGraph cfg) =>
cfg.Blocks
.SelectMany(x => x.Operations)
.Concat(cfg.Blocks.Select(x => x.BranchValue).Where(x => x is not null))
.SelectMany(x => x.DescendantsAndSelf())
.Where(IFlowAnonymousFunctionOperationWrapper.IsInstance)
.Select(IFlowAnonymousFunctionOperationWrapper.FromOperation);
}

public int Next() => value++;
}
private sealed class RoslynCfgIdProvider
{
private int value;

public int Next() => value++;
}
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
/*
* SonarAnalyzer for .NET
* Copyright (C) 2015-2024 SonarSource SA
* mailto: contact AT sonarsource DOT com
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 3 of the License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program; if not, write to the Free Software Foundation,
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/

using SonarAnalyzer.CFG.LiveVariableAnalysis;
using SonarAnalyzer.CFG.Roslyn;

namespace SonarAnalyzer.CFG;

public static partial class CfgSerializer
{
private sealed class RoslynLvaWalker : RoslynCfgWalker
{
private readonly RoslynLiveVariableAnalysis lva;

public RoslynLvaWalker(RoslynLiveVariableAnalysis lva, DotWriter writer, RoslynCfgIdProvider cfgIdProvider) : base(writer, cfgIdProvider)
{
this.lva = lva;
}

protected override void WriteEdges(BasicBlock block)
{
foreach (var predecessor in lva.BlockPredecessors[block.Ordinal].Where(x => !block.Predecessors.Any(y => y.Source == x)))
{
writer.WriteEdge(BlockId(predecessor), BlockId(block), "LVA");
}
base.WriteEdges(block);
}
}
}
Loading
Loading