//===-- CommandReturnObject.cpp -------------------------------------------===// // // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. // See https://llvm.org/LICENSE.txt for license information. // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception // //===----------------------------------------------------------------------===// #include "lldb/Interpreter/CommandReturnObject.h" #include "lldb/Utility/DiagnosticsRendering.h" #include "lldb/Utility/Status.h" #include "lldb/Utility/StreamString.h" using namespace lldb; using namespace lldb_private; static llvm::raw_ostream &error(Stream &strm) { return llvm::WithColor(strm.AsRawOstream(), llvm::HighlightColor::Error, llvm::ColorMode::Enable) << "error: "; } static llvm::raw_ostream &warning(Stream &strm) { return llvm::WithColor(strm.AsRawOstream(), llvm::HighlightColor::Warning, llvm::ColorMode::Enable) << "warning: "; } static void DumpStringToStreamWithNewline(Stream &strm, const std::string &s) { bool add_newline = false; if (!s.empty()) { // We already checked for empty above, now make sure there is a newline in // the error, and if there isn't one, add one. strm.Write(s.c_str(), s.size()); const char last_char = *s.rbegin(); add_newline = last_char != '\n' && last_char != '\r'; } if (add_newline) strm.EOL(); } CommandReturnObject::CommandReturnObject(bool colors) : m_out_stream(colors), m_err_stream(colors), m_colors(colors) {} void CommandReturnObject::AppendErrorWithFormat(const char *format, ...) { SetStatus(eReturnStatusFailed); if (!format) return; va_list args; va_start(args, format); StreamString sstrm; sstrm.PrintfVarArg(format, args); va_end(args); const std::string &s = std::string(sstrm.GetString()); if (!s.empty()) { error(GetErrorStream()); DumpStringToStreamWithNewline(GetErrorStream(), s); } } void CommandReturnObject::AppendMessageWithFormat(const char *format, ...) { if (!format) return; va_list args; va_start(args, format); StreamString sstrm; sstrm.PrintfVarArg(format, args); va_end(args); GetOutputStream() << sstrm.GetString(); } void CommandReturnObject::AppendWarningWithFormat(const char *format, ...) { if (!format) return; va_list args; va_start(args, format); StreamString sstrm; sstrm.PrintfVarArg(format, args); va_end(args); warning(GetErrorStream()) << sstrm.GetString(); } void CommandReturnObject::AppendMessage(llvm::StringRef in_string) { if (in_string.empty()) return; GetOutputStream() << in_string.rtrim() << '\n'; } void CommandReturnObject::AppendWarning(llvm::StringRef in_string) { if (in_string.empty()) return; warning(GetErrorStream()) << in_string.rtrim() << '\n'; } void CommandReturnObject::AppendError(llvm::StringRef in_string) { SetStatus(eReturnStatusFailed); if (in_string.empty()) return; // Workaround to deal with already fully formatted compiler diagnostics. llvm::StringRef msg(in_string.rtrim()); msg.consume_front("error: "); error(GetErrorStream()) << msg << '\n'; } void CommandReturnObject::SetError(Status error) { SetError(error.takeError()); } void CommandReturnObject::SetError(llvm::Error error) { // Retrieve any diagnostics. error = llvm::handleErrors(std::move(error), [&](DiagnosticError &error) { SetStatus(eReturnStatusFailed); m_diagnostics = error.GetDetails(); }); if (error) { AppendError(llvm::toString(std::move(error))); } } std::string CommandReturnObject::GetInlineDiagnosticString(unsigned indent) { StreamString diag_stream(m_colors); RenderDiagnosticDetails(diag_stream, indent, true, m_diagnostics); // Duplex the diagnostics to the secondary stream (but not inlined). if (auto stream_sp = m_err_stream.GetStreamAtIndex(eImmediateStreamIndex)) RenderDiagnosticDetails(*stream_sp, std::nullopt, false, m_diagnostics); return diag_stream.GetString().str(); } std::string CommandReturnObject::GetErrorString(bool with_diagnostics) { StreamString stream(m_colors); if (with_diagnostics) RenderDiagnosticDetails(stream, std::nullopt, false, m_diagnostics); lldb::StreamSP stream_sp(m_err_stream.GetStreamAtIndex(eStreamStringIndex)); if (stream_sp) stream << std::static_pointer_cast(stream_sp)->GetString(); return stream.GetString().str(); } StructuredData::ObjectSP CommandReturnObject::GetErrorData() { auto make_array = []() { return std::make_unique(); }; auto make_bool = [](bool b) { return std::make_unique(b); }; auto make_dict = []() { return std::make_unique(); }; auto make_int = [](unsigned i) { return std::make_unique(i); }; auto make_string = [](llvm::StringRef s) { return std::make_unique(s); }; auto dict_up = make_dict(); dict_up->AddItem("version", make_int(1)); auto array_up = make_array(); for (const DiagnosticDetail &diag : m_diagnostics) { auto detail_up = make_dict(); if (auto &sloc = diag.source_location) { auto sloc_up = make_dict(); sloc_up->AddItem("file", make_string(sloc->file.GetPath())); sloc_up->AddItem("line", make_int(sloc->line)); sloc_up->AddItem("length", make_int(sloc->length)); sloc_up->AddItem("hidden", make_bool(sloc->hidden)); sloc_up->AddItem("in_user_input", make_bool(sloc->in_user_input)); detail_up->AddItem("source_location", std::move(sloc_up)); } llvm::StringRef severity = "unknown"; switch (diag.severity) { case lldb::eSeverityError: severity = "error"; break; case lldb::eSeverityWarning: severity = "warning"; break; case lldb::eSeverityInfo: severity = "note"; break; } detail_up->AddItem("severity", make_string(severity)); detail_up->AddItem("message", make_string(diag.message)); detail_up->AddItem("rendered", make_string(diag.rendered)); array_up->AddItem(std::move(detail_up)); } dict_up->AddItem("details", std::move(array_up)); if (auto stream_sp = m_err_stream.GetStreamAtIndex(eStreamStringIndex)) { auto text = std::static_pointer_cast(stream_sp)->GetString(); if (!text.empty()) dict_up->AddItem("text", make_string(text)); } return dict_up; } // Similar to AppendError, but do not prepend 'Status: ' to message, and don't // append "\n" to the end of it. void CommandReturnObject::AppendRawError(llvm::StringRef in_string) { SetStatus(eReturnStatusFailed); assert(!in_string.empty() && "Expected a non-empty error message"); GetErrorStream() << in_string; } void CommandReturnObject::SetStatus(ReturnStatus status) { m_status = status; } ReturnStatus CommandReturnObject::GetStatus() const { return m_status; } bool CommandReturnObject::Succeeded() const { return m_status <= eReturnStatusSuccessContinuingResult; } bool CommandReturnObject::HasResult() const { return (m_status == eReturnStatusSuccessFinishResult || m_status == eReturnStatusSuccessContinuingResult); } void CommandReturnObject::Clear() { lldb::StreamSP stream_sp; stream_sp = m_out_stream.GetStreamAtIndex(eStreamStringIndex); if (stream_sp) static_cast(stream_sp.get())->Clear(); stream_sp = m_err_stream.GetStreamAtIndex(eStreamStringIndex); if (stream_sp) static_cast(stream_sp.get())->Clear(); m_diagnostics.clear(); m_status = eReturnStatusStarted; m_did_change_process_state = false; m_suppress_immediate_output = false; m_interactive = true; } bool CommandReturnObject::GetDidChangeProcessState() const { return m_did_change_process_state; } void CommandReturnObject::SetDidChangeProcessState(bool b) { m_did_change_process_state = b; } bool CommandReturnObject::GetInteractive() const { return m_interactive; } void CommandReturnObject::SetInteractive(bool b) { m_interactive = b; } bool CommandReturnObject::GetSuppressImmediateOutput() const { return m_suppress_immediate_output; } void CommandReturnObject::SetSuppressImmediateOutput(bool b) { m_suppress_immediate_output = b; }