using System; using System.IO; using System.Linq; using BepInEx.Logging; namespace BepInEx.Configuration { /// /// Container for a single setting of a . /// Each config entry is linked to one config file. /// public abstract class ConfigEntryBase { /// /// Types of defaultValue and definition.AcceptableValues have to be the same as settingType. /// internal ConfigEntryBase(ConfigFile configFile, ConfigDefinition definition, Type settingType, object defaultValue) { ConfigFile = configFile ?? throw new ArgumentNullException(nameof(configFile)); Definition = definition ?? throw new ArgumentNullException(nameof(definition)); SettingType = settingType ?? throw new ArgumentNullException(nameof(settingType)); // Free type check BoxedValue = defaultValue; DefaultValue = defaultValue; } /// /// Config file this entry is a part of. /// public ConfigFile ConfigFile { get; } /// /// Category and name of this setting. Used as a unique key for identification within a . /// public ConfigDefinition Definition { get; } /// /// Description / metadata of this setting. /// public ConfigDescription Description { get; private set; } /// /// Type of the that this setting holds. /// public Type SettingType { get; } /// /// Default value of this setting (set only if the setting was not changed before). /// public object DefaultValue { get; } /// /// Get or set the value of the setting. /// public abstract object BoxedValue { get; set; } /// /// Get the serialized representation of the value. /// public string GetSerializedValue() { return TomlTypeConverter.ConvertToString(BoxedValue, SettingType); } /// /// Set the value by using its serialized form. /// public void SetSerializedValue(string value) { try { var newValue = TomlTypeConverter.ConvertToValue(value, SettingType); BoxedValue = newValue; } catch (Exception e) { Logging.Logger.Log(LogLevel.Warning, $"Config value of setting \"{Definition}\" could not be parsed and will be ignored. Reason: {e.Message}; Value: {value}"); } } internal void SetDescription(ConfigDescription configDescription) { if (configDescription == null) throw new ArgumentNullException(nameof(configDescription)); if (configDescription.AcceptableValues != null && !SettingType.IsAssignableFrom(configDescription.AcceptableValues.ValueType)) throw new ArgumentException("configDescription.AcceptableValues is for a different type than the type of this setting"); Description = configDescription; // Automatically calls ClampValue in case it changed BoxedValue = BoxedValue; } /// /// If necessary, clamp the value to acceptable value range. T has to be equal to settingType. /// protected T ClampValue(T value) { if (Description?.AcceptableValues != null) return (T)Description.AcceptableValues.Clamp(value); return value; } /// /// Trigger setting changed event. /// protected void OnSettingChanged(object sender) { ConfigFile.OnSettingChanged(sender, this); } /// /// Write a description of this setting using all available metadata. /// public void WriteDescription(StreamWriter writer) { bool hasDescription = Description != null; if (hasDescription) writer.WriteLine(Description.ToSerializedString()); writer.WriteLine("# Setting type: " + SettingType.Name); writer.WriteLine("# Default value: " + DefaultValue); if (hasDescription && Description.AcceptableValues != null) { writer.WriteLine(Description.AcceptableValues.ToSerializedString()); } else if (SettingType.IsEnum) { writer.WriteLine("# Acceptable values: " + string.Join(", ", Enum.GetNames(SettingType))); if (SettingType.GetCustomAttributes(typeof(FlagsAttribute), true).Any()) writer.WriteLine("# Multiple values can be set at the same time by separating them with , (e.g. Debug, Warning)"); } } } }