Source/cmFindCommon.h

   1 /* Distributed under the OSI-approved BSD 3-Clause License.  See accompanying
   2    file Copyright.txt or https://cmake.org/licensing for details.  */
   3 #pragma once
   4
   5 #include "cmConfigure.h" // IWYU pragma: keep
   6
   7 #include <map>
   8 #include <set>
   9 #include <string>
  10 #include <vector>
  11
  12 #include "cmPathLabel.h"
  13 #include "cmSearchPath.h"
  14 #include "cmWindowsRegistry.h"
  15
  16 class cmExecutionStatus;
  17 class cmMakefile;
  18
  19 /** \class cmFindCommon
  20  * \brief Base class for FIND_XXX implementations.
  21  *
  22  * cmFindCommon is a parent class for cmFindBase,
  23  * cmFindProgramCommand, cmFindPathCommand, cmFindLibraryCommand,
  24  * cmFindFileCommand, and cmFindPackageCommand.
  25  */
  26 class cmFindCommon
  27 {
  28 public:
  29   cmFindCommon(cmExecutionStatus& status);
  30
  31   void SetError(std::string const& e);
  32
  33   bool DebugModeEnabled() const { return this->DebugMode; }
  34
  35 protected:
  36   friend class cmSearchPath;
  37   friend class cmFindBaseDebugState;
  38
  39   /** Used to define groups of path labels */
  40   class PathGroup : public cmPathLabel
  41   {
  42   protected:
  43     PathGroup();
  44
  45   public:
  46     PathGroup(const std::string& label)
  47       : cmPathLabel(label)
  48     {
  49     }
  50     static PathGroup All;
  51   };
  52
  53   /* Individual path types */
  54   class PathLabel : public cmPathLabel
  55   {
  56   protected:
  57     PathLabel();
  58
  59   public:
  60     PathLabel(const std::string& label)
  61       : cmPathLabel(label)
  62     {
  63     }
  64     static PathLabel PackageRoot;
  65     static PathLabel CMake;
  66     static PathLabel CMakeEnvironment;
  67     static PathLabel Hints;
  68     static PathLabel SystemEnvironment;
  69     static PathLabel CMakeSystem;
  70     static PathLabel Guess;
  71   };
  72
  73   enum RootPathMode
  74   {
  75     RootPathModeNever,
  76     RootPathModeOnly,
  77     RootPathModeBoth
  78   };
  79
  80   /** Construct the various path groups and labels */
  81   void InitializeSearchPathGroups();
  82
  83   /** Place a set of search paths under the search roots.  */
  84   void RerootPaths(std::vector<std::string>& paths);
  85
  86   /** Get ignored paths from CMAKE_[SYSTEM_]IGNORE_PATH variables.  */
  87   void GetIgnoredPaths(std::vector<std::string>& ignore);
  88   void GetIgnoredPaths(std::set<std::string>& ignore);
  89
  90   /** Get ignored paths from CMAKE_[SYSTEM_]IGNORE_PREFIX_PATH variables.  */
  91   void GetIgnoredPrefixPaths(std::vector<std::string>& ignore);
  92   void GetIgnoredPrefixPaths(std::set<std::string>& ignore);
  93
  94   /** Compute final search path list (reroot + trailing slash).  */
  95   enum class IgnorePaths
  96   {
  97     No,
  98     Yes,
  99   };
 100   void ComputeFinalPaths(IgnorePaths ignorePaths);
 101
 102   /** Compute the current default root path mode.  */
 103   void SelectDefaultRootPathMode();
 104
 105   /** Compute the current default bundle/framework search policy.  */
 106   void SelectDefaultMacMode();
 107
 108   /** Compute the current default search modes based on global variables.  */
 109   void SelectDefaultSearchModes();
 110
 111   /** The `InitialPass` functions of the child classes should set
 112       this->DebugMode to the result of these.  */
 113   bool ComputeIfDebugModeWanted();
 114   bool ComputeIfDebugModeWanted(std::string const& var);
 115
 116   // Path arguments prior to path manipulation routines
 117   std::vector<std::string> UserHintsArgs;
 118   std::vector<std::string> UserGuessArgs;
 119
 120   std::string CMakePathName;
 121   RootPathMode FindRootPathMode;
 122
 123   bool CheckCommonArgument(std::string const& arg);
 124   void AddPathSuffix(std::string const& arg);
 125
 126   void DebugMessage(std::string const& msg) const;
 127   bool DebugMode;
 128   bool NoDefaultPath;
 129   bool NoPackageRootPath;
 130   bool NoCMakePath;
 131   bool NoCMakeEnvironmentPath;
 132   bool NoSystemEnvironmentPath;
 133   bool NoCMakeSystemPath;
 134   bool NoCMakeInstallPath;
 135   cmWindowsRegistry::View RegistryView = cmWindowsRegistry::View::Target;
 136
 137   std::vector<std::string> SearchPathSuffixes;
 138
 139   std::map<PathGroup, std::vector<PathLabel>> PathGroupLabelMap;
 140   std::vector<PathGroup> PathGroupOrder;
 141   std::map<std::string, PathLabel> PathLabelStringMap;
 142   std::map<PathLabel, cmSearchPath> LabeledPaths;
 143
 144   std::vector<std::string> SearchPaths;
 145   std::set<cmSearchPath::PathWithPrefix> SearchPathsEmitted;
 146
 147   bool SearchFrameworkFirst;
 148   bool SearchFrameworkOnly;
 149   bool SearchFrameworkLast;
 150
 151   bool SearchAppBundleFirst;
 152   bool SearchAppBundleOnly;
 153   bool SearchAppBundleLast;
 154
 155   cmMakefile* Makefile;
 156   cmExecutionStatus& Status;
 157 };