htags.cpp

Go to the documentation of this file.

/******************************************************************************
 *
 * 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.
 *
 */
 
// own header
#include "htags.h"
 
// standard includes
#include <cstdio>
#include <string>
#include <unordered_map>
 
// other includes
#include "config.h"
#include "dir.h"
#include "fileinfo.h"
#include "message.h"
#include "portable.h"
#include "util.h"
 
bool Htags::useHtags = false;
 
static Dir g_inputDir;
static std::unordered_map<std::string,std::string> g_symbolMap;
 
/*! constructs command line of htags(1) and executes it.
 *  \retval true success
 *  \retval false an error has occurred.
 */
bool Htags::execute(const DString &htmldir)
{
  StringVector inputSource = Config_getList(INPUT);
  bool quiet = Config_getBool(QUIET);
  bool warnings = Config_getBool(WARNINGS);
  DString htagsOptions = ""; //Config_getString(HTAGS_OPTIONS);
  DString projectName = Config_getString(PROJECT_NAME);
  DString projectNumber = Config_getString(PROJECT_NUMBER);
 
  if (inputSource.empty())
  {
    g_inputDir.setPath(Dir::currentDirPath());
  }
  else if (inputSource.size()==1)
  {
    g_inputDir.setPath(inputSource.back());
    if (!g_inputDir.exists())
      err("Cannot find directory {}. "
          "Check the value of the INPUT tag in the configuration file.\n",
          inputSource.back()
         );
  }
  else
  {
    err("If you use USE_HTAGS then INPUT should specify a single directory.\n");
    return false;
  }
 
  /*
   * Construct command line for htags(1).
   */
  DString commandLine = " -g -s -a -n ";
  if (!quiet)   commandLine += "-v ";
  if (warnings) commandLine += "-w ";
  if (!htagsOptions.empty())
  {
    commandLine += ' ';
    commandLine += htagsOptions;
  }
  if (!projectName.empty())
  {
    commandLine += "-t \"";
    commandLine += projectName;
    if (!projectNumber.empty())
    {
      commandLine += '-';
      commandLine += projectNumber;
    }
    commandLine += "\" ";
  }
  commandLine += " \"" + htmldir + "\"";
  std::string oldDir = Dir::currentDirPath();
  Dir::setCurrent(g_inputDir.absPath());
  //printf("CommandLine=[%s]\n",qPrint(commandLine));
  bool result=Portable::system("htags",commandLine,false)==0;
  if (!result)
  {
    err("Problems running htags. Check your installation\n");
  }
  Dir::setCurrent(oldDir);
  return result;
}
 
 
/*! load filemap and make index.
 *  \param htmlDir of HTML directory generated by htags(1).
 *  \retval true success
 *  \retval false error
 */
bool Htags::loadFilemap(const DString &htmlDir)
{
  DString fileMapName = htmlDir+"/HTML/FILEMAP";
  FileInfo fi(fileMapName.str());
  /*
   * Construct FILEMAP dictionary.
   *
   * In FILEMAP, URL includes 'html' suffix but we cut it off according
   * to the method of FileDef class.
   *
   * FILEMAP format:
   * <NAME>\t<HREF>.html\n
   * QDICT:
   * dict[<NAME>] = <HREF>
   */
  if (fi.exists() && fi.isReadable())
  {
    std::ifstream f = Portable::openInputStream(fileMapName);
    if (f.is_open())
    {
      std::string lineStr;
      while (getline(f,lineStr))
      {
        DString line(lineStr);
        //printf("Read line: %s",qPrint(line));
        if (size_t sep = line.find('\t'); sep!=DString::npos)
        {
          DString key   = line.left(sep).stripWhiteSpace();
          DString value = line.mid(sep+1).stripWhiteSpace();
          size_t ext=value.rfind('.');
          if (ext!=DString::npos) value=value.left(ext); // strip extension
          g_symbolMap.emplace(key.str(),value.str());
          //printf("Key/Value=(%s,%s)\n",qPrint(key),qPrint(value));
        }
      }
      return true;
    }
    else
    {
      err("file {} cannot be opened\n",fileMapName);
    }
  }
  return false;
}
 
/*! convert path name into the url in the hypertext generated by htags.
 *  \param path path name
 *  \returns URL nullptr: not found.
 */
DString Htags::path2URL(const DString &path)
{
  DString url,symName=path;
  DString dir = g_inputDir.absPath();
  size_t dl=dir.length();
  if (symName.length()>dl+1)
  {
    symName = symName.mid(dl+1);
  }
  if (!symName.empty())
  {
    auto it = g_symbolMap.find(symName.str());
    //printf("path2URL=%s symName=%s result=%p\n",qPrint(path),qPrint(symName),result);
    if (it!=g_symbolMap.end())
    {
      url = DString("HTML/"+it->second);
    }
  }
  return url;
}