| /* Distributed under the OSI-approved BSD 3-Clause License. See accompanying |
| file Copyright.txt or https://cmake.org/licensing for details. */ |
| #include "cmAddCustomCommandCommand.h" |
| |
| #include <sstream> |
| #include <unordered_set> |
| |
| #include "cmCheckCustomOutputs.h" |
| #include "cmCustomCommand.h" |
| #include "cmCustomCommandLines.h" |
| #include "cmCustomCommandTypes.h" |
| #include "cmExecutionStatus.h" |
| #include "cmGlobalGenerator.h" |
| #include "cmMakefile.h" |
| #include "cmMessageType.h" |
| #include "cmPolicies.h" |
| #include "cmStringAlgorithms.h" |
| #include "cmSystemTools.h" |
| |
| bool cmAddCustomCommandCommand(std::vector<std::string> const& args, |
| cmExecutionStatus& status) |
| { |
| /* Let's complain at the end of this function about the lack of a particular |
| arg. For the moment, let's say that COMMAND, and either TARGET or SOURCE |
| are required. |
| */ |
| if (args.size() < 4) { |
| status.SetError("called with wrong number of arguments."); |
| return false; |
| } |
| |
| cmMakefile& mf = status.GetMakefile(); |
| std::string source; |
| std::string target; |
| std::string main_dependency; |
| std::string working; |
| std::string depfile; |
| std::string job_pool; |
| std::string comment_buffer; |
| const char* comment = nullptr; |
| std::vector<std::string> depends; |
| std::vector<std::string> outputs; |
| std::vector<std::string> output; |
| std::vector<std::string> byproducts; |
| bool verbatim = false; |
| bool append = false; |
| bool uses_terminal = false; |
| bool command_expand_lists = false; |
| std::string implicit_depends_lang; |
| cmImplicitDependsList implicit_depends; |
| |
| // Accumulate one command line at a time. |
| cmCustomCommandLine currentLine; |
| |
| // Save all command lines. |
| cmCustomCommandLines commandLines; |
| |
| cmCustomCommandType cctype = cmCustomCommandType::POST_BUILD; |
| |
| enum tdoing |
| { |
| doing_source, |
| doing_command, |
| doing_target, |
| doing_depends, |
| doing_implicit_depends_lang, |
| doing_implicit_depends_file, |
| doing_main_dependency, |
| doing_output, |
| doing_outputs, |
| doing_byproducts, |
| doing_comment, |
| doing_working_directory, |
| doing_depfile, |
| doing_job_pool, |
| doing_nothing |
| }; |
| |
| tdoing doing = doing_nothing; |
| |
| #define MAKE_STATIC_KEYWORD(KEYWORD) \ |
| static const std::string key##KEYWORD = #KEYWORD |
| MAKE_STATIC_KEYWORD(APPEND); |
| MAKE_STATIC_KEYWORD(ARGS); |
| MAKE_STATIC_KEYWORD(BYPRODUCTS); |
| MAKE_STATIC_KEYWORD(COMMAND); |
| MAKE_STATIC_KEYWORD(COMMAND_EXPAND_LISTS); |
| MAKE_STATIC_KEYWORD(COMMENT); |
| MAKE_STATIC_KEYWORD(DEPENDS); |
| MAKE_STATIC_KEYWORD(DEPFILE); |
| MAKE_STATIC_KEYWORD(IMPLICIT_DEPENDS); |
| MAKE_STATIC_KEYWORD(JOB_POOL); |
| MAKE_STATIC_KEYWORD(MAIN_DEPENDENCY); |
| MAKE_STATIC_KEYWORD(OUTPUT); |
| MAKE_STATIC_KEYWORD(OUTPUTS); |
| MAKE_STATIC_KEYWORD(POST_BUILD); |
| MAKE_STATIC_KEYWORD(PRE_BUILD); |
| MAKE_STATIC_KEYWORD(PRE_LINK); |
| MAKE_STATIC_KEYWORD(SOURCE); |
| MAKE_STATIC_KEYWORD(TARGET); |
| MAKE_STATIC_KEYWORD(USES_TERMINAL); |
| MAKE_STATIC_KEYWORD(VERBATIM); |
| MAKE_STATIC_KEYWORD(WORKING_DIRECTORY); |
| #undef MAKE_STATIC_KEYWORD |
| static std::unordered_set<std::string> const keywords{ |
| keyAPPEND, |
| keyARGS, |
| keyBYPRODUCTS, |
| keyCOMMAND, |
| keyCOMMAND_EXPAND_LISTS, |
| keyCOMMENT, |
| keyDEPENDS, |
| keyDEPFILE, |
| keyIMPLICIT_DEPENDS, |
| keyJOB_POOL, |
| keyMAIN_DEPENDENCY, |
| keyOUTPUT, |
| keyOUTPUTS, |
| keyPOST_BUILD, |
| keyPRE_BUILD, |
| keyPRE_LINK, |
| keySOURCE, |
| keyTARGET, |
| keyUSES_TERMINAL, |
| keyVERBATIM, |
| keyWORKING_DIRECTORY |
| }; |
| |
| for (std::string const& copy : args) { |
| if (keywords.count(copy)) { |
| if (copy == keySOURCE) { |
| doing = doing_source; |
| } else if (copy == keyCOMMAND) { |
| doing = doing_command; |
| |
| // Save the current command before starting the next command. |
| if (!currentLine.empty()) { |
| commandLines.push_back(currentLine); |
| currentLine.clear(); |
| } |
| } else if (copy == keyPRE_BUILD) { |
| cctype = cmCustomCommandType::PRE_BUILD; |
| } else if (copy == keyPRE_LINK) { |
| cctype = cmCustomCommandType::PRE_LINK; |
| } else if (copy == keyPOST_BUILD) { |
| cctype = cmCustomCommandType::POST_BUILD; |
| } else if (copy == keyVERBATIM) { |
| verbatim = true; |
| } else if (copy == keyAPPEND) { |
| append = true; |
| } else if (copy == keyUSES_TERMINAL) { |
| uses_terminal = true; |
| } else if (copy == keyCOMMAND_EXPAND_LISTS) { |
| command_expand_lists = true; |
| } else if (copy == keyTARGET) { |
| doing = doing_target; |
| } else if (copy == keyARGS) { |
| // Ignore this old keyword. |
| } else if (copy == keyDEPENDS) { |
| doing = doing_depends; |
| } else if (copy == keyOUTPUTS) { |
| doing = doing_outputs; |
| } else if (copy == keyOUTPUT) { |
| doing = doing_output; |
| } else if (copy == keyBYPRODUCTS) { |
| doing = doing_byproducts; |
| } else if (copy == keyWORKING_DIRECTORY) { |
| doing = doing_working_directory; |
| } else if (copy == keyMAIN_DEPENDENCY) { |
| doing = doing_main_dependency; |
| } else if (copy == keyIMPLICIT_DEPENDS) { |
| doing = doing_implicit_depends_lang; |
| } else if (copy == keyCOMMENT) { |
| doing = doing_comment; |
| } else if (copy == keyDEPFILE) { |
| doing = doing_depfile; |
| if (!mf.GetGlobalGenerator()->SupportsCustomCommandDepfile()) { |
| status.SetError("Option DEPFILE not supported by " + |
| mf.GetGlobalGenerator()->GetName()); |
| return false; |
| } |
| } else if (copy == keyJOB_POOL) { |
| doing = doing_job_pool; |
| } |
| } else { |
| std::string filename; |
| switch (doing) { |
| case doing_output: |
| case doing_outputs: |
| case doing_byproducts: |
| if (!cmSystemTools::FileIsFullPath(copy)) { |
| // This is an output to be generated, so it should be |
| // under the build tree. CMake 2.4 placed this under the |
| // source tree. However the only case that this change |
| // will break is when someone writes |
| // |
| // add_custom_command(OUTPUT out.txt ...) |
| // |
| // and later references "${CMAKE_CURRENT_SOURCE_DIR}/out.txt". |
| // This is fairly obscure so we can wait for someone to |
| // complain. |
| filename = cmStrCat(mf.GetCurrentBinaryDirectory(), '/'); |
| } |
| filename += copy; |
| cmSystemTools::ConvertToUnixSlashes(filename); |
| break; |
| case doing_source: |
| // We do not want to convert the argument to SOURCE because |
| // that option is only available for backward compatibility. |
| // Old-style use of this command may use the SOURCE==TARGET |
| // trick which we must preserve. If we convert the source |
| // to a full path then it will no longer equal the target. |
| default: |
| break; |
| } |
| |
| if (cmSystemTools::FileIsFullPath(filename)) { |
| filename = cmSystemTools::CollapseFullPath( |
| filename, status.GetMakefile().GetHomeOutputDirectory()); |
| } |
| switch (doing) { |
| case doing_depfile: |
| depfile = copy; |
| break; |
| case doing_job_pool: |
| job_pool = copy; |
| break; |
| case doing_working_directory: |
| working = copy; |
| break; |
| case doing_source: |
| source = copy; |
| break; |
| case doing_output: |
| output.push_back(filename); |
| break; |
| case doing_main_dependency: |
| main_dependency = copy; |
| break; |
| case doing_implicit_depends_lang: |
| implicit_depends_lang = copy; |
| doing = doing_implicit_depends_file; |
| break; |
| case doing_implicit_depends_file: { |
| // An implicit dependency starting point is also an |
| // explicit dependency. |
| std::string dep = copy; |
| // Upfront path conversion is correct because Genex |
| // are not supported. |
| cmSystemTools::ConvertToUnixSlashes(dep); |
| depends.push_back(dep); |
| |
| // Add the implicit dependency language and file. |
| implicit_depends.emplace_back(implicit_depends_lang, dep); |
| |
| // Switch back to looking for a language. |
| doing = doing_implicit_depends_lang; |
| } break; |
| case doing_command: |
| currentLine.push_back(copy); |
| break; |
| case doing_target: |
| target = copy; |
| break; |
| case doing_depends: |
| depends.push_back(copy); |
| break; |
| case doing_outputs: |
| outputs.push_back(filename); |
| break; |
| case doing_byproducts: |
| byproducts.push_back(filename); |
| break; |
| case doing_comment: |
| comment_buffer = copy; |
| comment = comment_buffer.c_str(); |
| break; |
| default: |
| status.SetError("Wrong syntax. Unknown type of argument."); |
| return false; |
| } |
| } |
| } |
| |
| // Store the last command line finished. |
| if (!currentLine.empty()) { |
| commandLines.push_back(currentLine); |
| currentLine.clear(); |
| } |
| |
| // At this point we could complain about the lack of arguments. For |
| // the moment, let's say that COMMAND, TARGET are always required. |
| if (output.empty() && target.empty()) { |
| status.SetError("Wrong syntax. A TARGET or OUTPUT must be specified."); |
| return false; |
| } |
| |
| if (source.empty() && !target.empty() && !output.empty()) { |
| status.SetError( |
| "Wrong syntax. A TARGET and OUTPUT can not both be specified."); |
| return false; |
| } |
| if (append && output.empty()) { |
| status.SetError("given APPEND option with no OUTPUT."); |
| return false; |
| } |
| |
| // Make sure the output names and locations are safe. |
| if (!cmCheckCustomOutputs(output, "OUTPUT", status) || |
| !cmCheckCustomOutputs(outputs, "OUTPUTS", status) || |
| !cmCheckCustomOutputs(byproducts, "BYPRODUCTS", status)) { |
| return false; |
| } |
| |
| // Check for an append request. |
| if (append) { |
| if (mf.AppendCustomCommandToOutput(output[0], depends, implicit_depends, |
| commandLines)) { |
| return true; |
| } |
| |
| // No command for this output exists. |
| status.SetError( |
| cmStrCat("given APPEND option with output\n ", output[0], |
| "\nwhich is not already a custom command output.")); |
| return false; |
| } |
| |
| if (uses_terminal && !job_pool.empty()) { |
| status.SetError("JOB_POOL is shadowed by USES_TERMINAL."); |
| return false; |
| } |
| |
| // Choose which mode of the command to use. |
| bool escapeOldStyle = !verbatim; |
| if (source.empty() && output.empty()) { |
| // Source is empty, use the target. |
| std::vector<std::string> no_depends; |
| mf.AddCustomCommandToTarget(target, byproducts, no_depends, commandLines, |
| cctype, comment, working.c_str(), |
| escapeOldStyle, uses_terminal, depfile, |
| job_pool, command_expand_lists); |
| } else if (target.empty()) { |
| // Target is empty, use the output. |
| mf.AddCustomCommandToOutput( |
| output, byproducts, depends, main_dependency, implicit_depends, |
| commandLines, comment, working.c_str(), nullptr, false, escapeOldStyle, |
| uses_terminal, command_expand_lists, depfile, job_pool); |
| } else if (!byproducts.empty()) { |
| status.SetError("BYPRODUCTS may not be specified with SOURCE signatures"); |
| return false; |
| } else if (uses_terminal) { |
| status.SetError("USES_TERMINAL may not be used with SOURCE signatures"); |
| return false; |
| } else { |
| bool issueMessage = true; |
| std::ostringstream e; |
| MessageType messageType = MessageType::AUTHOR_WARNING; |
| switch (mf.GetPolicyStatus(cmPolicies::CMP0050)) { |
| case cmPolicies::WARN: |
| e << cmPolicies::GetPolicyWarning(cmPolicies::CMP0050) << "\n"; |
| break; |
| case cmPolicies::OLD: |
| issueMessage = false; |
| break; |
| case cmPolicies::REQUIRED_ALWAYS: |
| case cmPolicies::REQUIRED_IF_USED: |
| case cmPolicies::NEW: |
| messageType = MessageType::FATAL_ERROR; |
| break; |
| } |
| |
| if (issueMessage) { |
| e << "The SOURCE signatures of add_custom_command are no longer " |
| "supported."; |
| mf.IssueMessage(messageType, e.str()); |
| if (messageType == MessageType::FATAL_ERROR) { |
| return false; |
| } |
| } |
| |
| // Use the old-style mode for backward compatibility. |
| mf.AddCustomCommandOldStyle(target, outputs, depends, source, commandLines, |
| comment); |
| } |
| |
| return true; |
| } |