Config.cs - escaco95/Charcoal GitHub Wiki

using System.Collections.Generic;
using System.IO;

namespace DiagramEditor.V4
{
    /// <summary>
    /// 설정 간 <see cref="Config.Merge(Config)"/> 연산이 발생할 때, 각 항목에 대한 병합 행위를 지정합니다.
    /// </summary>
    public enum ConfigMergeOption
    {
        /// <summary>
        /// 이전 데이터를 모두 지우고, 새 데이터로 <see cref="ConfigMergeOption.Replace"/>합니다.
        /// </summary>
        Clear,
        /// <summary>
        /// 이전 데이터를 유지합니다. 모든 중복되는 데이터에 대해, 새 데이터를 적용합니다.
        /// </summary>
        Replace,
        /// <summary>
        /// 이전 데이터를 유지합니다. 중복되는 데이터는 변경하지 않습니다.
        /// </summary>
        Append,
    }
    /// <summary>
    /// 모든 버전의 설정 파일에 대응할 수 있는 파일 ↔ 메모리 자료구조입니다.
    /// </summary>
    public class Config
    {
        public Config() { }
        public Config(string filePath) { Read(filePath); }
        public Config(Config source) { Merge(source); }
        /// <summary>
        /// 기본 카테고리로 제공되는 문자열 상수값입니다. 반드시 사용하지 않더라도 상관없습니다.
        /// </summary>
        public static string DefaultCategory = "Default";
        protected Dictionary<ConfigOption, bool> Linear = new Dictionary<ConfigOption, bool>();
        protected Dictionary<string, Dictionary<string, ConfigOption>> Hierarchy = new Dictionary<string, Dictionary<string, ConfigOption>>();
        /// <summary>
        /// 해당 설정 개체에 포함된 모든 옵션의 IEnumerable을 반환합니다.
        /// </summary>
        public IEnumerable<ConfigOption> Options { get { return Linear.Keys; } }
        /// <summary>
        /// 해당 설정 개체에 포함된 모든 카테고리의 IEnumerable을 반환합니다.
        /// </summary>
        public IEnumerable<string> Categories { get { return Hierarchy.Keys; } }
        /// <summary>
        /// 다른 설정 개체의 옵션을 병합합니다.
        /// </summary>
        public void Merge(Config source, ConfigMergeOption mergeOption = ConfigMergeOption.Replace)
        {
            if (mergeOption == ConfigMergeOption.Clear)
                Clear();
            switch (mergeOption)
            {
                case ConfigMergeOption.Clear:
                case ConfigMergeOption.Replace:
                    foreach (var tuple in source.Linear)
                        Set(tuple.Key.Category, tuple.Key.Name, tuple.Key.Value);
                    break;
                case ConfigMergeOption.Append:
                    foreach (var tuple in source.Linear)
                        if (!ContainsOption(tuple.Key.Category, tuple.Key.Name))
                            Set(tuple.Key.Category, tuple.Key.Name, tuple.Key.Value);
                    break;
            }
        }
        /// <summary>
        /// 해당 설정 개체의 내용을 복사하여, 새로운 설정 개체를 만듭니다. (Deep-Copy)
        /// </summary>
        public Config Clone()
        {
            Config temp = new Config();
            temp.Merge(this, ConfigMergeOption.Replace);
            return temp;
        }
        /// <summary>
        /// 해당 설정 개체에 포함된 모든 하위 옵션 수를 반환합니다.
        /// </summary>
        public int Count()
        {
            return Linear.Count;
        }
        /// <summary>
        /// 카테고리에 저장된 옵션이 몇 개인지를 반환합니다.
        /// </summary>
        public int Count(string category)
        {
            // 우선, 카테고리가 존재하는지부터 확인하고.
            // 존재 여부에 따라 0을 반환할 것인지, 내용을 반환할 것인지 결정합니다.
            return (Hierarchy.ContainsKey(category)) ? Hierarchy[category].Count : 0;
        }
        /// <summary>
        /// 옵션 파일의 내용을 완전히 비웁니다.
        /// </summary>
        public void Clear()
        {
            Linear.Clear();
            Hierarchy.Clear();
        }
        /// <summary>
        /// 특정 카테고리를 완전히 비웁니다.
        /// </summary>
        public void Clear(string category)
        {
            foreach (var tuple in Hierarchy[category])
                Linear.Remove(tuple.Value);
            Hierarchy.Remove(category);
        }
        /// <summary>
        /// 지정한 카테고리를 포함하고 있는지의 여부를 반환합니다.
        /// </summary>
        public bool ContainsCategory(string category) { return Hierarchy.ContainsKey(category); }
        /// <summary>
        /// 지정한 옵션을 포함하고 있는지의 여부를 반환합니다.
        /// </summary>
        public bool ContainsOption(string category, string optionName)
        {
            return (!Hierarchy.ContainsKey(category)) ? false : Hierarchy[category].ContainsKey(optionName);
        }
        /// <summary>
        /// 설정으로부터 특정 카테고리를 제거합니다. <see cref="Clear(string)"/>와 동일하게 동작합니다.
        /// </summary>
        public void Remove(string category) => Clear(category);
        /// <summary>
        /// 설정으로부터 특정 옵션을 제거합니다.
        /// </summary>
        public void Remove(string category, string optionName)
        {
            ConfigOption temp = Hierarchy[category][optionName];
            Hierarchy[category].Remove(optionName);
            Linear.Remove(temp);
            if (Hierarchy[category].Count > 0)
                return;
            Hierarchy.Remove(category);
        }
        /// <summary>
        /// 해당 개체의 특정 카테고리에 옵션을 설정합니다.
        /// </summary>
        public void Set(string category, string optionName, string value)
        {
            if (!Hierarchy.ContainsKey(category))
                Hierarchy.Add(category, new Dictionary<string, ConfigOption>());
            if (!Hierarchy[category].ContainsKey(optionName))
            {
                ConfigOption temp = new ConfigOption(category, optionName, value);
                Hierarchy[category].Add(optionName, temp);
                Linear.Add(temp, true);
            }
            else
                Hierarchy[category][optionName].Value = value;
        }
        public void SetInt(string category, string optionName, int value)
            => Set(category, optionName, value.ToString());
        public void SetBool(string category, string optionName, bool value)
            => Set(category, optionName, value.ToString());
        public void SetDouble(string category, string optionName, double value)
            => Set(category, optionName, value.ToString());
        public void SetFloat(string category, string optionName, float value)
            => Set(category, optionName, value.ToString());
        /// <summary>
        /// 해당 개체의 <see cref="DefaultCategory"/>(기본 카테고리)에 옵션을 추가합니다.
        /// </summary>
        public void Set(string optionName, string value) => Set(DefaultCategory, optionName, value);
        /// <summary>
        /// 해당 개체로부터 지정된 카테고리의 옵션 값을 가져옵니다.
        /// </summary>
        /// <param name="defaultValue">옵션 값이 존재하지 않았을 경우 반환할 기본값입니다.</param>
        public string Get(string category, string optionName, string defaultValue = "")
        {
            return (ContainsOption(category, optionName)) ? Hierarchy[category][optionName].Value : defaultValue;
        }
        public int GetInt(string category, string optionName, int defaultValue = -1)
        {
            int result; return (int.TryParse(Get(category, optionName), out result)) ? result : defaultValue;
        }
        public bool GetBool(string category, string optionName, bool defaultValue = false)
        {
            bool result; return (bool.TryParse(Get(category, optionName), out result)) ? result : defaultValue;
        }
        public double GetDouble(string category, string optionName, double defaultValue = 0.0)
        {
            double result; return (double.TryParse(Get(category, optionName), out result)) ? result : defaultValue;
        }
        public float GetFloat(string category, string optionName, float defaultValue = 0.0F)
        {
            float result; return (float.TryParse(Get(category, optionName), out result)) ? result : defaultValue;
        }
        /// <summary>
        /// 해당 개체로부터 <see cref="DefaultCategory"/>(기본 카테고리)의 옵션 값을 가져옵니다.
        /// </summary>
        /// <param name="defaultValue">옵션 값이 존재하지 않았을 경우 반환할 기본값입니다.</param>
        public string Get(string optionName, string defaultValue = "") => Get(DefaultCategory, optionName, defaultValue);
        /// <summary>
        /// 지정된 문자열 경로의 파일에 설정을 기록합니다.
        /// </summary>
        public void Write(string fileName)
        {
            // 파일에 Write합니다.
            File.WriteAllText(fileName, ToString());
        }
        public override string ToString()
        {
            // 아웃풋 버퍼입니다.
            string _outputBuffer = string.Empty;
            foreach (var _tuple in Hierarchy)
            {
                _outputBuffer += "[" + _tuple.Key + "]\r\n";
                foreach (var __tuple in _tuple.Value)
                {
                    var ___key = __tuple.Key;
                    var ___value = __tuple.Value.Value;
                    _outputBuffer += ___key + "=" + ___value + "\r\n";
                }
            }
            return _outputBuffer;
        }
        /// <summary>
        /// 지정된 파일스트림으로부터 설정을 읽어들입니다.
        /// </summary>
        public bool Read(string fileName)
        {
            Config _temp = new Config();
            try
            {
                string[] _inputBuffer = System.IO.File.ReadAllLines(fileName);
                // 기본 카테고리는 DefaultCategory 입니다. (생략된 카테고리에 대한 모든 처리 = DefaultCategory로 분류)
                string _lastCategory = DefaultCategory;
                // 버퍼를 줄 단위로 읽어들이면서 분석합니다.
                foreach (var __input in _inputBuffer)
                {
                    // 첫 번째 문자가 [로 시작했을 때, 이 줄이 카테고리인지 확인합니다.
                    int __delimOpenIndex = __input.IndexOf('[');
                    if (__delimOpenIndex == 0)
                    {
                        int __delimCloseIndex = __input.IndexOf(']');
                        if (__delimCloseIndex > __delimOpenIndex)
                        {
                            _lastCategory = __input.Substring(1, __delimCloseIndex - 1);
                            continue;
                        }
                    }
                    // 이 줄이 카테고리가 아니었을 경우, '=' 문자를 포함하고 있는지 확인합니다.
                    int __eqIndex = __input.IndexOf('=');
                    if (__eqIndex < 0)
                        continue;
                    string __key = __input.Substring(0, __eqIndex);
                    string __value = __input.Substring(__eqIndex + 1, __input.Length - __eqIndex - 1);
                    _temp.Set(_lastCategory, __key, __value);
                }
            }
            catch { return false; }
            // 얕은 복사를 수행합니다.
            Hierarchy = _temp.Hierarchy;
            Linear = _temp.Linear;
            return true;
        }
    }
    /// <summary>
    /// 단일 설정을 구성하는 가장 작은 형태의 개체입니다. 임의로 생성할 수 없습니다.
    /// </summary>
    public class ConfigOption
    {
        internal ConfigOption(string category, string name, string value)
        {
            Category = category;
            Name = name;
            Value = value;
        }
        internal ConfigOption Clone()
        {
            return new ConfigOption(Category, Name, Value);
        }
        /// <summary>
        /// 해당 설정이 속한 카테고리 값입니다.
        /// </summary>
        public string Category { get; private set; }
        /// <summary>
        /// 해당 설정의 이름값입니다.
        /// </summary>
        public string Name { get; private set; }
        /// <summary>
        /// 해당 설정의 값입니다.
        /// </summary>
        public string Value { get; set; }
        public override string ToString() { return $"[{Category}] {Name}={Value}"; }
    }
}