using System;
using System.Collections.Generic;
using System.Diagnostics;
using System.IO;
using System.Linq;
using System.Reflection;
namespace PKHeX.WinForms;
///
/// Provides functionality to load plugins from assemblies at runtime.
///
public static class PluginLoader
{
///
/// Loads plugin assemblies from the given directory using the provided load setting.
///
/// The directory path to search for plugin assemblies.
/// The plugin load setting to use.
/// A PluginLoadResult containing contexts and assemblies.
public static PluginLoadResult LoadPluginAssemblies(string pluginPath, bool loadMerged)
{
var result = new PluginLoadResult();
var dllFileNames = !Directory.Exists(pluginPath)
? []
: Directory.EnumerateFiles(pluginPath, "*.dll", SearchOption.AllDirectories);
foreach (var file in dllFileNames)
{
try
{
result.Load(file);
}
catch (Exception ex)
{
Debug.WriteLine($"Unable to load plugin from file: {file}");
Debug.WriteLine(ex.Message);
}
}
if (loadMerged)
result.LoadFromAssembly(Assembly.GetExecutingAssembly());
return result;
}
///
/// Loads plugins of the specified type from the given directory using the provided load setting.
///
/// The type of plugin to load.
/// The directory path to search for plugin assemblies.
/// Reference to the list to populate with loaded plugins.
/// The plugin load setting to use.
/// Plugin source information for the loaded plugin instances of type .
public static PluginLoadResult LoadPlugins(string pluginPath, List list, bool loadMerged) where T : class
{
var result = LoadPluginAssemblies(pluginPath, loadMerged);
var pluginTypes = GetPluginsOfType(result.GetAssemblies());
list.AddRange(LoadPlugins(pluginTypes));
return result;
}
///
/// Loads plugin instances of the specified type from the given plugin types.
///
/// The type of plugin to load.
/// The types of plugins to instantiate.
/// An enumerable of loaded plugin instances of type .
private static IEnumerable LoadPlugins(IEnumerable pluginTypes) where T : class
{
foreach (var t in pluginTypes)
{
T? activate;
try { activate = (T?)Activator.CreateInstance(t); }
catch (Exception ex)
{
Debug.WriteLine($"Unable to load plugin [{t.Name}]: {t.FullName}");
Debug.WriteLine(ex.Message);
continue;
}
if (activate is not null)
yield return activate;
}
}
///
/// Gets all plugin types of the specified type from the given assemblies.
///
/// The type of plugin to search for.
/// The assemblies to search for plugins.
/// An enumerable of plugin types.
private static IEnumerable GetPluginsOfType(IEnumerable assemblies)
{
var pluginType = typeof(T);
return assemblies.SelectMany(z => GetPluginTypes(z, pluginType));
}
///
/// Gets all types from the specified assembly that match the given plugin type.
///
/// The assembly to search.
/// The plugin type to match.
/// An enumerable of matching types.
private static IEnumerable GetPluginTypes(Assembly z, Type plugin)
{
try
{
// Handle Costura merged plugin dll's; need to Attach for them to correctly retrieve their dependencies.
var assemblyLoaderType = z.GetType("Costura.AssemblyLoader", false);
var attachMethod = assemblyLoaderType?.GetMethod("Attach", BindingFlags.Static | BindingFlags.Public);
attachMethod?.Invoke(null, []);
var types = z.GetExportedTypes();
return types.Where(type => IsTypePlugin(type, plugin));
}
// User plugins can be out of date, with mismatching API surfaces.
catch (Exception ex)
{
Debug.WriteLine($"Unable to load plugin [{plugin.FullName}]: {z.FullName}");
Debug.WriteLine(ex.Message);
if (ex is not ReflectionTypeLoadException rtle)
return [];
foreach (var le in rtle.LoaderExceptions)
{
if (le is not null)
Debug.WriteLine(le.Message);
}
return [];
}
}
///
/// Determines whether the specified type is a valid plugin type.
///
/// The type to check.
/// The plugin type to match.
/// if the type is a valid plugin type; otherwise, .
private static bool IsTypePlugin(Type type, Type plugin)
{
if (type.IsInterface || type.IsAbstract)
return false;
return plugin.IsAssignableFrom(type);
}
}