106 lines
3.8 KiB
C#
106 lines
3.8 KiB
C#
using Discord.WebSocket;
|
|
using Newtonsoft.Json.Linq;
|
|
using System;
|
|
using System.Linq;
|
|
using System.Threading.Tasks;
|
|
|
|
namespace Noikoio.RegexBot
|
|
{
|
|
/// <summary>
|
|
/// Base class for bot modules
|
|
/// </summary>
|
|
abstract class BotModule
|
|
{
|
|
private readonly DiscordSocketClient _client;
|
|
private readonly AsyncLogger _logger;
|
|
|
|
public abstract string Name { get; }
|
|
protected DiscordSocketClient Client => _client;
|
|
|
|
public BotModule(DiscordSocketClient client)
|
|
{
|
|
_client = client;
|
|
_logger = Logger.GetLogger(this.Name);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Processes module-specific configuration.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// Module code <i>should not</i> hold on to this data, but instead use <see cref="GetConfig(ulong)"/> to retrieve
|
|
/// them. This is in the event that configuration is reverted to an earlier state and allows for the
|
|
/// all modules to revert to previously used configuration values with no effort on the part of the
|
|
/// module code itself.
|
|
/// </remarks>
|
|
/// <returns>
|
|
/// Processed configuration data prepared for later use.
|
|
/// </returns>
|
|
/// <exception cref="ConfigItem.RuleImportException">
|
|
/// This method should throw RuleImportException in the event of any error.
|
|
/// The exception message will be properly logged.
|
|
/// </exception>
|
|
public abstract Task<object> ProcessConfiguration(JToken configSection);
|
|
|
|
/// <summary>
|
|
/// Gets this module's relevant configuration data associated with the given Discord guild.
|
|
/// </summary>
|
|
/// <returns>
|
|
/// The stored configuration data, or null if none exists.
|
|
/// </returns>
|
|
protected object GetConfig(ulong guildId)
|
|
{
|
|
var sc = RegexBot.Config.Servers.FirstOrDefault(g => g.Id == guildId);
|
|
if (sc == null)
|
|
{
|
|
throw new ArgumentException("There is no known configuration associated with the given Guild ID.");
|
|
}
|
|
|
|
if (sc.ModuleConfigs.TryGetValue(this, out var item)) return item;
|
|
else return null;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Determines if the given message author or channel is in the server configuration's moderator list.
|
|
/// </summary>
|
|
protected bool IsModerator(ulong guildId, SocketMessage m)
|
|
{
|
|
var sc = RegexBot.Config.Servers.FirstOrDefault(g => g.Id == guildId);
|
|
if (sc == null)
|
|
{
|
|
throw new ArgumentException("There is no known configuration associated with the given Guild ID.");
|
|
}
|
|
|
|
return sc.Moderators.ExistsInList(m);
|
|
}
|
|
|
|
protected async Task Log(string text)
|
|
{
|
|
await _logger(text);
|
|
}
|
|
|
|
public sealed override bool Equals(object obj) => base.Equals(obj);
|
|
public sealed override int GetHashCode() => base.GetHashCode();
|
|
public sealed override string ToString() => base.ToString();
|
|
}
|
|
|
|
/// <summary>
|
|
/// Indicates which section under an individual Discord guild configuration should be passed to the
|
|
/// module's <see cref="BotModule.ProcessConfiguration(JToken)"/> method during configuration load.
|
|
/// </summary>
|
|
[AttributeUsage(AttributeTargets.Method, Inherited = false)]
|
|
public class ConfigSectionAttribute : Attribute
|
|
{
|
|
private readonly string _sectionName;
|
|
|
|
public string SectionName => _sectionName;
|
|
|
|
public ConfigSectionAttribute(string sectionName)
|
|
{
|
|
if (string.IsNullOrWhiteSpace(sectionName))
|
|
{
|
|
throw new ArgumentNullException("Configuration section name cannot be blank.");
|
|
}
|
|
_sectionName = sectionName;
|
|
}
|
|
}
|
|
}
|