Diagnostics.hpp

Go to the documentation of this file.

/**
 * @file Diagnostics.hpp
 * @author Lexy Plateau (lexplt.dev@gmail.com)
 * @brief Tools to report code errors nicely to the user
 * @date 2025-08-16
 *
 * @copyright Copyright (c) 2025-2026
 *
 */
 
#ifndef ARK_ERROR_DIAGNOSTICS_HPP
#define ARK_ERROR_DIAGNOSTICS_HPP
 
#include <string>
#include <optional>
#include <iostream>
 
#include <Ark/Utils/Platform.hpp>
#include <Ark/Utils/Position.hpp>
#include <Ark/Error/Exceptions.hpp>
 
namespace Ark::Diagnostics
{
    struct ErrorLocation
    {
        std::string filename;  ///< Complete path to the file where the error is
        internal::FilePos start;
        std::optional<internal::FilePos> end;
        std::optional<std::string> maybe_content;
 
        [[nodiscard]] bool wholeLineIsError() const
        {
            return !end.has_value();
        }
 
        [[nodiscard]] std::optional<decltype(internal::FilePos::line)> maybeEndLine() const noexcept
        {
            if (end)
                return end->line;
            return std::nullopt;
        }
    };
 
    /**
     * @brief Helper to create a colorized context to report errors to the user
     *
     * @param loc error location
     * @param os stream in which the error will be written
     * @param maybe_context optional context, parent of the error
     * @param colorize generate colors or not
     */
    ARK_API void makeContext(
        const ErrorLocation& loc,
        std::ostream& os,
        const std::optional<CodeErrorContext>& maybe_context,
        bool colorize);
 
    /**
     * @brief Helper used by the compiler to generate a colorized context from a node
     *
     * @param message error message to be included in the context
     * @param node AST node with the error
     * @param colorize toggle context colors (default: true)
     * @return std::string
     */
    std::string makeContextWithNode(const std::string& message, const internal::Node& node, bool colorize = true);
 
    ARK_API void generateWithCode(const CodeError& e, const std::string& code, std::ostream& os = std::cerr, bool colorize = true);
 
    /**
     * @brief Generate a diagnostic from an error and print it to the standard error output
     *
     * @param e code error
     * @param os output stream
     * @param colorize generate colors or not
     */
    ARK_API void generate(const CodeError& e, std::ostream& os = std::cerr, bool colorize = true);
}
 
#endif  // ARK_ERROR_DIAGNOSTICS_HPP