Feature/get debug view value processing

src/libraries/Microsoft.Extensions.Configuration.Abstractions/ref/Microsoft.Extensions.Configuration.Abstractions.cs

@@ -32,6 +32,15 @@ public static partial class ConfigurationPath
  public static partial class ConfigurationRootExtensions
  {
  public static string GetDebugView(this Microsoft.Extensions.Configuration.IConfigurationRoot root) { throw null; }
+ public static string GetDebugView(this IConfigurationRoot root, System.Func<ConfigurationDebugViewContext, string>? processValue) { throw null; }
+ }
+ public readonly partial struct ConfigurationDebugViewContext
+ {
+ public ConfigurationDebugViewContext(string path, string key, string? value, IConfigurationProvider configurationProvider) { throw null; }
+ public string Path { get; }
+ public string Key { get; }
+ public string? Value { get; }
+ public IConfigurationProvider ConfigurationProvider { get; }
  }
  public partial interface IConfiguration
  {

src/libraries/Microsoft.Extensions.Configuration.Abstractions/src/ConfigurationDebugViewContext.cs

@@ -0,0 +1,39 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespace Microsoft.Extensions.Configuration
+{
+ /// <summary>
+ /// Configuration debug view context provides the data about current item of the configuration
+ /// </summary>
+ public readonly struct ConfigurationDebugViewContext
+ {
+ public ConfigurationDebugViewContext(string path, string key, string? value, IConfigurationProvider configurationProvider)
+ {
+ Path = path;
+ Key = key;
+ Value = value;
+ ConfigurationProvider = configurationProvider;
+ }
+
+ /// <summary>
+ /// Path of the current item
+ /// </summary>
+ public string Path { get; }
+
+ /// <summary>
+ /// Key of the current item
+ /// </summary>
+ public string Key { get; }
+
+ /// <summary>
+ /// Value of the current item
+ /// </summary>
+ public string? Value { get; }
+
+ /// <summary>
+ /// Provider used to get the value of the current item
+ /// </summary>
+ public IConfigurationProvider ConfigurationProvider { get; }
+ }
+}

src/libraries/Microsoft.Extensions.Configuration.Abstractions/src/ConfigurationRootExtensions.cs

@@ -1,6 +1,7 @@
 // Licensed to the .NET Foundation under one or more agreements.
 // The .NET Foundation licenses this file to you under the MIT license.
 
+using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Text;
@@ -17,6 +18,22 @@ public static class ConfigurationRootExtensions
  /// </summary>
  /// <returns> The debug view. </returns>
  public static string GetDebugView(this IConfigurationRoot root)
+ {
+ return GetDebugView(root, null);
+ }
+
+ /// <summary>
+ /// Generates a human-readable view of the configuration showing where each value came from.
+ /// </summary>
+ /// <param name="root">Configuration root</param>
+ /// <param name="processValue">
+ /// Function for processing the value e.g. hiding secrets
+ /// Parameters:
+ /// ConfigurationDebugViewContext: Context of the current configuration item
+ /// returns: Value is used to assign as the Value of the configuration section
+ /// </param>
+ /// <returns> The debug view. </returns>
+ public static string GetDebugView(this IConfigurationRoot root, Func<ConfigurationDebugViewContext, string>? processValue)
  {
  void RecurseChildren(
  StringBuilder stringBuilder,
@@ -29,11 +46,15 @@ void RecurseChildren(
 
  if (valueAndProvider.Provider != null)
  {
+ string? value = processValue != null
+ ? processValue(new ConfigurationDebugViewContext(child.Key, child.Path, valueAndProvider.Value, valueAndProvider.Provider))
+ : valueAndProvider.Value;
+
  stringBuilder
  .Append(indent)
  .Append(child.Key)
  .Append('=')
- .Append(valueAndProvider.Value)
+ .Append(value)
  .Append(" (")
  .Append(valueAndProvider.Provider)
  .AppendLine(")");