1 //<script type="text/javascript">
7 * this.data = new BuildLists();
14 // see if we can build the insertion tree for gtk - using introspection
16 // it should build the tree of feasible insertions, then we will have to manually prune it..
19 // a) what the inherited types are
20 // b) what methods are available for each type, that include a reference to another type..
22 // let's start with types..
23 GIRepository = imports.gi.GIRepository;
24 GLib = imports.gi.GLib;
26 // we add this in, as it appears to get lost sometimes if we set it using the ENV. variable in builder.sh
27 //GIRepository.Repository.prepend_search_path(GLib.get_home_dir() + '/.Builder/girepository-1.1');
30 imports.searchPath.push('../../gnome.introspection-doc-generator');
32 XObject = imports.XObject.XObject;
33 File = imports.File.File;
35 // Introspecion specific..
36 NameSpace = imports.Introspect.NameSpace.NameSpace;
37 Link = imports.Introspect.Link.Link;
40 Array.prototype.pushUnique = function(v) {
41 if (this.indexOf(v) < 0) {
46 function BuildLists () {
51 var ns_list = [ 'Gtk' , 'Gdk', 'Pango', 'GtkSource', 'WebKit', 'Vte', 'GtkClutter'] ; //NameSpace.namespaces();
53 ns_list = ns_list.sort();
54 // let's try and load them, so we find out early what will fail.
55 print("loading library to make sure it works.");
59 ns_list.forEach(function(ns_name) {
60 var core = imports.gi[ns_name];
61 var ns = NameSpace.ns(ns_name); // fetch all the elements in namespace...
62 ns['objects'].forEach( function(n) {
63 var odata = NameSpace.factory('Class', ns_name, n);
64 classes[odata.alias] = odata;
67 ns['interfaces'].forEach( function(n) {
68 var odata =NameSpace.factory('Interface', ns_name, n);
69 classes[odata.alias] = odata;
72 //print(JSON.stringify(classes['Gtk.CellRenderer'] , null, 4));
73 //print(JSON.stringify(classes['Gtk.CellRenderer'].titleType, null, 4));
74 //print(JSON.stringify(classes['Gtk.CellRenderer'].childClasses, null, 4));
75 //print(JSON.stringify(classes['Gtk.CellRenderer'].implementedBy, null, 4));
79 print("Looping throught namespaces");
81 var implementations = {};
86 for (cls in classes) {
87 var odata = classes[cls];
90 //titleType : odata.titleType,
93 can_contain_using: [],
94 // can_be_added_to : [],
95 //using_methods : { },
96 can_be_added_to_as : {}
98 odata.extendsClasses.forEach(function(child) {
99 methods[cls].extendsClasses.push(child.alias);
102 implementations[odata.alias] = odata.titleType == 'Class' ? odata.childClasses : odata.implementedBy;
105 for (cls in classes) {
106 var odata = classes[cls];
111 //print(JSON.stringify(odata.methods,null,4));
112 odata.methods.forEach(function(m) {
117 if (!m.name.match(/^(add|pack)/)) {
120 //print(JSON.stringify(m,null,4));
121 m.params.forEach(function(p) {
123 if (!p.type || typeof(classes[p.type]) == 'undefined') {
127 //print(JSON.stringify(p));Seed.exit();
128 var addable_type = p.type;
129 if (addable_type.indexOf('.') < 0) {
130 addable_type = p.memberOf + '.' + p.type;
133 if (m.memberOf == 'Gtk.Buildable') {
136 //"Gtk.Widget:add_accelerator",
137 //"Gtk.Widget:add_device_events"
139 if (m.name.match(/^(add_mnemonic_label|add_accelerator|add_device_events)$/)) {
143 // in theory you can not add a window to anything.. ???
144 //if ('Gtk.Window' == addable_type || methods[addable_type].extendsClasses.indexOf('Gtk.Window') > -1) {
149 //print(full_method_name );
151 //if (allmethods.indexOf(full_method_name) < 0) {
152 // allmethods.push(full_method_name);
155 methods[cls].can_contain.pushUnique(addable_type);
156 var add = m.memberOf +':'+ m.name;
158 methods[cls].can_contain_using.pushUnique(add);
159 //methods[cls].using_methods[m.name] = m.params;
161 //if (methods[addable_type].can_be_added_to.indexOf(cls) < 0) {
162 // methods[addable_type].can_be_added_to.push(cls);
167 if (typeof(methods[addable_type].can_be_added_to_as[cls]) == 'undefined') {
168 methods[addable_type].can_be_added_to_as[cls]=[];
170 methods[addable_type].can_be_added_to_as[cls].pushUnique( add );
171 implementations[cls].forEach(function(imp) {
174 if (typeof(methods[addable_type ].can_be_added_to_as[imp]) == 'undefined') {
175 methods[addable_type].can_be_added_to_as[imp] = [];
178 methods[addable_type].can_be_added_to_as[imp].pushUnique(add);
183 //print(addable_type);
184 //print(JSON.stringify(implementations[addable_type], null,4));
187 implementations[addable_type].forEach(function(addable_child) {
189 //if (addable_child == 'Gtk.AboutDialog') {
190 // print(JSON.stringify(methods[addable_child].extendsClasses,null,4));Seed.exit();
194 if (addable_child == 'Gtk.Window' ||
195 methods[addable_child].extendsClasses.indexOf('Gtk.Window') > -1) {
199 if (typeof(methods[addable_child].can_be_added_to_as[cls]) == 'undefined') {
200 methods[addable_child].can_be_added_to_as[cls]=[];
202 methods[addable_child].can_be_added_to_as[cls].pushUnique( add );
203 implementations[cls].forEach(function(imp) {
204 if (typeof(methods[addable_child ].can_be_added_to_as[imp]) == 'undefined') {
205 methods[addable_child].can_be_added_to_as[imp] = [];
208 methods[addable_child].can_be_added_to_as[imp].pushUnique(add);
227 methods[cls].using_methods[m.name] = {};
231 if (typeof(methods[cls][full_method_name]) == 'undefined') {
232 methods[cls][full_method_name] = [];
234 if (methods[cls][full_method_name].indexOf(m.name) > -1) {
237 methods[cls][full_method_name].push(m.name);
242 //for(method in odata.methods) {
243 // print(method.name);
249 // fill in the added to list..
250 for(var p in methods ) {
251 var odata = methods[p];
253 methods[p].can_be_added_to.forEach(function(c) {
254 methods[p].can_be_added_to_as[c]=c;
255 implementations[c].forEach(function(imp) {
256 methods[p].can_be_added_to_as[imp]=c;
263 // now do the reverese 'can be added to'
267 this.methods = methods;
268 this.allmethods = methods;
269 this.implementations = implementations;
270 //print(JSON.stringify(methods,null,4)); Seed.exit();
271 // dump out a usage file..
273 function verifyUsageMethod(parent,child,method)
275 // currently only verifies add on container.
276 if (method !='Gtk.Container:add') {
279 if (failed.indexOf(parent) > -1) {
283 var ar = parent.split('.')
288 if (parent == 'Gtk.Bin' || methods['Gtk.Bin'].extendsClasses.indexOf(parent) > -1) {
291 if (['GtkSource.CompletionInfo',
293 'GtkSource.View', // ??? nothing can be added to it?
294 'WebKit.WebView', // ??? nothing can be added to it?
296 ].indexOf(parent) > -1) {
303 var x = new imports.gi[ns][cls]();
306 print("TRY ctor: " + parent );
307 print(JSON.stringify(e));
311 //print("TRY child type: " + parent);
312 var ct = x.child_type();
313 //print(parent + " : says children are of type : " + ct);
314 // get the Gtype for the child?
315 var GObject = imports.gi.GObject;
316 var match = GObject.type_from_name(ar.join(''));
317 //print([match, ct]);
318 //print ("matching?" + (GObject.type_is_a(match, ct ) ? "YES" : "NO"));
321 return GObject.type_is_a(match, ct ) ? true : false;
325 function is_a(cls, instance_of) {
326 return methods[cls].extendsClasses.indexOf(instance_of) > -1;
329 function verifyUsage(parent,child)
331 // find all the methods that child can be added to parent.
332 var mts = methods[parent].can_contain_using;
333 for(var i =0;i<mts.length;i++) {
334 var m = mts[i].split(':');
335 if (!is_a(child,m[0])) {
339 if (verifyUsageMethod(parent,child,mts[i])) {
353 // basically anything that is a Gtk.Container, should be available at the top.
363 Gtk.FontSelectionDialog
365 Gtk.ColorSelectionDialog
366 Gtk.FileChooserDialog
371 // these should really be based on heirachy..
374 usage['*top'] = implementations['Gtk.Container'];
375 usage['*top'].forEach(function(ch) {
376 tops[ch] = [ '*top' ];
378 for(var cls in methods) {
379 if (cls =='Gtk.Builder') {
382 for (var par in methods[cls].can_be_added_to_as) {
384 if (!verifyUsage(par,cls)) {
388 if (typeof(usage[par]) == 'undefined') {
394 usage[par].pushUnique(cls);
395 if (typeof(tops[cls]) == 'undefined') {
398 tops[cls].pushUnique(par);
403 function canTop(cls, rec) {
406 //print('CANTOP: ' + cls + ' =' + rec);
408 // print('SKIP : ' + cls);
410 if (typeof(tops[cls]) == 'undefined') {
413 for (var i =0; i < tops[cls].length; i++) {
414 if (tops[cls][i] == '*top') {
417 if (cls == tops[cls][i]) {
420 if (canTop(tops[cls][i], rec+1)) {
427 for(var par in usage) {
428 var left = usage[par].join(',');
429 if (typeof(lefts[left]) == 'undefined') {
432 lefts[left].push(par);
434 print (JSON.stringify(lefts,null,4));
440 print (JSON.stringify(usage,null,4));
443 for(var par in usage) {
444 // see if the parent can be added to something.
449 for(var dupe in usage) {
451 && typeof(nusage[dupe]) != 'undefined'
452 && usage[par].join(',') == usage[dupe].join(',')) {
455 if (typeof(usage_left[dupe]) == 'undefined') {
456 usage_left[dupe] = [];
458 //print(par+ ' is a dupe of ' + dupe);
459 usage_left[dupe].pushUnique(par);
466 nusage[par] = usage[par];
470 //print(JSON.stringify(nusage,null,4)); Seed.exit();
471 print(JSON.stringify(methods['Gtk.TextView'],null,4));
474 for(var par in usage) {
477 if (typeof(usage_left[par]) != 'undefined') {
478 usage_left[par].forEach(function(d) { str.push(' ' + d);});
481 usage[par].forEach(function(d) { str.push(' ' + d);});
484 print(str.join("\n"));
485 //print(JSON.stringify(implementations ,null,4));
489 [has methods that use this object]
490 [list of methods of the top class..]
495 Gtk.Button.add(Gtk.Widget) <<
500 A) what can this dragged element be dropped onto.
502 - can_be_added_to_as (left)
506 B) what method is available when this object is dropped onto this one.
508 - get the right hand side?
516 //print(JSON.stringify(implementations,null,4));
519 imports.gi.Gtk.init(Seed.argv);
521 imports.gi.GtkClutter.init(Seed.argv);
524 // we now have a list of classes / methods that can be used..
525 // we now need a ui to flag stuff as "don't bother with"