aboutsummaryrefslogtreecommitdiff
path: root/lib/VNLib.Plugins.Extensions.Loading/src/UserLoading.cs
diff options
context:
space:
mode:
authorLibravatar vnugent <public@vaughnnugent.com>2023-01-09 15:09:13 -0500
committerLibravatar vnugent <public@vaughnnugent.com>2023-01-09 15:09:13 -0500
commita46c3bf452d287b50b2e7dd5a24f5995c9fd26f6 (patch)
tree3a978b2dd2887b5c0e25f595516594a647d8e880 /lib/VNLib.Plugins.Extensions.Loading/src/UserLoading.cs
parent189c6714057bf45553847eaeb9ce97eb7272eb8c (diff)
Restructure
Diffstat (limited to 'lib/VNLib.Plugins.Extensions.Loading/src/UserLoading.cs')
-rw-r--r--lib/VNLib.Plugins.Extensions.Loading/src/UserLoading.cs93
1 files changed, 93 insertions, 0 deletions
diff --git a/lib/VNLib.Plugins.Extensions.Loading/src/UserLoading.cs b/lib/VNLib.Plugins.Extensions.Loading/src/UserLoading.cs
new file mode 100644
index 0000000..da090ec
--- /dev/null
+++ b/lib/VNLib.Plugins.Extensions.Loading/src/UserLoading.cs
@@ -0,0 +1,93 @@
+/*
+* Copyright (c) 2022 Vaughn Nugent
+*
+* Library: VNLib
+* Package: VNLib.Plugins.Extensions.Loading
+* File: UserLoading.cs
+*
+* UserLoading.cs is part of VNLib.Plugins.Extensions.Loading which is part of the larger
+* VNLib collection of libraries and utilities.
+*
+* VNLib.Plugins.Extensions.Loading is free software: you can redistribute it and/or modify
+* it under the terms of the GNU General Public License as published
+* by the Free Software Foundation, either version 2 of the License,
+* or (at your option) any later version.
+*
+* VNLib.Plugins.Extensions.Loading 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. See the GNU
+* General Public License for more details.
+*
+* You should have received a copy of the GNU General Public License
+* along with VNLib.Plugins.Extensions.Loading. If not, see http://www.gnu.org/licenses/.
+*/
+
+using System;
+using System.Collections.Generic;
+
+using VNLib.Utils.Logging;
+using VNLib.Utils.Extensions;
+using VNLib.Plugins.Essentials.Users;
+
+namespace VNLib.Plugins.Extensions.Loading.Users
+{
+ /// <summary>
+ /// Contains extension methods for plugins to load the "users" system
+ /// </summary>
+ public static class UserLoading
+ {
+ public const string USER_CUSTOM_ASSEMBLY = "user_custom_asm";
+ public const string DEFAULT_USER_ASM = "VNLib.Plugins.Essentials.Users.dll";
+ public const string ONLOAD_METHOD_NAME = "OnPluginLoading";
+
+
+ /// <summary>
+ /// Gets or loads the plugin's ambient <see cref="IUserManager"/>, with the specified user-table name,
+ /// or the default table name
+ /// </summary>
+ /// <param name="plugin"></param>
+ /// <returns>The ambient <see cref="IUserManager"/> for the current plugin</returns>
+ /// <exception cref="KeyNotFoundException"></exception>
+ /// <exception cref="ObjectDisposedException"></exception>
+ public static IUserManager GetUserManager(this PluginBase plugin)
+ {
+ plugin.ThrowIfUnloaded();
+ //Get stored or load
+ return LoadingExtensions.GetOrCreateSingleton(plugin, LoadUsers);
+ }
+
+ private static IUserManager LoadUsers(PluginBase pbase)
+ {
+ //Try to load a custom user assembly for exporting IUserManager
+ string? customAsm = pbase.PluginConfig.GetPropString(USER_CUSTOM_ASSEMBLY);
+ //See if host config defined the path
+ customAsm ??= pbase.HostConfig.GetPropString(USER_CUSTOM_ASSEMBLY);
+ //Finally default
+ customAsm ??= DEFAULT_USER_ASM;
+
+ //Try to load a custom assembly
+ AssemblyLoader<IUserManager> loader = pbase.LoadAssembly<IUserManager>(customAsm);
+ try
+ {
+ //Try to get the onload method
+ Action<object>? onLoadMethod = loader.TryGetMethod<Action<object>>(ONLOAD_METHOD_NAME);
+
+ //Call the onplugin load method
+ onLoadMethod?.Invoke(pbase);
+
+ if (pbase.IsDebug())
+ {
+ pbase.Log.Verbose("Loading user manager from assembly {name}", loader.Resource.GetType().AssemblyQualifiedName);
+ }
+
+ //Return the loaded instance (may raise exception)
+ return loader.Resource;
+ }
+ catch
+ {
+ loader.Dispose();
+ throw;
+ }
+ }
+ }
+} \ No newline at end of file