Software Secret Weapons™

 
Linguine Maps For Apache Ant
by Pavel Simakov on 2006-03-23 16:38:02 under Linguine Maps, view comments
Bookmark and Share
 

Index  •  Intro  •  WSDL  •  Apache Ant  •  DTD's for XML  •  ObJectRelationalBridge  •  Hibernate  •  Gallery  •  FAQ  •  Help  •  JavaDoc  •  Download
Hibernate Configuration  •  Object Relational Impedance Mismatch  

Linguine Maps for Apache Ant is an open-source utility that will automatically produce easy to read diagrams from Ant build files. The diagram shows all the task dependencies and colors default, normal, and optional task in different colors.

There is absolutely no manual work! It is fully automatic! Use it online now! Just paste your favorite Ant build script into a web form and instantly view a diagram! With a diagram it will take you only minutes to become familiar with new Ant build files. You can always go back to source files when more details are needed.

Here we defined a simple Ant build file. And converted it to a diagram. It's that easy!


<project name="Test Build" default="build" basedir=".">

  <target name="init" 
          description="Clean all folders">
  </target>
		
  <target name="compile" depends="init" 
          description="Compile source files">
  </target>
		
  <target name="jar" depends="compile" 
          description="Create a jar file">
  </target>
		
  <target name="javadoc" if="doDocs" depends="compile" 
          description="Create docs">
  </target>		
		
  <target name="build" depends="jar, javadoc">
  </target>
		
</project>

There are many more sample diagrams available for Apache Ant files.

Linguine Maps is written in Java and provides clean object-oriented diagramming API for graph visualization. We developed a full set of Apache ANT tasks for integrating programmatic visualization with the build process. This package also contains demo applications that show you how to visualize abstract graphs.

Comments (3)

  • Comment by Nikhil Sidhaye — December 22, 2008 @ 7:57 am

    Hi Dr. Pavel,

    While creating anttogif I found that some of nodes do not render descriptions. especailly if one target is depending upon more than 1 targets.

    I found the bug is that styleNode overright description while processing cofigure dependencies.

    In ANTtoGRAPH Line: 166.

    I changed styleNode in following way :

    1. In styleNode method I checked if desc is not null then & only then update the caption:
    node.getInfo().setCaption(desc);

    private void styleNode(GraphNode node, String name, String desc){
    node.getInfo().setFillColor(colors[COLOR_NORMAL]);
    node.getInfo().setHeader(name);
    if (!StringUtil.isEmpty(desc)){
    node.getInfo().setCaption(desc);
    }
    node.getInfo().setModeSolid();
    }

    If possible please incorporate this in future release.

    Thanks for wonderful tool

  • Comment by Dave Parillo — January 23, 2009 @ 9:12 pm

    I just stumbled upon this tool. Very nice. I noticed that when running certain build files of mine (though v 1.4 of Linguine), targets with conditional attributes don’t always display the COLOR_CONDITIONAL color. The code looks amazingly simple, so it wasn’t clear to me what was overriding it. If I figure it out, I’ll let you know. Anyways, thanks for making my job of trying to teach someone how to write a better build file just that much easier!

  • Comment by Vinicius Menck — December 4, 2014 @ 9:42 am

    Hi Dr. Pavel,
    This tool is amazing! I don´t know if this project is still alive, but I´d like to report a behavior.
    I´m trying the version 1.4 and when I generate a gif from a ant files, some "targets shows no descritpions and others do. I don´t know if it´s happening just for my configs. Well, I´ll continue to use it even with this small issue. I really enjoyed the tool. Thanks.


Leave a comment


  Copyright © 2004-2014 by Pavel Simakov
any conclusions, recommendations, ideas, thoughts or the source code presented on this site are my own and do not reflect a official opinion of my current or past employers, partners or clients