port NodeFilters.SatisfiesAll|Any from XMLUnit.NET

Author: bodewig

RELEASE_NOTES.md

@@ -2,6 +2,11 @@
 
 ## XMLUnit.NET 2.9.2 - /not released, yet/
 
+* added `NodeFilters#SatisfiesAll` and `SatifiesAny` methods to make
+  it easier to combine multiple node filters.
+    added to simplify the use case of
+  [xmlunit/#249](https://github.com/xmlunit/xmlunit/issues/249)
+
 ## XMLUnit.NET 2.9.1 - /Released 2021-12-16/
 
 * improved comparison performance for documents with many siblings

src/main/net-core/Diff/NodeFilters.cs

@@ -12,6 +12,8 @@ the License.  You may obtain a copy of the License at
   limitations under the License.
 */
 
+using System;
+using System.Linq;
 using System.Xml;
 
 namespace Org.XmlUnit.Diff {
@@ -45,5 +47,38 @@ public static bool Default(XmlNode n) {
         public static bool AcceptAll(XmlNode n) {
             return true;
          }
+
+        /// <summary>
+        ///   Accepts nodes that are accepted by all given filters.
+        /// </summary>
+        /// <remarks>
+        ///   <para>
+        ///     This short-circuits the given list of predicates and
+        ///     returns false as soon as the first predicate does.
+        ///   </para>
+        ///   <para>
+        ///     since XMLUnit 2.9.2
+        ///   </para>
+        /// </remarks>
+        public static Predicate<XmlNode> SatifiesAll(params Predicate<XmlNode>[] predicates) {
+            return node => predicates.All(p => p(node));
+        }
+
+        /// <summary>
+        ///   Accepts nodes that are accepted by at least on of the given filters.
+        /// </summary>
+        /// <remarks>
+        ///   <para>
+        ///     This short-circuits the given list of predicates and
+        ///     returns true as soon as the first predicate does.
+        ///   </para>
+        ///   <para>
+        ///     since XMLUnit 2.9.2
+        ///   </para>
+        /// </remarks>
+        public static Predicate<XmlNode> SatifiesAny(params Predicate<XmlNode>[] predicates) {
+            return node => predicates.Any(p => p(node));
+        }
+
     }
 }

src/tests/net-core/Diff/NodeFiltersTest.cs

@@ -0,0 +1,72 @@
+/*
+  This file is licensed to You under the Apache License, Version 2.0
+  (the "License"); you may not use this file except in compliance with
+  the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+using System;
+using System.Xml;
+
+using NUnit.Framework;
+
+namespace Org.XmlUnit.Diff {
+
+    [TestFixture]
+    public class NodeFiltersTest {
+
+        internal class TestFilter {
+            private readonly bool doReturn;
+            internal bool called;
+
+            internal TestFilter(bool ret) {
+                doReturn = ret;
+            }
+
+            public bool Test(XmlNode n) {
+                called = true;
+                return doReturn;
+            }
+        }
+
+
+        [Test]
+        public void EmptySatisfiesAllReturnsTrue() {
+            Assert.IsTrue(NodeFilters.SatifiesAll()(null));
+        }
+
+        [Test]
+        public void EmptySatisfiesAnyReturnsFalse() {
+            Assert.IsFalse(NodeFilters.SatifiesAny()(null));
+        }
+
+        [Test]
+        public void SatisfiesAllWorksAsPromised() {
+            TestFilter n1 = new TestFilter(true);
+            TestFilter n2 = new TestFilter(false);
+            TestFilter n3 = new TestFilter(true);
+            Assert.IsTrue(NodeFilters.SatifiesAll(n1.Test)(null));
+            Assert.IsFalse(NodeFilters.SatifiesAll(n1.Test, n2.Test, n3.Test)(null));
+            Assert.IsFalse(n3.called);
+            Assert.IsTrue(NodeFilters.SatifiesAll(n1.Test, n3.Test)(null));
+        }
+
+        [Test]
+        public void SatisfiesAnyWorksAsPromised() {
+            TestFilter n1 = new TestFilter(false);
+            TestFilter n2 = new TestFilter(true);
+            TestFilter n3 = new TestFilter(false);
+            Assert.IsFalse(NodeFilters.SatifiesAny(n1.Test)(null));
+            Assert.IsTrue(NodeFilters.SatifiesAny(n1.Test, n2.Test, n3.Test)(null));
+            Assert.IsFalse(n3.called);
+            Assert.IsFalse(NodeFilters.SatifiesAny(n1.Test, n3.Test)(null));
+        }
+    }
+}

src/tests/net-core/NetFramework/XMLUnit.Core.Tests.NetFramework.csproj

@@ -81,6 +81,7 @@
     <Compile Include="..\Diff\DOMDifferenceEngineTest.cs" />
     <Compile Include="..\Diff\ElementSelectorsTest.cs" />
     <Compile Include="..\Diff\MultiLevelByNameAndTextSelectorTest.cs" />
+    <Compile Include="..\Diff\NodeFiltersTest.cs" />
     <Compile Include="..\Diff\RecursiveXPathBuilderTest.cs" />
     <Compile Include="..\Diff\XPathContextTest.cs" />
     <Compile Include="..\Input\CommentLessSourceTest.cs" />