/* Distributed under the OSI-approved BSD 3-Clause License. See accompanying file Copyright.txt or https://cmake.org/licensing for details. */ #pragma once #include "cmConfigure.h" // IWYU pragma: keep #include #include #include #include #include #include #include #include #include "CTest/cmCTestTypes.h" enum class PackageResolveMode; class cmCMakePresetsGraph { public: enum class ReadFileResult { READ_OK, FILE_NOT_FOUND, JSON_PARSE_ERROR, INVALID_ROOT, NO_VERSION, INVALID_VERSION, UNRECOGNIZED_VERSION, INVALID_CMAKE_VERSION, UNRECOGNIZED_CMAKE_VERSION, INVALID_PRESETS, INVALID_PRESET, INVALID_VARIABLE, DUPLICATE_PRESETS, CYCLIC_PRESET_INHERITANCE, INHERITED_PRESET_UNREACHABLE_FROM_FILE, CONFIGURE_PRESET_UNREACHABLE_FROM_FILE, INVALID_MACRO_EXPANSION, BUILD_TEST_PRESETS_UNSUPPORTED, PACKAGE_PRESETS_UNSUPPORTED, INCLUDE_UNSUPPORTED, INVALID_INCLUDE, INVALID_CONFIGURE_PRESET, INSTALL_PREFIX_UNSUPPORTED, INVALID_CONDITION, CONDITION_UNSUPPORTED, TOOLCHAIN_FILE_UNSUPPORTED, CYCLIC_INCLUDE, TEST_OUTPUT_TRUNCATION_UNSUPPORTED, }; std::string errors; enum class ArchToolsetStrategy { Set, External, }; class CacheVariable { public: std::string Type; std::string Value; }; class Condition; class File { public: std::string Filename; int Version; std::unordered_set ReachableFiles; }; class Preset { public: Preset() = default; Preset(Preset&& /*other*/) = default; Preset(const Preset& /*other*/) = default; Preset& operator=(const Preset& /*other*/) = default; virtual ~Preset() = default; #if __cplusplus >= 201703L || (defined(_MSVC_LANG) && _MSVC_LANG >= 201703L) Preset& operator=(Preset&& /*other*/) = default; #else // The move assignment operators for several STL classes did not become // noexcept until C++17, which causes some tools to warn about this move // assignment operator throwing an exception when it shouldn't. Preset& operator=(Preset&& /*other*/) = delete; #endif std::string Name; std::vector Inherits; bool Hidden; File* OriginFile; std::string DisplayName; std::string Description; std::shared_ptr ConditionEvaluator; bool ConditionResult = true; std::map> Environment; virtual ReadFileResult VisitPresetInherit(const Preset& parent) = 0; virtual ReadFileResult VisitPresetBeforeInherit() { return ReadFileResult::READ_OK; } virtual ReadFileResult VisitPresetAfterInherit(int /* version */) { return ReadFileResult::READ_OK; } }; class ConfigurePreset : public Preset { public: ConfigurePreset() = default; ConfigurePreset(ConfigurePreset&& /*other*/) = default; ConfigurePreset(const ConfigurePreset& /*other*/) = default; ConfigurePreset& operator=(const ConfigurePreset& /*other*/) = default; ~ConfigurePreset() override = default; #if __cplusplus >= 201703L || (defined(_MSVC_LANG) && _MSVC_LANG >= 201703L) ConfigurePreset& operator=(ConfigurePreset&& /*other*/) = default; #else // The move assignment operators for several STL classes did not become // noexcept until C++17, which causes some tools to warn about this move // assignment operator throwing an exception when it shouldn't. ConfigurePreset& operator=(ConfigurePreset&& /*other*/) = delete; #endif std::string Generator; std::string Architecture; cm::optional ArchitectureStrategy; std::string Toolset; cm::optional ToolsetStrategy; std::string ToolchainFile; std::string BinaryDir; std::string InstallDir; std::map> CacheVariables; cm::optional WarnDev; cm::optional ErrorDev; cm::optional WarnDeprecated; cm::optional ErrorDeprecated; cm::optional WarnUninitialized; cm::optional WarnUnusedCli; cm::optional WarnSystemVars; cm::optional DebugOutput; cm::optional DebugTryCompile; cm::optional DebugFind; ReadFileResult VisitPresetInherit(const Preset& parent) override; ReadFileResult VisitPresetBeforeInherit() override; ReadFileResult VisitPresetAfterInherit(int version) override; }; class BuildPreset : public Preset { public: BuildPreset() = default; BuildPreset(BuildPreset&& /*other*/) = default; BuildPreset(const BuildPreset& /*other*/) = default; BuildPreset& operator=(const BuildPreset& /*other*/) = default; ~BuildPreset() override = default; #if __cplusplus >= 201703L || (defined(_MSVC_LANG) && _MSVC_LANG >= 201703L) BuildPreset& operator=(BuildPreset&& /*other*/) = default; #else // The move assignment operators for several STL classes did not become // noexcept until C++17, which causes some tools to warn about this move // assignment operator throwing an exception when it shouldn't. BuildPreset& operator=(BuildPreset&& /*other*/) = delete; #endif std::string ConfigurePreset; cm::optional InheritConfigureEnvironment; cm::optional Jobs; std::vector Targets; std::string Configuration; cm::optional CleanFirst; cm::optional Verbose; std::vector NativeToolOptions; cm::optional ResolvePackageReferences; ReadFileResult VisitPresetInherit(const Preset& parent) override; ReadFileResult VisitPresetAfterInherit(int /* version */) override; }; class TestPreset : public Preset { public: TestPreset() = default; TestPreset(TestPreset&& /*other*/) = default; TestPreset(const TestPreset& /*other*/) = default; TestPreset& operator=(const TestPreset& /*other*/) = default; ~TestPreset() override = default; #if __cplusplus >= 201703L || (defined(_MSVC_LANG) && _MSVC_LANG >= 201703L) TestPreset& operator=(TestPreset&& /*other*/) = default; #else // The move assignment operators for several STL classes did not become // noexcept until C++17, which causes some tools to warn about this move // assignment operator throwing an exception when it shouldn't. TestPreset& operator=(TestPreset&& /*other*/) = delete; #endif struct OutputOptions { enum class VerbosityEnum { Default, Verbose, Extra }; cm::optional ShortProgress; cm::optional Verbosity; cm::optional Debug; cm::optional OutputOnFailure; cm::optional Quiet; std::string OutputLogFile; cm::optional LabelSummary; cm::optional SubprojectSummary; cm::optional MaxPassedTestOutputSize; cm::optional MaxFailedTestOutputSize; cm::optional TestOutputTruncation; cm::optional MaxTestNameWidth; }; struct IncludeOptions { struct IndexOptions { cm::optional Start; cm::optional End; cm::optional Stride; std::vector SpecificTests; std::string IndexFile; }; std::string Name; std::string Label; cm::optional Index; cm::optional UseUnion; }; struct ExcludeOptions { struct FixturesOptions { std::string Any; std::string Setup; std::string Cleanup; }; std::string Name; std::string Label; cm::optional Fixtures; }; struct FilterOptions { cm::optional Include; cm::optional Exclude; }; struct ExecutionOptions { enum class ShowOnlyEnum { Human, JsonV1 }; struct RepeatOptions { enum class ModeEnum { UntilFail, UntilPass, AfterTimeout }; ModeEnum Mode; int Count; }; enum class NoTestsActionEnum { Default, Error, Ignore }; cm::optional StopOnFailure; cm::optional EnableFailover; cm::optional Jobs; std::string ResourceSpecFile; cm::optional TestLoad; cm::optional ShowOnly; cm::optional Repeat; cm::optional InteractiveDebugging; cm::optional ScheduleRandom; cm::optional Timeout; cm::optional NoTestsAction; }; std::string ConfigurePreset; cm::optional InheritConfigureEnvironment; std::string Configuration; std::vector OverwriteConfigurationFile; cm::optional Output; cm::optional Filter; cm::optional Execution; ReadFileResult VisitPresetInherit(const Preset& parent) override; ReadFileResult VisitPresetAfterInherit(int /* version */) override; }; class PackagePreset : public Preset { public: PackagePreset() = default; PackagePreset(PackagePreset&& /*other*/) = default; PackagePreset(const PackagePreset& /*other*/) = default; PackagePreset& operator=(const PackagePreset& /*other*/) = default; ~PackagePreset() override = default; #if __cplusplus >= 201703L || (defined(_MSVC_LANG) && _MSVC_LANG >= 201703L) PackagePreset& operator=(PackagePreset&& /*other*/) = default; #else // The move assignment operators for several STL classes did not become // noexcept until C++17, which causes some tools to warn about this move // assignment operator throwing an exception when it shouldn't. PackagePreset& operator=(PackagePreset&& /*other*/) = delete; #endif std::string ConfigurePreset; cm::optional InheritConfigureEnvironment; std::vector Generators; std::vector Configurations; std::map Variables; std::string ConfigFile; cm::optional DebugOutput; cm::optional VerboseOutput; std::string PackageName; std::string PackageVersion; std::string PackageDirectory; std::string VendorName; ReadFileResult VisitPresetInherit(const Preset& parent) override; ReadFileResult VisitPresetAfterInherit(int /* version */) override; }; template class PresetPair { public: T Unexpanded; cm::optional Expanded; }; std::map> ConfigurePresets; std::map> BuildPresets; std::map> TestPresets; std::map> PackagePresets; std::vector ConfigurePresetOrder; std::vector BuildPresetOrder; std::vector TestPresetOrder; std::vector PackagePresetOrder; std::string SourceDir; std::vector> Files; int GetVersion(const Preset& preset) const { return preset.OriginFile->Version; } static std::string GetFilename(const std::string& sourceDir); static std::string GetUserFilename(const std::string& sourceDir); ReadFileResult ReadProjectPresets(const std::string& sourceDir, bool allowNoFiles = false); static const char* ResultToString(ReadFileResult result); std::string GetGeneratorForPreset(const std::string& presetName) const { auto configurePresetName = presetName; auto buildPresetIterator = this->BuildPresets.find(presetName); if (buildPresetIterator != this->BuildPresets.end()) { configurePresetName = buildPresetIterator->second.Unexpanded.ConfigurePreset; } else { auto testPresetIterator = this->TestPresets.find(presetName); if (testPresetIterator != this->TestPresets.end()) { configurePresetName = testPresetIterator->second.Unexpanded.ConfigurePreset; } } auto configurePresetIterator = this->ConfigurePresets.find(configurePresetName); if (configurePresetIterator != this->ConfigurePresets.end()) { return configurePresetIterator->second.Unexpanded.Generator; } // This should only happen if the preset is hidden // or (for build or test presets) if ConfigurePreset is invalid. return ""; } enum class PrintPrecedingNewline { False, True, }; static void printPrecedingNewline(PrintPrecedingNewline* p); static void PrintPresets( const std::vector& presets); void PrintConfigurePresetList( PrintPrecedingNewline* newline = nullptr) const; void PrintConfigurePresetList( const std::function& filter, PrintPrecedingNewline* newline = nullptr) const; void PrintBuildPresetList(PrintPrecedingNewline* newline = nullptr) const; void PrintTestPresetList(PrintPrecedingNewline* newline = nullptr) const; void PrintPackagePresetList(PrintPrecedingNewline* newline = nullptr) const; void PrintPackagePresetList( const std::function& filter, PrintPrecedingNewline* newline = nullptr) const; void PrintAllPresets() const; private: enum class RootType { Project, User, }; enum class ReadReason { Root, Included, }; ReadFileResult ReadProjectPresetsInternal(bool allowNoFiles); ReadFileResult ReadJSONFile(const std::string& filename, RootType rootType, ReadReason readReason, std::vector& inProgressFiles, File*& file, std::string& errMsg); void ClearPresets(); };