[Epydoc-devel] Patch for handling newer Graphviz version information.

[Edward d'A. <ed...@nm...>]

Hi Ed,

I am the developer of a number of projects (http://www.nmr-relax.com/,
https://gna.org/projects/minfx/, https://gna.org/projects/bmrblib/,
https://gna.org/projects/nessy/) and use Epydoc for compiling a lot of
API documentation (http://www.nmr-relax.com/api/ and
http://home.gna.org/minfx/).  Due to epydoc appearing to be long ago
abandoned, I thought I'd look into it a bit more.  Some basic
maintenance to keep epydoc alive - for example Python 3 support -
would be rather trivial.  Especially for Linux distributions which
often package epydoc.

I tried playing with the svn repository code but the first thing I
noticed was that the 'dot' Graphviz graphic files were no longer
produced.  This broke at r1805:

-----
r1805 | edloper | 2008-02-27 21:24:06 +0100 (Wed, 27 Feb 2008) | 3 lines
Changed paths:
   M /trunk/epydoc/src/epydoc/docwriter/dotgraph.py

- If the dot executable is not found, issue an error, and don't try to
  generate further graphs.
-----

The problem is because the version information from Graphviz is now
formatted differently:

[edward@localhost src]$ dot -V
dot - graphviz version 2.34.0 (20140110.2222)
[edward@localhost src]$

So the get_dot_version() function in the epydoc.docwriter.dotgraph
module no longer works and returns a version of (0,).  Please find
attached a patch to fix this.  How do I go about getting this added to
the repository?  The patch simply adds a second hardcoded Graphviz
version string format which is set up as a fall-back if the first
pattern does not work.

Cheers,

Edward


P. S.  I was pleasantly surprised to see that there has been a lot of
development (up to 2009-02-03) since the 3.0.1 release (2008-01-30).
Is there anything that should be known about these changes?  Is there
a good reason why these changes were not released as version 3.0.2?