Builder/Provider/Palete/Gtk.js
[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                 elist.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                 elist.push.apply(elist,this.proplist[pname]['events']);
310                 plist.push.apply(plist,this.proplist[pname]['props']);
311                 ilist.push.apply(ilist,this.proplist[pname]['inherits']);
312             }
313             
314             // implements needs to be more carefull as it could add dupes..
315             // use the parent implements list to ensure no dupes..
316             for(var i =0; i < GIRepository.object_info_get_n_interfaces(bi); i++) {
317                  
318                 var prop = GIRepository.object_info_get_interface(bi,i);
319                 var iface = GIRepository.base_info_get_namespace(prop) +'.'+ 
320                     GIRepository.base_info_get_name(prop);
321                 if ( ilist.indexOf(iface) > -1) {
322                     continue;
323                 }
324                 this.getPropertiesFor(iface, 'props');
325                 ilist.push(iface);
326                 elist.push.apply(elist,this.proplist[iface]['events']);
327                 plist.push.apply(plist,this.proplist[iface]['props']);
328             }
329             function sfunc(a,b) {
330                 if (a.name == b.name) return 0;
331                 return a.name > b.name ? 1 : -1
332             }
333             plist.sort(sfunc);
334             elist.sort(sfunc);
335             
336             
337             return this.proplist[ename][type];
338             
339         },
340         genParams: function(sig, meth)
341         {
342             var args = ['self'];
343             var ret = "\n";
344             meth.ret_type = this.typeToName(GIRepository.callable_info_get_return_type(sig));
345             // might be a numbeR??
346             meth.params = [];
347             for(var a_i  =0; a_i   < GIRepository.callable_info_get_n_args(sig); a_i++) {
348                 var arg = GIRepository.callable_info_get_arg(sig, a_i);
349                  
350                 meth.params.push({
351                     name : GIRepository.base_info_get_name(arg),
352                     type : this.typeToName(GIRepository.property_info_get_type(arg), true);
353                 });
354             }
355             
356                 
357             
358             
359         },
360         genSkel: function(sig) // should really use genParams...
361         {
362             var args = ['self'];
363             var ret = "\n";
364             var ret_type = this.typeToName(GIRepository.callable_info_get_return_type(sig));
365             // might be a numbeR??
366             if (ret_type == 'boolean') {
367                 ret = "    return false;\n";
368             }
369             for(var a_i  =0; a_i   < GIRepository.callable_info_get_n_args(sig); a_i++) {
370                 var arg = GIRepository.callable_info_get_arg(sig, a_i);
371                 
372                 args.push(GIRepository.base_info_get_name(arg));
373             }
374             return 'function (' + args.join(', ') + ") {\n" + ret + "}"; 
375                 
376             
377             
378         },
379         typeToName  : function (type_info, allow_iface) // find type for properties or arguments.
380         {
381            var ty = GIRepository.type_tag_to_string( GIRepository.type_info_get_tag(type_info));
382            
383             if ((ty == 'void') && GIRepository.type_info_is_pointer(type_info)) {
384                 return false;
385             }
386             if (ty == 'array') {
387                 return false; // unspported   
388             }
389             if (ty != 'interface') {
390                 return ty;
391             }
392             // we can accept enum types here..
393             var interface_info = GIRepository.type_info_get_interface (type_info);        
394             var interface_type = GIRepository.base_info_get_type (interface_info);
395             
396             if (!allow_iterface && interface_type != GIRepository.IInfoType.ENUM) {
397                 return false;
398             }
399             return GIRepository.base_info_get_namespace(interface_info) + '.' +
400                     GIRepository.base_info_get_name(interface_info);
401             
402         },
403         /**
404          * guess type..
405          * 
406          */
407         findType : function (data, prop, value)
408         {
409             // specials??
410             if ((prop == '|xns') || (prop == 'xtype'))  {
411                 return 'string';
412             }
413             
414             var qname = this.guessName(data);
415             if (prop[0] == '|') {
416                 prop= prop.substring(1);
417             }
418             
419             var prs = this.getPropertiesFor(qname, 'props');
420             var ret = false;
421             prs.forEach(function(e) {
422                 if (ret !== false) {
423                     return; // got it.
424                 }
425                 if (e.name == prop) {
426                     ret = e;
427                 }
428                 
429             });
430             if (!ret) {
431                 return Base.prototype.findType(data, prop,value);
432             }
433              
434             // got the type
435             return ret.type;
436         },
437         
438         findOptions : function(ename)
439         {
440             
441             var es = ename.split('.');
442             if (es.length !=2) {
443                 return Base.prototype.findOptions(ename);
444             }
445             var gi = GIRepository.IRepository.get_default();
446             var bi = gi.find_by_name(es[0], es[1]);
447             var etype = GIRepository.base_info_get_type(bi);
448             if (etype != GIRepository.IInfoType.ENUM) {
449                 console.log("Options not handled yet!!!");
450                 return false;
451             }
452             var ret = [];
453             // got an enum.. let's return the values..
454             for(var i =0; i < GIRepository.enum_info_get_n_values(bi); i++) {
455                  
456                   var prop = GIRepository.enum_info_get_value(bi,i);
457                    
458                 
459                   ret.push( ename + '.' + GIRepository.base_info_get_name(prop).toUpperCase() ) 
460             }
461             return ret;
462         },
463         /**
464          * determine the packing types..
465          */
466         getDefaultPack: function(pname, cname) {
467             return 'add';
468         },
469         /**
470          * get packing list..
471          */
472         getPackingList :function (pname, cname)
473         {
474             var funcs = this.listMethods(pname);
475             var ret = [];
476             var _this = this;
477             funcs.foreach(function(m) {
478                 if (m.params.length && _this.isA(m.params[0].type, cname)) {
479                     ret.push(m);
480                 }
481             });
482              
483         }
484         
485         
486     }
487 );
488