carbon-lang/toolchain/check/diagnostic_emitter.cpp

// Part of the Carbon Language project, under the Apache License v2.0 with LLVM
// Exceptions. See /LICENSE for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception

#include "toolchain/check/diagnostic_emitter.h"

#include <algorithm>
#include <optional>
#include <string>

#include "common/raw_string_ostream.h"
#include "toolchain/check/diagnostic_helpers.h"
#include "toolchain/sem_ir/absolute_node_id.h"
#include "toolchain/sem_ir/ids.h"
#include "toolchain/sem_ir/stringify.h"

namespace Carbon::Check {

auto DiagnosticEmitter::ConvertLoc(LocIdForDiagnostics loc_id,
                                   ContextFnT context_fn) const
    -> Diagnostics::ConvertedLoc {
  auto converted =
      ConvertLocImpl(loc_id.loc_id(), loc_id.is_token_only(), context_fn);

  // Use the token when possible, but -1 is the default value.
  auto last_offset = -1;
  if (last_token_.has_value()) {
    last_offset = sem_ir_->parse_tree().tokens().GetByteOffset(last_token_);
  }

  // When the diagnostic is in the same file, we use the last possible offset;
  // otherwise, we ignore the offset because it's probably in that file.
  if (converted.loc.filename == sem_ir_->filename()) {
    converted.last_byte_offset =
        std::max(converted.last_byte_offset, last_offset);
  } else {
    converted.last_byte_offset = last_offset;
  }

  return converted;
}

auto DiagnosticEmitter::ConvertLocImpl(SemIR::LocId loc_id, bool is_token_only,
                                       ContextFnT context_fn) const
    -> Diagnostics::ConvertedLoc {
  llvm::SmallVector<SemIR::AbsoluteNodeId> absolute_node_ids =
      SemIR::GetAbsoluteNodeId(sem_ir_, loc_id);

  auto final_node_id = absolute_node_ids.pop_back_val();
  for (const auto& absolute_node_id : absolute_node_ids) {
    if (!absolute_node_id.node_id().has_value()) {
      // TODO: Add an "In implicit import of prelude." note for the case where
      // we don't have a location.
      continue;
    }
    // TODO: Include the name of the imported library in the diagnostic.
    auto diag_loc =
        ConvertLocInFile(absolute_node_id, is_token_only, context_fn);
    AddInImport(diag_loc.loc, context_fn);
  }

  return ConvertLocInFile(final_node_id, is_token_only, context_fn);
}

auto DiagnosticEmitter::ConvertLocInFile(SemIR::AbsoluteNodeId absolute_node_id,
                                         bool token_only,
                                         ContextFnT context_fn) const
    -> Diagnostics::ConvertedLoc {
  if (absolute_node_id.check_ir_id() == SemIR::CheckIRId::Cpp) {
    // Special handling of Clang source locations.
    CARBON_CHECK(sem_ir_->import_cpps().size() > 0);
    // TODO: Use information on the specific C++ import extract from Clang error
    // message and propagated here instead of using first C++ import
    // arbitrarily.
    Parse::NodeId import_node_id =
        sem_ir_->import_cpps().values().begin()->node_id;
    AddInImport(ConvertLocInCarbonFile(sem_ir_->check_ir_id(), import_node_id,
                                       /*token_only=*/false)
                    .loc,
                context_fn);

    clang::SourceLocation clang_loc = sem_ir_->clang_source_locs().Get(
        absolute_node_id.clang_source_loc_id());

    CARBON_CHECK(sem_ir_->cpp_ast());
    clang::PresumedLoc presumed_loc =
        sem_ir_->cpp_ast()->getSourceManager().getPresumedLoc(clang_loc);

    return Diagnostics::ConvertedLoc{
        .loc = {.filename = presumed_loc.getFilename(),
                .line_number = static_cast<int32_t>(presumed_loc.getLine())},
        // TODO: Set `last_byte_offset` based on the `import Cpp` location.
        .last_byte_offset = 0};
  }

  return ConvertLocInCarbonFile(absolute_node_id.check_ir_id(),
                                absolute_node_id.node_id(), token_only);
}

auto DiagnosticEmitter::ConvertLocInCarbonFile(SemIR::CheckIRId check_ir_id,
                                               Parse::NodeId node_id,
                                               bool token_only) const
    -> Diagnostics::ConvertedLoc {
  CARBON_CHECK(check_ir_id != SemIR::CheckIRId::Cpp);
  const auto& tree_and_subtrees =
      tree_and_subtrees_getters_[check_ir_id.index]();
  return tree_and_subtrees.NodeToDiagnosticLoc(node_id, token_only);
}

auto DiagnosticEmitter::ConvertArg(llvm::Any arg) const -> llvm::Any {
  if (auto* library_name_id = llvm::any_cast<SemIR::LibraryNameId>(&arg)) {
    std::string library_name;
    if (*library_name_id == SemIR::LibraryNameId::Default) {
      library_name = "default library";
    } else if (!library_name_id->has_value()) {
      library_name = "library <none>";
    } else {
      RawStringOstream stream;
      stream << "library \""
             << sem_ir_->string_literal_values().Get(
                    library_name_id->AsStringLiteralValueId())
             << "\"";
      library_name = stream.TakeStr();
    }
    return library_name;
  }
  if (auto* name_id = llvm::any_cast<SemIR::NameId>(&arg)) {
    return sem_ir_->names().GetFormatted(*name_id).str();
  }
  if (auto* type_of_expr = llvm::any_cast<TypeOfInstId>(&arg)) {
    if (!type_of_expr->inst_id.has_value()) {
      return "<none>";
    }
    // TODO: Where possible, produce a better description of the type based on
    // the expression.
    return "`" +
           StringifyConstantInst(
               *sem_ir_,
               sem_ir_->types().GetInstId(
                   sem_ir_->insts().Get(type_of_expr->inst_id).type_id())) +
           "`";
  }
  if (auto* expr = llvm::any_cast<InstIdAsConstant>(&arg)) {
    return "`" + StringifyConstantInst(*sem_ir_, expr->inst_id) + "`";
  }
  if (auto* type_expr = llvm::any_cast<InstIdAsRawType>(&arg)) {
    return StringifyConstantInst(*sem_ir_, type_expr->inst_id);
  }
  if (auto* type = llvm::any_cast<TypeIdAsRawType>(&arg)) {
    return StringifyConstantInst(*sem_ir_,
                                 sem_ir_->types().GetInstId(type->type_id));
  }
  if (auto* type_id = llvm::any_cast<SemIR::TypeId>(&arg)) {
    return "`" +
           StringifyConstantInst(*sem_ir_,
                                 sem_ir_->types().GetInstId(*type_id)) +
           "`";
  }
  if (auto* specific_id = llvm::any_cast<SemIR::SpecificId>(&arg)) {
    return "`" + StringifySpecific(*sem_ir_, *specific_id) + "`";
  }
  if (auto* typed_int = llvm::any_cast<TypedInt>(&arg)) {
    return llvm::APSInt(typed_int->value,
                        !sem_ir_->types().IsSignedInt(typed_int->type));
  }
  if (auto* specific_interface_id =
          llvm::any_cast<SemIR::SpecificInterfaceId>(&arg)) {
    auto specific_interface =
        sem_ir_->specific_interfaces().Get(*specific_interface_id);
    return "`" + StringifySpecificInterface(*sem_ir_, specific_interface) + "`";
  }
  if (auto* specific_interface_raw =
          llvm::any_cast<SpecificInterfaceIdAsRawType>(&arg)) {
    auto specific_interface = sem_ir_->specific_interfaces().Get(
        specific_interface_raw->specific_interface_id);
    return StringifySpecificInterface(*sem_ir_, specific_interface);
  }
  return DiagnosticEmitterBase::ConvertArg(arg);
}

auto DiagnosticEmitter::AddInImport(Diagnostics::Loc loc, ContextFnT context_fn)
    -> void {
  CARBON_DIAGNOSTIC(InImport, LocationInfo, "in import");
  context_fn(loc, InImport);
}

}  // namespace Carbon::Check