Add [ExcludeFromCodeCoverage] attribute to obsolete methods for improved test coverage reporting

Source/QuestPDF/Companion/Previewer.cs

@@ -1,4 +1,5 @@
 using System;
+using System.Diagnostics.CodeAnalysis;
 using System.Threading;
 using System.Threading.Tasks;
 using QuestPDF.Companion;
@@ -14,12 +15,14 @@ public static class PreviewerExtensions
     #if NET6_0_OR_GREATER
     
     [Obsolete(ObsoleteMessage)]
+    [ExcludeFromCodeCoverage]
     public static void ShowInPreviewer(this IDocument document, int port = 12500)
     {
         throw new NotImplementedException(ObsoleteMessage);
     }
     
     [Obsolete(ObsoleteMessage)]
+    [ExcludeFromCodeCoverage]
     public static Task ShowInPreviewerAsync(this IDocument document, int port = 12500, CancellationToken cancellationToken = default)
     {
         throw new NotImplementedException(ObsoleteMessage);
@@ -28,12 +31,14 @@ public static class PreviewerExtensions
     #else
 
     [Obsolete(ObsoleteMessage)]
+    [ExcludeFromCodeCoverage]
     public static void ShowInPreviewer(this IDocument document, int port = 12500)
     {
         throw new NotSupportedException(ObsoleteMessage);
     }
 
     [Obsolete(ObsoleteMessage)]
+    [ExcludeFromCodeCoverage]
     public static async Task ShowInPreviewerAsync(this IDocument document, int port = 12500, CancellationToken cancellationToken = default)
     {
         throw new NotSupportedException(ObsoleteMessage);

Source/QuestPDF/Drawing/FontManager.cs

@@ -1,5 +1,6 @@
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.IO;
 using System.Linq;
 using System.Reflection;
@@ -26,6 +27,7 @@ namespace QuestPDF.Drawing
         }
         
         [Obsolete("Since version 2022.8 this method has been renamed. Please use the RegisterFontWithCustomName method.")]
+        [ExcludeFromCodeCoverage]
         public static void RegisterFontType(string fontName, Stream stream)
         {
             RegisterFontWithCustomName(fontName, stream);

Source/QuestPDF/Fluent/ColumnExtensions.cs

@@ -1,4 +1,5 @@
 using System;
+using System.Diagnostics.CodeAnalysis;
 using QuestPDF.Elements;
 using QuestPDF.Infrastructure;
 
@@ -34,6 +35,7 @@ namespace QuestPDF.Fluent
     public static class ColumnExtensions
     {
         [Obsolete("This element has been renamed since version 2022.2. Please use the 'Column' method.")]
+        [ExcludeFromCodeCoverage]
         public static void Stack(this IContainer element, Action<ColumnDescriptor> handler)
         {
             element.Column(handler);

Source/QuestPDF/Fluent/DecorationExtensions.cs

@@ -1,4 +1,5 @@
 using System;
+using System.Diagnostics.CodeAnalysis;
 using QuestPDF.Drawing.Exceptions;
 using QuestPDF.Elements;
 using QuestPDF.Infrastructure;
@@ -93,6 +94,7 @@ namespace QuestPDF.Fluent
         #region Obsolete
 
         [Obsolete("This element has been renamed since version 2022.2. Please use the 'Before' method.")]
+        [ExcludeFromCodeCoverage]
         public IContainer Header()
         {
             var container = new Container();
@@ -101,12 +103,14 @@ namespace QuestPDF.Fluent
         }
         
         [Obsolete("This element has been renamed since version 2022.2. Please use the 'Before' method.")]
+        [ExcludeFromCodeCoverage]
         public void Header(Action<IContainer> handler)
         {
             handler?.Invoke(Header());
         }
         
         [Obsolete("This element has been renamed since version 2022.2. Please use the 'After' method.")]
+        [ExcludeFromCodeCoverage]
         public IContainer Footer()
         {
             var container = new Container();
@@ -115,6 +119,7 @@ namespace QuestPDF.Fluent
         }
         
         [Obsolete("This element has been renamed since version 2022.2. Please use the 'After' method.")]
+        [ExcludeFromCodeCoverage]
         public void Footer(Action<IContainer> handler)
         {
             handler?.Invoke(Footer());

Source/QuestPDF/Fluent/ElementExtensions.cs

@@ -1,4 +1,5 @@
 using System;
+using System.Diagnostics.CodeAnalysis;
 using System.Net.Mime;
 using System.Runtime.CompilerServices;
 using QuestPDF.Drawing.Exceptions;
@@ -271,6 +272,7 @@ namespace QuestPDF.Fluent
         }
         
         [Obsolete("This element has been renamed since version 2022.3. Please use the Hyperlink method.")]
+        [ExcludeFromCodeCoverage]
         public static IContainer ExternalLink(this IContainer element, string url)
         {
             return element.Hyperlink(url);
@@ -290,6 +292,7 @@ namespace QuestPDF.Fluent
         }
         
         [Obsolete("This element has been renamed since version 2022.3. Please use the Section method.")]
+        [ExcludeFromCodeCoverage]
         public static IContainer Location(this IContainer element, string locationName)
         {
             return element.Section(locationName);
@@ -316,6 +319,7 @@ namespace QuestPDF.Fluent
         }
         
         [Obsolete("This element has been renamed since version 2022.3. Please use the SectionLink method.")]
+        [ExcludeFromCodeCoverage]
         public static IContainer InternalLink(this IContainer element, string locationName)
         {
             return element.SectionLink(locationName);
@@ -508,6 +512,7 @@ namespace QuestPDF.Fluent
         public delegate void DrawOnCanvas(object canvas, Size availableSpace);
         
         [Obsolete(CanvasDeprecatedMessage)]
+        [ExcludeFromCodeCoverage]
         public static void Canvas(this IContainer element, DrawOnCanvas handler)
         {
             throw new NotImplementedException(CanvasDeprecatedMessage);

Source/QuestPDF/Fluent/GridExtensions.cs

@@ -1,4 +1,5 @@
 using System;
+using System.Diagnostics.CodeAnalysis;
 using QuestPDF.Elements;
 using QuestPDF.Infrastructure;
 
@@ -68,6 +69,7 @@ namespace QuestPDF.Fluent
     public static class GridExtensions
     {
         [Obsolete("This element has been deprecated since version 2022.11. Please use the Table element, or the combination of the Row and Column elements.")]
+        [ExcludeFromCodeCoverage]
         public static void Grid(this IContainer element, Action<GridDescriptor> handler)
         {
             var descriptor = new GridDescriptor();

Source/QuestPDF/Fluent/ImageExtensions.cs

@@ -1,4 +1,5 @@
 using System;
+using System.Diagnostics.CodeAnalysis;
 using System.IO;
 using QuestPDF.Drawing.Exceptions;
 using QuestPDF.Elements;
@@ -263,24 +264,28 @@ namespace QuestPDF.Fluent
         #region Obsolete
         
         [Obsolete("This element has been changed since version 2023.5. Please use the Image method overload that takes the GenerateDynamicImageDelegate as an argument.")]
+        [ExcludeFromCodeCoverage]
         public static void Image(this IContainer element, Func<Size, byte[]> imageSource)
         {
             element.Image((ImageSize x) => imageSource(new Size(x.Width, x.Height)));
         }
         
         [Obsolete("This element has been changed since version 2023.5. Please use the Image method overload that returns the ImageDescriptor object.")]
+        [ExcludeFromCodeCoverage]
         public static void Image(this IContainer parent, byte[] imageData, ImageScaling scaling)
         {
             parent.Image(imageData).ApplyScaling(scaling);
         }
         
         [Obsolete("This element has been changed since version 2023.5. Please use the Image method overload that returns the ImageDescriptor object.")]
+        [ExcludeFromCodeCoverage]
         public static void Image(this IContainer parent, string filePath, ImageScaling scaling)
         {
             parent.Image(filePath).ApplyScaling(scaling);
         }
         
         [Obsolete("This element has been changed since version 2023.5. Please use the Image method overload that returns the ImageDescriptor object.")]
+        [ExcludeFromCodeCoverage]
         public static void Image(this IContainer parent, Stream fileStream, ImageScaling scaling)
         {
             parent.Image(fileStream).ApplyScaling(scaling);

Source/QuestPDF/Fluent/PageExtensions.cs

@@ -1,4 +1,5 @@
 using System;
+using System.Diagnostics.CodeAnalysis;
 using QuestPDF.Drawing;
 using QuestPDF.Drawing.Exceptions;
 using QuestPDF.Elements;
@@ -149,7 +150,7 @@ namespace QuestPDF.Fluent
         }
         
         /// <summary>
-        /// Applies a default text style to all <see cref="TextExtensions.Text">Text</see> elements within the page set.
+        /// Applies a default text style to all <see cref="MediaTypeNames.Text">Text</see> elements within the page set.
         /// </summary>
         /// <remarks>
         /// Use this method to achieve consistent text styling across entire document.
@@ -193,6 +194,7 @@ namespace QuestPDF.Fluent
         }
         
         [Obsolete("This element has been renamed since version 2022.3. Please use the PageColor method.")]
+        [ExcludeFromCodeCoverage]
         public void Background(Color color)
         {
             PageColor(color);

Source/QuestPDF/Fluent/ShrinkExtensions.cs

@@ -1,4 +1,5 @@
 using System;
+using System.Diagnostics.CodeAnalysis;
 using QuestPDF.Elements;
 using QuestPDF.Infrastructure;
 
@@ -55,12 +56,14 @@ namespace QuestPDF.Fluent
         #region Obsolete
 
         [Obsolete("This element has been renamed since version 2022.1. Please use the Shrink method.")]
+        [ExcludeFromCodeCoverage]
         public static IContainer Box(this IContainer element)
         {
             return element.Shrink();
         }
         
         [Obsolete("This element has been renamed since version 2023.11. Please use the Shrink method.")]
+        [ExcludeFromCodeCoverage]
         public static IContainer MinimalBox(this IContainer element)
         {
             return element.Shrink();

Source/QuestPDF/Fluent/TextExtensions.cs

@@ -1,5 +1,6 @@
 using System;
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using QuestPDF.Elements;
 using QuestPDF.Elements.Text;
@@ -229,6 +230,7 @@ namespace QuestPDF.Fluent
         }
 
         [Obsolete("This element has been renamed since version 2022.3. Please use the overload that returns a TextSpanDescriptor object which allows to specify text style.")]
+        [ExcludeFromCodeCoverage]
         public void Span(string? text, TextStyle style)
         {
             Span(text).Style(style);
@@ -294,6 +296,7 @@ namespace QuestPDF.Fluent
         }
 
         [Obsolete("This element has been renamed since version 2022.3. Please use the BeginPageNumberOfSection method.")]
+        [ExcludeFromCodeCoverage]
         public void PageNumberOfLocation(string sectionName, TextStyle? style = null)
         {
             BeginPageNumberOfSection(sectionName).Style(style);
@@ -369,6 +372,7 @@ namespace QuestPDF.Fluent
         }
         
         [Obsolete("This element has been renamed since version 2022.3. Please use the SectionLink method.")]
+        [ExcludeFromCodeCoverage]
         public void InternalLocation(string? text, string locationName, TextStyle? style = null)
         {
             SectionLink(text, locationName).Style(style);
@@ -398,6 +402,7 @@ namespace QuestPDF.Fluent
         }
         
         [Obsolete("This element has been renamed since version 2022.3. Please use the Hyperlink method.")]
+        [ExcludeFromCodeCoverage]
         public void ExternalLocation(string? text, string url, TextStyle? style = null)
         {
             Hyperlink(text, url).Style(style);
@@ -464,12 +469,14 @@ namespace QuestPDF.Fluent
         }
         
         [Obsolete("This method has been deprecated since version 2022.3. Please use the overload that returns a TextSpanDescriptor object which allows to specify text style.")]
+        [ExcludeFromCodeCoverage]
         public static void Text(this IContainer element, object? text, TextStyle style)
         {
             element.Text(text).Style(style);
         }
 
         [Obsolete("This method has been deprecated since version 2022.12. Please use an overload where the text parameter is passed explicitly as a string.")]
+        [ExcludeFromCodeCoverage]
         public static TextSpanDescriptor Text(this IContainer element, object? text)
         {
             return element.Text(text?.ToString());

Source/QuestPDF/Fluent/TextSpanDescriptorExtensions.cs

@@ -1,4 +1,5 @@
 using System;
+using System.Diagnostics.CodeAnalysis;
 using QuestPDF.Helpers;
 using QuestPDF.Infrastructure;
 
@@ -17,6 +18,7 @@ namespace QuestPDF.Fluent
         }
         
         [Obsolete("This setting is not supported since the 2024.3 version. Please use the FontFamilyFallback method or rely on the new automated fallback mechanism.")]
+        [ExcludeFromCodeCoverage]
         public static T Fallback<T>(this T descriptor, TextStyle? value = null) where T : TextSpanDescriptor
         {
             descriptor.MutateTextStyle(TextStyleExtensions.Fallback, value);
@@ -24,6 +26,7 @@ namespace QuestPDF.Fluent
         }
         
         [Obsolete("This setting is not supported since the 2024.3 version. Please use the FontFamilyFallback method or rely on the new automated fallback mechanism.")]
+        [ExcludeFromCodeCoverage]
         public static T Fallback<T>(this T descriptor, Func<TextStyle, TextStyle> handler) where T : TextSpanDescriptor
         {
             return descriptor.Fallback(handler(TextStyle.Default));
@@ -89,6 +92,7 @@ namespace QuestPDF.Fluent
 
         /// <include file='../Resources/Documentation.xml' path='documentation/doc[@for="text.wrapAnywhere"]/*' />
         [Obsolete("This setting is not supported since the 2024.3 version. This flag should be handled automatically by the layout engine.")]
+        [ExcludeFromCodeCoverage]
         public static T WrapAnywhere<T>(this T descriptor, bool value = true) where T : TextSpanDescriptor
         {
             return descriptor;

Source/QuestPDF/Fluent/TextStyleExtensions.cs

@@ -1,4 +1,5 @@
 using System;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using QuestPDF.Helpers;
 using QuestPDF.Infrastructure;
@@ -9,6 +10,7 @@ namespace QuestPDF.Fluent
     public static class TextStyleExtensions
     {
         [Obsolete("This element has been renamed since version 2022.3. Please use the FontColor method.")]
+        [ExcludeFromCodeCoverage]
         public static TextStyle Color(this TextStyle style, string value)
         {
             return style.FontColor(value);
@@ -31,6 +33,7 @@ namespace QuestPDF.Fluent
         }
         
         [Obsolete("This element has been renamed since version 2022.3. Please use the FontFamily method.")]
+        [ExcludeFromCodeCoverage]
         public static TextStyle FontType(this TextStyle style, string value)
         {
             return style.FontFamily(value);
@@ -46,6 +49,7 @@ namespace QuestPDF.Fluent
         }
         
         [Obsolete("This element has been renamed since version 2022.3. Please use the FontSize method.")]
+        [ExcludeFromCodeCoverage]
         public static TextStyle Size(this TextStyle style, float value)
         {
             return style.FontSize(value);
@@ -91,6 +95,7 @@ namespace QuestPDF.Fluent
         
         /// <include file='../Resources/Documentation.xml' path='documentation/doc[@for="text.wrapAnywhere"]/*' />
         [Obsolete("This setting is not supported since the 2024.3 version. This flag should be handled automatically by the layout engine.")]
+        [ExcludeFromCodeCoverage]
         public static TextStyle WrapAnywhere(this TextStyle style, bool value = true)
         {
             return style;
@@ -279,6 +284,7 @@ namespace QuestPDF.Fluent
         #region Fallback
         
         [Obsolete("This setting is not supported since the 2024.3 version. Please use the FontFamilyFallback method or rely on the new automated fallback mechanism.")]
+        [ExcludeFromCodeCoverage]
         public static TextStyle Fallback(this TextStyle style, TextStyle? value = null)
         {
             var currentFontFamilies = style.FontFamilies ?? Array.Empty<string>();
@@ -294,6 +300,7 @@ namespace QuestPDF.Fluent
         }
         
         [Obsolete("This setting is not supported since the 2024.3 version. Please use the FontFamilyFallback method or rely on the new automated fallback mechanism.")]
+        [ExcludeFromCodeCoverage]
         public static TextStyle Fallback(this TextStyle style, Func<TextStyle, TextStyle> handler)
         {
             return style.Fallback(handler(TextStyle.Default));

Source/QuestPDF/Infrastructure/DocumentMetadata.cs

@@ -1,4 +1,5 @@
 using System;
+using System.Diagnostics.CodeAnalysis;
 
 namespace QuestPDF.Infrastructure
 {
@@ -57,6 +58,7 @@ namespace QuestPDF.Infrastructure
         #region Deprecated properties
         
         [Obsolete("This API has been moved since version 2022.9. Please use the QuestPDF.Settings.DocumentLayoutExceptionThreshold static property.")]
+        [ExcludeFromCodeCoverage]
         public int DocumentLayoutExceptionThreshold
         {
             get => Settings.DocumentLayoutExceptionThreshold;
@@ -64,6 +66,7 @@ namespace QuestPDF.Infrastructure
         }
 
         [Obsolete("This API has been moved since version 2022.9. Please use the QuestPDF.Settings.EnableCaching static property.")]
+        [ExcludeFromCodeCoverage]
         public bool ApplyCaching
         {
             get => Settings.EnableCaching;
@@ -71,6 +74,7 @@ namespace QuestPDF.Infrastructure
         }
         
         [Obsolete("This API has been moved since version 2022.9. Please use the QuestPDF.Settings.EnableDebugging static property.")]
+        [ExcludeFromCodeCoverage]
         public bool ApplyDebugging
         {
             get => Settings.EnableDebugging;
@@ -78,12 +82,15 @@ namespace QuestPDF.Infrastructure
         }
         
         [Obsolete("This API has been moved since version 2023.5. Please use the QuestPDF.Infrastructure.DocumentSettings API.")]
+        [ExcludeFromCodeCoverage]
         public int? ImageQuality { get; set; }
         
         [Obsolete("This API has been moved since version 2023.5. Please use the QuestPDF.Infrastructure.DocumentSettings API.")]
+        [ExcludeFromCodeCoverage]
         public int? RasterDpi { get; set; }
         
         [Obsolete("This API has been moved since version 2023.5. Please use the QuestPDF.Infrastructure.DocumentSettings API.")]
+        [ExcludeFromCodeCoverage]
         public bool? PdfA { get; set; }
         
         #endregion