Add debugger attributes

TimmyMC · TimmyMC · commit 46e618944242 · 2026-01-30T19:32:50.000+01:00
diff --git a/Source/Common/OneOrMany{T}.cs b/Source/Common/OneOrMany{T}.cs
@@ -3,6 +3,7 @@ namespace Schema.NET;
 using System;
 using System.Collections;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using System.Runtime.CompilerServices;
@@ -12,11 +13,13 @@ namespace Schema.NET;
 /// </summary>
 /// <typeparam name="T">The type of the values.</typeparam>
 /// <seealso cref="IReadOnlyCollection{T}" />
+[DebuggerDisplay("{DebuggerDisplay,nq}")]
 [CollectionBuilder(typeof(OneOrManyBuilder), nameof(OneOrManyBuilder.Create))]
 #pragma warning disable CA1710 // Identifiers should have correct suffix.
 public readonly struct OneOrMany<T> : IReadOnlyCollection<T>, IValues, IEquatable<OneOrMany<T>>
 #pragma warning restore CA1710 // Identifiers should have correct suffix.
 {
+    [DebuggerBrowsable(DebuggerBrowsableState.RootHidden)]
     private readonly T[]? collection;
 
     /// <summary>
@@ -286,6 +289,12 @@ public bool Equals(OneOrMany<T> other)
     /// </summary>
     /// <returns>A <see cref="ReadOnlySpan{T}"/> wrapping the current items.</returns>
     public ReadOnlySpan<T> AsSpan() => this.collection.AsSpan();
+
+    /// <summary>
+    /// Gets the string to display in the debugger watches window for this instance.
+    /// </summary>
+    [DebuggerBrowsable(DebuggerBrowsableState.Never)]
+    private string DebuggerDisplay => $"Length = {this.Count}";
 }
 
 /// <summary>
diff --git a/Source/Common/Values{T1,T2,T3,T4,T5,T6,T7}.cs b/Source/Common/Values{T1,T2,T3,T4,T5,T6,T7}.cs
@@ -3,6 +3,7 @@ namespace Schema.NET;
 using System;
 using System.Collections;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Linq;
 using System.Runtime.CompilerServices;
 
@@ -16,6 +17,8 @@ namespace Schema.NET;
 /// <typeparam name="T5">The fifth type the values can take.</typeparam>
 /// <typeparam name="T6">The sixth type the values can take.</typeparam>
 /// <typeparam name="T7">The seventh type the values can take.</typeparam>
+[DebuggerDisplay("{DebuggerDisplay,nq}")]
+[DebuggerTypeProxy(typeof(IValuesDebugView))]
 [CollectionBuilder(typeof(ValuesBuilder), nameof(ValuesBuilder.Create))]
 public readonly struct Values<T1, T2, T3, T4, T5, T6, T7> : IReadOnlyCollection<object?>, IValues, IEquatable<Values<T1, T2, T3, T4, T5, T6, T7>>
 {
@@ -895,6 +898,12 @@ public bool Equals(Values<T1, T2, T3, T4, T5, T6, T7> other)
     /// </returns>
     public override int GetHashCode() =>
         HashCode.Of(this.Value1).And(this.Value2).And(this.Value3).And(this.Value4).And(this.Value5).And(this.Value6).And(this.Value7);
+
+    /// <summary>
+    /// Gets the string to display in the debugger watches window for this instance.
+    /// </summary>
+    [DebuggerBrowsable(DebuggerBrowsableState.Never)]
+    private string DebuggerDisplay => $"Length = {this.Count}";
 }
 
 public static partial class ValuesBuilder
diff --git a/Source/Common/Values{T1,T2,T3,T4,T5,T6}.cs b/Source/Common/Values{T1,T2,T3,T4,T5,T6}.cs
@@ -3,6 +3,7 @@ namespace Schema.NET;
 using System;
 using System.Collections;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Linq;
 using System.Runtime.CompilerServices;
 
@@ -15,6 +16,8 @@ namespace Schema.NET;
 /// <typeparam name="T4">The fourth type the values can take.</typeparam>
 /// <typeparam name="T5">The fifth type the values can take.</typeparam>
 /// <typeparam name="T6">The sixth type the values can take.</typeparam>
+[DebuggerDisplay("{DebuggerDisplay,nq}")]
+[DebuggerTypeProxy(typeof(IValuesDebugView))]
 [CollectionBuilder(typeof(ValuesBuilder), nameof(ValuesBuilder.Create))]
 public readonly struct Values<T1, T2, T3, T4, T5, T6> : IReadOnlyCollection<object?>, IValues, IEquatable<Values<T1, T2, T3, T4, T5, T6>>
 {
@@ -775,6 +778,12 @@ public bool Equals(Values<T1, T2, T3, T4, T5, T6> other)
     /// </returns>
     public override int GetHashCode() =>
         HashCode.Of(this.Value1).And(this.Value2).And(this.Value3).And(this.Value4).And(this.Value5).And(this.Value6);
+
+    /// <summary>
+    /// Gets the string to display in the debugger watches window for this instance.
+    /// </summary>
+    [DebuggerBrowsable(DebuggerBrowsableState.Never)]
+    private string DebuggerDisplay => $"Length = {this.Count}";
 }
 
 public static partial class ValuesBuilder
diff --git a/Source/Common/Values{T1,T2,T3,T4,T5}.cs b/Source/Common/Values{T1,T2,T3,T4,T5}.cs
@@ -3,6 +3,7 @@ namespace Schema.NET;
 using System;
 using System.Collections;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Linq;
 using System.Runtime.CompilerServices;
 
@@ -14,6 +15,8 @@ namespace Schema.NET;
 /// <typeparam name="T3">The third type the values can take.</typeparam>
 /// <typeparam name="T4">The fourth type the values can take.</typeparam>
 /// <typeparam name="T5">The fifth type the values can take.</typeparam>
+[DebuggerDisplay("{DebuggerDisplay,nq}")]
+[DebuggerTypeProxy(typeof(IValuesDebugView))]
 [CollectionBuilder(typeof(ValuesBuilder), nameof(ValuesBuilder.Create))]
 public readonly struct Values<T1, T2, T3, T4, T5> : IReadOnlyCollection<object?>, IValues, IEquatable<Values<T1, T2, T3, T4, T5>>
 {
@@ -659,6 +662,12 @@ public bool Equals(Values<T1, T2, T3, T4, T5> other)
     /// </returns>
     public override int GetHashCode() =>
         HashCode.Of(this.Value1).And(this.Value2).And(this.Value3).And(this.Value4).And(this.Value5);
+
+    /// <summary>
+    /// Gets the string to display in the debugger watches window for this instance.
+    /// </summary>
+    [DebuggerBrowsable(DebuggerBrowsableState.Never)]
+    private string DebuggerDisplay => $"Length = {this.Count}";
 }
 
 public static partial class ValuesBuilder
diff --git a/Source/Common/Values{T1,T2,T3,T4}.cs b/Source/Common/Values{T1,T2,T3,T4}.cs
@@ -3,6 +3,7 @@ namespace Schema.NET;
 using System;
 using System.Collections;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Linq;
 using System.Runtime.CompilerServices;
 
@@ -13,6 +14,8 @@ namespace Schema.NET;
 /// <typeparam name="T2">The second type the values can take.</typeparam>
 /// <typeparam name="T3">The third type the values can take.</typeparam>
 /// <typeparam name="T4">The fourth type the values can take.</typeparam>
+[DebuggerDisplay("{DebuggerDisplay,nq}")]
+[DebuggerTypeProxy(typeof(IValuesDebugView))]
 [CollectionBuilder(typeof(ValuesBuilder), nameof(ValuesBuilder.Create))]
 public readonly struct Values<T1, T2, T3, T4> : IReadOnlyCollection<object?>, IValues, IEquatable<Values<T1, T2, T3, T4>>
 {
@@ -547,6 +550,12 @@ public bool Equals(Values<T1, T2, T3, T4> other)
     /// </returns>
     public override int GetHashCode() =>
         HashCode.Of(this.Value1).And(this.Value2).And(this.Value3).And(this.Value4);
+
+    /// <summary>
+    /// Gets the string to display in the debugger watches window for this instance.
+    /// </summary>
+    [DebuggerBrowsable(DebuggerBrowsableState.Never)]
+    private string DebuggerDisplay => $"Length = {this.Count}";
 }
 
 public static partial class ValuesBuilder
diff --git a/Source/Common/Values{T1,T2,T3}.cs b/Source/Common/Values{T1,T2,T3}.cs
@@ -3,6 +3,7 @@ namespace Schema.NET;
 using System;
 using System.Collections;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Linq;
 using System.Runtime.CompilerServices;
 
@@ -12,6 +13,8 @@ namespace Schema.NET;
 /// <typeparam name="T1">The first type the values can take.</typeparam>
 /// <typeparam name="T2">The second type the values can take.</typeparam>
 /// <typeparam name="T3">The third type the values can take.</typeparam>
+[DebuggerDisplay("{DebuggerDisplay,nq}")]
+[DebuggerTypeProxy(typeof(IValuesDebugView))]
 [CollectionBuilder(typeof(ValuesBuilder), nameof(ValuesBuilder.Create))]
 public readonly struct Values<T1, T2, T3> : IReadOnlyCollection<object?>, IValues, IEquatable<Values<T1, T2, T3>>
 {
@@ -438,6 +441,12 @@ public bool Equals(Values<T1, T2, T3> other)
     /// A hash code for this instance, suitable for use in hashing algorithms and data structures like a hash table.
     /// </returns>
     public override int GetHashCode() => HashCode.Of(this.Value1).And(this.Value2).And(this.Value3);
+
+    /// <summary>
+    /// Gets the string to display in the debugger watches window for this instance.
+    /// </summary>
+    [DebuggerBrowsable(DebuggerBrowsableState.Never)]
+    private string DebuggerDisplay => $"Length = {this.Count}";
 }
 
 public static partial class ValuesBuilder
diff --git a/Source/Common/Values{T1,T2}.cs b/Source/Common/Values{T1,T2}.cs
@@ -3,6 +3,7 @@ namespace Schema.NET;
 using System;
 using System.Collections;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Linq;
 using System.Runtime.CompilerServices;
 
@@ -11,6 +12,8 @@ namespace Schema.NET;
 /// </summary>
 /// <typeparam name="T1">The first type the values can take.</typeparam>
 /// <typeparam name="T2">The second type the values can take.</typeparam>
+[DebuggerDisplay("{DebuggerDisplay,nq}")]
+[DebuggerTypeProxy(typeof(IValuesDebugView))]
 [CollectionBuilder(typeof(ValuesBuilder), nameof(ValuesBuilder.Create))]
 public readonly struct Values<T1, T2> : IReadOnlyCollection<object?>, IValues, IEquatable<Values<T1, T2>>
 {
@@ -334,6 +337,12 @@ public bool Equals(Values<T1, T2> other)
     /// A hash code for this instance, suitable for use in hashing algorithms and data structures like a hash table.
     /// </returns>
     public override int GetHashCode() => HashCode.Of(this.Value1).And(this.Value2);
+
+    /// <summary>
+    /// Gets the string to display in the debugger watches window for this instance.
+    /// </summary>
+    [DebuggerBrowsable(DebuggerBrowsableState.Never)]
+    private string DebuggerDisplay => $"Length = {this.Count}";
 }
 
 /// <summary>
diff --git a/Source/Schema.NET/IValuesDebugView.cs b/Source/Schema.NET/IValuesDebugView.cs
@@ -0,0 +1,22 @@
+﻿namespace Schema.NET;
+
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.Linq;
+
+internal sealed class IValuesDebugView
+{
+    private readonly IEnumerable<object> collection;
+
+    public IValuesDebugView(IEnumerable<object> collection)
+    {
+        ArgumentNullException.ThrowIfNull(collection);
+
+        this.collection = collection;
+    }
+
+    [DebuggerBrowsable(DebuggerBrowsableState.RootHidden)]
+    public object[] Items => this.collection.ToArray();
+}
+
