Awesome
<img src="/src/icon.png" height="30px"> Verify.AngleSharp
Extends Verify with Html verification utilities via AngleSharp.
See Milestones for release notes.
NuGet package
https://nuget.org/packages/Verify.AngleSharp/
Comparer Usage
Extends Verify to allow comparison of htm and html files via AngleSharp.
Initialize
Call VerifyAngleSharpDiffing.Initialize()
once at assembly load time.
Initialize takes an optional Action<IDiffingStrategyCollection>
to control settings at a global level:
<a id='snippet-Initialize'></a>
[ModuleInitializer]
public static void Init() =>
VerifyAngleSharpDiffing.Initialize();
<sup><a href='/src/Tests/ModuleInitializer.cs#L3-L9' title='Snippet source file'>snippet source</a> | <a href='#snippet-Initialize' title='Start of snippet'>anchor</a></sup>
<!-- endSnippet -->Verify html
Given an existing verified file:
<!-- snippet: Samples.Sample.verified.html --><a id='snippet-Samples.Sample.verified.html'></a>
<!DOCTYPE html>
<html>
<body>
<h1>My First Heading</h1>
<p>My first paragraph.</p>
</body>
</html>
<sup><a href='/src/Tests/Samples.Sample.verified.html#L1-L7' title='Snippet source file'>snippet source</a> | <a href='#snippet-Samples.Sample.verified.html' title='Start of snippet'>anchor</a></sup>
<!-- endSnippet -->And a test:
<!-- snippet: Sample --><a id='snippet-Sample'></a>
[Test]
public Task Sample()
{
var html =
"""
<!DOCTYPE html>
<html>
<body>
<h1>My First Heading</h1>
<p>My first paragraph.</p>
</body>
</html>
""";
return Verify(html, "html");
}
<sup><a href='/src/Tests/Samples.cs#L139-L157' title='Snippet source file'>snippet source</a> | <a href='#snippet-Sample' title='Start of snippet'>anchor</a></sup>
<!-- endSnippet -->Note that the input html differs from the verified html, but not in a semantically significant way. Hence this test will pass.
Diff results
If the comparison fails, the resulting differences will be included in the test result displayed to the user.
For example if, in the above html, <h1>My First Heading</h1>
changes to <h1>First Heading</h1>
then the following will be printed in the test results:
Comparer result:
* Node Diff
Path: h1(0) > #text(0)
Received: First Heading
Verified: My First Heading
Test level settings
Settings can also be controlled for a specific test.
<!-- snippet: CustomOptions --><a id='snippet-CustomOptions'></a>
var settings = new VerifySettings();
settings.AngleSharpDiffingSettings(
action =>
{
static FilterDecision SpanFilter(
in ComparisonSource source,
FilterDecision decision)
{
if (source.Node.NodeName == "SPAN")
{
return FilterDecision.Exclude;
}
return decision;
}
var options = action.AddDefaultOptions();
options.AddFilter(SpanFilter);
});
<sup><a href='/src/Tests/Samples.cs#L162-L184' title='Snippet source file'>snippet source</a> | <a href='#snippet-CustomOptions' title='Start of snippet'>anchor</a></sup>
<!-- endSnippet -->Global settings
<!-- snippet: CustomOptionsGlobal --><a id='snippet-CustomOptionsGlobal'></a>
VerifyAngleSharpDiffing.Initialize(
action =>
{
static FilterDecision SpanFilter(
in ComparisonSource source,
FilterDecision decision)
{
if (source.Node.NodeName == "SPAN")
{
return FilterDecision.Exclude;
}
return decision;
}
var options = action.AddDefaultOptions();
options.AddFilter(SpanFilter);
});
<sup><a href='/src/Tests/Samples.cs#L200-L220' title='Snippet source file'>snippet source</a> | <a href='#snippet-CustomOptionsGlobal' title='Start of snippet'>anchor</a></sup>
<!-- endSnippet -->Pretty Print
Html can be pretty printed.
<!-- snippet: PrettyPrintHtml --><a id='snippet-PrettyPrintHtml'></a>
[Test]
public Task PrettyPrintHtml()
{
var html = """
<!DOCTYPE html>
<html><body><h1>My First Heading</h1>
<p>My first paragraph.</p></body></html>
""";
return Verify(html, "html")
.PrettyPrintHtml();
}
<sup><a href='/src/Tests/Samples.cs#L4-L18' title='Snippet source file'>snippet source</a> | <a href='#snippet-PrettyPrintHtml' title='Start of snippet'>anchor</a></sup>
<!-- endSnippet -->Results in
<!-- snippet: Samples.PrettyPrintHtml.verified.html --><a id='snippet-Samples.PrettyPrintHtml.verified.html'></a>
<!DOCTYPE html>
<html>
<head></head>
<body>
<h1>My First Heading</h1>
<p>My first paragraph.</p>
</body>
</html>
<sup><a href='/src/Tests/Samples.PrettyPrintHtml.verified.html#L1-L8' title='Snippet source file'>snippet source</a> | <a href='#snippet-Samples.PrettyPrintHtml.verified.html' title='Start of snippet'>anchor</a></sup>
<!-- endSnippet -->To apply this to all html
files use HtmlPrettyPrint.All();
Manipulate Html
Nodes can be manipulated as part of the pretty print:
<!-- snippet: PrettyPrintHtmlWithNodeManipulation --><a id='snippet-PrettyPrintHtmlWithNodeManipulation'></a>
[Test]
public Task PrettyPrintHtmlWithNodeManipulation()
{
var html = """
<!DOCTYPE html>
<html>
<body>
<h1>My First Heading</h1>
<p>My first paragraph.</p>
</body>
</html>
""";
return Verify(html, "html")
.PrettyPrintHtml(
nodes =>
{
foreach (var node in nodes.QuerySelectorAll("h1"))
{
node.Remove();
}
});
}
<sup><a href='/src/Tests/Samples.cs#L87-L112' title='Snippet source file'>snippet source</a> | <a href='#snippet-PrettyPrintHtmlWithNodeManipulation' title='Start of snippet'>anchor</a></sup>
<!-- endSnippet -->Results in
<!-- snippet: Samples.PrettyPrintHtmlWithNodeManipulation.verified.html --><a id='snippet-Samples.PrettyPrintHtmlWithNodeManipulation.verified.html'></a>
<!DOCTYPE html>
<html>
<head></head>
<body>
<p>My first paragraph.</p>
</body>
</html>
<sup><a href='/src/Tests/Samples.PrettyPrintHtmlWithNodeManipulation.verified.html#L1-L7' title='Snippet source file'>snippet source</a> | <a href='#snippet-Samples.PrettyPrintHtmlWithNodeManipulation.verified.html' title='Start of snippet'>anchor</a></sup>
<!-- endSnippet -->AngleSharp helpers
ScrubEmptyDivs
<!-- snippet: ScrubEmptyDivs --><a id='snippet-ScrubEmptyDivs'></a>
[Test]
public Task ScrubEmptyDivs()
{
var html = """
<!DOCTYPE html>
<html>
<body>
<div>My First Heading</div>
<div></div>
</body>
</html>
""";
return Verify(html, "html")
.PrettyPrintHtml(nodes => nodes.ScrubEmptyDivs());
}
<sup><a href='/src/Tests/Samples.cs#L20-L38' title='Snippet source file'>snippet source</a> | <a href='#snippet-ScrubEmptyDivs' title='Start of snippet'>anchor</a></sup>
<!-- endSnippet -->Results in:
<!-- snippet: Samples.ScrubEmptyDivs.verified.html --><a id='snippet-Samples.ScrubEmptyDivs.verified.html'></a>
<!DOCTYPE html>
<html>
<head></head>
<body>
<div>My First Heading</div>
</body>
</html>
<sup><a href='/src/Tests/Samples.ScrubEmptyDivs.verified.html#L1-L7' title='Snippet source file'>snippet source</a> | <a href='#snippet-Samples.ScrubEmptyDivs.verified.html' title='Start of snippet'>anchor</a></sup>
<!-- endSnippet -->ScrubAttributes
Removal
<!-- snippet: ScrubAttributes --><a id='snippet-ScrubAttributes'></a>
[Test]
public Task ScrubAttributes()
{
var html = """
<!DOCTYPE html>
<html>
<body>
<div id='a'>My First Heading</div>
</body>
</html>
""";
return Verify(html, "html")
.PrettyPrintHtml(nodes => nodes.ScrubAttributes("id"));
}
<sup><a href='/src/Tests/Samples.cs#L40-L57' title='Snippet source file'>snippet source</a> | <a href='#snippet-ScrubAttributes' title='Start of snippet'>anchor</a></sup>
<!-- endSnippet -->Results in:
<!-- snippet: Samples.ScrubAttributes.verified.html --><a id='snippet-Samples.ScrubAttributes.verified.html'></a>
<!DOCTYPE html>
<html>
<head></head>
<body>
<div>My First Heading</div>
</body>
</html>
<sup><a href='/src/Tests/Samples.ScrubAttributes.verified.html#L1-L7' title='Snippet source file'>snippet source</a> | <a href='#snippet-Samples.ScrubAttributes.verified.html' title='Start of snippet'>anchor</a></sup>
<!-- endSnippet -->Replace Value
<!-- snippet: ScrubAttributeWithNewValue --><a id='snippet-ScrubAttributeWithNewValue'></a>
[Test]
public Task ScrubAttributeWithNewValue()
{
var html = """
<!DOCTYPE html>
<html>
<body>
<div id='a'>My First Heading</div>
</body>
</html>
""";
return Verify(html, "html")
.PrettyPrintHtml(
nodes => nodes.ScrubAttributes(x =>
{
if (x.Name == "id")
{
return "new value";
}
return null;
}));
}
<sup><a href='/src/Tests/Samples.cs#L59-L85' title='Snippet source file'>snippet source</a> | <a href='#snippet-ScrubAttributeWithNewValue' title='Start of snippet'>anchor</a></sup>
<!-- endSnippet -->Results in:
<!-- snippet: Samples.ScrubAttributeWithNewValue.verified.html --><a id='snippet-Samples.ScrubAttributeWithNewValue.verified.html'></a>
<!DOCTYPE html>
<html>
<head></head>
<body>
<div id="new value">My First Heading</div>
</body>
</html>
<sup><a href='/src/Tests/Samples.ScrubAttributeWithNewValue.verified.html#L1-L7' title='Snippet source file'>snippet source</a> | <a href='#snippet-Samples.ScrubAttributeWithNewValue.verified.html' title='Start of snippet'>anchor</a></sup>
<!-- endSnippet -->