mirror of
https://github.com/reactos/CMake.git
synced 2024-11-27 05:20:34 +00:00
bc877a7e94
Adds a flag to indicate that pipe output from a custom command should be interpreted as UTF-8 encoded. This change does not introduce a public way to set the flag, but generators that create internally-generated commands know if they are calling cmake, which uses UTF-8 pipes. MSBuild added support for interpreting output of PreBuildEvent, PreLinkEvent, PostBuildEvent, and CustomBuildStep as UTF-8. This change will appear in Visual Studio 16.6 Preview 3. It is opt-in, and you need to add the StdOutEncoding tag. MSBuild treats these as property bags so if we emit the tag for earlier versions of Visual Studio it would be safely ignored. This change emits the StdOutEncoding tag and sets it to UTF-8 whenever the custom command UTF-8 pipe flag is set. This fixes globalization issues when the output from cmake contained characters that required MSBuild to interpret as UTF-8 before displaying them.
119 lines
3.7 KiB
C++
119 lines
3.7 KiB
C++
/* Distributed under the OSI-approved BSD 3-Clause License. See accompanying
|
|
file Copyright.txt or https://cmake.org/licensing for details. */
|
|
#ifndef cmCustomCommand_h
|
|
#define cmCustomCommand_h
|
|
|
|
#include "cmConfigure.h" // IWYU pragma: keep
|
|
|
|
#include <string>
|
|
#include <utility>
|
|
#include <vector>
|
|
|
|
#include "cmCustomCommandLines.h"
|
|
#include "cmListFileCache.h"
|
|
|
|
class cmImplicitDependsList
|
|
: public std::vector<std::pair<std::string, std::string>>
|
|
{
|
|
};
|
|
|
|
/** \class cmCustomCommand
|
|
* \brief A class to encapsulate a custom command
|
|
*
|
|
* cmCustomCommand encapsulates the properties of a custom command
|
|
*/
|
|
class cmCustomCommand
|
|
{
|
|
public:
|
|
/** Main constructor specifies all information for the command. */
|
|
cmCustomCommand(std::vector<std::string> outputs,
|
|
std::vector<std::string> byproducts,
|
|
std::vector<std::string> depends,
|
|
cmCustomCommandLines commandLines, cmListFileBacktrace lfbt,
|
|
const char* comment, const char* workingDirectory,
|
|
bool stdPipesUTF8);
|
|
|
|
/** Get the output file produced by the command. */
|
|
const std::vector<std::string>& GetOutputs() const;
|
|
|
|
/** Get the extra files produced by the command. */
|
|
const std::vector<std::string>& GetByproducts() const;
|
|
|
|
/** Get the vector that holds the list of dependencies. */
|
|
const std::vector<std::string>& GetDepends() const;
|
|
|
|
/** Get the working directory. */
|
|
std::string const& GetWorkingDirectory() const
|
|
{
|
|
return this->WorkingDirectory;
|
|
}
|
|
|
|
/** Get the list of command lines. */
|
|
const cmCustomCommandLines& GetCommandLines() const;
|
|
|
|
/** Get the comment string for the command. */
|
|
const char* GetComment() const;
|
|
|
|
/** Get a value indicating if the command uses UTF-8 output pipes. */
|
|
bool GetStdPipesUTF8() const { return this->StdPipesUTF8; }
|
|
|
|
/** Append to the list of command lines. */
|
|
void AppendCommands(const cmCustomCommandLines& commandLines);
|
|
|
|
/** Append to the list of dependencies. */
|
|
void AppendDepends(const std::vector<std::string>& depends);
|
|
|
|
/** Set/Get whether old-style escaping should be used. */
|
|
bool GetEscapeOldStyle() const;
|
|
void SetEscapeOldStyle(bool b);
|
|
|
|
/** Set/Get whether the build tool can replace variables in
|
|
arguments to the command. */
|
|
bool GetEscapeAllowMakeVars() const;
|
|
void SetEscapeAllowMakeVars(bool b);
|
|
|
|
/** Backtrace of the command that created this custom command. */
|
|
cmListFileBacktrace const& GetBacktrace() const;
|
|
|
|
void SetImplicitDepends(cmImplicitDependsList const&);
|
|
void AppendImplicitDepends(cmImplicitDependsList const&);
|
|
cmImplicitDependsList const& GetImplicitDepends() const;
|
|
|
|
/** Set/Get whether this custom command should be given access to the
|
|
real console (if possible). */
|
|
bool GetUsesTerminal() const;
|
|
void SetUsesTerminal(bool b);
|
|
|
|
/** Set/Get whether lists in command lines should be expanded. */
|
|
bool GetCommandExpandLists() const;
|
|
void SetCommandExpandLists(bool b);
|
|
|
|
/** Set/Get the depfile (used by the Ninja generator) */
|
|
const std::string& GetDepfile() const;
|
|
void SetDepfile(const std::string& depfile);
|
|
|
|
/** Set/Get the job_pool (used by the Ninja generator) */
|
|
const std::string& GetJobPool() const;
|
|
void SetJobPool(const std::string& job_pool);
|
|
|
|
private:
|
|
std::vector<std::string> Outputs;
|
|
std::vector<std::string> Byproducts;
|
|
std::vector<std::string> Depends;
|
|
cmCustomCommandLines CommandLines;
|
|
cmListFileBacktrace Backtrace;
|
|
cmImplicitDependsList ImplicitDepends;
|
|
std::string Comment;
|
|
std::string WorkingDirectory;
|
|
std::string Depfile;
|
|
std::string JobPool;
|
|
bool HaveComment = false;
|
|
bool EscapeAllowMakeVars = false;
|
|
bool EscapeOldStyle = true;
|
|
bool UsesTerminal = false;
|
|
bool CommandExpandLists = false;
|
|
bool StdPipesUTF8 = false;
|
|
};
|
|
|
|
#endif
|