#nullable enable
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Text.Json;
namespace Duplicati.Library.AutoUpdater;
///
/// Utility class for loading the preload settings
///
public static class PreloadSettingsLoader
{
///
/// The environment variable to specify the preload settings file
///
private const string PreloadSettingsEnvVar = "DUPLICATI_PRELOAD_SETTINGS";
///
/// The environment variable to enable debug output for preload settings
///
private const string PreloadSettingsDebugEnvVar = "DUPLICATI_PRELOAD_SETTINGS_DEBUG";
///
/// The marker for any executable
///
private const string AnyExecutableMarker = "*";
///
/// Cached value for toggling debug code
///
private static readonly bool PreloadDebug = !string.IsNullOrWhiteSpace(Environment.GetEnvironmentVariable(PreloadSettingsDebugEnvVar));
///
/// The preload paths to search for settings in.
/// Each path is checked and applied to obtain the final settings.
/// Later paths take precedence over earlier ones, so the env variable is most specific.
/// These are statically loaded so the preload cannot change the settings after startup.
///
private static readonly string[] PreloadPaths = new string[]
{
// The default path for preload settings
Path.Combine(
Environment.GetFolderPath(Environment.SpecialFolder.CommonApplicationData),
"Duplicati",
"preload.json"
),
// The path for preload settings with the install directory
Path.Combine(
Path.GetDirectoryName(System.Reflection.Assembly.GetExecutingAssembly().Location) ?? "",
"preload.json"
),
// The path for preload settings specified with an environment variable
Environment.GetEnvironmentVariable(PreloadSettingsEnvVar) ?? "",
}
.Where(x => !string.IsNullOrEmpty(x))
.ToArray();
///
/// Configures the preload settings for the given executable
///
/// The source commandline arguments
/// The executable to match
public static void ConfigurePreloadSettings(ref string[] arguments, PackageHelper.NamedExecutable executable)
=> ConfigurePreloadSettings(ref arguments, executable, out _);
///
/// Configures the preload settings for the given executable
///
/// The source commandline arguments
/// The executable to match
/// The database settings
public static void ConfigurePreloadSettings(ref string[] arguments, PackageHelper.NamedExecutable executable, out Dictionary dbsettings)
{
var (env, args, db) = GetExecutableMergedSettings(executable);
dbsettings = db;
ApplyEnvironmentVariables(env);
ApplyCommandLineArguments(ref arguments, args);
}
///
/// Gets the argument name from the given argument
///
/// The argument to get the name from
/// The argument name
private static string GetArgumentName(string arg)
=> arg.Split('=', 2)[0];
///
/// Gets the merged settings for the given executable
///
/// The executable to get settings for
/// The merged settings
private static (Dictionary env, List args, Dictionary db) GetExecutableMergedSettings(PackageHelper.NamedExecutable executable)
{
// Collect settings in generic and specific dictionaries
// The executable-specific settings take precedence over the generic ones,
// but the loading order is used so that the most specific file is loaded last
var env_generic = new Dictionary(StringComparer.OrdinalIgnoreCase);
var env_specific = new Dictionary(StringComparer.OrdinalIgnoreCase);
var args_generic = new List();
var args_specific = new List();
var db_generic = new Dictionary(StringComparer.OrdinalIgnoreCase);
var db_specific = new Dictionary(StringComparer.OrdinalIgnoreCase);
var exename = MapExecutableName(executable);
void MergeDicts(Dictionary target, Dictionary? source)
{
if (source != null)
foreach (var kvp in source)
target[kvp.Key] = kvp.Value;
}
foreach (var path in PreloadPaths)
{
if (!Path.IsPathRooted(path))
{
if (PreloadDebug)
Console.WriteLine($"Preload settings path is not rooted, ignoring: {path}");
continue;
}
if (!File.Exists(path))
{
if (PreloadDebug)
Console.WriteLine($"Preload settings file does not exist, ignoring: {path}");
continue;
}
var settings = LoadSettings(path);
if (settings == null)
continue;
if (settings.db != null)
{
if (settings.db.TryGetValue(AnyExecutableMarker, out var entry))
MergeDicts(db_generic, entry);
if (exename != AnyExecutableMarker && settings.db.TryGetValue(exename, out entry))
MergeDicts(db_specific, entry);
}
if (settings.env != null)
{
if (settings.env.TryGetValue(AnyExecutableMarker, out var entry))
MergeDicts(env_generic, entry);
if (exename != AnyExecutableMarker && settings.env.TryGetValue(exename, out entry))
MergeDicts(env_specific, entry);
}
if (settings.args != null)
{
if (settings.args.TryGetValue(AnyExecutableMarker, out var entry))
args_generic.AddRange(entry ?? []);
if (exename != AnyExecutableMarker && settings.args.TryGetValue(exename, out entry))
args_specific.AddRange(entry ?? []);
}
}
// Merge specific settings into generic ones
foreach (var kvp in db_specific)
db_generic[kvp.Key] = kvp.Value;
foreach (var kvp in env_specific)
env_generic[kvp.Key] = kvp.Value;
args_generic.AddRange(args_specific);
// Remove duplicates from the arguments, preserve order
var mapped = new Dictionary(StringComparer.OrdinalIgnoreCase);
var args = new List();
foreach (var value in args_generic)
{
var argname = GetArgumentName(value);
if (mapped.TryGetValue(argname, out var index))
args.RemoveAt(index);
mapped[argname] = args.Count;
args.Add(value);
}
var env = env_generic.ToDictionary(x => x.Key, x => x.Value ?? "");
return (env, args, db_generic);
}
///
/// Applies loaded environment variables, but does not overwrite existing ones
///
/// The environment variables to apply
private static void ApplyEnvironmentVariables(Dictionary env)
{
var current = Environment.GetEnvironmentVariables();
foreach (var kvp in env)
if (!current.Contains(kvp.Key))
Environment.SetEnvironmentVariable(kvp.Key, kvp.Value ?? "");
}
///
/// Applies loaded commandline arguments, but does not overwrite existing ones
///
/// The source commandline arguments
/// The arguments to apply
private static void ApplyCommandLineArguments(ref string[] arguments, List args)
{
arguments ??= [];
var existing = new HashSet(arguments.Select(GetArgumentName), StringComparer.OrdinalIgnoreCase);
var result = arguments.ToList();
foreach (var value in args)
if (!existing.Contains(GetArgumentName(value)))
result.Add(value);
arguments = result.ToArray();
}
///
/// Loads the settings from the given path
///
/// The path to load settings from
/// The loaded settings, or null if an error occurred
private static PreloadSettingsRoot? LoadSettings(string path)
{
try
{
var result = JsonSerializer.Deserialize(File.ReadAllText(path));
if (PreloadDebug)
{
if (result == null)
{
Console.WriteLine($"Loaded empty preload settings from {path}");
return null;
}
var jsData = JsonSerializer.Deserialize(File.ReadAllText(path));
var unmatched_keys = jsData.EnumerateObject().Select(x => x.Name).Except(["db", "env", "args"]);
if (unmatched_keys.Any())
Console.WriteLine($"Unexpected key(s) in preload settings: {string.Join(", ", unmatched_keys)}");
Console.WriteLine($"Loaded preload settings from {path}");
var allowedSources = Enum.GetValues()
.Select(MapExecutableName)
.Append(AnyExecutableMarker)
.ToHashSet(StringComparer.OrdinalIgnoreCase);
var unmatched_db = result.db?.Keys.Where(x => !allowedSources.Contains(x)) ?? [];
var unmatched_env = result.env?.Keys.Where(x => !allowedSources.Contains(x)) ?? [];
var unmatched_args = result.args?.Keys.Where(x => !allowedSources.Contains(x)) ?? [];
if (unmatched_db.Any())
Console.WriteLine($"Found unknown executable name(s) in db preload settings: {string.Join(", ", unmatched_db)}");
if (unmatched_env.Any())
Console.WriteLine($"Found unknown executable name(s) in env preload settings: {string.Join(", ", unmatched_env)}");
if (unmatched_args.Any())
Console.WriteLine($"Found unknown executable name(s) in args preload settings: {string.Join(", ", unmatched_args)}");
}
return result;
}
catch (Exception ex)
{
// Logging is usually not set up at this point
if (PreloadDebug)
Console.WriteLine($"Failed to load preload settings from {path}: {ex}");
return null;
}
}
///
/// Maps the executable name to the preload settings key
///
/// The executable to map
/// The mapped name
private static string MapExecutableName(PackageHelper.NamedExecutable exe)
=> exe switch
{
PackageHelper.NamedExecutable.TrayIcon => "tray",
PackageHelper.NamedExecutable.CommandLine => "cli",
PackageHelper.NamedExecutable.AutoUpdater => "autoupdater",
PackageHelper.NamedExecutable.Server => "server",
PackageHelper.NamedExecutable.WindowsService => "winservice",
PackageHelper.NamedExecutable.BackendTool => "backendtool",
PackageHelper.NamedExecutable.RecoveryTool => "recoverytool",
PackageHelper.NamedExecutable.BackendTester => "backendtester",
PackageHelper.NamedExecutable.SharpAESCrypt => "aescrypt",
PackageHelper.NamedExecutable.Snapshots => "snapshots",
PackageHelper.NamedExecutable.ServerUtil => "serverutil",
PackageHelper.NamedExecutable.Service => "service",
_ => AnyExecutableMarker,
};
///
/// JSON root object for preload settings
///
/// The database settings
/// The environment variables
/// The executable settings
private sealed record PreloadSettingsRoot(
Dictionary>? db,
Dictionary>? env,
Dictionary>? args
);
}