Jupiter-Bot/Bot/IRC_Bot.h

/**
 * Copyright (C) 2013-2014 Justin James.
 *
 * This license must be preserved.
 * Any applications, libraries, or code which make any use of any
 * component of this program must not be commercial, unless explicit
 * permission is granted from the original author. The use of this
 * program for non-profit purposes is permitted.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 *
 * In the event that this license restricts you from making desired use of this program, contact the original author.
 * Written by Justin James <justin.aj@hotmail.com>
 */

#if !defined _IRC_BOT_H_HEADER
#define _IRC_BOT_H_HEADER

/**
 * @file IRC_Bot.h
 * @brief Provides extendable bot-like interfacing with the IRC client.
 */

#include "Jupiter_Bot.h"
#include "Jupiter/IRC_Client.h"
#include "Jupiter/ArrayList.h"
#include "Jupiter/Rehash.h"
#include "Jupiter/String.h"

/** Forward Declaration */
class IRCCommand;

/** DLL Linkage Nagging */
#if defined _MSC_VER
#pragma warning(push)
#pragma warning(disable: 4251)
#endif

/**
* @brief Provies extendable bot-like interfacing with the IRC client.
*/
class JUPITER_BOT_API IRC_Bot : public Jupiter::IRC::Client, public Jupiter::Rehashable
{
public:

	/**
	* @brief Pulls the configured access levels from the config and applies them.
	*/
	void setCommandAccessLevels();

	/**
	* @brief Adds a command to the command list.
	*/
	void addCommand(IRCCommand *cmd);

	/**
	* @brief Removes a command from the command list.
	*
	* @param trigger Trigger of the command to remove
	* @return True if a command is removed, false otherwise.
	*/
	bool freeCommand(const Jupiter::ReadableString &trigger);

	/**
	* @brief Gets the index of a command.
	*
	* @param trigger Trigger of the command to find.
	* @return Index of the first match for the trigger if found, -1 otherwise.
	*/
	int getCommandIndex(const Jupiter::ReadableString &trigger) const;

	/**
	* @return Gets a command.
	*
	* @param trigger Trigger of the command to find.
	* @return First command using the specified trigger, nullptr otherwise.
	*/
	IRCCommand *getCommand(const Jupiter::ReadableString &trigger) const;

	/**
	* @brief Creates and returns an ArrayList of IRC Commands with a specified access level.
	*
	* @param chan Channel which access levels are set.
	* @param access Access level to match.
	* @return An ArrayList containing pointers to all of the matching commands.
	*/
	Jupiter::ArrayList<IRCCommand> getAccessCommands(Jupiter::IRC::Client::Channel *chan, int access);

	/**
	* @brief Gets the triggers of all the commands in an ArrayList, and adds them to a space-deliminated string.
	*
	* @param cmds Commands to construct the string with.
	* @return A string containing the triggers of the commands in a space-deliminated list.
	*/
	static Jupiter::StringL getTriggers(Jupiter::ArrayList<IRCCommand> cmds);

	/**
	* @brief Reloads some settings.
	*
	* @return 0 on success, 1 otherwise.
	*/
	int OnRehash();

	/** Constructor for IRC_Bot */
	IRC_Bot(const Jupiter::ReadableString &configSection);

	/** Destructor for IRC_Bot */
	~IRC_Bot();

	/** Overloaded events from Jupiter::IRC::Client */
protected:

	void OnChat(const Jupiter::ReadableString &channel, const Jupiter::ReadableString &nick, const Jupiter::ReadableString &message);

	/** Private members for internal usage */
private:
	Jupiter::ArrayList<IRCCommand> commands;
	Jupiter::StringS commandPrefix;
};

/** Re-enable warnings */
#if defined _MSC_VER
#pragma warning(pop)
#endif

#endif // _IRC_BOT_H_HEADER