manager.hpp

Go to the documentation of this file.

/*
   Copyright (C) 2014 - 2016 by Chris Beck <[email protected]>
   Part of the Battle for Wesnoth Project http://www.wesnoth.org/

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2 of the License, or
   (at your option) any later version.
   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY.

   See the COPYING file for more details.
*/

/**
 * Manages a collection of lua kernels containing plugin modules running
 * as coroutines, running in various engine contexts.
 */

#ifndef INCLUDED_PLUGINS_MANAGER_HPP_
#define INCLUDED_PLUGINS_MANAGER_HPP_

#include "config.hpp"
#include "utils/make_enum.hpp"

#include <boost/ptr_container/ptr_vector.hpp>
#include <boost/scoped_ptr.hpp>
#include <boost/shared_ptr.hpp>
#include <string>

struct plugin;

class plugins_context;
class lua_kernel_base;
class application_lua_kernel;

class plugins_manager {
public:
    plugins_manager(application_lua_kernel *);
    ~plugins_manager();

    static plugins_manager * get(); //this class is a singleton
    lua_kernel_base * get_kernel_base(); // just to mess around with lua console and debug stuff

    void play_slice(const plugins_context &);
    void notify_event(const std::string & name, const config & data);

    MAKE_ENUM( STATUS,
        (NONE,      "not created")
        (RUNNING,   "running")
        (STOPPED,   "stopped")
    )

    size_t size();

    STATUS get_status(size_t idx);
    std::string get_detailed_status(size_t idx);
    std::string get_name (size_t idx);

    bool any_running();

    size_t load_plugin(const std::string & name, const std::string & filename);     //throws exceptions in case of failure
    size_t add_plugin(const std::string & name, const std::string & prog);      //throws exceptions in case of failure

    void start_plugin(size_t idx);                          //throws exceptions in case of failure

    struct event {
        std::string name;
        config data;
    };

private:
    boost::ptr_vector<plugin> plugins_;
    boost::shared_ptr<bool> playing_;
    boost::scoped_ptr<application_lua_kernel> kernel_;
};

#endif