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);
195 parent.params.add(c);
198 this.checkParamOverride(c);
203 var c = new GirObject("Prop",n.replace("-", "_"));
206 c.propertyof = parent.name;
207 parent.props.set(n.replace("-", "_"),c);
212 var c = new GirObject("Function",n);
215 parent.methods.set(n,c);
220 parent.is_array = true;
221 break; // type is added soon..
224 parent.is_varargs= true;
228 var c = new GirObject("Const",n);
230 c.value = element->get_prop("value");
232 parent.consts.set(n,c);
238 var c = new GirObject("Enum",n);
241 parent.consts.set(n,c);
247 var c = new GirObject("EnumMember",n);
250 c.value = element->get_prop("value");
251 parent.consts.set(n,c);
256 case "doc-deprecated":
259 case "record": // struct?
264 case "prerequisite": // ignore?
266 case "union": // ignore?
269 print("UNHANDLED Gir file element: " + element->name +"\n");
273 if (element->name == "signal") {
278 if (element->name == "return-value") {
279 path += ".return-value";
281 print(path + ":" + element->name + "\n");
283 //var d = getAttribute(element,'doc');
285 // Seed.print(path + ':' + d);
288 for (Xml.Node* iter = element->children; iter != null; iter = iter->next) {
289 if (iter->type == Xml.ElementType.TEXT_NODE) {
292 this.walk(iter, parent);
298 public void checkParamOverride(GirObject c)
300 var parset = c.gparent;
301 if (parset == null || parset.nodetype != "Paramset") {
304 var method = parset.gparent;
305 if (method == null || method.nodetype != "Ctor") {
308 var cls = method.gparent;
309 if (cls == null || cls.nodetype != "Class") {
315 c.name = this.fetchOverride( cls.name, method.name, c.name);
317 public static bool overrides_loaded = false;
318 public static Gee.HashMap<string,string> overrides;
320 public string fetchOverride( string cls, string method, string param)
322 // overrides should be in a file Gir.overides
323 // in that "Gtk.Label.new.str" : "label"
324 this.loadOverrides();
325 var key = "%s.%s.%s".printf(cls,method,param);
326 //print("Chekcing for key %s\n", key);
327 if (!overrides.has_key(key)) {
330 return overrides.get(key);
335 public void loadOverrides(bool force = false)
337 if (overrides_loaded && ! force) {
341 var pa = new Json.Parser();
342 pa.load_from_file(BuilderApplication.configDirectory() + "/resources/Gir.overides");
343 var node = pa.get_root();
345 if (node.get_node_type () != Json.NodeType.OBJECT) {
346 throw new GirError.INVALID_FORMAT ("Error loading gir.overides : Unexpected element type %s", node.type_name ());
348 overrides = new Gee.HashMap<string,string>();
351 var obj = node.get_object ();
354 obj.foreach_member((o , key, value) => {
357 var v = obj.get_string_member(key);
360 overrides.set(key, v);
364 overrides_loaded = true;
370 public string doc(string what)
372 var ar = what.split(".");
373 var cls = this.classes.get(ar[1]);
374 if (ar.length == 2) {
375 return cls.doctxt != null ? cls.doctxt : "";
377 // return the property.. by default..
378 var pr = cls.props.get(ar[2]);
379 return pr.doctxt != null ? pr.doctxt : "";
383 public static Gir? factory(string ns)
386 cache = new Gee.HashMap<string,Gir>();
387 var a = new Palete.VapiParser( );
388 a.create_valac_tree();
392 var ret = cache.get(ns);
395 var add = new Gir(ns);
399 var iter = add.classes.map_iterator();
401 iter.get_value().overlayParent();
403 // loop again and add the ctor properties.
404 iter = add.classes.map_iterator();
406 iter.get_value().overlayCtorProperties();
417 public static GirObject? factoryFqn(string fqn)
419 var bits = fqn.split(".");
420 if (bits.length < 1) {
424 var f = (GirObject)factory(bits[0]);
426 if (bits.length == 1 || f ==null) {
429 return f.fetchByFqn(fqn.substring(bits[0].length+1)); // since classes are stored in fqn format...?
436 * guess the fqn of a type == eg. gboolean or Widget etc...
438 public static string fqtypeLookup(string type, string ns) {
440 if (g.classes.has_key(type)) {
441 return ns + "." + type;
444 if (g.consts.has_key(type)) {
445 return ns + "." + type;
449 // look at includes..
450 var iter = g.includes.map_iterator();
452 // skip empty namespaces on include..?
453 if ( iter.get_key() == "") {
456 var ret = fqtypeLookup(type, iter.get_key());
467 // needed still - where's it called form..
468 public static string guessDefaultValueForType(string type) {
469 //print("guessDefaultValueForType: %s\n", type);
470 if (type.length < 1 || type.contains(".")) {
481 return "?"+ type + "?";