As some have noticed there has been a libawn-extras library sitting in my branch for the last few weeks. It's basically a collection of useful utility functions though there is nothing to keep it from acquiring more focused elements.

As of today libawn-extras has acquired python bindings courtesy of malept.

The purpose of this library is to provided awn-extra devs a place to put commonly used code without as high of a hurdle to cross as there is for libawn.

I encourage anyone who is interested to check it out. It is only in my branch at the moment but it will be moving in trunk at some point in the relatively near future.

C:

-urls.
char* urlencode(const char *source, char *dest, unsigned max);
char *urldecode(char *source, char *dest);

-convert a cairo surface to a pixbuf.
GdkPixbuf * surface_2_pixbuf( GdkPixbuf * pixbuf, cairo_surface_t * surface);
GdkPixbuf * get_pixbuf_from_surface(cairo_surface_t * surface);

-some colour conversion stuff.
gchar * awncolor_to_string(AwnColor * colour);
AwnColor gdkcolor_to_awncolor_with_alpha( GdkColor * gdk_color,double alpha);
AwnColor gdkcolor_to_awncolor( GdkColor * gdk_colour);

-Canned functions to send a message to a notifiication daemon.
gboolean notify_message(gchar * summary, gchar * body,gchar * icon_str,glong timeout);
void notify_message_async(gchar * summary, gchar * body,gchar * icon_str,glong timeout);

Python bindings:

dict_to_rgba_string()

gdkcolor_to_dict()

notify_message()

surface_to_pixbuf()

Some clarifications:

* "dict" is basically my version of AwnColor, which is basically a dictionary with the following keys defined: red, green, blue, alpha

* rgba_string is what it sounds like: RRGGBBAA, where each section is a hex value between 00 and FF.

* surface_to_pixbuf() takes a surface as a parameter, and returns a new gtk.gdk.Pixbuf object.

* urlencode and urldecode are not in the python bindings because the functionality is already in the libraries included with Python. urlencode exists in the urllib module, and urldecode exists in the cgi module as "parse_qs", or "parse_qsl", depending on what you want as the return value:

The Python bindings are:

dict_to_rgba_string()

gdkcolor_to_dict()

notify_message()

surface_to_pixbuf()

malept has short post above about he specifics of using them.

Currently they're only in my branch. Once awn-testing gets a few more things merged in, then I'm hoping the see the new build system go into awn-extras-testing. Then the new code can get pushed into extras.