Giraffe should handle external interfaces

[Mikkel Kamstrup Erlandsen]

While trying to generate the documentation for DbusmenuGtk-0.4.gir, giraffe outputs:

> Reading /tmp/tmpXnlQX9/natty/usr/share/gir-1.0/DbusmenuGtk-0.4.gir
> Traceback (most recent call last):
> File "/home/dpm/dev-apt/giraffe/bin/giraffe", line 70, in <module>
> repo.add_gir (file(f, "r"))
> File "/home/dpm/dev-apt/giraffe/giraffe/ast.py", line 616, in add_gir
> raise ImportError, "Unresolved interface %s for class %s" % (name, cl.namespaced_name)
> ImportError: Unresolved interface Atk.ImplementorIface for class DbusmenuGtk.Menu

[Mikkel Kamstrup Erlandsen (kamstrup)]

This happens because dbusmenu implements an interface that is in a package unknown to giraffe. The planned solution is to add a command line switch to giraffe --external=filename.gir that can be specified N times. The external girs will be used to resolve interfaces and class inheritance, but will not be included in the generated docs.

As an intermediate solution everything should work if you add the Atk.gir to command line args when generating the dbusmenu docs.

[David Planella (dpm)]

Ah, thanks. The workaround will work well for now for my use case.