BranchManager.hxx

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

 
#pragma once
 
#include "../../services/ISubject.hxx"
 
#include <string>
#include <utility>
#include <vector>
#include <memory>
#include <unordered_map>

 */
namespace svcs::core {
 
using namespace svcs::services;

 * @english
 * @class BranchManager
 * @brief Core service for managing version control branches (creation, deletion, switching).
 * @details This class abstracts the details of branch storage and provides a
 * high-level interface for branch manipulation. It uses an internal map to
 * track branches and communicates status/errors via the ISubject event bus.
 *
 * @russian
 * @class BranchManager
 * @brief Основной сервис для управления ветвями системы контроля версий (создание, удаление, переключение).
 * @details Этот класс абстрагирует детали хранения ветвей и предоставляет высокоуровневый
 * интерфейс для манипулирования ветвями. Он использует внутреннюю карту для отслеживания ветвей
 * и передает статус/ошибки через шину событий ISubject.
 *
 * @ingroup Core
 */
class BranchManager {
public:
    struct Branch {


        std::string name;

        std::string head_commit;

        bool is_current;

        Branch() : name(""), head_commit(""), is_current(false) {}

        Branch(std::string  name, std::string  head_commit, bool is_current = false)
            : name(std::move(name)), head_commit(std::move(head_commit)), is_current(is_current) {}
    };

    explicit BranchManager(std::shared_ptr<ISubject> event_bus);

    void createDefaultBranches();
 
    // --- Public Branch Operations / Публичные операции с ветвями ---

    bool createBranch(const std::string& name);

    bool createBranchFromCommit(const std::string& name, const std::string& commit_hash);

    std::string getHeadCommit();

    bool deleteBranch(const std::string& name, bool force = false);

    bool renameBranch(const std::string& old_name, const std::string& new_name);

    bool switchBranch(const std::string& name);
 
    // --- Public Branch Queries / Публичные запросы о ветвях ---

    std::vector<Branch> getAllBranches() const;

    std::string getCurrentBranch() const;

    bool updateBranchHead(const std::string& branch_name, const std::string& commit_hash);

    bool branchExists(const std::string& name) const;


    std::string getBranchHead(const std::string& branch_name) const;
 
    // --- Public Utility Methods / Публичные служебные методы ---

    static bool isValidBranchName(const std::string& name);

    static bool commitExists(const std::string& commit_hash);
 
private:
    // --- Private Persistence Methods / Приватные методы сохранения состояния ---

    void loadBranches();

    void saveBranches();

    static void saveBranchToFile(const std::string &branch_name, const std::string &commit_hash);

    static void deleteBranchFile(const std::string &branch_name);

    void loadCurrentBranch();

    bool saveCurrentBranch() const;
 
    // --- Private File System Abstraction Methods / Приватные методы абстракции файловой системы ---

    static std::string readFile(const std::string& path);

    static void writeFile(const std::string& path, const std::string& content);

    static bool fileExists(const std::string& path);

    static void createDirectory(const std::string& path);
 
    // --- Private Path Generation Methods / Приватные методы генерации путей ---

    static std::string getBranchesFilePath();

    static std::string getHeadFilePath();

    static std::string getBranchesDirectory();

    std::unordered_map<std::string, Branch> branches;

    std::string current_branch;

    std::shared_ptr<ISubject> event_bus;
};
 
}