Exemple #1
0
        public static void Main(string[] args)
        {
            try {
                // load .dll files in the current directory to
                foreach (var file in Directory.GetFiles(Environment.CurrentDirectory, "*", SearchOption.AllDirectories))
                {
                    if (file.ToLowerInvariant().EndsWith(".dll"))
                    {
                        Assembly.LoadFile(file);
                    }
                }
                foreach (var file in Directory.GetFiles(Environment.CurrentDirectory, "*", SearchOption.AllDirectories))
                {
                    if (file.ToLowerInvariant().EndsWith(".xml"))
                    {
                        string xmlStr = File.ReadAllText(file);

                        xmlStr = Regex.Replace(xmlStr,
                                               "<see cref=\"[A-Z?]:(.*)\" \\/>",
                                               m => "&lt;a href=\"#" +
                                               m.Groups[1].Value.ToLower().Replace('.', '-') + "\"&gt;" +
                                               m.Groups[1].Value.Split('.').Last() +
                                               "&lt;/a&gt;"
                                               );

                        xmlStr = Regex.Replace(xmlStr,
                                               @"<(c|code)>([^<])*<\/(c|code)>",
                                               m => "&lt;" +
                                               m.Groups[1].Value +
                                               "&gt;" +
                                               m.Groups[2].Captures.Join() +
                                               "&lt;/" +
                                               m.Groups[1].Value +
                                               "&gt;"
                                               );

                        using (var stream = xmlStr.ToStream()) {
                            // TODO: Add reflection stuff, to:
                            // * determine if properties has setters or only getters

                            using (var xml = System.Xml.XmlReader.Create(stream)) {
                                while (xml.Read())
                                {
                                    if (xml.IsStartElement())
                                    {
                                        BaseDoc CurrentDoc = null;

                                        switch (xml.Name)
                                        {
                                        case "assembly":
                                            CurrentAssembly = new AssemblyDoc();
                                            CurrentDoc      = CurrentAssembly;
                                            break;

                                        case "name":
                                            xml.Read();
                                            CurrentAssembly.Name = xml.Value;
                                            reflectedAssembly    = AppDomain.CurrentDomain.GetAssemblies().ToList().First(a => a.GetName().Name == xml.Value);
                                            break;

                                        case "member":
                                            var  memberName = xml["name"];
                                            char type       = memberName[0];

                                            if (memberName.Contains("Hooks"))
                                            {
                                                PreviousDoc = null;
                                                break;
                                            }

                                            switch (type)
                                            {
                                            case 'T':
                                                CurrentDoc    = new TypeDoc(CurrentAssembly);
                                                CurrentType   = CurrentDoc;
                                                reflectedType = reflectedAssembly.GetType(memberName.Substring(2));
                                                break;

                                            case 'P':
                                            case 'F':
                                                if (CurrentType == null || !memberName.Contains(CurrentType.Name.Substring(2)))
                                                {
                                                    string typename = memberName.GetTypeName();
                                                    CurrentType = new TypeDoc(CurrentAssembly)
                                                    {
                                                        Name = typename
                                                    };
                                                    reflectedType = reflectedAssembly.GetType(typename);
                                                }

                                                // if type == p => add property documentation else => add field doc.

                                                CurrentDoc = type == 'P' ? (new PropertyDoc(CurrentType as TypeDoc)
                                                {
                                                    Name = memberName.Substring(2),
                                                    Type = (from pinfo in reflectedType.GetProperties()
                                                            where pinfo.Name == memberName.GetMemberName()
                                                            select pinfo.PropertyType).FirstOrDefault()
                                                } as BaseDoc)
                                                            : (new FieldDoc(CurrentType as TypeDoc)
                                                {
                                                    Name = memberName.Substring(2),
                                                    Type = (from finfo in reflectedType.GetFields()
                                                            where finfo.Name == memberName.GetMemberName()
                                                            select finfo.FieldType).FirstOrDefault()
                                                } as BaseDoc);
                                                break;

                                            case 'M':
                                                // check if the method is a method of the _current_ type, if it's not then it means the type of this method is not _documented_
                                                // so we add an empty doc for it here
                                                if (CurrentType == null || !memberName.Contains(CurrentType.Name.Substring(2)))
                                                {
                                                    string typename = memberName.GetTypeName();
                                                    CurrentType = new TypeDoc(CurrentAssembly)
                                                    {
                                                        Name = typename
                                                    };
                                                    reflectedType = reflectedAssembly.GetType(typename);
                                                }

                                                reflectedMethodParams = new List <Type>();

                                                string methodname = memberName.GetMemberName();

                                                string paramtypes = Regex.Match(memberName, "\\(([\\.,A-z0-9])*\\)").Groups[1].Captures.Join();

                                                foreach (var paramtype in paramtypes.Split(','))
                                                {
                                                    Type typ = null;
                                                    if (!TryFindType(paramtype, out typ))
                                                    {
                                                        var paramtype2 = Regex.Replace(paramtype, "(.*)\\.([A-z]*)$", "$1+$2");
                                                        TryFindType(paramtype2, out typ);
                                                    }
                                                    if (typ != null)
                                                    {
                                                        reflectedMethodParams.Add(typ);
                                                    }
                                                }

                                                if (!methodname.Contains('#'))
                                                {
                                                    reflectedMethod = reflectedType.GetMethod(methodname, reflectedMethodParams.ToArray());
                                                }
                                                else
                                                {
                                                    reflectedMethod = reflectedType.GetConstructor(reflectedMethodParams.ToArray());
                                                }

                                                // the method's name for constructors is #ctor, lets change that to the name of the Type
                                                if (memberName.Contains("#ctor"))
                                                {
                                                    CurrentDoc      = new ConstructorDoc(CurrentType as TypeDoc);
                                                    CurrentDoc.Name = memberName.Replace("#ctor", Regex.Match(memberName, ".([A-z]+).#").Groups[1].Value).Substring(2);
                                                    CurrentDoc.Name = CurrentDoc.Name.Substring(0, CurrentDoc.Name.IndexOf("("));
                                                }
                                                else
                                                {
                                                    CurrentDoc = new MethodDoc(CurrentType as TypeDoc);
                                                }

                                                CurrentMethod = CurrentDoc;
                                                currentParam  = 0;

                                                if (reflectedMethod is MethodInfo)
                                                {
                                                    CurrentMethod["ReturnType"] = (reflectedMethod as MethodInfo).ReturnType;
                                                }
                                                else
                                                {
                                                    CurrentMethod["ReturnType"] = reflectedType;
                                                }

                                                break;
                                            }
                                            if (CurrentDoc.Name == null)
                                            {
                                                if (memberName.Contains("("))
                                                {
                                                    CurrentDoc.Name = memberName.Substring(2, memberName.IndexOf("(") - 2);
                                                }
                                                else
                                                {
                                                    CurrentDoc.Name = memberName.Substring(2);
                                                }
                                            }
                                            break;

                                        case "summary":
                                            xml.Read();
                                            if (PreviousDoc != null)
                                            {
                                                PreviousDoc["Summary"] = xml.Value.Trim();
                                            }

                                            break;

                                        case "param":
                                            string name = xml["name"];
                                            xml.Read();
                                            CurrentDoc = new ParameterDoc(CurrentMethod)
                                            {
                                                Name    = name,
                                                Summary = xml.Value,
                                                Type    = reflectedMethodParams[currentParam]
                                            };
                                            currentParam++;
                                            break;

                                        case "csharp":
                                        case "javascript":
                                        case "python":
                                        case "lua":
                                            if (PreviousDoc is TypeDoc)
                                            {
                                                var cdoc = PreviousDoc as TypeDoc;
                                                var lang = xml.Name;
                                                xml.Read();

                                                cdoc.CodeExamples.Add(new CodeExample {
                                                    Code     = xml.Value,
                                                    Language = (Language)Enum.Parse(typeof(Language), lang)
                                                });
                                            }
                                            else if (PreviousDoc is MethodDoc)
                                            {
                                                var cdoc = PreviousDoc as MethodDoc;
                                                var lang = xml.Name;
                                                xml.Read();

                                                cdoc.CodeExamples.Add(new CodeExample {
                                                    Code     = xml.Value,
                                                    Language = (Language)Enum.Parse(typeof(Language), lang)
                                                });
                                            }
                                            break;

                                        case "value":
                                            xml.Read();
                                            PreviousDoc["defaultValue"] = xml.Value;
                                            break;
                                        }

                                        if (CurrentDoc != null)
                                        {
                                            PreviousDoc = CurrentDoc;
                                        }
                                    }
                                }
                            }
                            #if DEBUG
                            Console.WriteLine("CurrentAssembly is: " + Environment.NewLine + CurrentAssembly);
                            #endif
                            CurrentAssembly.ToFile();
                        }
                    }
                }
            } catch (Exception ex) {
                Console.WriteLine(ex.ToString());
                Console.WriteLine(ex.StackTrace);
            }
        }