RegexBot/BotModule.cs

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 string Name => this.GetType().Name;
        protected DiscordSocketClient Client => _client;

        public BotModule(DiscordSocketClient client)
        {
            _client = client;
            _logger = Logger.GetLogger(this.Name);
        }

        /// <summary>
        /// Processes module-specific configuration.
        /// This method is not called if the user did not provide configuration for the module.
        /// </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 <see cref="ConfigItem.RuleImportException"/>
        /// in the event of configuration errors. The exception message will be properly displayed.
        /// </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) return null;

            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();
    }
}