1 //<Script type="text/javascript">
4 GIRepository = imports.gi.GIRepository;
6 console = imports.console;
7 XObject = imports.XObject.XObject;
9 Base = imports.Builder.Provider.Palete.Base.Base;
10 File = imports.File.File;
11 //----------------------- our roo verison
20 // various loader methods..
35 var data = File.read(__script_path__ +'/../GtkUsage.txt');
37 data = data.split(/\n/g);
43 data.forEach( function(d) {
44 if (!d.length || d.match(/^\s+$/) || d.match(/^\s*\//)) { //empty
47 if (d.match(/^left:/)) {
60 if (d.match(/^right:/)) {
65 left.push(d.replace(/\s+/g, ''));
68 right.push(d.replace(/\s+/g, ''));
84 commentLoad : function(ns)
87 if (typeof(this.comments[ns]) != 'undefined') {
91 console.log("LOAD DOCS: " + ns);
92 var gi = GIRepository.IRepository.get_default();
93 var ver = gi.get_version(ns);
95 this.comments[ns] = {};
100 // no idea why this is broken on my build system.
101 function getAttribute(n, name){
102 var properties = n.properties;
104 if (properties.name == name)
105 return properties.children.content;
106 properties = properties.next
112 function walk(element, path) {
119 var n = getAttribute(element, 'name') ;
120 //console.log("WALK" + n);
121 if (element.name == 'signal') {
125 path += path.length ? '.' : '';
128 if (element.name == 'return-value') {
129 path += '.return-value';
134 var d = getAttribute(element,'doc');
136 // Seed.print(path + ':' + d);
140 var child = element.children;
143 //console.log(child.tag);
144 if (child.type == "element"){
151 var pth = GIRepository.IRepository.get_search_path ();
154 var gir_path = pth[0].replace(/lib\/girepository-1.0/, 'share\/gir-1.0');
158 var fn = gir_path + '/'+ ns + '-' + ver + '.gir';
161 if (!File.exists(fn)) {
162 console.log('missing docc file ' + fn);
163 this.comments[ns] = {};
167 var doc = xml.parseFile(fn);
168 //console.log("xmldoc?" + doc);
171 this.comments[ns] = ret;
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];
183 getPropertiesFor: function(ename, type)
185 print("Loading for " + ename);
187 if (typeof(this.proplist[ename]) != 'undefined') {
188 return this.proplist[ename][type];
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]);
196 print("COULND NOT FIND BY NAME");
199 var etype = GIRepository.base_info_get_type(bi);
200 var meth = etype == GIRepository.IInfoType.INTERFACE ?
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'
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'
218 this.proplist[ename] = {}
219 this.proplist[ename]['props'] = [];
220 this.proplist[ename]['events'] = [];
221 this.proplist[ename]['methods'] = [];
222 this.proplist[ename]['inherits']= [];
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'];
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);
240 var flags = GIRepository.property_info_get_flags(prop); // check for readonly..
243 var ty = this.typeToName(GIRepository.property_info_get_type(prop));
244 print (n_original +":"+ ty);
249 name : n_original.replace(/\-/g, '_'),
251 desc : this.doc(ename + '.' + n_original),
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);
268 name : n_original.replace(/\-/g, '_'),
269 type : 'function', //???
270 desc : this.doc(ename + '.signal.' + n_original),
271 sig : this.genSkel(prop) // fixme..
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);
282 name : n_original.replace(/\-/g, '_'),
283 type : 'function', //???
284 desc : this.doc(ename + '.signal.' + n_original),
286 this.getParams(prop,add);
295 if (etype == GIRepository.IInfoType.INTERFACE ) {
300 var pi = GIRepository.object_info_get_parent(bi);
305 var pname = GIRepository.base_info_get_namespace(pi) + '.' +
306 GIRepository.base_info_get_name(pi);
307 this.getPropertiesFor(pname, 'props');
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']);
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++) {
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) {
324 this.getPropertiesFor(iface, 'props');
326 elist.push.apply(elist,this.proplist[iface]['events']);
327 plist.push.apply(plist,this.proplist[iface]['props']);
329 function sfunc(a,b) {
330 if (a.name == b.name) return 0;
331 return a.name > b.name ? 1 : -1
337 return this.proplist[ename][type];
340 genParams: function(sig, meth)
344 meth.ret_type = this.typeToName(GIRepository.callable_info_get_return_type(sig));
345 // might be a numbeR??
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);
351 name : GIRepository.base_info_get_name(arg),
352 type : this.typeToName(GIRepository.property_info_get_type(arg), true);
360 genSkel: function(sig)
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";
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);
372 args.push(GIRepository.base_info_get_name(arg));
374 return 'function (' + args.join(', ') + ") {\n" + ret + "}";
379 typeToName : function (type_info, allow_iface) // find type for properties or arguments.
381 var ty = GIRepository.type_tag_to_string( GIRepository.type_info_get_tag(type_info));
383 if ((ty == 'void') && GIRepository.type_info_is_pointer(type_info)) {
387 return false; // unspported
389 if (ty != 'interface') {
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);
396 if (!allow_iterface && interface_type != GIRepository.IInfoType.ENUM) {
399 return GIRepository.base_info_get_namespace(interface_info) + '.' +
400 GIRepository.base_info_get_name(interface_info);
407 findType : function (data, prop, value)
410 if ((prop == '|xns') || (prop == 'xtype')) {
414 var qname = this.guessName(data);
415 if (prop[0] == '|') {
416 prop= prop.substring(1);
419 var prs = this.getPropertiesFor(qname, 'props');
421 prs.forEach(function(e) {
425 if (e.name == prop) {
431 return Base.prototype.findType(data, prop,value);
438 findOptions : function(ename)
441 var es = ename.split('.');
443 return Base.prototype.findOptions(ename);
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!!!");
453 // got an enum.. let's return the values..
454 for(var i =0; i < GIRepository.enum_info_get_n_values(bi); i++) {
456 var prop = GIRepository.enum_info_get_value(bi,i);
459 ret.push( ename + '.' + GIRepository.base_info_get_name(prop).toUpperCase() )
464 * determine the packing types..
466 getDefaultPack: function(pname, cname) {
472 getPackingList :function (pname, cname)
474 var funcs = this.listMethods(pname);
477 funcs.foreach(function(m) {
478 if (m.params.length && _this.isA(m.params[0].type, cname)) {