Make ShingleBased.GetProfile public to match upstream, update documentation and add unit test for Cosine similarity. #21

Author: paulirwin

README.md

@@ -365,11 +365,11 @@ public class Program
         var cosine = new Cosine(2);
 
         // For cosine similarity I need the profile of strings
-        StringProfile profile1 = cosine.GetProfile(s1);
-        StringProfile profile2 = cosine.GetProfile(s2);
+        var profile1 = cosine.GetProfile(s1);
+        var profile2 = cosine.GetProfile(s2);
 
         // Prints 0.516185
-        Console.WriteLine(profile1.CosineSimilarity(profile2));
+        Console.WriteLine(cosine.Similarity(profile1, profile2));
     }
 }
 ```

src/F23.StringSimilarity/ShingleBased.cs

@@ -59,7 +59,7 @@ protected ShingleBased(int k)
 
         protected ShingleBased() : this(DEFAULT_K) { }
 
-        protected IDictionary<string, int> GetProfile(string s)
+        public IDictionary<string, int> GetProfile(string s)
         {
             var shingles = new Dictionary<string, int>();
 

test/F23.StringSimilarity.Tests/CosineTest.cs

@@ -22,21 +22,31 @@
  * THE SOFTWARE.
  */
 
+using System;
 using System.CodeDom;
 using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
+using System.Globalization;
 using System.IO;
 using System.Reflection;
 using System.Threading.Tasks;
 using F23.StringSimilarity.Tests.TestUtil;
 using Xunit;
+using Xunit.Abstractions;
 
 namespace F23.StringSimilarity.Tests
 {
     [SuppressMessage("ReSharper", "ArgumentsStyleLiteral")]
     [SuppressMessage("ReSharper", "ArgumentsStyleNamedExpression")]
     public class CosineTest
     {
+        private readonly ITestOutputHelper _testOutputHelper;
+
+        public CosineTest(ITestOutputHelper testOutputHelper)
+        {
+            _testOutputHelper = testOutputHelper;
+        }
+
         [Fact]
         public void TestSimilarity()
         {
@@ -94,6 +104,23 @@ public void TestDistance()
             // TODO: regular (non-null/empty) distance tests
         }
 
+        [Fact]
+        public void DocumentationExampleTest()
+        {
+            string s1 = "My first string";
+            string s2 = "My other string...";
+
+            // Let's work with sequences of 2 characters...
+            var cosine = new Cosine(2);
+
+            // For cosine similarity I need the profile of strings
+            var profile1 = cosine.GetProfile(s1);
+            var profile2 = cosine.GetProfile(s2);
+
+            // Prints 0.516185
+            Assert.Equal(0.516185, cosine.Similarity(profile1, profile2), 6);
+        }
+
         private static async Task<string> ReadResourceFileAsync(string file)
         {
             var assembly = Assembly.GetExecutingAssembly();