Exemplo n.º 1
0
 public static List<DocumentationComment> Read(string s)
 {
     XmlDocument doc = new XmlDocument();
     doc.LoadXml(s);
     XmlNode n = doc.SelectSingleNode("/Documentation");
     List<DocumentationComment> ret = new List<DocumentationComment>();
     foreach (XmlNode n2 in n.ChildNodes)
     {
         DocumentationComment dc = new DocumentationComment();
         dc.Ident = n2.Name;
         string s2 = n2.InnerText;
         string[] lines = s2.Split('\n');
         foreach (string line in lines)
             dc.Lines.Add(line.Replace("\r", "").Replace("\n", ""));
         ret.Add(dc);
     }
     return ret;
 }
Exemplo n.º 2
0
 static string generate(DocumentationComment dc)
 {
     try
     {
         XmlDocument d = new XmlDocument();
         d.LoadXml("<doc>" + dc.Text + "</doc>");
         StringBuilder sb = new StringBuilder();
         if (d.SelectNodes("/doc/param").Count > 0)
         {
             sb.Append(dc.Ident + "(");
             //foreach (XmlNode n in d.SelectNodes("/doc/param"))
             for (int i = 0; i < d.SelectNodes("/doc/param").Count; i++)
             {
                 sb.Append(d.SelectNodes("/doc/param")[i].Attributes["name"].InnerText.Trim());
                 if (i != d.SelectNodes("/doc/param").Count - 1)
                     sb.Append(", ");
             }
             sb.Append(")");
             sb.AppendLine();
             sb.AppendLine();
         }
         sb.AppendLine(d.SelectSingleNode("/doc/summary").InnerText.Trim().Replace("<br />", "\r\n").Replace("<br>", "\r\n").Replace("<br/>", "\r\n"));
         foreach (XmlNode n in d.SelectNodes("/doc/param"))
         {
             sb.Append(n.Attributes["name"].InnerText.Trim());
             sb.Append(": ");
             sb.AppendLine(n.InnerText.Trim());
         }
         foreach (XmlNode n in d.SelectNodes("/doc/returns"))
         {
             sb.AppendLine("Returns: " + n.InnerText.Trim());
         }
         if (sb.Length >= 2)
             sb.Remove(sb.Length - 2, 2); // remove last \n
         return sb.ToString();
     }
     catch (Exception ex)
     {
         //MessageBox.Show(ex.ToString());
         LoggingService.Error(dc.Text, ex);
     }
     return dc.Text;
 }
Exemplo n.º 3
0
        public static List <DocumentationComment> Read(string s)
        {
            XmlDocument doc = new XmlDocument();

            doc.LoadXml(s);
            XmlNode n = doc.SelectSingleNode("/Documentation");
            List <DocumentationComment> ret = new List <DocumentationComment>();

            foreach (XmlNode n2 in n.ChildNodes)
            {
                DocumentationComment dc = new DocumentationComment();
                dc.Ident = n2.Name;
                string   s2    = n2.InnerText;
                string[] lines = s2.Split('\n');
                foreach (string line in lines)
                {
                    dc.Lines.Add(line.Replace("\r", "").Replace("\n", ""));
                }
                ret.Add(dc);
            }
            return(ret);
        }
        public static List<DocumentationComment> Extract(Chunk c)
        {
            if (c.ScannedTokens != null && c.ScannedTokens.Count > 0)
            {
                List<DocumentationComment> cmnts = new List<DocumentationComment>();
                for (int p = 0; p < c.ScannedTokens.Count; p++)
                {
                    Token t_ = c.ScannedTokens[p];
                    Token t = t_.Leading.Count > 0 ? t_.Leading[0] : null;
                    if (t != null)
                    {
                        int i = 0;
                        DocumentationComment cmt = new DocumentationComment();
                        do
                        {
                            if (t_.Leading.Count <= i)
                                break;
                            t = t_.Leading[i++];
                            if (t.Type == TokenType.DocumentationComment)
                                cmt.Lines.Add(t.Data);
                        } while (t.Type == TokenType.WhitespaceN
                            || t.Type == TokenType.WhitespaceR
                            || t.Type == TokenType.WhitespaceSpace
                            || t.Type == TokenType.WhitespaceTab
                            || t.Type == TokenType.DocumentationComment);

                        // find the ident it's for
                        if (c.ScannedTokens.Count > p)
                        {
                            t = c.ScannedTokens[p];
                            if (t.Type == TokenType.Keyword && t.Data == "local")
                                if (c.ScannedTokens[p + 1].Type == TokenType.Keyword && c.ScannedTokens[p + 1].Data == "function")
                                {
                                    int i2 = 2;
                                    while (
                                        (c.ScannedTokens[p + i2].Type == TokenType.Symbol && c.ScannedTokens[p + i2].Data == ".")
                                        || (c.ScannedTokens[p + i2].Type == TokenType.Ident))
                                        i2++;
                                    cmt.Ident = c.ScannedTokens[p + i2 - 1].Data;
                                    p += i2;
                                }
                                else
                                {
                                    int i2 = 2;
                                    while (
                                        (c.ScannedTokens[p + i2].Type == TokenType.Symbol && c.ScannedTokens[p + i2].Data == ".")
                                        || (c.ScannedTokens[p + i2].Type == TokenType.Ident))
                                        i2++;
                                    cmt.Ident = c.ScannedTokens[p + i2 - 1].Data;
                                    p += i2;
                                }
                            else if (t.Type == TokenType.Keyword && t.Data == "function")
                            {
                                int i2 = 1;
                                while (
                                    (c.ScannedTokens[p + i2].Type == TokenType.Symbol && c.ScannedTokens[p + i2].Data == ".")
                                    || (c.ScannedTokens[p + i2].Type == TokenType.Ident))
                                    i2++;
                                cmt.Ident = c.ScannedTokens[p + i2 - 1].Data;
                                p += i2;
                            }
                            else if (t.Type == TokenType.Ident)
                            {
                                int i2 = 1;
                                while (
                                    (c.ScannedTokens[p + i2].Type == TokenType.Symbol && c.ScannedTokens[p + i2].Data == ".")
                                    || (c.ScannedTokens[p + i2].Type == TokenType.Ident))
                                    i2++;
                                cmt.Ident = c.ScannedTokens[p + i2 - 1].Data;
                                p += i2;
                            }

                        }
                        if (cmt.Ident != null
                            && string.IsNullOrEmpty(cmt.Ident) == false
                            && cmt.Lines.Count > 0)
                        {
                            //Console.WriteLine("YEP: " + cmt.Ident);
                            cmnts.Add(cmt);
                        }
                        else
                        {
                            /*
                            Console.Write("NOPE: (" + (cmt.Ident == null ? "" : cmt.Ident) + ")");
                            Console.WriteLine(
                                cmt.Ident == null ? "Ident is null"
                                : (string.IsNullOrEmpty(cmt.Ident)
                                  ? "Ident is empty"
                                  : (cmt.Lines.Count == 0
                                    ? "No doc lines"
                                    : "wut?"))
                                );
                            */
                        }
                    }
                }
                return cmnts;
            }
            return new List<DocumentationComment>();
        }
        public static List <DocumentationComment> Extract(Chunk c)
        {
            if (c.ScannedTokens != null && c.ScannedTokens.Count > 0)
            {
                List <DocumentationComment> cmnts = new List <DocumentationComment>();
                for (int p = 0; p < c.ScannedTokens.Count; p++)
                {
                    Token t_ = c.ScannedTokens[p];
                    Token t  = t_.Leading.Count > 0 ? t_.Leading[0] : null;
                    if (t != null)
                    {
                        int i = 0;
                        DocumentationComment cmt = new DocumentationComment();
                        do
                        {
                            if (t_.Leading.Count <= i)
                            {
                                break;
                            }
                            t = t_.Leading[i++];
                            if (t.Type == TokenType.DocumentationComment)
                            {
                                cmt.Lines.Add(t.Data);
                            }
                        } while (t.Type == TokenType.WhitespaceN ||
                                 t.Type == TokenType.WhitespaceR ||
                                 t.Type == TokenType.WhitespaceSpace ||
                                 t.Type == TokenType.WhitespaceTab ||
                                 t.Type == TokenType.DocumentationComment);

                        // find the ident it's for
                        if (c.ScannedTokens.Count > p)
                        {
                            t = c.ScannedTokens[p];
                            if (t.Type == TokenType.Keyword && t.Data == "local")
                            {
                                if (c.ScannedTokens[p + 1].Type == TokenType.Keyword && c.ScannedTokens[p + 1].Data == "function")
                                {
                                    int i2 = 2;
                                    while (
                                        (c.ScannedTokens[p + i2].Type == TokenType.Symbol && c.ScannedTokens[p + i2].Data == ".") ||
                                        (c.ScannedTokens[p + i2].Type == TokenType.Ident))
                                    {
                                        i2++;
                                    }
                                    cmt.Ident = c.ScannedTokens[p + i2 - 1].Data;
                                    p        += i2;
                                }
                                else
                                {
                                    int i2 = 2;
                                    while (
                                        (c.ScannedTokens[p + i2].Type == TokenType.Symbol && c.ScannedTokens[p + i2].Data == ".") ||
                                        (c.ScannedTokens[p + i2].Type == TokenType.Ident))
                                    {
                                        i2++;
                                    }
                                    cmt.Ident = c.ScannedTokens[p + i2 - 1].Data;
                                    p        += i2;
                                }
                            }
                            else if (t.Type == TokenType.Keyword && t.Data == "function")
                            {
                                int i2 = 1;
                                while (
                                    (c.ScannedTokens[p + i2].Type == TokenType.Symbol && c.ScannedTokens[p + i2].Data == ".") ||
                                    (c.ScannedTokens[p + i2].Type == TokenType.Ident))
                                {
                                    i2++;
                                }
                                cmt.Ident = c.ScannedTokens[p + i2 - 1].Data;
                                p        += i2;
                            }
                            else if (t.Type == TokenType.Ident)
                            {
                                int i2 = 1;
                                while (
                                    (c.ScannedTokens[p + i2].Type == TokenType.Symbol && c.ScannedTokens[p + i2].Data == ".") ||
                                    (c.ScannedTokens[p + i2].Type == TokenType.Ident))
                                {
                                    i2++;
                                }
                                cmt.Ident = c.ScannedTokens[p + i2 - 1].Data;
                                p        += i2;
                            }
                        }
                        if (cmt.Ident != null &&
                            string.IsNullOrEmpty(cmt.Ident) == false &&
                            cmt.Lines.Count > 0)
                        {
                            //Console.WriteLine("YEP: " + cmt.Ident);
                            cmnts.Add(cmt);
                        }
                        else
                        {
                            /*
                             * Console.Write("NOPE: (" + (cmt.Ident == null ? "" : cmt.Ident) + ")");
                             * Console.WriteLine(
                             *  cmt.Ident == null ? "Ident is null"
                             *  : (string.IsNullOrEmpty(cmt.Ident)
                             *    ? "Ident is empty"
                             *    : (cmt.Lines.Count == 0
                             *      ? "No doc lines"
                             *      : "wut?"))
                             *  );
                             */
                        }
                    }
                }
                return(cmnts);
            }
            return(new List <DocumentationComment>());
        }