2 * This is the old Gir File based API parser..
9 public class Gir : GirObject {
11 public Gir (string ns)
19 var xns = ns == "Glade" ? "Gladeui" : this.name;
20 var gi = GI.Repository.get_default();
21 gi.require(xns, null, 0);
23 var ver = gi.get_version(xns);
24 unowned GLib.SList<string> pth = GI.Repository.get_search_path ();
25 var gir_path = pth.nth_data(0).replace("/lib/girepository-1.0", "/share/gir-1.0");
27 gir_path = gir_path.replace("/lib/x86_64-linux-gnu/girepository-1.0", "/share/gir-1.0");
33 var file = gir_path + "/" + xns + "-" + ver + ".gir";
34 // print("ns: " + ns + "\n");
35 // print("ver: " + ver + "\n");
40 //this.nodes = new Gee.Hashmap<string,what>();
42 var doc = Xml.Parser.parse_file (file);
43 var root = doc->get_root_element();
44 this.walk( root, (GirObject) this );
50 public void walk(Xml.Node* element, GirObject? parent)
52 var n = element->get_prop("name");
53 // ignore null or c:include...
54 if (n == null || (element->ns->prefix != null && element->ns->prefix == "c")) {
57 //print("%s:%s (%s ==> %s\n", element->ns->prefix , element->name , parent.name , n);
58 switch (element->name) {
63 parent.includes.set(n, element->get_prop("version"));
79 //break; // not handled..
82 var c = new GirObject("Class", parent.name + "." + n);
83 parent.classes.set(n, c);
85 c.parent = element->get_prop("parent");
87 if (c.parent == null) {
94 var c = new GirObject("Interface", parent.name + "." + n);
96 parent.classes.set(n, c);
99 c.parent = element->get_prop("parent");
100 if (c.parent == null) {
108 parent.doctxt = element->get_content();
112 parent.implements.add(n);
117 var c = new GirObject("Ctor",n);
120 parent.ctors.set(n,c);
125 var c = new GirObject("Return", "return-value");
128 parent.return_value = c;
132 case "virtual-method": // not sure...
135 var c = new GirObject("Signal",n);
136 parent.signals.set(n,c);
140 case "signal": // Glib:signal
141 var c = new GirObject("Signal",n.replace("-", "_"));
144 parent.signals.set(n.replace("-", "_"),c);
150 case "callback": // not sure...
157 return; // no children?
161 var c = new GirObject("Method",n);
164 c.propertyof = parent.name;
165 parent.methods.set(n,c);
170 var c = new GirObject("Paramset",n);
177 case "instance-parameter":
179 // looks like this is the C first arg, that is ignored (as it is
180 // treated as 'this' )
181 var c = new GirObject("Param",n);
184 c.is_instance = true;
185 parent.params.add(c);
190 var c = new GirObject("Param",n);
193 parent.params.add(c);
195 this.checkParamOverride(c);
200 var c = new GirObject("Prop",n.replace("-", "_"));
203 c.propertyof = parent.name;
204 parent.props.set(n.replace("-", "_"),c);
209 var c = new GirObject("Function",n);
212 parent.methods.set(n,c);
217 parent.is_array = true;
218 break; // type is added soon..
221 parent.is_varargs= true;
225 var c = new GirObject("Const",n);
227 c.value = element->get_prop("value");
229 parent.consts.set(n,c);
235 var c = new GirObject("Enum",n);
238 parent.consts.set(n,c);
244 var c = new GirObject("EnumMember",n);
247 c.value = element->get_prop("value");
248 parent.consts.set(n,c);
253 case "doc-deprecated":
256 case "record": // struct?
261 case "prerequisite": // ignore?
263 case "union": // ignore?
266 print("UNHANDLED Gir file element: " + element->name +"\n");
270 if (element->name == "signal") {
275 if (element->name == "return-value") {
276 path += ".return-value";
278 print(path + ":" + element->name + "\n");
280 //var d = getAttribute(element,'doc');
282 // Seed.print(path + ':' + d);
285 for (Xml.Node* iter = element->children; iter != null; iter = iter->next) {
286 if (iter->type == Xml.ElementType.TEXT_NODE) {
289 this.walk(iter, parent);
295 public void checkParamOverride(GirObject c)
297 var parset = c.gparent;
298 if (parset == null || parset.nodetype != "Paramset") {
301 var method = parset.gparent;
302 if (method == null || method.nodetype != "Ctor") {
305 var cls = method.gparent;
306 if (cls == null || cls.nodetype != "Class") {
312 c.name = this.fetchOverride( cls.name, method.name, c.name);
314 public static bool overrides_loaded = false;
315 public static Gee.HashMap<string,string> overrides;
317 public string fetchOverride( string cls, string method, string param)
319 // overrides should be in a file Gir.overides
320 // in that "Gtk.Label.new.str" : "label"
321 this.loadOverrides();
322 var key = "%s.%s.%s".printf(cls,method,param);
323 //print("Chekcing for key %s\n", key);
324 if (!overrides.has_key(key)) {
327 return overrides.get(key);
332 public void loadOverrides(bool force = false)
334 if (overrides_loaded && ! force) {
338 var pa = new Json.Parser();
339 pa.load_from_file(BuilderApplication.configDirectory() + "/resources/Gir.overides");
340 var node = pa.get_root();
342 if (node.get_node_type () != Json.NodeType.OBJECT) {
343 throw new GirError.INVALID_FORMAT ("Error loading gir.overides : Unexpected element type %s", node.type_name ());
345 overrides = new Gee.HashMap<string,string>();
348 var obj = node.get_object ();
351 obj.foreach_member((o , key, value) => {
354 var v = obj.get_string_member(key);
357 overrides.set(key, v);
361 overrides_loaded = true;
367 public string doc(string what)
369 var ar = what.split(".");
370 var cls = this.classes.get(ar[1]);
371 if (ar.length == 2) {
372 return cls.doctxt != null ? cls.doctxt : "";
374 // return the property.. by default..
375 var pr = cls.props.get(ar[2]);
376 return pr.doctxt != null ? pr.doctxt : "";
380 public static Gir? factory(string ns)
383 cache = new Gee.HashMap<string,Gir>();
384 var a = new Palete.VapiParser( );
385 a.create_valac_tree();
389 var ret = cache.get(ns);
392 var add = new Gir(ns);
396 var iter = add.classes.map_iterator();
398 iter.get_value().overlayParent();
400 // loop again and add the ctor properties.
401 iter = add.classes.map_iterator();
403 iter.get_value().overlayCtorProperties();
414 public static GirObject? factoryFqn(string fqn)
416 var bits = fqn.split(".");
417 if (bits.length < 1) {
421 var f = (GirObject)factory(bits[0]);
423 if (bits.length == 1 || f ==null) {
426 return f.fetchByFqn(fqn.substring(bits[0].length+1)); // since classes are stored in fqn format...?
433 * guess the fqn of a type == eg. gboolean or Widget etc...
435 public static string fqtypeLookup(string type, string ns) {
437 if (g.classes.has_key(type)) {
438 return ns + "." + type;
441 if (g.consts.has_key(type)) {
442 return ns + "." + type;
446 // look at includes..
447 var iter = g.includes.map_iterator();
449 // skip empty namespaces on include..?
450 if ( iter.get_key() == "") {
453 var ret = fqtypeLookup(type, iter.get_key());
464 // needed still - where's it called form..
465 public static string guessDefaultValueForType(string type) {
466 //print("guessDefaultValueForType: %s\n", type);
467 if (type.length < 1 || type.contains(".")) {
478 return "?"+ type + "?";