cmake/Source/cmGeneratorExpression.h

/* Distributed under the OSI-approved BSD 3-Clause License.  See accompanying
   file Copyright.txt or https://cmake.org/licensing for details.  */
#ifndef cmGeneratorExpression_h
#define cmGeneratorExpression_h

#include "cmConfigure.h" // IWYU pragma: keep

#include "cmListFileCache.h"

#include <map>
#include <memory> // IWYU pragma: keep
#include <set>
#include <string>
#include <vector>

class cmCompiledGeneratorExpression;
class cmGeneratorTarget;
class cmLocalGenerator;
struct cmGeneratorExpressionContext;
struct cmGeneratorExpressionDAGChecker;
struct cmGeneratorExpressionEvaluator;

/** \class cmGeneratorExpression
 * \brief Evaluate generate-time query expression syntax.
 *
 * cmGeneratorExpression instances are used by build system generator
 * implementations to evaluate the $<> generator expression syntax.
 * Generator expressions are evaluated just before the generate step
 * writes strings into the build system.  They have knowledge of the
 * build configuration which is not available at configure time.
 */
class cmGeneratorExpression
{
  CM_DISABLE_COPY(cmGeneratorExpression)

public:
  /** Construct. */
  cmGeneratorExpression(
    cmListFileBacktrace const& backtrace = cmListFileBacktrace());
  ~cmGeneratorExpression();

  std::unique_ptr<cmCompiledGeneratorExpression> Parse(
    std::string const& input);
  std::unique_ptr<cmCompiledGeneratorExpression> Parse(const char* input);

  enum PreprocessContext
  {
    StripAllGeneratorExpressions,
    BuildInterface,
    InstallInterface
  };

  static std::string Preprocess(const std::string& input,
                                PreprocessContext context,
                                bool resolveRelative = false);

  static void Split(const std::string& input,
                    std::vector<std::string>& output);

  static std::string::size_type Find(const std::string& input);

  static bool IsValidTargetName(const std::string& input);

  static std::string StripEmptyListElements(const std::string& input);

private:
  cmListFileBacktrace Backtrace;
};

class cmCompiledGeneratorExpression
{
  CM_DISABLE_COPY(cmCompiledGeneratorExpression)

public:
  const char* Evaluate(cmLocalGenerator* lg, const std::string& config,
                       bool quiet = false,
                       cmGeneratorTarget const* headTarget = nullptr,
                       cmGeneratorTarget const* currentTarget = nullptr,
                       cmGeneratorExpressionDAGChecker* dagChecker = nullptr,
                       std::string const& language = std::string()) const;
  const char* Evaluate(cmLocalGenerator* lg, const std::string& config,
                       bool quiet, cmGeneratorTarget const* headTarget,
                       cmGeneratorExpressionDAGChecker* dagChecker,
                       std::string const& language = std::string()) const;

  /** Get set of targets found during evaluations.  */
  std::set<cmGeneratorTarget*> const& GetTargets() const
  {
    return this->DependTargets;
  }

  std::set<std::string> const& GetSeenTargetProperties() const
  {
    return this->SeenTargetProperties;
  }

  std::set<cmGeneratorTarget const*> const& GetAllTargetsSeen() const
  {
    return this->AllTargetsSeen;
  }

  ~cmCompiledGeneratorExpression();

  std::string const& GetInput() const { return this->Input; }

  cmListFileBacktrace GetBacktrace() const { return this->Backtrace; }
  bool GetHadContextSensitiveCondition() const
  {
    return this->HadContextSensitiveCondition;
  }
  bool GetHadHeadSensitiveCondition() const
  {
    return this->HadHeadSensitiveCondition;
  }
  std::set<cmGeneratorTarget const*> GetSourceSensitiveTargets() const
  {
    return this->SourceSensitiveTargets;
  }

  void SetEvaluateForBuildsystem(bool eval)
  {
    this->EvaluateForBuildsystem = eval;
  }

  void GetMaxLanguageStandard(cmGeneratorTarget const* tgt,
                              std::map<std::string, std::string>& mapping);

private:
  const char* EvaluateWithContext(
    cmGeneratorExpressionContext& context,
    cmGeneratorExpressionDAGChecker* dagChecker) const;

  cmCompiledGeneratorExpression(cmListFileBacktrace const& backtrace,
                                const std::string& input);

  friend class cmGeneratorExpression;

  cmListFileBacktrace Backtrace;
  std::vector<cmGeneratorExpressionEvaluator*> Evaluators;
  const std::string Input;
  bool NeedsEvaluation;

  mutable std::set<cmGeneratorTarget*> DependTargets;
  mutable std::set<cmGeneratorTarget const*> AllTargetsSeen;
  mutable std::set<std::string> SeenTargetProperties;
  mutable std::map<cmGeneratorTarget const*,
                   std::map<std::string, std::string>>
    MaxLanguageStandard;
  mutable std::string Output;
  mutable bool HadContextSensitiveCondition;
  mutable bool HadHeadSensitiveCondition;
  mutable std::set<cmGeneratorTarget const*> SourceSensitiveTargets;
  bool EvaluateForBuildsystem;
};

class cmGeneratorExpressionInterpreter
{
  CM_DISABLE_COPY(cmGeneratorExpressionInterpreter)

public:
  cmGeneratorExpressionInterpreter(cmLocalGenerator* localGenerator,
                                   cmGeneratorTarget* generatorTarget,
                                   const std::string& config,
                                   const std::string& target,
                                   const std::string& lang)
    : LocalGenerator(localGenerator)
    , GeneratorTarget(generatorTarget)
    , Config(config)
    , Target(target)
    , Language(lang)
  {
  }
  cmGeneratorExpressionInterpreter(cmLocalGenerator* localGenerator,
                                   cmGeneratorTarget* generatorTarget,
                                   const std::string& config)
    : cmGeneratorExpressionInterpreter(localGenerator, generatorTarget, config,
                                       std::string(), std::string())
  {
  }

  const char* Evaluate(const char* expression)
  {
    return this->EvaluateExpression(expression);
  }
  const char* Evaluate(const std::string& expression)
  {
    return this->Evaluate(expression.c_str());
  }
  const char* Evaluate(const char* expression, const std::string& property);
  const char* Evaluate(const std::string& expression,
                       const std::string& property)
  {
    return this->Evaluate(expression.c_str(), property);
  }

protected:
  cmGeneratorExpression& GetGeneratorExpression()
  {
    return this->GeneratorExpression;
  }

  cmCompiledGeneratorExpression& GetCompiledGeneratorExpression()
  {
    return *(this->CompiledGeneratorExpression);
  }

  cmLocalGenerator* GetLocalGenerator() { return this->LocalGenerator; }

  cmGeneratorTarget* GetGeneratorTarget() { return this->GeneratorTarget; }

  const std::string& GetTargetName() const { return this->Target; }
  const std::string& GetLanguage() const { return this->Language; }

  const char* EvaluateExpression(
    const char* expression,
    cmGeneratorExpressionDAGChecker* dagChecker = nullptr)
  {
    this->CompiledGeneratorExpression =
      this->GeneratorExpression.Parse(expression);

    if (dagChecker == nullptr) {
      return this->CompiledGeneratorExpression->Evaluate(
        this->LocalGenerator, this->Config, false, this->GeneratorTarget);
    }

    return this->CompiledGeneratorExpression->Evaluate(
      this->LocalGenerator, this->Config, false, this->GeneratorTarget,
      dagChecker, this->Language);
  }

private:
  cmGeneratorExpression GeneratorExpression;
  std::unique_ptr<cmCompiledGeneratorExpression> CompiledGeneratorExpression;
  cmLocalGenerator* LocalGenerator = nullptr;
  cmGeneratorTarget* GeneratorTarget = nullptr;
  std::string Config;
  std::string Target;
  std::string Language;
};

#endif