DotRunner Class Reference

#include <dot.h>

Classes
struct	CleanupItem

Public Member Functions
	DotRunner (const QCString &file, const QCString &fontPath, bool checkResult, const QCString &imageName=QCString())
void	addJob (const char *format, const char *output)
void	addPostProcessing (const char *cmd, const char *args)
void	preventCleanUp ()
bool	run ()
const CleanupItem &	cleanup () const

Private Attributes
DotConstString	m_dotExe
bool	m_multiTargets
QList< DotConstString >	m_jobs
DotConstString	m_postArgs
DotConstString	m_postCmd
DotConstString	m_file
DotConstString	m_path
bool	m_checkResult
DotConstString	m_imageName
DotConstString	m_imgExt
bool	m_cleanUp
CleanupItem	m_cleanupItem

Detailed Description

Helper class to run dot from doxygen.

Definition at line 356 of file dot.h.

Constructor & Destructor Documentation

DotRunner::DotRunner	(	const QCString &	file,
		const QCString &	fontPath,
		bool	checkResult,
		const QCString &	imageName = QCString()
	)

Creates a runner for a dot file.

Definition at line 793 of file dot.cpp.

  : m_dotExe(Config_getString("DOT_PATH")+"dot"),
    m_file(file), m_path(path), 
    m_checkResult(checkResult), m_imageName(imageName),
    m_imgExt(getDotImageExtension())
{
  static bool dotCleanUp      = Config_getBool("DOT_CLEANUP"); 
  static bool dotMultiTargets = Config_getBool("DOT_MULTI_TARGETS");
  m_cleanUp      = dotCleanUp;
  m_multiTargets = dotMultiTargets;
  m_jobs.setAutoDelete(TRUE);
}

Member Function Documentation

void DotRunner::addJob	(	const char *	format,
		const char *	output
	)

Adds an additional job to the run. Performing multiple jobs one file can be faster.

Definition at line 807 of file dot.cpp.

{
  QCString args = QCString("-T")+format+" -o \""+output+"\"";
  m_jobs.append(new DotConstString(args));
}

void DotRunner::addPostProcessing	(	const char *	cmd,
		const char *	args
	)

Definition at line 813 of file dot.cpp.

{
  m_postCmd.set(cmd);
  m_postArgs.set(args);
}

const CleanupItem& DotRunner::cleanup ( ) const

inline

Definition at line 380 of file dot.h.

{ return m_cleanupItem; }

void DotRunner::preventCleanUp ( )

inline

Definition at line 376 of file dot.h.

{ m_cleanUp = FALSE; }

bool DotRunner::run

(

)

Runs dot for all jobs added.

Definition at line 819 of file dot.cpp.

{
  int exitCode=0;

  QCString dotArgs;
  QListIterator<DotConstString> li(m_jobs);
  DotConstString *s;
  if (m_multiTargets)
  {
    dotArgs=QCString("\"")+m_file.data()+"\"";
    for (li.toFirst();(s=li.current());++li)
    {
      dotArgs+=' ';
      dotArgs+=s->data();
    }
    if ((exitCode=portable_system(m_dotExe.data(),dotArgs,FALSE))!=0)
    {
      goto error;
    }
  }
  else
  {
    for (li.toFirst();(s=li.current());++li)
    {
      dotArgs=QCString("\"")+m_file.data()+"\" "+s->data();
      if ((exitCode=portable_system(m_dotExe.data(),dotArgs,FALSE))!=0)
      {
        goto error;
      }
    }
  }
  if (!m_postCmd.isEmpty() && portable_system(m_postCmd.data(),m_postArgs.data())!=0)
  {
    err("Problems running '%s' as a post-processing step for dot output\n",m_postCmd.data());
    return FALSE;
  }
  if (m_checkResult)
  {
    checkDotResult(m_imgExt.data(),m_imageName.data());
  }
  if (m_cleanUp) 
  {
    //printf("removing dot file %s\n",m_file.data());
    //QDir(path).remove(file);
    m_cleanupItem.file.set(m_file.data());
    m_cleanupItem.path.set(m_path.data());
  }
  return TRUE;
error:
  err("Problems running dot: exit code=%d, command='%s', arguments='%s'\n",
      exitCode,m_dotExe.data(),dotArgs.data());
  return FALSE;
}

Member Data Documentation

bool DotRunner::m_checkResult

private

Definition at line 390 of file dot.h.

bool DotRunner::m_cleanUp

private

Definition at line 393 of file dot.h.

CleanupItem DotRunner::m_cleanupItem

private

Definition at line 394 of file dot.h.

DotConstString DotRunner::m_dotExe

private

Definition at line 383 of file dot.h.

DotConstString DotRunner::m_file

private

Definition at line 388 of file dot.h.

DotConstString DotRunner::m_imageName

private

Definition at line 391 of file dot.h.

DotConstString DotRunner::m_imgExt

private

Definition at line 392 of file dot.h.

QList<DotConstString> DotRunner::m_jobs

private

Definition at line 385 of file dot.h.

bool DotRunner::m_multiTargets

private

Definition at line 384 of file dot.h.

DotConstString DotRunner::m_path

private

Definition at line 389 of file dot.h.

DotConstString DotRunner::m_postArgs

private

Definition at line 386 of file dot.h.

DotConstString DotRunner::m_postCmd

private

Definition at line 387 of file dot.h.

---

The documentation for this class was generated from the following files:

• doxygen-1.8.11/src/dot.h
• doxygen-1.8.11/src/dot.cpp