blob: f55ef65f304aa6c1d192d0f3b419b02f57010ee1 [file]
/* Distributed under the OSI-approved BSD 3-Clause License. See accompanying
file LICENSE.rst or https://cmake.org/licensing for details. */
#include "cmCTestBuildCommand.h"
#include <sstream>
#include <utility>
#include <cm/memory>
#include <cm/optional>
#include <cmext/string_view>
#include "cmArgumentParser.h"
#include "cmCMakePresetsGraph.h"
#include "cmCTest.h"
#include "cmCTestBuildHandler.h"
#include "cmCTestGenericHandler.h"
#include "cmExecutionStatus.h"
#include "cmGlobalGenerator.h"
#include "cmJSONState.h"
#include "cmMakefile.h"
#include "cmMessageType.h"
#include "cmStringAlgorithms.h"
#include "cmSystemTools.h"
#include "cmValue.h"
#include "cmake.h"
using BuildPreset = cmCMakePresetsGraph::BuildPreset;
bool cmCTestBuildCommand::InitialPass(std::vector<std::string> const& args,
cmExecutionStatus& status) const
{
static auto const parser =
cmArgumentParser<BuildArguments>{ MakeHandlerParser<BuildArguments>() }
.Bind("NUMBER_ERRORS"_s, &BuildArguments::NumberErrors)
.Bind("NUMBER_WARNINGS"_s, &BuildArguments::NumberWarnings)
.Bind("TARGET"_s, &BuildArguments::Target)
.Bind("CONFIGURATION"_s, &BuildArguments::Configuration)
.Bind("FLAGS"_s, &BuildArguments::Flags)
.Bind("PROJECT_NAME"_s, &BuildArguments::ProjectName)
.Bind("PARALLEL_LEVEL"_s, &BuildArguments::ParallelLevel)
.Bind("PRESET"_s, &BuildArguments::Preset)
.Bind("PRESETS_FILE"_s, &BuildArguments::PresetsFile);
return this->Invoke(parser, args, status, [&](BuildArguments& a) {
return this->ExecuteHandlerCommand(a, status);
});
}
std::unique_ptr<cmCTestGenericHandler> cmCTestBuildCommand::InitializeHandler(
HandlerArguments& arguments, cmExecutionStatus& status) const
{
cmMakefile& mf = status.GetMakefile();
auto const& args = static_cast<BuildArguments&>(arguments);
auto handler = cm::make_unique<cmCTestBuildHandler>(this->CTest);
// Build configuration is set according to the following priority order:
// 1) The CONFIGURATION option to ctest_build()
// 2) CTEST_BUILD_CONFIGURATION script variable
// 3) CTEST_CONFIGURATION_TYPE script variable
// 4) The ctest -C command line argument
// 5) The configuration entry from the build preset
cmValue ctestBuildConfiguration =
mf.GetDefinition("CTEST_BUILD_CONFIGURATION");
std::string cmakeBuildConfiguration = cmNonempty(args.Configuration)
? args.Configuration
: cmNonempty(ctestBuildConfiguration) ? *ctestBuildConfiguration
: this->CTest->GetConfigType();
std::string const& cmakeBuildAdditionalFlags = cmNonempty(args.Flags)
? args.Flags
: mf.GetSafeDefinition("CTEST_BUILD_FLAGS");
std::string const& cmakeBuildTarget = cmNonempty(args.Target)
? args.Target
: mf.GetSafeDefinition("CTEST_BUILD_TARGET");
// Preset name is set according to the following priority order:
// 1) The PRESET option to ctest_build()
// 2) CTEST_BUILD_PRESET script variable
// 3) CTEST_PRESET script variable (a warning is emitted if no build preset
// exists with this name)
std::string const sourceDirectory =
mf.GetSafeDefinition("CTEST_SOURCE_DIRECTORY");
// Presets file is set according to the following priority order:
// 1) The PRESETS_FILE option to ctest_build()
// 2) CTEST_PRESETS_FILE script variable
std::string const rawPresetsFile = !args.PresetsFile.empty()
? args.PresetsFile
: mf.GetSafeDefinition("CTEST_PRESETS_FILE");
std::string const presetsFile = rawPresetsFile.empty()
? ""
: cmSystemTools::CollapseFullPath(rawPresetsFile, sourceDirectory);
std::string effectivePreset = !args.Preset.empty() ? args.Preset
: cmNonempty(mf.GetDefinition("CTEST_BUILD_PRESET"))
? *mf.GetDefinition("CTEST_BUILD_PRESET")
: "";
if (effectivePreset.empty()) {
cmValue v = mf.GetDefinition("CTEST_PRESET");
if (cmNonempty(v)) {
std::string presetError;
auto presetCheck =
BuildPresetExists(*v, sourceDirectory, presetsFile, presetError);
if (presetCheck == PresetCheckResult::ReadError) {
status.SetError(cmStrCat('\n', presetError));
return nullptr;
}
if (presetCheck == PresetCheckResult::Found) {
effectivePreset = *v;
} else {
cmCTestLog(this->CTest, WARNING,
"No build preset named \""
<< *v << "\" found, ignoring CTEST_PRESET." << std::endl);
}
}
}
// Skip checking CTEST_BUILD_COMMAND when a preset is specified.
// We do this to avoid using a stale MakeCommand from DartConfiguration.tcl
// that would cause us to silently ignore the requested preset.
cmValue ctestBuildCommand = mf.GetDefinition("CTEST_BUILD_COMMAND");
if (cmNonempty(ctestBuildCommand) && effectivePreset.empty()) {
this->CTest->SetCTestConfiguration("MakeCommand", *ctestBuildCommand,
args.Quiet);
} else if (!effectivePreset.empty()) {
if (cmNonempty(ctestBuildCommand)) {
cmCTestOptionalLog(this->CTest, HANDLER_VERBOSE_OUTPUT,
"Ignoring CTEST_BUILD_COMMAND because preset \""
<< effectivePreset << "\" is in use.\n",
args.Quiet);
}
cmCMakePresetsGraph presetsGraph;
if (!presetsGraph.ReadProjectPresets(sourceDirectory, presetsFile)) {
status.SetError(cmStrCat("\n Could not read presets from \"",
sourceDirectory, "\":\n ",
presetsGraph.parseState.GetErrorMessage()));
return nullptr;
}
auto resolveResult =
presetsGraph.ResolvePreset(effectivePreset, presetsGraph.BuildPresets);
auto resolveError = cmCMakePresetsGraph::FormatPresetError<BuildPreset>(
resolveResult.StatusCode, resolveResult.ErrorPresetName,
sourceDirectory);
if (resolveError) {
status.SetError(*resolveError);
return nullptr;
}
std::string buildCommand =
cmStrCat('"', cmSystemTools::GetCMakeCommand(), '"');
buildCommand += " --build . --preset \"";
buildCommand += effectivePreset;
buildCommand += "\"";
if (!presetsFile.empty()) {
buildCommand += " --presets-file \"";
buildCommand += presetsFile;
buildCommand += "\"";
}
if (!cmakeBuildConfiguration.empty()) {
buildCommand += " --config \"";
buildCommand += cmakeBuildConfiguration;
buildCommand += "\"";
}
if (!cmakeBuildTarget.empty()) {
buildCommand += " --target \"";
buildCommand += cmakeBuildTarget;
buildCommand += "\"";
}
if (!args.ParallelLevel.empty()) {
buildCommand += " --parallel ";
buildCommand += args.ParallelLevel;
}
if (!cmakeBuildAdditionalFlags.empty()) {
buildCommand += " -- ";
buildCommand += cmakeBuildAdditionalFlags;
}
cmCTestOptionalLog(this->CTest, HANDLER_VERBOSE_OUTPUT,
"SetMakeCommand:" << buildCommand << "\n", args.Quiet);
this->CTest->SetCTestConfiguration("MakeCommand", buildCommand,
args.Quiet);
} else {
cmValue cmakeGeneratorName = mf.GetDefinition("CTEST_CMAKE_GENERATOR");
if (cmNonempty(cmakeGeneratorName)) {
if (cmakeBuildConfiguration.empty()) {
cmakeBuildConfiguration = "Release";
}
auto globalGenerator =
mf.GetCMakeInstance()->CreateGlobalGenerator(*cmakeGeneratorName);
if (!globalGenerator) {
std::string e = cmStrCat("could not create generator named \"",
*cmakeGeneratorName, '"');
mf.IssueMessage(MessageType::FATAL_ERROR, e);
cmSystemTools::SetFatalErrorOccurred();
return nullptr;
}
if (cmakeBuildConfiguration.empty()) {
cmakeBuildConfiguration = "Debug";
}
std::string dir = this->CTest->GetCTestConfiguration("BuildDirectory");
std::string buildCommand = globalGenerator->GenerateCMakeBuildCommand(
cmakeBuildTarget, cmakeBuildConfiguration, args.ParallelLevel,
cmakeBuildAdditionalFlags, false);
cmCTestOptionalLog(this->CTest, HANDLER_VERBOSE_OUTPUT,
"SetMakeCommand:" << buildCommand << "\n",
args.Quiet);
this->CTest->SetCTestConfiguration("MakeCommand", buildCommand,
args.Quiet);
} else {
std::ostringstream ostr;
/* clang-format off */
ostr << "has no project to build. If this is a "
"\"built with CMake\" project, verify that CTEST_CMAKE_GENERATOR "
"is set. Otherwise, set CTEST_BUILD_COMMAND to build the project "
"with a custom command line.";
/* clang-format on */
status.SetError(ostr.str());
return nullptr;
}
}
if (cmValue useLaunchers = mf.GetDefinition("CTEST_USE_LAUNCHERS")) {
this->CTest->SetCTestConfiguration("UseLaunchers", *useLaunchers,
args.Quiet);
}
if (cmValue labelsForSubprojects =
mf.GetDefinition("CTEST_LABELS_FOR_SUBPROJECTS")) {
this->CTest->SetCTestConfiguration("LabelsForSubprojects",
*labelsForSubprojects, args.Quiet);
}
handler->SetQuiet(args.Quiet);
return std::unique_ptr<cmCTestGenericHandler>(std::move(handler));
}
void cmCTestBuildCommand::ProcessAdditionalValues(
cmCTestGenericHandler* generic, HandlerArguments const& arguments,
cmExecutionStatus& status) const
{
cmMakefile& mf = status.GetMakefile();
auto const& args = static_cast<BuildArguments const&>(arguments);
auto const* handler = static_cast<cmCTestBuildHandler*>(generic);
if (!args.NumberErrors.empty()) {
mf.AddDefinition(args.NumberErrors,
std::to_string(handler->GetTotalErrors()));
}
if (!args.NumberWarnings.empty()) {
mf.AddDefinition(args.NumberWarnings,
std::to_string(handler->GetTotalWarnings()));
}
}