cpp-rotor/include/rotor/system_context.h

#pragma once

//
// Copyright (c) 2019-2020 Ivan Baidakou (basiliscos) (the dot dmol at gmail dot com)
//
// Distributed under the MIT Software License
//

#include "address.hpp"
#include "supervisor_config.h"
#include "error_code.h"
#include <system_error>

namespace rotor {

struct supervisor_t;
using supervisor_ptr_t = intrusive_ptr_t<supervisor_t>;

/** \struct system_context_t
 *  \brief The system context holds root {@link supervisor_t}
 * (intrusive pointer) and may be loop-related details in derived classes
 *
 */
struct system_context_t : arc_base_t<system_context_t> {
  public:
    /** \brief returns builder for root supervisor */
    template <typename Supervisor = supervisor_t> auto create_supervisor();

    /** \brief returns root supervisor */
    inline supervisor_ptr_t get_supervisor() noexcept { return supervisor; }

    system_context_t();

    system_context_t(const system_context_t &) = delete;
    system_context_t(system_context_t &&) = delete;
    virtual ~system_context_t();

    /** \brief fatal error handler
     *
     * The error is fatal, is further `rotor` behavior is undefined. The method should
     * be overriden in derived classes for error propagation/notification. The default
     * implementation is to output the error to `std::err` and invoke `std::abort()`.
     *
     */
    virtual void on_error(const std::error_code &ec) noexcept;

  private:
    friend struct supervisor_t;
    supervisor_ptr_t supervisor;
};

/** \brief intrusive pointer for system context */
using system_context_ptr_t = intrusive_ptr_t<system_context_t>;

} // namespace rotor