perlmodgen.cpp File Reference

#include <stdlib.h>
#include <stack>
#include "perlmodgen.h"
#include "docparser.h"
#include "docnode.h"
#include "message.h"
#include "doxygen.h"
#include "pagedef.h"
#include "memberlist.h"
#include "arguments.h"
#include "config.h"
#include "groupdef.h"
#include "classdef.h"
#include "conceptdef.h"
#include "classlist.h"
#include "filename.h"
#include "membername.h"
#include "namespacedef.h"
#include "membergroup.h"
#include "section.h"
#include "docvisitor.h"
#include "util.h"
#include "htmlentity.h"
#include "emoji.h"
#include "dir.h"
#include "portable.h"
#include "moduledef.h"
#include "construct.h"
#include "cite.h"

Include dependency graph for perlmodgen.cpp:

Go to the source code of this file.

Classes
class	PerlModOutputStream
class	PerlModOutput
class	PerlModDocVisitor
	Concrete visitor implementation for PerlMod output. More...
class	PerlModGenerator

Macros
#define	PERLOUTPUT_MAX_INDENTATION   40

Functions
static void	addTemplateArgumentList (const ArgumentList &al, PerlModOutput &output, const DString &)
static void	addTemplateList (const ClassDef *cd, PerlModOutput &output)
static void	addTemplateList (const ConceptDef *cd, PerlModOutput &output)
static void	addPerlModDocBlock (PerlModOutput &output, const DString &name, const DString &fileName, int lineNr, const Definition *scope, const MemberDef *md, const DString &text)
static const char *	getProtectionName (Protection prot)
static const char *	getVirtualnessName (Specifier virt)
void	setPerlModDoxyfile (const DString &qs)
void	generatePerlMod ()

Variables
static DString	pathDoxyfile
static DString	pathDoxyExec

Macro Definition Documentation

PERLOUTPUT_MAX_INDENTATION

#define PERLOUTPUT_MAX_INDENTATION   40

Definition at line 48 of file perlmodgen.cpp.

Referenced by PerlModOutput::decIndent(), and PerlModOutput::incIndent().

Function Documentation

addPerlModDocBlock()

void addPerlModDocBlock ( PerlModOutput & output, const DString & name, const DString & fileName, int lineNr, const Definition * scope, const MemberDef * md, const DString & text )

static

Definition at line 1384 of file perlmodgen.cpp.

{
  DString stext = text.stripWhiteSpace();
  if (stext.empty())
  {
    output.addField(name).add("{}");
  }
  else
  {
    auto parser { createDocParser() };
    auto ast    { validatingParseDoc(*parser.get(),
                                     fileName,
                                     lineNr,
                                     scope,
                                     md,
                                     stext,
                                     DocOptions())
                 };
    output.openHash(name);
    auto astImpl = dynamic_cast<const DocNodeAST*>(ast.get());
    if (astImpl)
    {
      PerlModDocVisitor visitor(output);
      std::visit(visitor,astImpl->root);
      visitor.finish();
    }
    output.closeHash();
  }
}

References PerlModOutput::add(), PerlModOutput::addField(), PerlModOutput::closeHash(), createDocParser(), DString::empty(), PerlModDocVisitor::finish(), PerlModOutput::openHash(), DString::stripWhiteSpace(), and validatingParseDoc().

Referenced by PerlModGenerator::generatePerlModForClass(), PerlModGenerator::generatePerlModForConcept(), PerlModGenerator::generatePerlModForFile(), PerlModGenerator::generatePerlModForGroup(), PerlModGenerator::generatePerlModForMember(), PerlModGenerator::generatePerlModForModule(), PerlModGenerator::generatePerlModForNamespace(), and PerlModGenerator::generatePerlModForPage().

addTemplateArgumentList()

void addTemplateArgumentList ( const ArgumentList & al, PerlModOutput & output, const DString &  )

static

Definition at line 1355 of file perlmodgen.cpp.

{
  if (!al.hasParameters()) return;
  output.openList("template_parameters");
  for (const Argument &a : al)
  {
    output.openHash();
    if (!a.type.empty())
      output.addFieldQuotedString("type", a.type);
    if (!a.name.empty())
      output.addFieldQuotedString("declaration_name", a.name)
            .addFieldQuotedString("definition_name", a.name);
    if (!a.defval.empty())
      output.addFieldQuotedString("default", a.defval);
    output.closeHash();
  }
  output.closeList();
}

References PerlModOutput::addFieldQuotedString(), PerlModOutput::closeHash(), PerlModOutput::closeList(), ArgumentList::hasParameters(), PerlModOutput::openHash(), and PerlModOutput::openList().

Referenced by addTemplateList(), and addTemplateList().

addTemplateList() [1/2]

void addTemplateList ( const ClassDef * cd, PerlModOutput & output )

static

Definition at line 1374 of file perlmodgen.cpp.

{
  addTemplateArgumentList(cd->templateArguments(),output,cd->name());
}

References addTemplateArgumentList(), Definition::name(), and ClassDef::templateArguments().

Referenced by PerlModGenerator::generatePerlModForClass(), and PerlModGenerator::generatePerlModForConcept().

addTemplateList() [2/2]

void addTemplateList ( const ConceptDef * cd, PerlModOutput & output )

static

Definition at line 1379 of file perlmodgen.cpp.

{
  addTemplateArgumentList(cd->getTemplateParameterList(),output,cd->name());
}

References addTemplateArgumentList(), ConceptDef::getTemplateParameterList(), and Definition::name().

generatePerlMod()

void generatePerlMod

(

)

Definition at line 2953 of file perlmodgen.cpp.

{
  PerlModGenerator pmg(Config_getBool(PERLMOD_PRETTY));
  pmg.generate();
}

References Config_getBool, and PerlModGenerator::generate().

Referenced by generateOutput().

getProtectionName()

const char * getProtectionName ( Protection prot )

static

Definition at line 1420 of file perlmodgen.cpp.

{
  return to_string_lower(prot);
}

Referenced by PerlModGenerator::addListOfAllMembers(), PerlModGenerator::generatePerlModForClass(), and PerlModGenerator::generatePerlModForMember().

getVirtualnessName()

const char * getVirtualnessName ( Specifier virt )

static

Definition at line 1425 of file perlmodgen.cpp.

{
  return to_string_lower(virt);
}

Referenced by PerlModGenerator::addListOfAllMembers(), PerlModGenerator::generatePerlModForClass(), and PerlModGenerator::generatePerlModForMember().

setPerlModDoxyfile()

void setPerlModDoxyfile

(

const DString &

qs

)

Definition at line 1433 of file perlmodgen.cpp.

{
  pathDoxyfile = qs;
  pathDoxyExec = Dir::currentDirPath();
}

References Dir::currentDirPath(), pathDoxyExec, and pathDoxyfile.

Referenced by readConfiguration().

Variable Documentation

pathDoxyExec

DString pathDoxyExec

static

Definition at line 1431 of file perlmodgen.cpp.

Referenced by PerlModGenerator::generateDoxyRules(), and setPerlModDoxyfile().

pathDoxyfile

DString pathDoxyfile

static

Definition at line 1430 of file perlmodgen.cpp.

Referenced by PerlModGenerator::generateDoxyRules(), and setPerlModDoxyfile().