/****************************************************************************** * * Copyright (C) 1997-2015 by Dimitri van Heesch. * * Permission to use, copy, modify, and distribute this software and its * documentation under the terms of the GNU General Public License is hereby * granted. No representations are made about the suitability of this software * for any purpose. It is provided "as is" without express or implied warranty. * See the GNU General Public License for more details. * * Documents produced by Doxygen are derivative works derived from the * input used in their production; they are not affected by this license. * */ #include "plantuml.h" #include "util.h" #include "portable.h" #include "config.h" #include "doxygen.h" #include "message.h" #include "debug.h" #include "fileinfo.h" QCString PlantumlManager::writePlantUMLSource(const QCString &outDirArg,const QCString &fileName,const QCString &content,OutputFormat format) { QCString baseName; QCString puName; QCString imgName; QCString outDir(outDirArg); static int umlindex=1; Debug::print(Debug::Plantuml,0,"*** %s fileName: %s\n","writePlantUMLSource",qPrint(fileName)); Debug::print(Debug::Plantuml,0,"*** %s outDir: %s\n","writePlantUMLSource",qPrint(outDir)); // strip any trailing slashes and backslashes uint l; while ((l=outDir.length())>0 && (outDir.at(l-1)=='/' || outDir.at(l-1)=='\\')) { outDir = outDir.left(l-1); } if (fileName.isEmpty()) // generate name { puName = "inline_umlgraph_"+QCString().setNum(umlindex); baseName = outDir+"/inline_umlgraph_"+QCString().setNum(umlindex++); } else // user specified name { baseName = fileName; int i=baseName.findRev('.'); if (i!=-1) baseName = baseName.left(i); puName = baseName; baseName.prepend(outDir+"/"); } switch (format) { case PUML_BITMAP: imgName =puName+".png"; break; case PUML_EPS: imgName =puName+".eps"; break; case PUML_SVG: imgName =puName+".svg"; break; } Debug::print(Debug::Plantuml,0,"*** %s baseName: %s\n","writePlantUMLSource",qPrint(baseName)); Debug::print(Debug::Plantuml,0,"*** %s puName: %s\n","writePlantUMLSource",qPrint(puName)); Debug::print(Debug::Plantuml,0,"*** %s imgName: %s\n","writePlantUMLSource",qPrint(imgName)); QCString text = "@startuml "+imgName+"\n"; text+=content; text+="\n@enduml\n"; QCString qcOutDir(outDir); uint pos = qcOutDir.findRev("/"); QCString generateType(qcOutDir.right(qcOutDir.length() - (pos + 1)) ); Debug::print(Debug::Plantuml,0,"*** %s generateType: %s\n","writePlantUMLSource",qPrint(generateType)); PlantumlManager::instance().insert(generateType.str(),puName.str(),outDir,format,text); Debug::print(Debug::Plantuml,0,"*** %s generateType: %s\n","writePlantUMLSource",qPrint(generateType)); return baseName; } void PlantumlManager::generatePlantUMLOutput(const char *baseName,const char *outDir,OutputFormat format) { QCString plantumlJarPath = Config_getString(PLANTUML_JAR_PATH); QCString plantumlConfigFile = Config_getString(PLANTUML_CFG_FILE); QCString dotPath = Config_getString(DOT_PATH); QCString imgName = baseName; // The basename contains path, we need to strip the path from the filename in order // to create the image file name which should be included in the index.qhp (Qt help index file). int i; if ((i=imgName.findRev('/'))!=-1) // strip path { imgName=imgName.right(imgName.length()-i-1); } switch (format) { case PUML_BITMAP: imgName+=".png"; break; case PUML_EPS: imgName+=".eps"; break; case PUML_SVG: imgName+=".svg"; break; } Doxygen::indexList->addImageFile(imgName); } //-------------------------------------------------------------------- PlantumlManager &PlantumlManager::instance() { static PlantumlManager theInstance; return theInstance; } PlantumlManager::PlantumlManager() { QCString outputFilename = Config_getString(OUTPUT_DIRECTORY) + "/" + CACHE_FILENAME; FileInfo fi(outputFilename.str()); if (fi.exists()) { m_cachedPlantumlAllContent = fileToString(outputFilename); } Debug::print(Debug::Plantuml,0,"*** instance() : m_cachedPlantumlAllContent = [%s]\n",qPrint(m_cachedPlantumlAllContent)); } static void runPlantumlContent(const PlantumlManager::FilesMap &plantumlFiles, const PlantumlManager::ContentMap &plantumlContent, PlantumlManager::OutputFormat format) { /* example : running: java -Djava.awt.headless=true -jar "/usr/local/bin/plantuml.jar" -o "test_doxygen/DOXYGEN_OUTPUT/html" -tpng "test_doxygen/DOXYGEN_OUTPUT/html/A.pu" -charset UTF-8 outDir:test_doxygen/DOXYGEN_OUTPUT/html test_doxygen/DOXYGEN_OUTPUT/html/A */ int exitCode; QCString plantumlJarPath = Config_getString(PLANTUML_JAR_PATH); QCString plantumlConfigFile = Config_getString(PLANTUML_CFG_FILE); QCString dotPath = Config_getString(DOT_PATH); QCString pumlExe = "java"; QCString pumlArgs = ""; QCString pumlType = ""; QCString pumlOutDir = ""; const StringVector &pumlIncludePathList = Config_getList(PLANTUML_INCLUDE_PATH); { auto it = pumlIncludePathList.begin(); if (it!=pumlIncludePathList.end()) { pumlArgs += "-Dplantuml.include.path=\""; pumlArgs += it->c_str(); ++it; } while (it!=pumlIncludePathList.end()) { pumlArgs += Portable::pathListSeparator(); pumlArgs += it->c_str(); ++it; } } if (!pumlIncludePathList.empty()) pumlArgs += "\" "; pumlArgs += "-Djava.awt.headless=true -jar \""+plantumlJarPath+"plantuml.jar\" "; if (!plantumlConfigFile.isEmpty()) { pumlArgs += "-config \""; pumlArgs += plantumlConfigFile; pumlArgs += "\" "; } if (Config_getBool(HAVE_DOT) && !dotPath.isEmpty()) { pumlArgs += "-graphvizdot \""; pumlArgs += dotPath; pumlArgs += "dot"; pumlArgs += Portable::commandExtension(); pumlArgs += "\" "; } switch (format) { case PlantumlManager::PUML_BITMAP: pumlType="png"; break; case PlantumlManager::PUML_EPS: pumlType="eps"; break; case PlantumlManager::PUML_SVG: pumlType="svg"; break; } { for (const auto &kv : plantumlContent) { const PlantumlContent &nb = kv.second; QCString pumlArguments = pumlArgs; msg("Generating PlantUML %s Files in %s\n",qPrint(pumlType),kv.first.c_str()); pumlArguments+="-o \""; pumlArguments+=nb.outDir; pumlArguments+="\" "; pumlArguments+="-charset UTF-8 -t"; pumlArguments+=pumlType; pumlArguments+=" "; QCString puFileName(""); puFileName+=nb.outDir; puFileName+="/"; pumlOutDir=puFileName; puFileName+="inline_umlgraph_"; puFileName+=pumlType; puFileName+=kv.first.c_str(); puFileName+=".pu"; pumlArguments+="\""; pumlArguments+=puFileName; pumlArguments+="\" "; std::ofstream file(puFileName.str(),std::ofstream::out | std::ofstream::binary); if (!file.is_open()) { err("Could not open file %s for writing\n",puFileName.data()); } file.write( nb.content.data(), nb.content.length() ); file.close(); Debug::print(Debug::Plantuml,0,"*** %s Running Plantuml arguments:%s\n","PlantumlManager::runPlantumlContent",qPrint(pumlArguments)); Portable::sysTimerStart(); if ((exitCode=Portable::system(pumlExe,pumlArguments,TRUE))!=0) { err("Problems running PlantUML. Verify that the command 'java -jar \"%splantuml.jar\" -h' works from the command line. Exit code: %d\n", plantumlJarPath.data(),exitCode); } else if (Config_getBool(DOT_CLEANUP)) { Debug::print(Debug::Plantuml,0,"*** %s Remove %s file\n","PlantumlManager::runPlantumlContent",qPrint(puFileName)); Dir().remove(puFileName.str()); } Portable::sysTimerStop(); if ( (format==PlantumlManager::PUML_EPS) && (Config_getBool(USE_PDFLATEX)) ) { Debug::print(Debug::Plantuml,0,"*** %s Running epstopdf\n","PlantumlManager::runPlantumlContent"); auto files_kv = plantumlFiles.find(kv.first); if (files_kv!=plantumlFiles.end()) { for (const auto &str : files_kv->second) { const int maxCmdLine = 40960; QCString epstopdfArgs(maxCmdLine); epstopdfArgs.sprintf("\"%s%s.eps\" --outfile=\"%s%s.pdf\"", pumlOutDir.data(),str.c_str(), pumlOutDir.data(),str.c_str()); Portable::sysTimerStart(); if ((exitCode=Portable::system("epstopdf",epstopdfArgs))!=0) { err("Problems running epstopdf. Check your TeX installation! Exit code: %d\n",exitCode); } Portable::sysTimerStop(); } } } } } } void PlantumlManager::run() { Debug::print(Debug::Plantuml,0,"*** %s\n","PlantumlManager::run"); if (m_currentPlantumlAllContent.isEmpty()) return; runPlantumlContent(m_pngPlantumlFiles, m_pngPlantumlContent, PUML_BITMAP); runPlantumlContent(m_svgPlantumlFiles, m_svgPlantumlContent, PUML_SVG); runPlantumlContent(m_epsPlantumlFiles, m_epsPlantumlContent, PUML_EPS); QCString outputFilename = Config_getString(OUTPUT_DIRECTORY) + "/" + CACHE_FILENAME; std::ofstream file(outputFilename.str(),std::ofstream::out | std::ofstream::binary); if (!file.is_open()) { err("Could not open file %s for writing\n",CACHE_FILENAME); } file.write( m_currentPlantumlAllContent.data(), m_currentPlantumlAllContent.length() ); file.close(); } static void print(const PlantumlManager::FilesMap &plantumlFiles) { if (Debug::isFlagSet(Debug::Plantuml)) { for (const auto &kv : plantumlFiles) { Debug::print(Debug::Plantuml,0,"*** %s PlantumlFiles key:%s size:%zu\n","PlantumlManager::print Files",kv.first.c_str(),kv.second.size()); for (const auto &s : kv.second) { Debug::print(Debug::Plantuml,0,"*** %s list:%s\n","PlantumlManager::print",s.c_str()); } } } } static void print(const PlantumlManager::ContentMap &plantumlContent) { if (Debug::isFlagSet(Debug::Plantuml)) { for (const auto &kv : plantumlContent) { Debug::print(Debug::Plantuml,0,"*** %s PlantumlContent key:%s\n","PlantumlManager::print Content",kv.first.c_str()); Debug::print(Debug::Plantuml,0,"*** %s Content :%s\n","PlantumlManager::print",kv.second.content.data()); } } } static void addPlantumlFiles(PlantumlManager::FilesMap &plantumlFiles, const std::string &key, const std::string &value) { auto kv = plantumlFiles.find(key); if (kv==plantumlFiles.end()) { kv = plantumlFiles.insert(std::make_pair(key,StringVector())).first; } kv->second.push_back(value); } static void addPlantumlContent(PlantumlManager::ContentMap &plantumlContent, const std::string &key, const QCString &outDir, const QCString &puContent) { auto kv = plantumlContent.find(key); if (kv==plantumlContent.end()) { kv = plantumlContent.insert(std::make_pair(key,PlantumlContent("",outDir))).first; } kv->second.content+=puContent; } void PlantumlManager::insert(const std::string &key, const std::string &value, const QCString &outDir,OutputFormat format,const QCString &puContent) { int find; Debug::print(Debug::Plantuml,0,"*** %s key:%s ,value:%s\n","PlantumlManager::insert",qPrint(key),qPrint(value)); m_currentPlantumlAllContent+=puContent; find = m_cachedPlantumlAllContent.find(puContent); Debug::print(Debug::Plantuml,0,"*** %s find: %d\n","PlantumlManager::addPlantumlContent",find); if (find >=0) { // matched in cache. so we skip to run java for this plantuml return ; } switch (format) { case PUML_BITMAP: addPlantumlFiles(m_pngPlantumlFiles,key,value); print(m_pngPlantumlFiles); addPlantumlContent(m_pngPlantumlContent,key,outDir,puContent); print(m_pngPlantumlContent); break; case PUML_EPS: addPlantumlFiles(m_epsPlantumlFiles,key,value); print(m_epsPlantumlFiles); addPlantumlContent(m_epsPlantumlContent,key,outDir,puContent); print(m_epsPlantumlContent); break; case PUML_SVG: addPlantumlFiles(m_svgPlantumlFiles,key,value); print(m_svgPlantumlFiles); addPlantumlContent(m_svgPlantumlContent,key,outDir,puContent); print(m_svgPlantumlContent); break; } } //--------------------------------------------------------------------