git.roojs.org Git - app.Builder.js/blob - 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          * merge two proprety arrays' ignoring what's overrriden.
 412          *
 413          */
 414
 415
 416         overrides : function (top, bottom)
 417         {
 418             function inTop(b)
 419             {
 420                 return top.every(function(t) {
 421                     if (t.name == b.name) {
 422                         return false;
 423                     }
 424                 });
 425             }
 426             bottom.forEach(function(e) {
 427                 if (!inTop(e)) {
 428                     top.push(e);
 429                 }
 430             });
 431
 432         },
 433
 434         /**
 435          * guess type..
 436          *
 437          */
 438         findType : function (data, prop, value)
 439         {
 440             // specials??
 441             if ((prop == '|xns') || (prop == 'xtype'))  {
 442                 return 'string';
 443             }
 444
 445             var qname = this.guessName(data);
 446             if (prop[0] == '|') {
 447                 prop= prop.substring(1);
 448             }
 449
 450             var prs = this.getPropertiesFor(qname, 'props');
 451             var ret = false;
 452             prs.forEach(function(e) {
 453                 if (ret !== false) {
 454                     return; // got it.
 455                 }
 456                 if (e.name == prop) {
 457                     ret = e;
 458                 }
 459
 460             });
 461             if (!ret) {
 462                 return Base.prototype.findType(data, prop,value);
 463             }
 464
 465             // got the type
 466             return ret.type;
 467         },
 468
 469         findOptions : function(ename)
 470         {
 471
 472             var es = ename.split('.');
 473             if (es.length !=2) {
 474                 return Base.prototype.findOptions(ename);
 475             }
 476             var gi = GIRepository.IRepository.get_default();
 477             var bi = gi.find_by_name(es[0], es[1]);
 478             var etype = GIRepository.base_info_get_type(bi);
 479             if (etype != GIRepository.IInfoType.ENUM) {
 480                 console.log("Options not handled yet!!!");
 481                 return false;
 482             }
 483             var ret = [];
 484             // got an enum.. let's return the values..
 485             for(var i =0; i < GIRepository.enum_info_get_n_values(bi); i++) {
 486
 487                   var prop = GIRepository.enum_info_get_value(bi,i);
 488
 489
 490                   ret.push( ename + '.' + GIRepository.base_info_get_name(prop).toUpperCase() )
 491             }
 492             return ret;
 493         },
 494         /**
 495          * determine the packing types..
 496          */
 497         getDefaultPack: function(pname, cname) {
 498             var list = this.getPackingList(pname,cname);
 499             console.dump(list);
 500             if (!list.every(function(e) { return e.name =='add'; })) {
 501                 return 'add'; // add is in our list..?? what about args..?!?
 502             }
 503             function toRet(e) {
 504                 var ret = [e.name];
 505                 e.params.forEach(function(p,i) {
 506                     if (ret == false) { return; } // skip broken..
 507                     if (i==0) { return; } // skip first..
 508                     if (p.type == 'boolean') {
 509                         ret.push('false');
 510                         return;
 511                     }
 512                     if (p.type == 'number') {
 513                         ret.push('0');
 514                         return;
 515                     }
 516                     ret = false; // invalid!
 517                 })
 518                 return ret;
 519             };
 520             var packret = false;
 521             list.every(function(e) {
 522                 packret = toRet(e);
 523                 if (packret !== false) {
 524                     return false;
 525                 }
 526             });
 527
 528             // should we do best match..?
 529             return packret;
 530         },
 531         /**
 532          * get packing list..
 533          */
 534         getPackingList :function (pname, cname)
 535         {
 536             var funcs = this.getPropertiesFor(pname,'methods');
 537             var ret = [];
 538             var _this = this;
 539             // let's assume top down...
 540             var inherits = [ cname ];
 541             inherits.push.apply(inherits, this.getPropertiesFor(cname,'inherits'));
 542             funcs.forEach(function(m) {
 543                 if (m.params.length && (typeof(m.params[0].type) == 'string') &&
 544                     inherits.indexOf(m.params[0].type) > -1) {
 545                     ret.push(m);
 546                 }
 547             });
 548             return ret;
 549         }
 550
 551
 552     }
 553 );
 554