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 // Used by ReachabilityWithCrefsTest
  12 // using HtmlAgilityPack;
  13
  14 namespace MonoTests.Monodoc
  15 {
  16         [TestFixture]
  17         public class HelpSourceTest
  18         {
  19                 const string BaseDir = "../../class/monodoc/Test/monodoc_test/";
  20
  21                 class CheckGenerator : IDocGenerator<bool>
  22                 {
  23                         public string LastCheckMessage { get; set; }
  24
  25                         public bool Generate (HelpSource hs, string id, Dictionary<string, string> context)
  26                         {
  27                                 LastCheckMessage = string.Format ("#1 : {0} {1}", hs, id);
  28                                 if (hs == null || string.IsNullOrEmpty (id))
  29                                         return false;
  30
  31                                 // Stripe the arguments parts since we don't need it
  32                                 var argIdx = id.LastIndexOf ('?');
  33                                 if (argIdx != -1)
  34                                         id = id.Substring (0, argIdx);
  35
  36                                 LastCheckMessage = string.Format ("#2 : {0} {1}", hs, id);
  37                                 if (hs.IsRawContent (id))
  38                                         return hs.GetText (id) != null;
  39
  40                                 IEnumerable<string> parts;
  41                                 if (hs.IsMultiPart (id, out parts)) {
  42                                         LastCheckMessage = string.Format ("#4 : {0} {1} ({2})", hs, id, string.Join (", ", parts));
  43                                         foreach (var partId in parts)
  44                                                 if (!Generate (hs, partId, context))
  45                                                         return false;
  46                                 }
  47
  48                                 LastCheckMessage = string.Format ("#3 : {0} {1}", hs, id);
  49                                 if (hs.IsGeneratedContent (id))
  50                                         return hs.GetCachedText (id) != null;
  51                                 else {
  52                                         var s = hs.GetCachedHelpStream (id);
  53                                         if (s != null) {
  54                                                 s.Close ();
  55                                                 return true;
  56                                         } else {
  57                                                 return false;
  58                                         }
  59                                 }
  60                         }
  61                 }
  62
  63                 /* This test verifies that for every node in our tree that possed a PublicUrl,
  64                  * we can correctly access it back through RenderUrl
  65                  */
  66                 [Test]
  67                 public void ReachabilityTest ()
  68                 {
  69                         var rootTree = RootTree.LoadTree (Path.GetFullPath (BaseDir), false);
  70                         Node result;
  71                         var generator = new CheckGenerator ();
  72                         int errorCount = 0;
  73                         int testCount = 0;
  74
  75                         foreach (var leaf in GetLeaves (rootTree.RootNode)) {
  76                                 if (!rootTree.RenderUrl (leaf.PublicUrl, generator, out result) || leaf != result) {
  77                                         Console.WriteLine ("Error: {0} with HelpSource {1} ", leaf.PublicUrl, leaf.Tree.HelpSource.Name);
  78                                         errorCount++;
  79                                 }
  80                                 testCount++;
  81                         }
  82
  83                         //Assert.AreEqual (0, errorCount, errorCount + " / " + testCount.ToString ());
  84
  85                         // HACK: in reality we have currently 4 known issues which are due to duplicated namespaces across
  86                         // doc sources, something that was never supported and that we need to improve/fix at some stage
  87                         Assert.LessOrEqual (4, errorCount, errorCount + " / " + testCount.ToString ());
  88                 }
  89
  90                 IEnumerable<Node> GetLeaves (Node node)
  91                 {
  92                         if (node == null)
  93                                 yield break;
  94
  95                         if (node.IsLeaf)
  96                                 yield return node;
  97                         else {
  98                                 foreach (var child in node.ChildNodes) {
  99                                         if (!string.IsNullOrEmpty (child.Element) && !child.Element.StartsWith ("root:/"))
 100                                                 yield return child;
 101                                         foreach (var childLeaf in GetLeaves (child))
 102                                                 yield return childLeaf;
 103                                 }
 104                         }
 105                 }
 106
 107                 [Test]
 108                 public void ReachabilityWithShortGenericNotationTest ()
 109                 {
 110                         var rootTree = RootTree.LoadTree (Path.GetFullPath (BaseDir), false);
 111                         Node result;
 112                         var generator = new CheckGenerator ();
 113
 114                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Collections.Concurrent.IProducerConsumerCollection`1", generator, out result), "#1");
 115                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Collections.Generic.Dictionary`2", generator, out result), "#2");
 116                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Action`4", generator, out result), "#3");
 117                         Assert.IsTrue (rootTree.RenderUrl ("T:System.EventHandler`1", generator, out result), "#4");
 118                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Func`5", generator, out result), "#5a");
 119                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Func`4", generator, out result), "#5b");
 120                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Func`6", generator, out result), "#5c");
 121                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Func`7", generator, out result), "#5d");
 122                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Func`3", generator, out result), "#5e");
 123                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Func`2", generator, out result), "#5f");
 124                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Func`1", generator, out result), "#5g");
 125                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Func`8", generator, out result), "#5h");
 126                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Func`9", generator, out result), "#5i");
 127                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Action`3", generator, out result), "#6a");
 128                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Action`2", generator, out result), "#6b");
 129                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Action`4", generator, out result), "#6c");
 130                         Assert.IsTrue (rootTree.RenderUrl ("T:System.IComparable`1", generator, out result), "#7");
 131                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Lazy`1", generator, out result), "#8");
 132                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Tuple`1", generator, out result), "#9a");
 133                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Tuple`2", generator, out result), "#9b");
 134                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Tuple`3", generator, out result), "#9c");
 135                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Tuple`4", generator, out result), "#9d");
 136                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Collections.Generic.Dictionary`2+ValueCollection", generator, out result), "#10");
 137                         Assert.IsFalse (rootTree.RenderUrl ("T:System.EventHandler`2", generator, out result), "#11");
 138                         Assert.IsFalse (rootTree.RenderUrl ("T:System.Lazy`2", generator, out result), "#12");
 139                 }
 140
 141                 [Test]
 142                 public void AspNetStyleUrlReachabilityTest ()
 143                 {
 144                         var rootTree = RootTree.LoadTree (Path.GetFullPath (BaseDir), false);
 145                         Node result;
 146                         var generator = new CheckGenerator ();
 147
 148                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Collections.Generic.Dictionary{TKey,TValue}", generator, out result), "#1");
 149                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Action{T1,T2}", generator, out result), "#2");
 150                         Assert.IsTrue (rootTree.RenderUrl ("T:System.EventHandler{TEventArgs}", generator, out result), "#3");
 151                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Func{T1,T2,T3,TResult}", generator, out result), "#4");
 152                         Assert.IsTrue (rootTree.RenderUrl ("T:System.Collections.Generic.Dictionary{TKey,TValue}+ValueCollection", generator, out result), "#5");
 153                         Assert.IsTrue (rootTree.RenderUrl ("T:System.IComparable{T}", generator, out result), "#6");
 154                 }
 155
 156                 /*
 157                 [Test, Ignore ("Mono documentation is full of syntax errors so we can't use it reliably for this test")]
 158                 public void ReachabilityWithCrefsTest ()
 159                 {
 160                         var rootTree = RootTree.LoadTree (Path.GetFullPath (BaseDir), false);
 161                         Node result;
 162                         var htmlGenerator = new HtmlGenerator (null);
 163                         var crefs = new HashSet<string> ();
 164                         var generator = new CheckGenerator ();
 165                         int errorCount = 0;
 166
 167                         foreach (var leaf in GetLeaves (rootTree.RootNode)) {
 168                                 Dictionary<string, string> context;
 169                                 string internalId = leaf.Tree.HelpSource.GetInternalIdForUrl (leaf.PublicUrl, out result, out context);
 170                                 if (leaf.Tree.HelpSource.GetDocumentTypeForId (internalId) != DocumentType.EcmaXml)
 171                                         continue;
 172
 173                                 string content = null;
 174                                 if (string.IsNullOrEmpty (content = rootTree.RenderUrl (leaf.PublicUrl, htmlGenerator, out result)) || leaf != result) {
 175                                         Console.WriteLine ("Error: {0} with HelpSource {1} ", leaf.PublicUrl, leaf.Tree.HelpSource.Name);
 176                                         continue;
 177                                 }
 178
 179                                 HtmlDocument doc = new HtmlDocument();
 180                                 try {
 181                                         doc.LoadHtml (content);
 182                                 } catch {
 183                                         Console.WriteLine ("Couldn't load a HTML document for URL {0}", leaf.PublicUrl);
 184                                         continue;
 185                                 }
 186
 187                                 foreach (HtmlNode link in doc.DocumentNode.SelectNodes("//a[@href]")) {
 188                                         var newUrl = link.Attributes["href"].Value;
 189                                         var hashIndex = newUrl.IndexOf ('#');
 190                                         if (hashIndex != -1)
 191                                                 newUrl = newUrl.Substring (0, hashIndex);
 192                                         if (newUrl.Length > 1 && newUrl[1] == ':' && char.IsLetter (newUrl, 0) && char.ToLowerInvariant (newUrl[0]) != 'c')
 193                                                 crefs.Add (newUrl);
 194                                 }
 195
 196                                 foreach (var cref in crefs) {
 197                                         if (!rootTree.RenderUrl (cref, generator, out result) || result == null) {
 198                                                 Console.WriteLine ("Error with cref: `{0}'", cref);
 199                                                 errorCount++;
 200                                         }
 201                                 }
 202
 203                                 crefs.Clear ();
 204                         }
 205
 206                         Assert.AreEqual (0, errorCount, errorCount + " / " + crefs.Count);
 207                 }*/
 208         }
 209 }