Files
chatterino2/src/controllers/plugins/PluginController.hpp
T
NerixyzandGitHub 305149a795 refactor(plugins): Use signals to update UI (#7030)
The plugin UI manually updated itself whenever the user changed the
state by clicking a button (e.g. enabling a plugin). This gets more
complicated when other parts of Chatterino can also load/toggle plugins.
To help with this, I added a signal for the current list of plugins. The
UI also reacts to changes to the enabled plugins (a setting).

Reviewed-by: pajlada <rasmus.karlsson@pajlada.com>
2026-06-30 11:50:01 +00:00

104 lines
2.7 KiB
C++

// SPDX-FileCopyrightText: 2023 Contributors to Chatterino <https://chatterino.com>
//
// SPDX-License-Identifier: MIT
#pragma once
#ifdef CHATTERINO_HAVE_PLUGINS
# include "common/websockets/WebSocketPool.hpp"
# include "controllers/commands/CommandContext.hpp"
# include "controllers/plugins/Plugin.hpp"
# include <pajlada/signals/signal.hpp>
# include <QDir>
# include <QFileInfo>
# include <QJsonArray>
# include <QJsonObject>
# include <QString>
# include <sol/forward.hpp>
# include <map>
# include <memory>
# include <utility>
struct lua_State;
namespace chatterino {
class Settings;
class Paths;
class PluginController
{
const Paths &paths;
public:
explicit PluginController(const Paths &paths_);
void initialize(Settings &settings);
QString tryExecPluginCommand(const QString &commandName,
const CommandContext &ctx);
// NOTE: this pointer does not own the Plugin, unique_ptr still owns it
// This is required to be public because of c functions
Plugin *getPluginByStatePtr(lua_State *L);
// TODO: make a function that iterates plugins that aren't errored/enabled
const std::map<QString, std::unique_ptr<Plugin>> &plugins() const;
/**
* @brief Reload plugin given by id
*
* @param id This is the unique identifier of the plugin, the name of the directory it is in
*/
bool reload(const QString &id);
/**
* @brief Checks settings to tell if a plugin named by id is enabled.
*
* It is the callers responsibility to check Settings::pluginsEnabled
*/
static bool isPluginEnabled(const QString &id);
std::pair<bool, QStringList> updateCustomCompletions(
const QString &query, const QString &fullTextContent,
int cursorPosition, bool isFirstWord) const;
WebSocketPool &webSocketPool();
pajlada::Signals::Signal<Plugin *> onPluginLoaded;
pajlada::Signals::NoArgSignal onPluginsUpdated;
private:
void loadPlugins();
void load(const QFileInfo &index, const QDir &pluginDir,
const PluginMeta &meta);
// This function adds lua standard libraries into the state
void openLibrariesFor(Plugin *plugin);
void initSol(sol::state_view &lua, Plugin *plugin);
static void loadChatterinoLib(lua_State *l);
bool tryLoadFromDir(const QDir &pluginDir);
void queueChangeNotification();
std::map<QString, std::unique_ptr<Plugin>> plugins_;
WebSocketPool webSocketPool_;
std::vector<
std::pair<std::string, std::function<sol::object(sol::state_view)>>>
loaders_;
bool changeNotificationQueued = false;
// This is for tests, pay no attention
friend class PluginControllerAccess;
};
} // namespace chatterino
#endif