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 var ar = parent.split('.')
284 if (parent == 'Gtk.Bin' || methods['Gtk.Bin'].extendsClasses.indexOf(parent) > -1) {
287 if (['GtkSource.CompletionInfo',
289 'GtkSource.View', // ??? nothing can be added to it?
290 'WebKit.WebView', // ??? nothing can be added to it?
292 ].indexOf(parent) > -1) {
299 var x = new imports.gi[ns][cls]();
301 print("TRY ctor: " + parent );
306 //print("TRY child type: " + parent);
307 var ct = x.child_type();
308 //print(parent + " : says children are of type : " + ct);
309 // get the Gtype for the child?
310 var GObject = imports.gi.GObject;
311 var match = GObject.type_from_name(ar.join(''));
312 //print([match, ct]);
313 //print ("matching?" + (GObject.type_is_a(match, ct ) ? "YES" : "NO"));
316 return GObject.type_is_a(match, ct ) ? true : false;
320 function is_a(cls, instance_of) {
321 return methods[cls].extendsClasses.indexOf(instance_of) > -1;
324 function verifyUsage(parent,child)
326 // find all the methods that child can be added to parent.
327 var mts = methods[parent].can_contain_using;
328 for(var i =0;i<mts.length;i++) {
329 var m = mts[i].split(':');
330 if (!is_a(child,m[0])) {
334 if (verifyUsageMethod(parent,child,mts[i])) {
348 // basically anything that is a Gtk.Container, should be available at the top.
358 Gtk.FontSelectionDialog
360 Gtk.ColorSelectionDialog
361 Gtk.FileChooserDialog
366 // these should really be based on heirachy..
369 usage['*top'] = implementations['Gtk.Container'];
370 usage['*top'].forEach(function(ch) {
371 tops[ch] = [ '*top' ];
373 for(var cls in methods) {
374 if (cls =='Gtk.Builder') {
377 for (var par in methods[cls].can_be_added_to_as) {
379 if (!verifyUsage(par,cls)) {
383 if (typeof(usage[par]) == 'undefined') {
389 usage[par].pushUnique(cls);
390 if (typeof(tops[cls]) == 'undefined') {
393 tops[cls].pushUnique(par);
398 function canTop(cls, rec) {
401 //print('CANTOP: ' + cls + ' =' + rec);
403 // print('SKIP : ' + cls);
405 if (typeof(tops[cls]) == 'undefined') {
408 for (var i =0; i < tops[cls].length; i++) {
409 if (tops[cls][i] == '*top') {
412 if (cls == tops[cls][i]) {
415 if (canTop(tops[cls][i], rec+1)) {
422 for(var par in usage) {
423 var left = usage[par].join(',');
424 if (typeof(lefts[left]) == 'undefined') {
427 lefts[left].push(par);
429 print (JSON.stringify(lefts,null,4));
435 print (JSON.stringify(usage,null,4));
438 for(var par in usage) {
439 // see if the parent can be added to something.
444 for(var dupe in usage) {
446 && typeof(nusage[dupe]) != 'undefined'
447 && usage[par].join(',') == usage[dupe].join(',')) {
450 if (typeof(usage_left[dupe]) == 'undefined') {
451 usage_left[dupe] = [];
453 //print(par+ ' is a dupe of ' + dupe);
454 usage_left[dupe].pushUnique(par);
461 nusage[par] = usage[par];
465 //print(JSON.stringify(nusage,null,4)); Seed.exit();
466 print(JSON.stringify(methods['Gtk.TextView'],null,4));
469 for(var par in usage) {
472 if (typeof(usage_left[par]) != 'undefined') {
473 usage_left[par].forEach(function(d) { str.push(' ' + d);});
476 usage[par].forEach(function(d) { str.push(' ' + d);});
479 print(str.join("\n"));
480 //print(JSON.stringify(implementations ,null,4));
484 [has methods that use this object]
485 [list of methods of the top class..]
490 Gtk.Button.add(Gtk.Widget) <<
495 A) what can this dragged element be dropped onto.
497 - can_be_added_to_as (left)
501 B) what method is available when this object is dropped onto this one.
503 - get the right hand side?
511 //print(JSON.stringify(implementations,null,4));
514 imports.gi.Gtk.init(Seed.argv);
516 imports.gi.GtkClutter.init(Seed.argv);
519 // we now have a list of classes / methods that can be used..
520 // we now need a ui to flag stuff as "don't bother with"