Fold ConfigurationExtensions.cs into Configuration.cs

Author: nulltoken

LibGit2Sharp/Configuration.cs

@@ -290,6 +290,64 @@ protected virtual void Dispose(bool disposing)
             configHandle.SafeDispose();
         }
 
+        /// <summary>
+        /// Get a configuration value for the given key parts.
+        /// <para>
+        ///   For example in order to get the value for this in a .git\config file:
+        ///
+        ///   <code>
+        ///   [core]
+        ///   bare = true
+        ///   </code>
+        ///
+        ///   You would call:
+        ///
+        ///   <code>
+        ///   bool isBare = repo.Config.Get&lt;bool&gt;(new []{ "core", "bare" }).Value;
+        ///   </code>
+        /// </para>
+        /// </summary>
+        /// <typeparam name="T">The configuration value type</typeparam>
+        /// <param name="keyParts">The key parts</param>
+        /// <returns>The <see cref="ConfigurationEntry{T}"/>, or null if not set</returns>
+        public virtual ConfigurationEntry<T> Get<T>(string[] keyParts)
+        {
+            Ensure.ArgumentNotNull(keyParts, "keyParts");
+
+            return Get<T>(string.Join(".", keyParts));
+        }
+
+        /// <summary>
+        /// Get a configuration value for the given key parts.
+        /// <para>
+        ///   For example in order to get the value for this in a .git\config file:
+        ///
+        ///   <code>
+        ///   [difftool "kdiff3"]
+        ///     path = c:/Program Files/KDiff3/kdiff3.exe
+        ///   </code>
+        ///
+        ///   You would call:
+        ///
+        ///   <code>
+        ///   string where = repo.Config.Get&lt;string&gt;("difftool", "kdiff3", "path").Value;
+        ///   </code>
+        /// </para>
+        /// </summary>
+        /// <typeparam name="T">The configuration value type</typeparam>
+        /// <param name="firstKeyPart">The first key part</param>
+        /// <param name="secondKeyPart">The second key part</param>
+        /// <param name="thirdKeyPart">The third key part</param>
+        /// <returns>The <see cref="ConfigurationEntry{T}"/>, or null if not set</returns>
+        public virtual ConfigurationEntry<T> Get<T>(string firstKeyPart, string secondKeyPart, string thirdKeyPart)
+        {
+            Ensure.ArgumentNotNullOrEmptyString(firstKeyPart, "firstKeyPart");
+            Ensure.ArgumentNotNullOrEmptyString(secondKeyPart, "secondKeyPart");
+            Ensure.ArgumentNotNullOrEmptyString(thirdKeyPart, "thirdKeyPart");
+
+            return Get<T>(new[] { firstKeyPart, secondKeyPart, thirdKeyPart });
+        }
+
         /// <summary>
         /// Get a configuration value for a key. Keys are in the form 'section.name'.
         /// <para>
@@ -366,6 +424,181 @@ public virtual ConfigurationEntry<T> Get<T>(string key, ConfigurationLevel level
             }
         }
 
+        /// <summary>
+        /// Get a configuration value for the given key.
+        /// </summary>
+        /// <typeparam name="T">The configuration value type.</typeparam>
+        /// <param name="key">The key</param>
+        /// <returns>The configuration value, or the default value for the selected <see typeparamref="T"/>if not found</returns>
+        public virtual T GetValueOrDefault<T>(string key)
+        {
+            return ValueOrDefault(Get<T>(key), default(T));
+        }
+
+        /// <summary>
+        /// Get a configuration value for the given key,
+        /// or <paramref name="defaultValue" /> if the key is not set.
+        /// </summary>
+        /// <typeparam name="T">The configuration value type.</typeparam>
+        /// <param name="key">The key</param>
+        /// <param name="defaultValue">The default value if the key is not set.</param>
+        /// <returns>The configuration value, or the default value</returns>
+        public virtual T GetValueOrDefault<T>(string key, T defaultValue)
+        {
+            return ValueOrDefault(Get<T>(key), defaultValue);
+        }
+
+        /// <summary>
+        /// Get a configuration value for the given key
+        /// </summary>
+        /// <typeparam name="T">The configuration value type.</typeparam>
+        /// <param name="key">The key.</param>
+        /// <param name="level">The configuration file into which the key should be searched for.</param>
+        /// <returns>The configuration value, or the default value for <see typeparamref="T"/> if not found</returns>
+        public virtual T GetValueOrDefault<T>(string key, ConfigurationLevel level)
+        {
+            return ValueOrDefault(Get<T>(key, level), default(T));
+        }
+
+        /// <summary>
+        /// Get a configuration value for the given key,
+        /// or <paramref name="defaultValue" /> if the key is not set.
+        /// </summary>
+        /// <typeparam name="T">The configuration value type.</typeparam>
+        /// <param name="key">The key.</param>
+        /// <param name="level">The configuration file into which the key should be searched for.</param>
+        /// <param name="defaultValue">The selector used to generate a default value if the key is not set.</param>
+        /// <returns>The configuration value, or the default value.</returns>
+        public virtual T GetValueOrDefault<T>(string key, ConfigurationLevel level, T defaultValue)
+        {
+            return ValueOrDefault(Get<T>(key, level), defaultValue);
+        }
+
+        /// <summary>
+        /// Get a configuration value for the given key parts
+        /// </summary>
+        /// <typeparam name="T">The configuration value type.</typeparam>
+        /// <param name="keyParts">The key parts.</param>
+        /// <returns>The configuration value, or the default value for<see typeparamref="T"/> if not found</returns>
+        public virtual T GetValueOrDefault<T>(string[] keyParts)
+        {
+            return ValueOrDefault(Get<T>(keyParts), default(T));
+        }
+
+        /// <summary>
+        /// Get a configuration value for the given key parts,
+        /// or <paramref name="defaultValue" /> if the key is not set.
+        /// </summary>
+        /// <typeparam name="T">The configuration value type.</typeparam>
+        /// <param name="keyParts">The key parts.</param>
+        /// <param name="defaultValue">The default value if the key is not set.</param>
+        /// <returns>The configuration value, or the default value.</returns>
+        public virtual T GetValueOrDefault<T>(string[] keyParts, T defaultValue)
+        {
+            return ValueOrDefault(Get<T>(keyParts), defaultValue);
+        }
+
+        /// <summary>
+        /// Get a configuration value for the given key parts.
+        /// </summary>
+        /// <typeparam name="T">The configuration value type.</typeparam>
+        /// <param name="firstKeyPart">The first key part.</param>
+        /// <param name="secondKeyPart">The second key part.</param>
+        /// <param name="thirdKeyPart">The third key part.</param>
+        /// <returns>The configuration value, or the default value for the selected <see typeparamref="T"/> if not found</returns>
+        public virtual T GetValueOrDefault<T>(string firstKeyPart, string secondKeyPart, string thirdKeyPart)
+        {
+            return ValueOrDefault(Get<T>(firstKeyPart, secondKeyPart, thirdKeyPart), default(T));
+        }
+
+        /// <summary>
+        /// Get a configuration value for the given key parts,
+        /// or <paramref name="defaultValue" /> if the key is not set.
+        /// </summary>
+        /// <typeparam name="T">The configuration value type.</typeparam>
+        /// <param name="firstKeyPart">The first key part.</param>
+        /// <param name="secondKeyPart">The second key part.</param>
+        /// <param name="thirdKeyPart">The third key part.</param>
+        /// <param name="defaultValue">The default value if the key is not set.</param>
+        /// <returns>The configuration value, or the default.</returns>
+        public virtual T GetValueOrDefault<T>(string firstKeyPart, string secondKeyPart, string thirdKeyPart, T defaultValue)
+        {
+            return ValueOrDefault(Get<T>(firstKeyPart, secondKeyPart, thirdKeyPart), defaultValue);
+        }
+
+        /// <summary>
+        /// Get a configuration value for the given key,
+        /// or a value generated by <paramref name="defaultValueSelector" />
+        /// if the key is not set.
+        /// </summary>
+        /// <typeparam name="T">The configuration value type.</typeparam>
+        /// <param name="key">The key</param>
+        /// <param name="defaultValueSelector">The selector used to generate a default value if the key is not set.</param>
+        /// <returns>The configuration value, or a generated default.</returns>
+        public virtual T GetValueOrDefault<T>(string key, Func<T> defaultValueSelector)
+        {
+            return ValueOrDefault(Get<T>(key), defaultValueSelector);
+        }
+
+        /// <summary>
+        /// Get a configuration value for the given key,
+        /// or a value generated by <paramref name="defaultValueSelector" />
+        /// if the key is not set.
+        /// </summary>
+        /// <typeparam name="T">The configuration value type.</typeparam>
+        /// <param name="key">The key.</param>
+        /// <param name="level">The configuration file into which the key should be searched for.</param>
+        /// <param name="defaultValueSelector">The selector used to generate a default value if the key is not set.</param>
+        /// <returns>The configuration value, or a generated default.</returns>
+        public virtual T GetValueOrDefault<T>(string key, ConfigurationLevel level, Func<T> defaultValueSelector)
+        {
+            return ValueOrDefault(Get<T>(key, level), defaultValueSelector);
+        }
+
+        /// <summary>
+        /// Get a configuration value for the given key parts,
+        /// or a value generated by <paramref name="defaultValueSelector" />
+        /// if the key is not set.
+        /// </summary>
+        /// <typeparam name="T">The configuration value type.</typeparam>
+        /// <param name="keyParts">The key parts.</param>
+        /// <param name="defaultValueSelector">The selector used to generate a default value if the key is not set.</param>
+        /// <returns>The configuration value, or a generated default.</returns>
+        public virtual T GetValueOrDefault<T>(string[] keyParts, Func<T> defaultValueSelector)
+        {
+            return ValueOrDefault(Get<T>(keyParts), defaultValueSelector);
+        }
+
+        /// <summary>
+        /// Get a configuration value for the given key parts,
+        /// or a value generated by <paramref name="defaultValueSelector" />
+        /// if the key is not set.
+        /// </summary>
+        /// <typeparam name="T">The configuration value type.</typeparam>
+        /// <param name="firstKeyPart">The first key part.</param>
+        /// <param name="secondKeyPart">The second key part.</param>
+        /// <param name="thirdKeyPart">The third key part.</param>
+        /// <param name="defaultValueSelector">The selector used to generate a default value if the key is not set.</param>
+        /// <returns>The configuration value, or a generated default.</returns>
+        public virtual T GetValueOrDefault<T>(string firstKeyPart, string secondKeyPart, string thirdKeyPart, Func<T> defaultValueSelector)
+        {
+            return ValueOrDefault(Get<T>(firstKeyPart, secondKeyPart, thirdKeyPart), defaultValueSelector);
+        }
+
+        private static T ValueOrDefault<T>(ConfigurationEntry<T> value, T defaultValue)
+        {
+            return value == null ? defaultValue : value.Value;
+        }
+
+        private static T ValueOrDefault<T>(ConfigurationEntry<T> value, Func<T> defaultValueSelector)
+        {
+            Ensure.ArgumentNotNull(defaultValueSelector, "defaultValueSelector");
+
+            return value == null
+                       ? defaultValueSelector()
+                       : value.Value;
+        }
+
         /// <summary>
         /// Set a configuration value for a key in the local configuration. Keys are in the form 'section.name'.
         /// <para>