What's Changed

Feature: Add interface IFormattingExtensionsToggle to skip formatting (#436)

• Added the IFormattingExtensionsToggle interface to allow skipping formatting by IFormatter extensions.
• This interface is primarily used by ISource extensions that receive it with the ISelectorInfo parameter.
• By setting IFormattingExtensionsToggle.DisableFormattingExtensions to true, formatting can be skipped. This can be useful when the ISource found a value in ISource.TryEvaluateSelector where default formatting cannot reasonably be done.

Security: Update of System.Text.Json (#435)

• Bumped System.Text.Json to v8.0.4
• Fixed a vulnerability in .NET when calling the JsonSerializer.DeserializeAsyncEnumerable method against an untrusted input using System.Text.Json, which could result in Denial of Service.

Feature: Implement ISpanFormattable for DefaultFormatter (#434)

• Implemented ISpanFormattable for DefaultFormatter

• ISpanFormattable is 5% faster than IFormattable, with 24% less allocations CSharp // Performance test case Smart.FormatInto(output, null, _placeholder0005Format, 1234567.890123f, 1234567.890123f, 1234567.890123f, 1234567.890123f, 1234567.890123f); ``` BenchmarkDotNet v0.13.12, Windows 11 (10.0.22631.3737/23H2/2023Update/SunValley3) 13th Gen Intel Core i7-13700K, 1 CPU, 24 logical and 16 physical cores .NET SDK 8.0.302 [Host] : .NET 8.0.6 (8.0.624.26715), X64 RyuJIT AVX2 .NET 8.0 : .NET 8.0.6 (8.0.624.26715), X64 RyuJIT AVX2

  Job=.NET 8.0 Runtime=.NET 8.0

  Method	N	Mean	Error	StdDev	Ratio	RatioSD	Gen0	Allocated	Alloc Ratio
  ISpanFormattable	100	74.502 us	0.3693 us	0.3273 us	8.52	0.05	4.0283	62.5 KB	2.76
  IFormattable	100	77.927 us	0.5760 us	0.5388 us	8.91	0.07	5.2490	82.0 KB	3.62
  ```

Feature: ReflectionSource (#426)

• Made ReflectionSource.TypeCache static for better performance.
• Implemented a mechanism to control the size of ReflectionSource.TypeCache and remove the oldest item first.

Enhancement: DictionarySource (#426)

• Dynamics in DictionarySource now use case-sensitivity setting
• Cache for IReadOnlyDictionary now has instance scope

Refactor: Split off classes Registry and Evaluator from SmartFormatter (#424)

SmartFormatter

• Separated members for handling ISource and IFormatter extensions into internal class Registry
• Separated members for evaluating formats into internal class Evaluator
• Existing members of SmartFormatter remain unchanged and are not yet marked as obsolete

ZCharArray

• Added a lightweight, thread-safe container that rents a buffer from an ArrayPool<char> and returns it when disposed
• Simplifies passing around the buffer without intermediate memory allocations
• ZCharArray contains most frequently used methods for writing data into the underlying buffer
• Used in FormattingInfo methods (see below) for low memory allocation

FormattingInfo

Added methods useful in custom IFormatters: - public ZCharArray FormattingInfo.FormatAsSpan(IFormatProvider, Format, object?): Works like SmartFormatter.Format(...) for the specified Format - public ZCharArray FormattingInfo.FormatAsSpan(IFormatProvider, Placeholder, object?): Gets the value for the Placeholder and applies its Format - public bool TryGetValue(Placeholder, out object?): Tries to get the value for a Placeholder

Evaluator

• Internal class that supplies the methods for evaluating Placeholder and Format objects
• Contains the methods that FormattingInfo uses to evaluate Placeholder and Format objects
• Has other methods formerly included in SmartFormatter that are now moved to Evaluator
• Includes a partial class for handling events in all steps of the evaluation process

Registry

• Internal class that contains all methods for handling ISource and IFormatter extensions that have been moved from SmartFormatter

Feature: Format.HasNested checks for existing Placeholder in Items (#416)

• Added Format.HasNested property that checks Items for existing Placeholder

Test: Add unit test for nested scope (#404)

• Added unit test for nested scope

Enhancement: Ensure Format instances get returned to object pool (#402)

• Ensured that Format instances get returned to object pool

Refactor: Internal SmartFormat.Pooling classes (#401)

• Simplified pooling classes and made methods and names more consistent

Chore: Remove unused performance test projects (#398)

• Removed unused performance test projects

Fix: Returning a StringBuilder exceeding default capacity to StringBuilderPool (#397)

• Fixed an issue where returning a StringBuilder exceeding the default capacity to StringBuilderPool would throw an exception.

Refactor: Remove code duplications in SmartFormatter (#396)

• Removed code duplications in SmartFormatter
• Unified preprocessor directives

Chore: Remove redundant DependsOnTargets from SmartFormat.csproj (#394)

• Removed redundant DependsOnTargets from SmartFormat.csproj

---

Full Changelog: https://github.com/axuno/SmartFormat/compare/v3.4.0...v3.5.0