Merge pull request #471 from baynezy/release/7.0.1.9

Release version 7.0.1.9

CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [7.0.1.9] - 2024-09-06
+
+### Added
+
+- Added support extending existing Schemes for customisation
+
 ## [7.0.0.8] - 2024-08-15
 
 ### Added
@@ -485,7 +491,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [0.0.1] - 2013-07-04
 
-[unreleased]: https://github.com/baynezy/Html2Markdown/compare/7.0.0.8...HEAD
+[unreleased]: https://github.com/baynezy/Html2Markdown/compare/7.0.1.9...HEAD
+[7.0.1.9]: https://github.com/baynezy/Html2Markdown/compare/7.0.0.8...7.0.1.9
 [7.0.0.8]: https://github.com/baynezy/Html2Markdown/compare/6.2.5.7...7.0.0.8
 [6.2.5.7]: https://github.com/baynezy/Html2Markdown/compare/6.2.4.6...6.2.5.7
 [6.2.4.6]: https://github.com/baynezy/Html2Markdown/compare/6.2.3.6...6.2.4.6

semver.json

@@ -1 +1 @@
-{"major":"7","minor":"0","patch":"0","build":"8"}
+{"major":"7","minor":"0","patch":"1","build":"9"}

src/Html2Markdown/Html2Markdown.csproj

@@ -15,7 +15,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="HtmlAgilityPack" Version="1.11.63" />
+    <PackageReference Include="HtmlAgilityPack" Version="1.11.65" />
     <PackageReference Include="JetBrains.Annotations" Version="2024.2.0" />
   </ItemGroup>
 

src/Html2Markdown/Scheme/AbstractScheme.cs

@@ -6,7 +6,7 @@ namespace Html2Markdown.Scheme;
 /// A group of IReplacer to deal with converting HTML entities.
 /// </summary>
 public abstract class AbstractScheme : IScheme {
-    
+
     /// <summary>
     /// The collection of IReplacer instances used for replacements.
     /// </summary>
@@ -30,4 +30,13 @@ public IList<IReplacer> Replacers()
     {
         return ReplacerCollection;
     }
+
+    /// <summary>
+    /// Adds a single replacer to the collection.
+    /// </summary>
+    /// <param name="replacer">The replacer to add.</param>
+    public void AddReplacer(IReplacer replacer)
+    {
+        ReplacerCollection.Add(replacer);
+    }
 }

test/Html2Markdown.Test/Html2Markdown.Test.csproj

@@ -6,10 +6,10 @@
 
   <ItemGroup>
     <PackageReference Include="JunitXml.TestLogger" Version="4.0.254" />
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.10.0" />
-    <PackageReference Include="NUnit" Version="4.1.0" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.11.1" />
+    <PackageReference Include="NUnit" Version="4.2.1" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.6.0" />
-    <PackageReference Include="Verify.NUnit" Version="26.2.0" />
+    <PackageReference Include="Verify.NUnit" Version="26.3.0" />
   </ItemGroup>
 
   <ItemGroup>

test/Html2Markdown.Test/Scheme/AbstractSchemeTests.cs

@@ -0,0 +1,106 @@
+using System.Collections.Generic;
+using Html2Markdown.Replacement;
+using Html2Markdown.Scheme;
+
+namespace Html2Markdown.Test.Scheme;
+
+public class AbstractSchemeTests
+{
+    [Test]
+    public void Replacers_WhenCalled_ReturnsReplacerCollection()
+    {
+        // arrange
+        const int expectedCount = 1;
+        var scheme = new TestScheme();
+
+        // act
+        var replacers = scheme.Replacers();
+
+        // assert
+        Assert.That(replacers.Count, Is.EqualTo(expectedCount));
+    }
+
+    [Test]
+    public void Replacers_WhenCalled_ReturnsReplacerCollectionWithTestReplacer()
+    {
+        // arrange
+        var scheme = new TestScheme();
+
+        // act
+        var replacers = scheme.Replacers();
+
+        // assert
+        Assert.That(replacers[0], Is.InstanceOf<TestReplacer>());
+    }
+
+    [Test]
+    public void Replacers_WhenCalled_ReturnsReplacerCollectionWithTestReplacerReplaceMethod()
+    {
+        // arrange
+        const string expected = "test";
+        var scheme = new TestScheme();
+
+        // act
+        var replacers = scheme.Replacers();
+        var result = replacers[0].Replace(string.Empty);
+
+        // assert
+        Assert.That(result, Is.EqualTo(expected));
+    }
+
+    [Test]
+    public void AddReplacer_WhenCalled_AddsReplacerToReplacerCollection()
+    {
+        // arrange
+        const int expectedCount = 2;
+        var scheme = new TestScheme();
+
+        // act
+        scheme.AddReplacer(new TestReplacer());
+        var replacers = scheme.Replacers();
+
+        // assert
+        Assert.That(replacers.Count, Is.EqualTo(expectedCount));
+    }
+
+    [Test]
+    public void AddReplacer_WhenCalled_AddsReplacerToReplacerCollectionWithTestReplacer()
+    {
+        // arrange
+        var scheme = new TestScheme();
+
+        // act
+        scheme.AddReplacer(new TestReplacer());
+        var replacers = scheme.Replacers();
+
+        // assert
+        Assert.That(replacers[1], Is.InstanceOf<TestReplacer>());
+    }
+}
+
+public class TestScheme : AbstractScheme
+{
+    public TestScheme()
+    {
+        AddReplacementGroup(ReplacerCollection, new TestReplacementGroup());
+    }
+}
+
+public class TestReplacementGroup : IReplacementGroup
+{
+    public IEnumerable<IReplacer> Replacers()
+    {
+        return new List<IReplacer>
+        {
+            new TestReplacer()
+        };
+    }
+}
+
+public class TestReplacer : IReplacer
+{
+    public string Replace(string html)
+    {
+        return "test";
+    }
+}