/// <summary>
/// Match enough of the 'What' properties of two ExtractedResults (Guid, Fingerprints, PartialFingerprints, Snippets, Message, Properties).
/// A match in high-confidence identity properties is a match (Guid, Fingerprint, >= 50% of PartialFingerprint).
/// A non-match in high-confidence identity properties is a non-match (Fingerprint, 0% of PartialFingerprints, Properties).
/// Otherwise, Results match if Message and first Snippet match.
/// </summary>
/// <param name="other">ExtractedResult to match</param>
/// <returns>True if *any* 'What' property matches, False otherwise</returns>
public bool MatchesAnyWhat(ExtractedResult other)
{
return(WhatComparer.MatchesWhat(this, other));
}
public void WhatComparer_Basics()
{
Result left = new Result {
RuleId = "Rule1", Message = new Message()
{
Text = "One"
}
};
Result right = new Result {
RuleId = "Rule1", Message = new Message()
{
Text = "Two"
}
};
ExtractedResult eLeft = new ExtractedResult(left, null);
ExtractedResult eRight = new ExtractedResult(right, null);
// GUIDs
// =====
string g1 = Guid.NewGuid().ToString(), g2 = Guid.NewGuid().ToString();
// Match if Guids match.
left.Guid = g1;
right.Guid = g1;
WhatComparer.MatchesWhat(eLeft, eRight).Should().BeTrue();
// Don't match without Guids.
right.Guid = g2;
WhatComparer.MatchesWhat(eLeft, eRight).Should().BeFalse();
left.Guid = null;
right.Guid = null;
// Fingerprints
// ============
left.Fingerprints = new Dictionary <string, string>
{
["First"] = "0001",
["Second"] = "1001"
};
right.Fingerprints = new Dictionary <string, string>
{
["First"] = "0002",
["Second"] = "1002"
};
// Don't match if no fingerprints match.
WhatComparer.MatchesWhat(eLeft, eRight).Should().BeFalse();
// Match if any fingerprint matches.
right.Fingerprints["Second"] = "1001";
WhatComparer.MatchesWhat(eLeft, eRight).Should().BeTrue();
// Don't match if fingerprints with different names have the same value.
right.Fingerprints["Second"] = "0001";
WhatComparer.MatchesWhat(eLeft, eRight).Should().BeFalse();
// Handle different fingerprint names smoothly.
right.Fingerprints["Third"] = "2002";
WhatComparer.MatchesWhat(eLeft, eRight).Should().BeFalse();
left.Fingerprints = null;
right.Fingerprints = null;
// PartialFingerprints
// ===================
left.PartialFingerprints = new Dictionary <string, string>();
right.PartialFingerprints = new Dictionary <string, string>();
// Don't match with no matches.
left.PartialFingerprints["First"] = "0001";
right.PartialFingerprints["First"] = "1001";
WhatComparer.MatchesWhat(eLeft, eRight).Should().BeFalse();
// Match if only one matches.
right.PartialFingerprints["First"] = "0001";
WhatComparer.MatchesWhat(eLeft, eRight).Should().BeTrue();
// Match if one of two (50%) match.
left.PartialFingerprints["Second"] = "0002";
right.PartialFingerprints["Second"] = "1002";
WhatComparer.MatchesWhat(eLeft, eRight).Should().BeTrue();
// Don't match if one of three (under 50%) match.
left.PartialFingerprints["Third"] = "0003";
right.PartialFingerprints["Third"] = "1003";
WhatComparer.MatchesWhat(eLeft, eRight).Should().BeFalse();
// Match for two of four matches
left.PartialFingerprints["Fourth"] = "0004";
right.PartialFingerprints["Fourth"] = "0004";
WhatComparer.MatchesWhat(eLeft, eRight).Should().BeTrue();
// Don't match when names are different
left.PartialFingerprints["Fifth_Left"] = "0005";
right.PartialFingerprints["Fifth_Right"] = "0005";
WhatComparer.MatchesWhat(eLeft, eRight).Should().BeFalse();
left.PartialFingerprints = null;
right.PartialFingerprints = null;
// Fallback
// ========
// Don't match via fallback (Message doesn't match).
WhatComparer.MatchesWhat(eLeft, eRight).Should().BeFalse();
// Verify match if messages match.
right.Message.Text = "One";
WhatComparer.MatchesWhat(eLeft, eRight).Should().BeTrue();
// Verify no match if not enough matching Properties.
// Don't match if the only Property is a non-match.
left.SetProperty("First", "0001");
right.SetProperty("First", "1001");
WhatComparer.MatchesWhat(eLeft, eRight).Should().BeFalse();
// Match if only one matches.
right.SetProperty("First", "0001");
WhatComparer.MatchesWhat(eLeft, eRight).Should().BeTrue();
// Match if one of two (50%) matches.
left.SetProperty("Second", "0002");
right.SetProperty("Second", "1002");
WhatComparer.MatchesWhat(eLeft, eRight).Should().BeTrue();
// Don't match if one of three (under 50%) match.
left.SetProperty("Third", "0003");
right.SetProperty("Third", "1003");
WhatComparer.MatchesWhat(eLeft, eRight).Should().BeFalse();
// Match for two of four matches.
left.SetProperty("Fourth", "0004");
right.SetProperty("Fourth", "0004");
WhatComparer.MatchesWhat(eLeft, eRight).Should().BeTrue();
// Don't match when names are different.
left.SetProperty("Fifth_Left", "0005");
right.SetProperty("Fifth_Right", "0005");
WhatComparer.MatchesWhat(eLeft, eRight).Should().BeFalse();
// Match when non-string properties are equal.
left.SetProperty("Date", new DateTime(2019, 6, 21));
right.SetProperty("Date", new DateTime(2019, 6, 21));
WhatComparer.MatchesWhat(eLeft, eRight).Should().BeTrue();
// Don't match when non-string properties are different.
left.SetProperty("Date2", new DateTime(2019, 6, 21));
right.SetProperty("Date2", new DateTime(2019, 6, 22));
WhatComparer.MatchesWhat(eLeft, eRight).Should().BeFalse();
left.Properties.Clear();
right.Properties.Clear();
WhatComparer.MatchesWhat(eLeft, eRight).Should().BeTrue();
// Verify snippets must also match.
Location location = new Location
{
PhysicalLocation = new PhysicalLocation
{
Region = new Region
{
Snippet = new ArtifactContent {
Text = "Sample"
}
}
}
};
left.Locations = new List <Location> {
location
};
right.Locations = new List <Location> {
location.DeepClone()
};
WhatComparer.MatchesWhat(eLeft, eRight).Should().BeTrue();
right.Locations[0].PhysicalLocation.Region.Snippet.Text = "NewSample";
WhatComparer.MatchesWhat(eLeft, eRight).Should().BeFalse();
}
/// <summary>
/// Match enough of the 'What' properties of two ExtractedResults (Guid, Fingerprints, PartialFingerprints, Snippets, Message, Properties).
/// A match in high-confidence identity properties is a match (Guid, Fingerprint, >= 50% of PartialFingerprint).
/// A non-match in high-confidence identity properties is a non-match (Fingerprint, 0% of PartialFingerprints, Properties).
/// Otherwise, Results match if Message and first Snippet match.
/// </summary>
/// <param name="other">ExtractedResult to match</param>
/// <param name="trustMap">TrustMap for either Run being compared, to weight attributes selectively</param>
/// <returns>True if *any* 'What' property matches, False otherwise</returns>
internal bool MatchesAnyWhat(ExtractedResult other, TrustMap trustMap)
{
return(WhatComparer.MatchesWhat(this, other, trustMap));
}
