U++ forum: Welcome to the forum

Search on this site

Search in forums

Home » Community » Coffee corner » Visualizing package structure

Show: Today's Messages :: Show Polls :: Message Navigator
E-mail to friend

Visualizing package structure [message #31471]

Fri, 04 March 2011 21:14

dolik.rce
Messages: 1791
Registered: August 2008
Location: Czech Republic

Ultimate Contributor

Hi everyone,

Let me introduce you another little toy of mine Smile

A simple shell script that visualizes the structure of packages in given project. The only thing you need is to have graphviz installed on your system, as it uses DOT language to render the graphics.

Thanks to the great power of graphviz, it is possible to export pictures in many formats from simple bitmaps like png, gif ot jpg through to html click maps or vrml to advanced formats like pdf or svg. You can even choose pseudoformat "xlib", which will feed the graph directly into simple viewer.

How to use it? Simple example:

uppviz.sh -k -f bmp UWord upp/{uppsrc,examples}

This will render the dependency tree of UWord into file UWord.bmp. All parameters after package name are nests where the script should look for code. The -f argument selects file format. If the -f option is omitted, png is used. For list of available format have a look here. The "-k" says it should keep the graph description in DOT language that was used when rendering as well. It can be found in UWord.gv, so you can play with it a bit and e.g. re-render it or tweak it in graph editor (such as dotty or grappa).

Sorry to all windows users, but since this is a shell script, it won't be that easy to run on windows. Your best chance is cygwin or emulation Wink