JSDOC/Collapse.vala
[gnome.introspection-doc-generator] / JSDOC / Collapse.vala
1
2 /**
3  * 
4  * base class for parsing segments of token array..
5  * 
6  * 
7  * We want to make parsing the whole thing easy..
8  * 
9  * so we do various tricks:
10  * 
11  * 
12  * a) white space collased
13  *    wsPrefix 
14  * b)  toks
15  *     { } - collapse into first element.
16        ( ) - collapse into first element.
17        [ ] - collapse into first element.
18  * c) items = , seperation within the above..
19  * 
20  * usage: x = new Collapse(token_array)
21  * 
22  * 
23  * 
24  * 
25  */ 
26
27 namespace JSDOC {
28
29         public class  Collapse : TokenStream  {
30
31
32                 public Collapse(Gee.ArrayList<Token> tokens) 
33                 {
34                     parent(ar);;
35                     
36                     this.spaces();
37                     
38                     ar = this.collapse(this.tokens);
39                     
40                     this.tokens = ar;
41                     
42                    // console.dump(ar);
43                     
44                 }
45     
46         void spaces () {
47             var ar = new Gee.ArrayList<Token>()
48             var pref =  new Gee.ArrayList<Token>();
49             
50
51             
52             for (var i = 0; i < this.tokens.size; i ++) {
53                 var tok = this.tokens[i];
54                 if (tok.is("COMM") || tok.is("WHIT")) {
55                     pref.add(tok);
56                     continue;
57                 }
58                 tok.prefix = '';
59                 if (pref.size > 0) {
60                         foreach(e in pref) {
61                         tok.prefix += e.data;
62                     }
63                     pref =  new Gee.ArrayList<Token>(); // reset pref..
64                 }
65                 
66                 ar.add(tok);
67                 
68
69                 
70             }
71             this.tokens = ar;
72             
73         },
74         collapse : function(ar) {
75             
76             var st = new  TokenStream(ar);
77             var ret = [];
78             
79             while (true) {
80                 var  tok = st.look(1,true);
81                 if (!tok || !tok.is) {
82                   //  Seed.print(TokenStream.toString(ret));
83                     return ret;
84                 }
85                 // console.log(tok.data);
86                 switch(tok.type) {
87                     case "VOID": 
88                         return ret; //EOF
89                         
90                         
91                     case "KEYW": 
92                     case "TOKN":
93                     case "NAME":
94                     case "STRN":
95                     case "NUMB":
96                     case "REGX":
97                         ret.push(st.next(1));
98                         continue;
99                         
100                     case "PUNC":
101                         switch (tok.data) {
102                             case "[":
103                             case "{":
104                             case "(":
105                                 
106                                 var start = st.cursor;
107                                 st.next(1);
108                                 var add = st.balance(tok.data);
109                                 if (!add) {
110                                     console.dump(tok);
111                                     console.dump(start + '...' + st.cursor);
112                                     console.dump(st.tokens);
113                                  
114                                 }
115                                 if (add) {
116                                     add.shift();
117                                 }
118                                 //Seed.print("ADD");
119                                 //Seed.print(JSON.stringify(add, null,4));
120                                 
121                                 
122                                 
123                                 var toks = add ? this.collapse(add) : [];
124                                 tok.items = false;
125                                 tok.props = false;
126                                 
127                                 
128                                 
129                                 if (tok.data != '{') {
130                                     // paramters or array elements..
131                                     tok.items = this.toItems(toks, [',']);
132                                 } else {
133                                     // check for types.. it could be a list of statements.. or object
134                                     
135                                     var ost = new  TokenStream(toks);
136                                     //console.dump(ost.look(2,true) );
137                                     if (ost.look(2,true) && ost.look(2,true).data == ":") {
138                                         tok.props = this.toProps(toks);
139                                     } else {
140                                         // list of statemetns..
141                                         tok.items = this.toItems(toks,[ ';', '{'] );;
142                                     }
143                                     
144                                     
145                                 }
146                                  
147                                 
148                                 
149                                 
150                                 
151                                 
152                                 
153                                 //Seed.print(" ADD : " + add.length  +  " ITEMS: " + tok.items.length);
154                                 
155                                 ret.push(tok);
156                                 
157                                 continue;
158                    
159                             default:
160                                 ret.push(st.next(1));
161                                 continue;
162                         }
163                         Seed.print("OOPS");
164                         continue;
165                     default : 
166                         Seed.print("OOPS" + tok.type);
167                         continue;
168                 }
169             }
170                 
171                 
172             
173             
174             
175             
176             
177             
178             
179             
180         },
181         toItems : function(ar,sep)
182         {
183             var ret = [];
184             var g = [];
185               
186             for (var i = 0; i < ar.length; i ++) {
187                 if (sep.indexOf(ar[i].data) < 0) {
188                     g.push(ar[i]);
189                     continue;
190                 }
191                 // var a=..., b =...
192                 if ((ar[i].data != ';') && g.length && (g[0].name == "VAR")) {;
193                     g.push(ar[i]);
194                     continue;
195                 }
196                 
197                 g.push(ar[i]);
198                 ret.push(g);
199                 g = [];
200                 
201             }
202             // last..
203             if (g.length) {
204                 ret.push(g);
205             }
206             return ret;
207             
208         },
209         toProps : function(ar)
210         {
211             
212             var ret = { }
213                
214             var g = { key : '', val: [] }
215                
216             
217             var k = '';
218             var state = 0;
219             for (var i = 0; i < ar.length; i ++) {
220                 
221                 switch(state) {
222                     case 0:
223                         k = ar[i].data;
224                         g.key = ar[i];
225                         state = 1;
226                         continue;
227                     case 1:
228                         state =2; // should be ':'
229                         continue;
230                     case 2:
231                         g.val.push(ar[i]);
232                         if (ar[i].data != ',') {
233                             continue;
234                         }
235                         ret[k] = g;
236                         g = { key : '', val: [] }
237                         state = 0;
238                         continue;
239                    
240                 }
241             }
242              // last.. - if g.val.length is 0 then it's a trailing ','...
243              // we should really throw a syntax error in that case..
244             if (k.length && g.val.length) {
245                 ret[k] = g;
246             }
247             return ret;
248             
249             
250         }
251
252     
253     
254 });