1 //<script type="text/javascript">
2 //Gtk = imports.gi.Gtk;
3 GI = imports.gi.GIRepository;
4 GLib = imports.gi.GLib;
8 imports['Object.js'].load(Object);
10 console = imports['console.js'].console;
11 JSDOC = imports['JSDOC.js'].JSDOC;
13 xnew = imports['xnew.js'].xnew;
20 xnew.load(Introspect,'JSDOC/Introspect');
24 Object.extend(Introspect, {
29 namespaces : function(ns)
31 // this should be a class of it's own...
32 this.references[ns] = []; // technically not needed - but fills in files..
33 // get this from GI... (it's the path..)
38 if (!GLib.file_test(dir, GLib.FileTest.EXISTS)) {
41 var gdir = GLib.dir_open(dir,0);
45 var fn = GLib.dir_read_name(gdir);
46 // console.log('trying ' + fn);
51 if (!fn.match(/.typelib$/)) {
54 var par = fn.split('-').shift();
55 //console.log('trying ' + par);
56 if (ret.indexOf(par) > -1) {
64 var gi = GI.IRepository.get_default();
65 var pth = GI.IRepository.get_search_path ();
76 var gi = GI.IRepository.get_default();
78 titleType: 'Namespace',
89 // so ns looks like class..
91 extendsClasses : [], // what it extends...
92 childClasses : [], // what uses it..
96 values : [], /// really constants.
101 for (var i=0; i < gi.get_n_infos (ns); i++ ) {
102 var info = gi.get_info (ns, i);
104 var info_type = GI.base_info_get_type (info);
106 case GI.IInfoType.OBJECT:
107 ret.objects.push(GI.base_info_get_name(info));
108 this.clsGatherInterfaces(ns , GI.base_info_get_name(info));
110 case GI.IInfoType.INTERFACE:
111 ret.interfaces.push(GI.base_info_get_name(info));
113 case GI.IInfoType.FUNCTION:
114 new Introspect.Method(info, ret, 'functions', []);
117 case GI.IInfoType.CALLBACK:
118 // new Introspect.Callback(info, ret, 'callbacks', []);
121 case GI.IInfoType.ENUM:
122 case GI.IInfoType.FLAGS:
123 ret.enums.push(GI.base_info_get_name(info));
125 case GI.IInfoType.STRUCT:
126 if (GI.struct_info_is_gtype_struct (info)) {
130 ret.structs.push(GI.base_info_get_name(info));
132 case GI.IInfoType.UNION:
133 ret.unions.push(GI.base_info_get_name(info));
135 case GI.IInfoType.CONSTANT:
136 new Introspect.Constant(info, ret, 'values', []);
145 //console.dump(this.ifaceList);
152 // store all the interfaces, so we can show a list of them later...
153 // called when you list the namespace
154 clsGatherInterfaces : function(ns, cls)
156 var gi = GI.IRepository.get_default();
157 var bb = gi.find_by_name(ns, cls);
158 var fullname = ns+'.'+cls;
159 this.ifaceList = this.ifaceList || { };
162 for(var i =0; i < GI.object_info_get_n_interfaces(bb); i++) {
164 var prop = GI.object_info_get_interface(bb,i);
166 var add = GI.base_info_get_namespace(prop) +'.' + GI.base_info_get_name(prop);
167 this.ifaceList[add] = this.ifaceList[add] || [];
168 if (this.ifaceList[add].indexOf(fullname) < 0) {
169 this.ifaceList[add].push(fullname);
181 doc : function(what) {
182 var ns = what.split('.').shift();
183 this.commentLoad(ns);
184 return typeof(this.comments[ns][what]) == 'undefined' ? '' : this.comments[ns][what];
192 commentLoad : function(ns)
195 if (typeof(this.comments[ns]) != 'undefined') {
199 console.log("LOAD DOCS: " + ns);
200 var gi = GI.IRepository.get_default();
201 var ver = gi.get_version(ns);
203 this.comments[ns] = {};
208 // no idea why this is broken on my build system.
209 var getAttribute = function(n, name){
210 var properties = n.properties;
212 if (properties.name == name)
213 return properties.children.content;
214 properties = properties.next
220 function walk (element, path) {
227 var n = getAttribute(element, 'name') ;
228 //console.log("WALK" + n);
230 path += path.length ? '.' : '';
233 if (element.name == 'return-value') {
234 path += '.return-value';
238 var d = getAttribute(element,'doc');
240 // Seed.print(path + ':' + d);
244 var child = element.children;
247 //console.log(child.tag);
248 if (child.type == "element"){
255 var pth = GI.IRepository.get_search_path ();
258 var gir_path = pth[0].replace(/lib\/girepository-1.0/, 'share\/gir-1.0');
262 var fn = gir_path + '/'+ ns + '-' + ver + '.gir';
265 if (!GLib.file_test(fn, GLib.FileTest.EXISTS)) {
266 console.log('missing docc file ' + fn);
267 this.comments[ns] = {};
271 var doc = xml.parseFile(fn);
272 //console.log("xmldoc?" + doc);
275 this.comments[ns] = ret;
279 factory : function(type, ns, name) {
280 if (typeof (this.registry[ns +'.' + name]) == 'undefined') {
281 this.registry[ns +'.' + name] = new Introspect[type](ns,name);
282 this.registry[ns +'.' + name].load();
285 return this.registry[ns +'.' + name];