Abort formatting exception

[karljj1]

This solution addresses the issue I outlined in the GitHub discussion (#373). In scenarios where the data from a custom source may be invalid, it becomes necessary to prevent continued processing of the string, and halt any further sources, and formatters without necessarily generating an error. This is particularly useful when dealing with optional sources that may not always be used or ready yet.

This adds an exception named AbortFormattingException. When this exception is encountered during the processing of the string, it serves as a signal to cease any further processing. Additionally, the exception can optionally include text that will be inserted instead of proceeding with the regular formatting.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (245d3b0) 96% compared to head (1852f57) 96%.

Additional details and impacted files

@@         Coverage Diff         @@
##           main   #375   +/-   ##
===================================
  Coverage    96%    96%           
===================================
  Files        92     93    +1     
  Lines      3233   3241    +8     
===================================
+ Hits       3117   3125    +8     
  Misses      116    116           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.