using System;
using System.Configuration;
using System.Linq.Expressions;
using Developpez.Dotnet.Linq;
using JetBrains.Annotations;

namespace Developpez.Dotnet.Configuration
{
    /// <summary>
    /// Fournit des méthodes en rapport avec la configuration et les paramètres d'application.
    /// </summary>
    public static class ConfigurationExtension
    {
        /// <summary>
        /// Met à jour les paramètres de l'application depuis une version précédente si nécessaire.
        /// </summary>
        /// <typeparam name="TSettings">Type qui gère l'accès aux paramètres d'application</typeparam>
        /// <param name="settings">Objet qui gère l'accès aux paramètres d'application (par exemple Settings.Default ou My.Settings)</param>
        /// <param name="upgradeFlagName">Nom du paramètre indiquant si les paramètres d'application ont été mis à jour</param>
        /// <remarks>Pour utiliser cette méthode, vous devez définir dans vos paramètres d'application un paramètre de type <see cref="bool"/>
        /// dont la valeur par défaut est <c>false</c>, et indiquer son nom à la méthode via le paramètre  <c>upgradeFlagName</c>. La mise à
        /// jour sera effectuée si et seulement si ce paramètre d'application vaut false, et la valeur sera mise à true pour indiquer que
        /// la mise à jour a été effectuée.</remarks>
        public static void UpgradeIfRequired<TSettings>(
            [NotNull] this TSettings settings,
            [NotNull] string upgradeFlagName)
            where TSettings : ApplicationSettingsBase
        {
            settings.CheckArgumentNull("settings");
            upgradeFlagName.CheckArgumentNull("upgradeFlagName");
            bool flag = (bool)settings[upgradeFlagName];
            if (!flag)
            {
                settings.Upgrade();
                settings[upgradeFlagName] = true;
                settings.Save();
            }
        }

        /// <summary>
        /// Met à jour les paramètres de l'application depuis une version précédente si nécessaire.
        /// </summary>
        /// <typeparam name="TSettings">Type qui gère l'accès aux paramètres d'application</typeparam>
        /// <param name="settings">Objet qui gère l'accès aux paramètres d'application (par exemple Settings.Default ou My.Settings)</param>
        /// <param name="upgradeFlagSelector">Expression qui renvoie le paramètre indiquant si les paramètres d'application ont été mis à jour</param>
        /// <remarks>Pour utiliser cette méthode, vous devez définir dans vos paramètres d'application un paramètre de type <see cref="bool"/>
        /// dont la valeur par défaut est <c>false</c>, et l'indiquer à la méthode via le paramètre <c>upgradeFlagSelector</c>. La mise à
        /// jour sera effectuée si et seulement si ce paramètre d'application vaut false, et la valeur sera mise à true pour indiquer que la
        /// mise à jour a été effectuée.</remarks>
        public static void UpgradeIfRequired<TSettings>(
            [NotNull] this TSettings settings,
            [NotNull] Expression<Func<TSettings, bool>> upgradeFlagSelector)
            where TSettings : ApplicationSettingsBase
        {
            settings.CheckArgumentNull("settings");
            upgradeFlagSelector.CheckArgumentNull("upgradeFlagSelector");
            var upgradeFlagName = LinqHelper.GetPropertyName(upgradeFlagSelector);
            settings.UpgradeIfRequired(upgradeFlagName);
        }
    }
}