e1da4eb4389a7fc58e8b7efc80ab7dd9e6c7a598
[app.Builder.js] / Builder / Provider / Palete / Gtk.js
1 //<Script type="text/javascript">
2  
3 Gio = imports.gi.Gio;
4 GIRepository  = imports.gi.GIRepository;
5 xml     = imports.libxml;
6 console = imports.console;
7 XObject = imports.XObject.XObject;
8
9 Base = imports.Builder.Provider.Palete.Base.Base;
10 File = imports.File.File;
11 //----------------------- our roo verison
12
13
14
15
16 Gtk = XObject.define(
17     function(cfg) {
18         
19        
20         // various loader methods..
21           this.map = [];
22         this.load();
23         this.proplist = {};
24         this.comments = { }; 
25         // no parent...
26         
27        
28     },
29     Base,
30     {
31         load: function () {
32                 
33          
34         
35             var data = File.read(__script_path__ +'/../GtkUsage.txt');
36           // print(data);
37             data  = data.split(/\n/g);
38             var state = 0;
39             var cfg = [];
40             var left = [];
41             var right = [];
42             
43             data.forEach( function(d) {
44                 if (!d.length || d.match(/^\s+$/) || d.match(/^\s*\//)) { //empty
45                     return;
46                 }
47                 if (d.match(/^left:/)) { 
48                     state = 1;
49                     if (left.length ){
50                         
51                         cfg.push({
52                             left : left,
53                             right: right
54                         });
55                         }
56                     left = [];
57                     right = [];
58                     return;
59                 }
60                 if (d.match(/^right:/)) { 
61                     state = 2;
62                     return;
63                 }
64                 if (state == 1) {
65                     left.push(d.replace(/\s+/g, ''));
66                     return;
67                 }
68                 right.push(d.replace(/\s+/g, ''));
69                 //Seed.quit();
70                
71             }); 
72             if (left.length ){
73                         
74                 cfg.push({
75                     left : left,
76                     right: right
77                 });
78             }
79             this.map = cfg;
80              
81         },
82         
83         
84         commentLoad : function(ns)
85         {
86              
87             if (typeof(this.comments[ns]) != 'undefined') {
88                 return;
89             }
90
91             console.log("LOAD DOCS: " + ns);
92             var gi = GIRepository.IRepository.get_default();
93             var ver = gi.get_version(ns);
94             if (!ver) {
95                 this.comments[ns] = {};
96                 return;
97             }
98             var ret = { };
99
100             // no idea why this is broken on my build system.
101             function getAttribute(n, name){
102                 var properties = n.properties;
103                 while (properties){
104                     if (properties.name == name)
105                          return properties.children.content;
106                      properties = properties.next
107                 }
108                 return null;
109             }
110                  
111          
112             function walk(element, path) {
113                  
114                  
115                 if (!element) {
116                     return;
117                 }
118                 
119                 var n =  getAttribute(element, 'name') ;
120                 //console.log("WALK" + n);
121                 if (element.name == 'signal') {
122                     path += '.signal';
123                 } 
124                 if (n) {
125                     path += path.length ? '.' : '';
126                     path += n;
127                 }
128                 if (element.name == 'return-value') {
129                     path += '.return-value';
130                 }
131                 
132                 
133              
134                 var d =   getAttribute(element,'doc');
135                 if (d) {
136                  //   Seed.print(path + ':' + d);
137                     ret[path] = d;
138                 }
139                 
140                 var child = element.children;
141
142                 while (child){
143                     //console.log(child.tag);
144                     if (child.type == "element"){
145                         walk (child, path);
146                     }
147                     child = child.next;
148                 }
149             }
150             
151             var pth = GIRepository.IRepository.get_search_path ();
152             
153             
154             var gir_path = pth[0].replace(/lib\/girepository-1.0/, 'share\/gir-1.0');
155            
156             
157             //console.log(fn);
158             var  fn = gir_path + '/'+ ns + '-' + ver + '.gir';
159            // console.log(fn);
160             
161             if (!File.exists(fn)) {
162                 console.log('missing docc file ' + fn);
163                 this.comments[ns] = {};
164                 
165                 return;
166             }
167             var doc = xml.parseFile(fn);
168             //console.log("xmldoc?" + doc);
169             walk (doc.root, '');
170             //console.dump(ret);
171             this.comments[ns] = ret;
172             //console.dump(ret);
173
174         },
175        
176         
177         doc : function(what) {
178             var ns = what.split('.').shift();
179             this.commentLoad(ns);
180             return typeof(this.comments[ns][what]) == 'undefined' ?  '' : this.comments[ns][what];
181         },
182   
183         getPropertiesFor: function(ename, type)
184         {
185             print("Loading for " + ename);
186             
187             if (typeof(this.proplist[ename]) != 'undefined') {
188                     return this.proplist[ename][type];
189             }
190             // use introspection to get lists..
191             var gi = GIRepository.IRepository.get_default();
192             var es = ename.split('.');
193             var bi = gi.find_by_name(es[0], es[1]);
194             
195             if (!bi) {
196                 print("COULND NOT FIND BY NAME");
197                 return [];
198             }
199             var etype = GIRepository.base_info_get_type(bi);
200             var meth = etype == GIRepository.IInfoType.INTERFACE ?
201                 [ 
202                     'interface_info_get_n_properties',
203                     'interface_info_get_property',
204                     'interface_info_get_n_signals',
205                     'interface_info_get_signal',
206                     'interface_info_get_n_methods',
207                     'interface_info_get_method'
208                 ] : [ 
209                     'object_info_get_n_properties',
210                     'object_info_get_property',
211                     'object_info_get_n_signals',
212                     'object_info_get_signal',
213                     'object_info_get_n_methods',
214                     'object_info_get_method'
215                 ]; 
216             
217             
218             this.proplist[ename] = {}
219             this.proplist[ename]['props'] = [];
220             this.proplist[ename]['events'] = [];
221             this.proplist[ename]['methods'] = [];
222             this.proplist[ename]['inherits']= [];
223             
224             var plist = this.proplist[ename]['props'] ;
225             var elist = this.proplist[ename]['events'];
226             var mlist = this.proplist[ename]['methods'];
227             var ilist = this.proplist[ename]['inherits'];
228              /*
229              we need...
230              p.name
231             p.type
232             p.desc
233             p.sig */
234             
235             // properties.. -- and parent ones...!!!
236             for (var i =0;i <  GIRepository[meth[0]](bi); i++) {
237                 var prop = GIRepository[meth[1]](bi, i);  
238                 var n_original =  GIRepository.base_info_get_name(prop);
239                 
240                 var flags =  GIRepository.property_info_get_flags(prop); // check for readonly..
241                 
242                 
243                 var ty = this.typeToName(GIRepository.property_info_get_type(prop));
244                 print (n_original +":"+ ty);
245                 if (ty === false) {
246                     continue;
247                 }
248                 var add = {
249                      name :  n_original.replace(/\-/g, '_'),
250                      type :  ty,
251                      desc : this.doc(ename + '.' + n_original),
252                      sig : ''
253                 }
254                 plist.push(add)
255             }
256            
257            
258            
259            
260            
261             // signals..
262             
263             for (var i =0;i <  GIRepository[meth[2]](bi); i++) {
264                 var prop = GIRepository[meth[3]](bi, i);  
265                 var n_original =  GIRepository.base_info_get_name(prop);
266                 // print ('signal: ' + n_original); 
267                 var add = {
268                     name :  n_original.replace(/\-/g, '_'),
269                     type : 'function', //???
270                     desc : this.doc(ename + '.signal.' + n_original),
271                     sig  : this.genSkel(prop) // fixme..
272                 }
273                 elist.push(add);
274             }
275             // methods
276             
277             for (var i =0;i <  GIRepository[meth[4]](bi); i++) {
278                 var prop = GIRepository[meth[5]](bi, i);  
279                 var n_original =  GIRepository.base_info_get_name(prop);
280                 // print ('signal: ' + n_original); 
281                 var add = {
282                     name :  n_original.replace(/\-/g, '_'),
283                     type : 'function', //???
284                     desc : this.doc(ename + '.signal.' + n_original),
285                 }
286                 this.getParams(prop,add);
287                 mlist.push(add);
288             }
289             
290             
291             
292             
293             
294             
295             if (etype == GIRepository.IInfoType.INTERFACE ) {
296                   return;
297             }
298             
299             // parent!!?!!?
300             var pi = GIRepository.object_info_get_parent(bi);
301             
302             if (pi) {
303                 
304                    
305                 var pname = GIRepository.base_info_get_namespace(pi) + '.' +
306                     GIRepository.base_info_get_name(pi);
307                 this.getPropertiesFor(pname, 'props');
308                 
309                 
310                 elist.push.apply(elist,this.proplist[pname]['events']);
311                 plist.push.apply(plist,this.proplist[pname]['props']);
312                 ilist.push(pname);
313                 ilist.push.apply(ilist,this.proplist[pname]['inherits']);
314                 this.overrides(this.proplist[pname]['methods'], mlist);
315                 
316                 
317             }
318             
319             // implements needs to be more carefull as it could add dupes..
320             // use the parent implements list to ensure no dupes..
321             for(var i =0; i < GIRepository.object_info_get_n_interfaces(bi); i++) {
322                  
323                 var prop = GIRepository.object_info_get_interface(bi,i);
324                 var iface = GIRepository.base_info_get_namespace(prop) +'.'+ 
325                     GIRepository.base_info_get_name(prop);
326                 if ( ilist.indexOf(iface) > -1) {
327                     continue;
328                 }
329                 this.getPropertiesFor(iface, 'props'); // just load one of them..
330                 ilist.push(iface);
331                 
332                 elist.push.apply(elist,this.proplist[iface]['events']);
333                 plist.push.apply(plist,this.proplist[iface]['props']);
334                 this.overrides(this.proplist[pname]['methods'], mlist);
335             }
336             function sfunc(a,b) {
337                 if (a.name == b.name) return 0;
338                 return a.name > b.name ? 1 : -1
339             }
340             plist.sort(sfunc);
341             elist.sort(sfunc);
342             mlist.sort(sfunc);
343             
344             return this.proplist[ename][type];
345             
346         },
347         genParams: function(sig, meth)
348         {
349             var args = ['self'];
350             var ret = "\n";
351             meth.ret_type = this.typeToName(GIRepository.callable_info_get_return_type(sig));
352             // might be a numbeR??
353             meth.params = [];
354             for(var a_i  =0; a_i   < GIRepository.callable_info_get_n_args(sig); a_i++) {
355                 var arg = GIRepository.callable_info_get_arg(sig, a_i);
356                  
357                 meth.params.push({
358                     name : GIRepository.base_info_get_name(arg),
359                     type : this.typeToName(GIRepository.property_info_get_type(arg), true)
360                 });
361             }
362             
363                 
364             
365             
366         },
367         genSkel: function(sig) // should really use genParams...
368         {
369             var args = ['self'];
370             var ret = "\n";
371             var ret_type = this.typeToName(GIRepository.callable_info_get_return_type(sig));
372             // might be a numbeR??
373             if (ret_type == 'boolean') {
374                 ret = "    return false;\n";
375             }
376             for(var a_i  =0; a_i   < GIRepository.callable_info_get_n_args(sig); a_i++) {
377                 var arg = GIRepository.callable_info_get_arg(sig, a_i);
378                 
379                 args.push(GIRepository.base_info_get_name(arg));
380             }
381             return 'function (' + args.join(', ') + ") {\n" + ret + "}"; 
382                 
383             
384             
385         },
386         typeToName  : function (type_info, allow_iface) // find type for properties or arguments.
387         {
388            var ty = GIRepository.type_tag_to_string( GIRepository.type_info_get_tag(type_info));
389            
390             if ((ty == 'void') && GIRepository.type_info_is_pointer(type_info)) {
391                 return false;
392             }
393             if (ty == 'array') {
394                 return false; // unspported   
395             }
396             if (ty != 'interface') {
397                 return ty;
398             }
399             // we can accept enum types here..
400             var interface_info = GIRepository.type_info_get_interface (type_info);        
401             var interface_type = GIRepository.base_info_get_type (interface_info);
402             
403             if (!allow_iterface && interface_type != GIRepository.IInfoType.ENUM) {
404                 return false;
405             }
406             return GIRepository.base_info_get_namespace(interface_info) + '.' +
407                     GIRepository.base_info_get_name(interface_info);
408             
409         },
410         
411         overrides : function (top, bottom)
412         {
413             function inTop(b)
414             {
415                 return top.every(function(t) {
416                     if (t.name == b.name) {
417                         return false;
418                     }
419                 });
420             }
421             bottom.forEach(function(e) {
422                 if (!inTop(e)) {
423                     top.push(e);
424                 }
425             }
426             
427         }
428         
429         /**
430          * guess type..
431          * 
432          */
433         findType : function (data, prop, value)
434         {
435             // specials??
436             if ((prop == '|xns') || (prop == 'xtype'))  {
437                 return 'string';
438             }
439             
440             var qname = this.guessName(data);
441             if (prop[0] == '|') {
442                 prop= prop.substring(1);
443             }
444             
445             var prs = this.getPropertiesFor(qname, 'props');
446             var ret = false;
447             prs.forEach(function(e) {
448                 if (ret !== false) {
449                     return; // got it.
450                 }
451                 if (e.name == prop) {
452                     ret = e;
453                 }
454                 
455             });
456             if (!ret) {
457                 return Base.prototype.findType(data, prop,value);
458             }
459              
460             // got the type
461             return ret.type;
462         },
463         
464         findOptions : function(ename)
465         {
466             
467             var es = ename.split('.');
468             if (es.length !=2) {
469                 return Base.prototype.findOptions(ename);
470             }
471             var gi = GIRepository.IRepository.get_default();
472             var bi = gi.find_by_name(es[0], es[1]);
473             var etype = GIRepository.base_info_get_type(bi);
474             if (etype != GIRepository.IInfoType.ENUM) {
475                 console.log("Options not handled yet!!!");
476                 return false;
477             }
478             var ret = [];
479             // got an enum.. let's return the values..
480             for(var i =0; i < GIRepository.enum_info_get_n_values(bi); i++) {
481                  
482                   var prop = GIRepository.enum_info_get_value(bi,i);
483                    
484                 
485                   ret.push( ename + '.' + GIRepository.base_info_get_name(prop).toUpperCase() ) 
486             }
487             return ret;
488         },
489         /**
490          * determine the packing types..
491          */
492         getDefaultPack: function(pname, cname) {
493             var list = this.getPackingList(pname,cname);
494             console.dump(list);
495             if (!list.every(function(e) { return e.name =='add'; })) {
496                 return 'add'; // add is in our list..?? what about args..?!?
497             }
498             function toRet(e) {
499                 var ret = [e.name];
500                 e.params.forEach(function(p,i) {
501                     if (ret == false) { return; } // skip broken..
502                     if (i==0) { return; } // skip first..
503                     if (p.type == 'boolean') {
504                         ret.push('false');
505                         return;
506                     }
507                     if (p.type == 'number') {
508                         ret.push('0');
509                         return;
510                     }
511                     ret = false; // invalid!
512                 })
513                 return ret;
514             }
515             var packret = false;
516             list.every(function(e) {
517                 packret = toRet(e);
518                 if (packret !== false) {
519                     return false;
520                 }
521             });
522             
523             // should we do best match..?
524             return packret;
525         },
526         /**
527          * get packing list..
528          */
529         getPackingList :function (pname, cname)
530         {
531             var funcs = this.getPropertiesFor(pname,'methods');
532             var ret = [];
533             var _this = this;
534             // let's assume top down...
535             var inherits = [ cname ];
536             inherits.push.apply(inherits, this.getPropertiesFor(cname,'inherits'));
537             funcs.foreach(function(m) {
538                 if (m.params.length && typeof(m.params[0].type) == 'string') &&
539                     inherits.indexOf(m.params[0].type) > -1) {
540                     ret.push(m);
541                 }
542             });
543             return ret; 
544         }
545         
546         
547     }
548 );
549