I just added a new repository on GitHub containing the tools from my Graphviz / diagram related posts.
The repository can be found at: http://github.com/vidarh/diagram-tools/tree/master

These are the ones included and the appropriate articles:

• notugly.xsl: An XSL transform to pretty up the SVG output from Graphviz
• arytodot.rb: A script to visualize Ruby arrays using Graphviz
• traceviz.rb: A script to visualize traceveroute ouput with Graphviz
  

The only new thing so far is that notugly.xsl is updated to work with Graphviz 2.22.2

As part of my compiler project I wanted a way to visualize the programs, and since the syntax tree (so far at least) is represented with plain Ruby arrays I decided to throw together a script to use Graphviz to generate some graphs. I've written about using Graphviz previously here
The code does not make any assumptions tied to my compiler, but it's NOT an attempt at visualizing arbitrary object structures. You need to pass it an Array object, which can contain other arrays or objects that responds to #to_s.
NOTE: The code makes NO attempt to deal with structures that have loops - you'll run out of stack space soon enough if you try that. Feel free to post your fixes to do that in the comments (easy enough - just need to keep track of visited objects).

An example example. Given this:

 [:defun, :parse_quoted, [:c],
 [:while, [:and, [:ne, [:assign, :c, [:getchar]], -1], [:ne, :c, 34]], [:do,
  [:putchar, :c]
  ]
 ]
 ]

I generate this image (the gradients and shadows are thanks to my previously described XSL transform to pretty up the Graphviz SVG output):



The code is quite straightforward, though I'm not quite happy with the amount of monkey-patching. There were two easy choices: monkey-patching or lots of #is_a? calls, which made it horribly messy. I wouldn't advocate including this into a larger app without cleaning it up first, but as a quick hack it works well.

module ToDot
 def self.escape str
  str.gsub(/([<>{} |\])/) { "\"+$1 }
 end
end
class String
 def to_dot_label; '\"'+ToDot::escape(self)+'\"'; end
end
class Array
 def to_dot_label; "..."; end
 def to_dot_edge src, shorten
  " #{src}" + (shorten ? "" : ":#{object_id}") + " -> #{object_id};\n"
 end
 def to_dot_subgraph
  return "" if nil
  ary = self[0].is_a?(Array)
  shorten = !ary && self[1..-1].detect{|o| !o.is_a?(Array)} == nil
  s = " #{object_id} [label=\""
  if shorten
   s += self[0].to_dot_label + "\", shape=rect];\n"
  else
   s += collect { |o| "<#{o.object_id}> " + o.to_dot_label }.join("|")
   s += "\"];\n"
  end
  s += collect {|o| o.to_dot_edge(object_id,shorten) }.join
  s += collect {|o| o.to_dot_subgraph }.join
  s
 end
end
class Object
 def to_dot_subgraph; end
 def to_dot_edge src, shorten; end
 def to_dot_label; ToDot::escape(to_s); end
 def to_dot
  s = "digraph G {\n"
  s += " node [shape=record style=filled fillcolor=lightblue "
  s += "fontname=Verdana height=0.05 fontsize=10.0 ];\n"
  s += to_a.to_dot_subgraph
  s += "}\n"
 end
end

As for how to use it:

require 'arytodot'
puts someArray.to_dot

Then pipe the output to "dot -Tsvg >output file" and use your favorite XSL processor to render an image from it. I used "rsvg file.svg file.png". If you want to use my XSL transform to pretty it up, follow the instructions in the article linked to above.

Here's the full "parser" example from my compiler series (click for the full size version):

NOTE: See the updated version of this stylesheet HERE

UPDATED: Example of the latest version here

A couple of years back I posted some about an XSL transformation I used to clean up Graphviz output to make my diagrams prettier. These days I use Omni Graffle for most of my diagramming needs, and making diagrams look nice with it is trivial, but Graphviz is still my tool of choice whenever I need to generate diagrams from code automatically, because its automated layout is reasonably good.

Last year I got an e-mail from Ryan Shea who asked about the stylesheet I'd used, and we went back and forth and fixed various problems and made it a lot cleaner. Just the other day I wanted to generate a Graphviz graph and looked up the stylesheet again, and figured it was about time I actually posted it so others can benefit.

Here's a "hello world" Graphviz diagram:

digraph G {
        Hello->World
        Hello [style=filled fillcolor=lightblue]
        World [style=filled fillcolor=lightgrey]
}

Here's how Graphviz renders it (with "dot -Tsvg"). The image on the left (if it shows up for you) is the SVG file. The image on the right is a screenshot in case your browser doesn't support SVG:

Fair enough, but we can do a lot better:

The XSL is pretty simple and can be found here (updated to link to a GitHub repository that will be regularly updated)  NOTE: The Graphviz SVG output has changed quite a few times - if the XSL linked here doesn't work for you, I'd very much appreciate if you post what version of Graphviz you've tested it with in the comments, and/or a sample of the SVG, so I can fix the XSL

The one caveat is that for any color you want turned into a gradient, you need to add an extra "linearGradient" tag to the XSL file like the ones that are already there.

You will need an XSL processor to convert the files. Personally I use "xsltproc" on my Linux box, which is from libxslt RPM if you're on Fedora Core or Redhat EL - chances are it's already installed if you use Linux. If so, you convert your Graphviz files like this (assuming your dot file is names "hello.dot" and you've saved the XSL file as notugly.xsl):

dot -Tsvg hello.dot >hello.svg
xsltproc notugly.xsl hello.svg >hello-notugly.svg