MockHelpService.hxx

См. документацию.

#pragma once
 
#include <string>
#include <vector>
#include <map>
#include <set>
#include <functional>
#include <memory>
#include "MockSubject.hxx"
#include "../../../services/Event.hxx"

 * @details Содержит mock реализации CLI-интерфейсов, используемых
 * для тестирования поведения команд, систем справки и взаимодействий с пользователем.
 * Эти моки предоставляют контролируемые ответы команд и возможности
 * верификации для модульных тестов CLI команд.
 */
namespace svcs::test::cli::mocks {
 
using svcs::services::Event;

class MockHelpService {
private:
     * @brief Storage for the list of available commands to be returned by the mock.
     *
     * @russian
     * @brief Хранилище для списка доступных команд, возвращаемых mock'ом.
     */
    std::vector<std::string> availableCommands_;

     *
     * @russian
     * @brief Хранилище для предварительно настроенных описаний команд.
     */
    std::map<std::string, std::string> commandDescriptions_;

     *
     * @russian
     * @brief Записывает имена команд, для которых была запрошена справка через showCommandHelp.
     */
    std::set<std::string> calledCommandHelp_;


    std::shared_ptr<MockSubject> mockEventBus_;

    bool wasGeneralHelpCalled_ = false;
 
public:
     *
     * @russian
     * @brief Конструктор для MockHelpService.
     * @param mockEventBus Общий указатель на MockSubject, используемый для уведомлений.
     */
    explicit MockHelpService(const std::shared_ptr<MockSubject>& mockEventBus)
        : mockEventBus_(mockEventBus) {
    }
 
    // --- Mock Methods Matching HelpService Interface ---


     * @return Вектор имен команд.
     */
    [[nodiscard]] std::vector<std::string> getAvailableCommands() const {
        return availableCommands_;
    }

     * @param commandName The name of the command.
     * @return The configured description, or "No description available" if not set.
     *
     * @russian
     * @brief Возвращает предварительно настроенное описание для заданной команды.
     * @param commandName Имя команды.
     * @return Настроенное описание или "No description available", если не установлено.
     */
    [[nodiscard]] std::string getCommandDescription(const std::string& commandName) const {
        auto it = commandDescriptions_.find(commandName);
        if (it != commandDescriptions_.end()) {
            return it->second;
        }
        return "No description available";
    }

     * @english
     * @brief Records that help was requested for the given command.
     * @details Also emits a debug message to the mock event bus.
     * @param commandName The name of the command whose help is requested.
     *
     * @russian
     * @brief Записывает, что справка была запрошена для заданной команды.
     * @details Также отправляет отладочное сообщение в mock шину событий.
     * @param commandName Имя команды, для которой запрашивается справка.
     */
    void showCommandHelp(const std::string& commandName) {
        calledCommandHelp_.insert(commandName);
        if (mockEventBus_) {
            // Создаем объект Event правильно - используем поле details
            Event event;
            event.type = Event::DEBUG_MESSAGE;
            event.details = "MockHelpService: Showing help for " + commandName;
            event.source_name = "help";
            mockEventBus_->notify(event);
        }
    }

    void showGeneralHelp() {
        wasGeneralHelpCalled_ = true;
        if (mockEventBus_) {
            // Создаем объект Event правильно - используем поле details
            Event event;
            event.type = Event::DEBUG_MESSAGE;
            event.details = "MockHelpService: Showing general help";
            event.source_name = "help";
            mockEventBus_->notify(event);
        }
    }
 
    // --- Test Control Methods ---

    void setAvailableCommands(const std::vector<std::string>& commands) {
        availableCommands_ = commands;
    }

    void setCommandDescription(const std::string& commandName, const std::string& description) {
        commandDescriptions_[commandName] = description;
    }

    [[nodiscard]] bool wasCommandHelpCalled(const std::string& commandName) const {
        return calledCommandHelp_.find(commandName) != calledCommandHelp_.end();
    }

    [[nodiscard]] bool wasGeneralHelpCalled() const {
        return wasGeneralHelpCalled_;
    }

    void clear() {
        calledCommandHelp_.clear();
        availableCommands_.clear();
        commandDescriptions_.clear();
        wasGeneralHelpCalled_ = false;
    }
};
 
} // namespace svcs::test::cli::mocks