blob: f8cc7072d139b031e5a64f52121dd886c5f85e8b (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89pre { line-height: 125%; }
td.linenos .normal { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; }
span.linenos { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; }
td.linenos .special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; }
span.linenos.special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; }
.highlight .hll { background-color: #ffffcc }
.highlight .c { color: #888888 } /* Comment */
.highlight .err { color: #a61717; background-color: #e3d2d2 } /* Error */
.highlight .k { color: #008800; font-weight: bold } /* Keyword */
.highlight .ch { color: #888888 } /* Comment.Hashbang */
.highlight .cm { color: #888888 } /* Comment.Multiline */
.highlight .cp { color: #cc0000; font-weight: bold } /* Comment.Preproc */
.highlight .cpf { color: #888888 } /* Comment.PreprocFile */
.highlight .c1 { color: #888888 } /* Comment.Single */
.highlight .cs { color: #cc0000; font-weight: bold; background-color: #fff0f0 } /* Comment.Special */
.highlight .gd { color: #000000; background-color: #ffdddd } /* Generic.Deleted */
.highlight .ge { font-style: italic } /* Generic.Emph */
.highlight .ges { font-weight: bold; font-style: italic } /* Generic.EmphStrong */
.highlight .gr { color: #aa0000 } /* Generic.Error */
.highlight .gh { color: #333333 } /* Generic.Heading */
.highlight .gi { color: #000000; background-color: #ddffdd } /* Generic.Inserted */
.highlight .go { color: #888888 } /* Generic.Output */
.highlight .gp { color: #555555 } /* Generic.Prompt */
.highlight .gs { font-weight: bold } /* Generic.Strong */
.highlight .gu { color: #666666 } /* Generic.Subheading */
.highlight .gt { color: #aa0000 } /* Generic.Traceback */
.highlight .kc { color: #008800; font-weight: bold } /* Keyword.Constant */
.highlight .kd { color: #008800; font-weight: bold } /* Keyword.Declaration */
.highlight .kn { color: #008800; font-weight: bold } /* Keyword.Namespace */
.highlight .kp { color: #008800 } /* Keyword.Pseudo */
.highlight .kr { color: #008800; font-weight: bold } /* Keyword.Reserved */
.highlight .kt { color: #888888; font-weight: bold } /* Keyword.Type */
.highlight .m { color: #0000DD; font-weight: bold } /* Literal.Number */
.highlight .s { color: #dd2200; background-color: #fff0f0 } /* Literal.String */
.highlight .na { color: #336699 } /* Name.Attribute */
.highlight .nb { color: #003388 } /* Name.Builtin */
.highlight .nc { color: #bb0066; font-weight: bold } /* Name.Class */
.highlight .no { color: #003366; font-weight: bold } /* Name.Constant */
.highlight .nd { color: #555555 } /* Name.Decorator */
.highlight .ne { color: #bb0066; font-weight: bold } /* Name.Exception */
.highlight .nf { color: #0066busing System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Reflection;
using System.Text;
using System.Threading.Tasks;
using System.Xml;
namespace Tango.Scripting.Editors.Intellisense
{
public static class Utils
{
private static String dotNetXmlFolder = @"C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.X";
private static Dictionary<Assembly, XmlDocument> _assemblies_docs_cache;
static Utils()
{
_assemblies_docs_cache = new Dictionary<Assembly, XmlDocument>();
}
public static void LoadKnownTypeDocs(KnownType knownType)
{
XmlDocument xmlDoc = null;
if (_assemblies_docs_cache.ContainsKey(knownType.Type.Assembly))
{
xmlDoc = _assemblies_docs_cache[knownType.Type.Assembly];
}
if (xmlDoc == null)
{
String dllPath = knownType.Type.Assembly.Location;
string docuPath = dllPath.Substring(0, dllPath.LastIndexOf(".")) + ".XML";
if (File.Exists(docuPath))
{
xmlDoc = new XmlDocument();
xmlDoc.Load(docuPath);
}
else if (File.Exists(System.IO.Path.Combine(dotNetXmlFolder, System.IO.Path.GetFileName(docuPath))))
{
xmlDoc = new XmlDocument();
xmlDoc.Load(System.IO.Path.Combine(dotNetXmlFolder, System.IO.Path.GetFileName(docuPath)));
}
if (xmlDoc != null)
{
_assemblies_docs_cache.Add(knownType.Type.Assembly, xmlDoc);
}
}
if (xmlDoc == null)
{
xmlDoc = new XmlDocument();
}
//Load Type Summary
{
string path = "T:" + knownType.Type.FullName;
XmlNode xmlDocuOfType = xmlDoc.SelectSingleNode("//member[starts-with(@name, '" + path + "')]");
if (xmlDocuOfType != null)
{
XmlNode summaryNode = xmlDocuOfType.SelectSingleNode("summary");
knownType.Summary = summaryNode.InnerText;
}
}
//Load Constructors...
{
string path = "M:" + knownType.Type.FullName + ".#ctor";
var docNodes = xmlDoc.SelectNodes("//member[starts-with(@name, '" + path + "')]").OfType<XmlNode>().ToList();
for (int i = 0; i < knownType.Constructors.Count; i++)
{
var constructor = knownType.Constructors[i];
XmlNode cDoc = null;
if (i < docNodes.Count)
{
cDoc = docNodes[i];
}
constructor.Summary = cDoc != null ? cDoc.SelectSingleNode("summary").InnerXml : $"Initializes a new instance of {knownType.FriendlyName}.";
var parameters = constructor.Parameters.ToList();
var parametersNodes = cDoc != null ? cDoc.SelectNodes("param").OfType<XmlNode>().ToList() : new List<XmlNode>();
for (int j = 0; j < parameters.Count; j++)
{
var parameter = parameters[j];
XmlNode pNode = null;
if (j < parametersNodes.Count)
{
pNode = parametersNodes[j];
}
parameter.Description = pNode != null ? pNode.InnerText : null;
}
}
}
//Load Methods...
{
string path = "M:" + knownType.Type.FullName;
var docNodes = xmlDoc.SelectNodes("//member[starts-with(@name, '" + path + "')]").OfType<XmlNode>().ToList();
for (int i = 0; i < knownType.Methods.Count; i++)
{
var method = knownType.Methods[i];
XmlNode mDoc = null;
mDoc = docNodes.FirstOrDefault(x => x.Attributes["name"].InnerText.Contains(knownType.Type.Name + "." + method.Name));
method.Summary = mDoc != null ? mDoc.SelectSingleNode("summary").InnerXml.Remove("(<see cref=\".:)|(\" \\/>)") : "No documentation";
var parameters = method.Parameters.ToList();
var parametersNodes = mDoc != null ? mDoc.SelectNodes("param").OfType<XmlNode>().ToList() : new List<XmlNode>();
bool isLinq = knownType.Type == typeof(Enumerable);
for (int j = 0; j < parameters.Count; j++)
{
var parameter = parameters[j];
XmlNode pNode = null;
if (j < parametersNodes.Count)
{
pNode = parametersNodes[j];
}
parameter.Description = pNode != null ? pNode.InnerText.Remove("(<see cref=\".:)|(\" \\/>)") : null;
}
}
}
//Load Properties
{
string path = "P:" + knownType.Type.FullName;
var docNodes = xmlDoc.SelectNodes("//member[starts-with(@name, '" + path + "')]").OfType<XmlNode>().ToList();
for (int i = 0; i < knownType.Properties.Count; i++)
{
var property = knownType.Properties[i];
var pDoc = docNodes.FirstOrDefault(x => x.Attributes["name"].InnerText.Contains(knownType.Type.Name + "." + property.Name));
property.Summary = pDoc != null ? pDoc.SelectSingleNode("summary").InnerXml : "No documentation";
}
}
//Load Enum Values
{
if (knownType.Type.IsEnum)
{
for (int i = 0; i < knownType.Fields.Count; i++)
{
var field = knownType.Fields[i];
var pDoc = xmlDoc.SelectSingleNode("//member[starts-with(@name, '" + $"F:{knownType.Type.FullName}.{field.Name}" + "')]");
field.Summary = pDoc != null ? pDoc.SelectSingleNode("summary").InnerXml : "No documentation";
}
}
}
}
}
}
|