Piotras' blog: Archive

Midgard2 and Gtkdoc

Posted on 2008-03-06 20:32:00 UTC.

One day I realized that for last few months, I managed to fix (few times) some documentation part for Midgard core and PHP bindings. Those fixes almost always included properties of some class. And recently I started to wonder how to write documentation for events in midgard, once. Well, not about the idea, but at least I wanted to avoid writing ( few times in few different places ) what events some class provieds.

Since Midgard 1.8 we used doxygen, which is very good, with cool features for writing docs, but for me ( and writing GObject based code and docs ) is not perfect enough. Mainly you can not document class inheritance, object properties or class signals. And what is more important, you can not do this automagically.

I decided to test gtkdoc ( which is also far from being perfect and seems to be missing doxygen :), and got quite nice documentation part for a start.

• List of MgdSchema object events
• midgard_config properties

Those are created automagically, so I do not have to document them. PHP or Python developer might always want to look for additional information in core documentation, without need to duplicate many informations in many places and without risk that those docs are getting out of date quickly.

Bad thing about gtkdoc and doxygen is the fact that docs should be located in c files ( instead of headers ) and must be reformatted a bit. But once they are written, one is able to use even devhelp to read them.

Gnomegard

Posted on 2008-03-09 12:46:58 UTC.

I think t's going to be sexy. Very sexy.

• 4 years ago we planned some features.
• Few weeks ago world heard about Midgard2 first alpha release.
• Gnome 2.22 should be released soon.
• Gnome 2.22 should contain new API for Virtual File System.

I must test it! mgd:// uri will look lovely :)

midgard-python once again

Posted on 2008-03-18 21:02:12 UTC.

Bergie just blogged about initial MidCOM3 architecture. He included nice and very easy example of midgard-php API. And while he mentioned some python based solution I decided to add short and working example of midgard-python in action.

All in all, it's good to have, especially now, when Midgard2 is already an alpha and available also as packages for maemo.org platform.

D-Bus and Midgard

Posted on 2008-03-28 12:40:12 UTC.

Midgard is decent CMS framework. Not just yet another PHP based CMS. And as every decent piece of code must have many features. I just added initial test cases with D-Bus support. They use midgard-python and dbus modules.

Usage is simple. You start service as one proccess and client as another one. If all goes fine, client notifies daemon that some object needs to be imported to database, then listener service imports this object to database. Listener is not aware who sent such data and even not aware what kind of language was used to send notify.

So in theory ( it's not yet API implementation ) application written in PHP and using Midgard 1.9 may may send notification and listener may be daemon writen in python using Midgard 2.0. Even on the same machine.

Check initial test code!