mcs/class/monodoc/Test/Monodoc/HelpSourceTests.cs

   1 using System;
   2 using System.IO;
   3 using System.Linq;
   4 using System.Collections.Generic;
   5
   6 using NUnit.Framework;
   7
   8 using Monodoc;
   9 using Monodoc.Generators;
  10
  11 using HtmlAgilityPack;
  12
  13 namespace MonoTests.Monodoc
  14 {
  15         [TestFixture]
  16         public class HelpSourceTest
  17         {
  18                 const string BaseDir = "../../class/monodoc/Test/monodoc_test/";
  19
  20                 class CheckGenerator : IDocGenerator<bool>
  21                 {
  22                         public string LastCheckMessage { get; set; }
  23
  24                         public bool Generate (HelpSource hs, string id, Dictionary<string, string> context)
  25                         {
  26                                 LastCheckMessage = string.Format ("#1 : {0} {1}", hs, id);
  27                                 if (hs == null || string.IsNullOrEmpty (id))
  28                                         return false;
  29
  30                                 // Stripe the arguments parts since we don't need it
  31                                 var argIdx = id.LastIndexOf ('?');
  32                                 if (argIdx != -1)
  33                                         id = id.Substring (0, argIdx);
  34
  35                                 LastCheckMessage = string.Format ("#2 : {0} {1}", hs, id);
  36                                 if (hs.IsRawContent (id))
  37                                         return hs.GetText (id) != null;
  38
  39                                 IEnumerable<string> parts;
  40                                 if (hs.IsMultiPart (id, out parts)) {
  41                                         LastCheckMessage = string.Format ("#4 : {0} {1} ({2})", hs, id, string.Join (", ", parts));
  42                                         foreach (var partId in parts)
  43                                                 if (!Generate (hs, partId, context))
  44                                                         return false;
  45                                 }
  46
  47                                 LastCheckMessage = string.Format ("#3 : {0} {1}", hs, id);
  48                                 if (hs.IsGeneratedContent (id))
  49                                         return hs.GetCachedText (id) != null;
  50                                 else {
  51                                         var s = hs.GetCachedHelpStream (id);
  52                                         if (s != null) {
  53                                                 s.Close ();
  54                                                 return true;
  55                                         } else {
  56                                                 return false;
  57                                         }
  58                                 }
  59                         }
  60                 }
  61
  62                 /* This test verifies that for every node in our tree that possed a PublicUrl,
  63                  * we can correctly access it back through RenderUrl
  64                  */
  65                 [Test]
  66                 public void ReachabilityTest ()
  67                 {
  68                         var rootTree = RootTree.LoadTree (Path.GetFullPath (BaseDir), false);
  69                         Node result;
  70                         var generator = new CheckGenerator ();
  71                         int errorCount = 0;
  72                         int testCount = 0;
  73
  74                         foreach (var leaf in GetLeaves (rootTree.RootNode)) {
  75                                 if (!rootTree.RenderUrl (leaf.PublicUrl, generator, out result) || leaf != result) {
  76                                         Console.WriteLine ("Error: {0} with HelpSource {1} ", leaf.PublicUrl, leaf.Tree.HelpSource.Name);
  77                                         errorCount++;
  78                                 }
  79                                 testCount++;
  80                         }
  81
  82                         //Assert.AreEqual (0, errorCount, errorCount + " / " + testCount.ToString ());
  83
  84                         // HACK: in reality we have currently 4 known issues which are due to duplicated namespaces across
  85                         // doc sources, something that was never supported and that we need to improve/fix at some stage
  86                         Assert.LessOrEqual (4, errorCount, errorCount + " / " + testCount.ToString ());
  87                 }
  88
  89                 IEnumerable<Node> GetLeaves (Node node)
  90                 {
  91                         if (node == null)
  92                                 yield break;
  93
  94                         if (node.IsLeaf)
  95                                 yield return node;
  96                         else {
  97                                 foreach (var child in node.ChildNodes) {
  98                                         if (!string.IsNullOrEmpty (child.Element) && !child.Element.StartsWith ("root:/"))
  99                                                 yield return child;
 100                                         foreach (var childLeaf in GetLeaves (child))
 101                                                 yield return childLeaf;
 102                                 }
 103                         }
 104                 }
 105
 106                 [Test]
 107                 public void ReachabilityWithShortGenericNotationTest ()
 108                 {
 109                         var rootTree = RootTree.LoadTree (Path.GetFullPath (BaseDir), false);
 110                         Node result;
 111                         var generator = new CheckGenerator ();
 112
 113                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Collections.Concurrent.IProducerConsumerCollection`1", generator, out result), "#1");
 114                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Collections.Generic.Dictionary`2", generator, out result), "#2");
 115                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Action`4", generator, out result), "#3");
 116                 }
 117
 118                 [Test]
 119                 public void AspNetStyleUrlReachabilityTest ()
 120                 {
 121                         var rootTree = RootTree.LoadTree (Path.GetFullPath (BaseDir), false);
 122                         Node result;
 123                         var generator = new CheckGenerator ();
 124
 125                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Collections.Generic.Dictionary{TKey,TValue}", generator, out result), "#1");
 126                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Action{T1,T2}", generator, out result), "#2");
 127                         Assert.IsTrue (rootTree.RenderUrl ("T:System.EventHandler{TEventArgs}", generator, out result), "#3");
 128                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Func{T1,T2,T3,TResult}", generator, out result), "#4");
 129                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Collections.Generic.Dictionary{TKey,TValue}+ValueCollection", generator, out result), "#5");
 130                         Assert.IsTrue (rootTree.RenderUrl ("T:System.IComparable{T}", generator, out result), "#6");
 131                 }
 132         }
 133 }