Coverage Report

Created: 2026-07-14 07:09

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/CMake/Source/cmExportCMakeConfigGenerator.h
Line
Count
Source
1
/* Distributed under the OSI-approved BSD 3-Clause License.  See accompanying
2
   file LICENSE.rst or https://cmake.org/licensing for details.  */
3
#pragma once
4
5
#include "cmConfigure.h" // IWYU pragma: keep
6
7
#include <iosfwd>
8
#include <map>
9
#include <set>
10
#include <string>
11
12
#include <cm/string_view>
13
14
#include "cmExportFileGenerator.h"
15
#include "cmGeneratorExpression.h"
16
17
class cmGeneratorFileSet;
18
class cmGeneratorTarget;
19
class cmTargetExport;
20
21
namespace cm {
22
enum class TargetType;
23
} // namespace cm
24
25
/** \class cmExportCMakeConfigGenerator
26
 * \brief Generate CMake configuration files exporting targets from a build or
27
 * install tree.
28
 *
29
 * cmExportCMakeConfigGenerator is the superclass for
30
 * cmExportBuildCMakeConfigGenerator and cmExportInstallCMakeConfigGenerator.
31
 * It contains common code generation routines for the two kinds of export
32
 * implementations.
33
 */
34
class cmExportCMakeConfigGenerator : virtual public cmExportFileGenerator
35
{
36
public:
37
  cmExportCMakeConfigGenerator();
38
39
0
  void SetExportOld(bool exportOld) { this->ExportOld = exportOld; }
40
41
  void SetExportPackageDependencies(bool exportPackageDependencies)
42
0
  {
43
0
    this->ExportPackageDependencies = exportPackageDependencies;
44
0
  }
45
46
  using cmExportFileGenerator::GenerateImportFile;
47
48
protected:
49
  using ImportPropertyMap = std::map<std::string, std::string>;
50
  using ImportFileSetPropertyMap = std::map<std::string, ImportPropertyMap>;
51
52
  // Methods to implement export file code generation.
53
  bool GenerateImportFile(std::ostream& os) override;
54
  virtual void GeneratePolicyHeaderCode(std::ostream& os);
55
  virtual void GeneratePolicyFooterCode(std::ostream& os);
56
  virtual void GenerateImportHeaderCode(std::ostream& os,
57
                                        std::string const& config = "");
58
  virtual void GenerateImportFooterCode(std::ostream& os);
59
  void GenerateImportVersionCode(std::ostream& os);
60
  virtual void GenerateImportTargetCode(std::ostream& os,
61
                                        cmGeneratorTarget const* target,
62
                                        cm::TargetType targetType);
63
  virtual void GenerateImportPropertyCode(
64
    std::ostream& os, std::string const& config, std::string const& suffix,
65
    cmGeneratorTarget const* target, ImportPropertyMap const& properties,
66
    std::string const& importedXcFrameworkLocation);
67
  virtual void GenerateImportedFileChecksCode(
68
    std::ostream& os, cmGeneratorTarget const* target,
69
    ImportPropertyMap const& properties,
70
    std::set<std::string> const& importedLocations,
71
    std::string const& importedXcFrameworkLocation);
72
  virtual void GenerateImportedFileCheckLoop(std::ostream& os);
73
  virtual void GenerateMissingTargetsCheckCode(std::ostream& os);
74
  virtual void GenerateFindDependencyCalls(std::ostream& os);
75
76
  virtual void GenerateExpectedTargetsCode(std::ostream& os,
77
                                           std::string const& expectedTargets);
78
79
  cm::string_view GetImportPrefixWithSlash() const override;
80
81
  virtual void GenerateInterfaceProperties(
82
    cmGeneratorTarget const* target, std::ostream& os,
83
    ImportPropertyMap const& properties);
84
85
  void SetImportLinkInterface(
86
    std::string const& config, std::string const& suffix,
87
    cmGeneratorExpression::PreprocessContext preprocessRule,
88
    cmGeneratorTarget const* target, ImportPropertyMap& properties);
89
90
  void GenerateTargetFileSets(cmGeneratorTarget* gte, std::ostream& os,
91
                              ImportFileSetPropertyMap const& properties,
92
                              cmTargetExport const* te = nullptr);
93
94
  std::string GetCxxModuleFile(std::string const& name) const override;
95
96
  void GenerateCxxModuleInformation(std::string const& name, std::ostream& os);
97
98
  virtual std::string GetFileSetDirectories(cmGeneratorTarget* gte,
99
                                            cmGeneratorFileSet const* fileSet,
100
                                            cmTargetExport const* te) = 0;
101
  virtual std::string GetFileSetFiles(cmGeneratorTarget* gte,
102
                                      cmGeneratorFileSet const* fileSet,
103
                                      cmTargetExport const* te) = 0;
104
105
  void SetRequiredCMakeVersion(unsigned int major, unsigned int minor,
106
                               unsigned int patch);
107
108
  bool ExportOld = false;
109
  bool ExportPackageDependencies = false;
110
111
  unsigned int RequiredCMakeVersionMajor = 2;
112
  unsigned int RequiredCMakeVersionMinor = 8;
113
  unsigned int RequiredCMakeVersionPatch = 3;
114
};