feat: add IsParsableInto for strings

[vbreuss]

This PR adds IsParsableInto functionality for strings, allowing verification that a string can be parsed into a specific type using the .NET 8+ IParsable<T> interface.

• Introduces IsParsableInto<TType> and IsNotParsableInto<TType> extension methods for string assertions
• Adds support for culture-specific parsing via optional IFormatProvider parameter
• Provides fluent API support through Which property for chaining additional assertions on the parsed value

[Copilot]

Pull Request Overview

This PR adds IsParsableInto functionality for strings, allowing verification that a string can be parsed into a specific type using the .NET 8+ IParsable<T> interface.

• Introduces IsParsableInto<TType> and IsNotParsableInto<TType> extension methods for string assertions
• Adds support for culture-specific parsing via optional IFormatProvider parameter
• Provides fluent API support through Which property for chaining additional assertions on the parsed value

Reviewed Changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
ThatString.IsParsableInto.Tests.cs	Comprehensive test coverage for both positive and negative parsing scenarios with culture support
ThatString.IsNotParsableInto.Tests.cs	Test coverage for the negated assertion method
aweXpect_net8.0.txt	API surface updates reflecting the new public methods and result type
ThatString.IsParsableInto.cs	Core implementation of parsing assertions with constraint logic
IsParsableResult.cs	Result type enabling fluent chaining with Which property

[github-actions]

Test Results

    14 files   - 24      14 suites   - 24   2m 34s ⏱️ -28s
14 055 tests  -  3  14 053 ✅  -  3  2 💤 ±0  0 ❌ ±0 
38 958 runs   - 21  38 956 ✅  - 21  2 💤 ±0  0 ❌ ±0 

Results for commit 494add9. ± Comparison against base commit 6df2116.

This pull request removes 1497 and adds 1494 tests. Note that renamed tests count towards both.

aweXpect.Core.Tests.Core.Exceptions.FailExceptionTests ‑ Message_ShouldBeSet(message: "messageb210647b-3524-4200-9a9d-511496798453")
aweXpect.Core.Tests.Core.Exceptions.FailExceptionTests ‑ Message_ShouldBeSet(message: "messagee9896997-e83e-4545-9052-9b06a5565e10")
aweXpect.Core.Tests.Core.Exceptions.FailExceptionTests ‑ Message_ShouldBeSet(message: "messagef0e34a7a-b0cd-4322-b77e-0806b2f33a9b")
aweXpect.Core.Tests.Core.Exceptions.SkipExceptionTests ‑ Message_ShouldBeSet(message: "message013bc9a0-1f32-4842-923a-7cfd8320f9cb")
aweXpect.Core.Tests.Core.Exceptions.SkipExceptionTests ‑ Message_ShouldBeSet(message: "message3a50c675-3015-436b-ae2e-a8f6a78797d2")
aweXpect.Core.Tests.Core.Exceptions.SkipExceptionTests ‑ Message_ShouldBeSet(message: "messageeddb5d95-bf22-401f-8ffd-f2506ff4d9da")
aweXpect.Core.Tests.Equivalency.EquivalencyOptionsExtensionsTests ‑ Generic_For_IgnoringMember_ShouldSetOptionForType(memberToIgnore: "memberToIgnore46c93e34-b769-4784-a4a5-71ac576339dd")
aweXpect.Core.Tests.Equivalency.EquivalencyOptionsExtensionsTests ‑ Generic_For_IgnoringMember_ShouldSetOptionForType(memberToIgnore: "memberToIgnore4bc2dfb5-3895-4fd4-b01a-4bf3d9e75fa2")
aweXpect.Core.Tests.Equivalency.EquivalencyOptionsExtensionsTests ‑ Generic_For_IgnoringMember_ShouldSetOptionForType(memberToIgnore: "memberToIgnorefc2a2b6e-0c0a-4f1c-8d58-48755484d0a6")
aweXpect.Core.Tests.FailTests ‑ Test_ShouldThrowException(reason: "reason36aa32af-4bd9-4b0e-86f5-c6efe9c7cc7c")
…

aweXpect.Core.Tests.Core.Exceptions.FailExceptionTests ‑ Message_ShouldBeSet(message: "message7fe1a39f-175f-4ca0-bbe2-a0373a10b6ae")
aweXpect.Core.Tests.Core.Exceptions.FailExceptionTests ‑ Message_ShouldBeSet(message: "messagea76a4588-4244-483d-9057-40c79d38857a")
aweXpect.Core.Tests.Core.Exceptions.FailExceptionTests ‑ Message_ShouldBeSet(message: "messagef88143e7-0da1-4f4f-b963-66bbe61a9597")
aweXpect.Core.Tests.Core.Exceptions.SkipExceptionTests ‑ Message_ShouldBeSet(message: "message53d05acb-0748-4297-babc-afae561047f5")
aweXpect.Core.Tests.Core.Exceptions.SkipExceptionTests ‑ Message_ShouldBeSet(message: "message98d17d28-e38a-4176-8291-be30d80bc9a9")
aweXpect.Core.Tests.Core.Exceptions.SkipExceptionTests ‑ Message_ShouldBeSet(message: "messageb43a5163-ae22-4a33-878a-7b437334f8f2")
aweXpect.Core.Tests.Equivalency.EquivalencyOptionsExtensionsTests ‑ Generic_For_IgnoringMember_ShouldSetOptionForType(memberToIgnore: "memberToIgnore2ba8eb6c-8617-4fc3-a9e6-5c95156da7ed")
aweXpect.Core.Tests.Equivalency.EquivalencyOptionsExtensionsTests ‑ Generic_For_IgnoringMember_ShouldSetOptionForType(memberToIgnore: "memberToIgnore4edb5018-2a0c-4d7b-a78d-72f3989bf9d5")
aweXpect.Core.Tests.Equivalency.EquivalencyOptionsExtensionsTests ‑ Generic_For_IgnoringMember_ShouldSetOptionForType(memberToIgnore: "memberToIgnoref9608ff6-58e6-4b9b-8ccd-b36b56d1f66b")
aweXpect.Core.Tests.FailTests ‑ Test_ShouldThrowException(reason: "reason14bccee7-b05f-4eaf-9cb1-c230a85c7ae7")
…

♻️ This comment has been updated with latest results.

[github-actions]

🚀 Benchmark Results

Details

BenchmarkDotNet v0.14.0, Ubuntu 24.04.2 LTS (Noble Numbat)

AMD EPYC 7763, 1 CPU, 4 logical and 2 physical cores

.NET SDK 8.0.412

[Host] : .NET 8.0.18 (8.0.1825.31117), X64 RyuJIT AVX2
Job=InProcess  Toolchain=InProcessEmitToolchain  IterationCount=15

LaunchCount=1  WarmupCount=10

Method	Mean	Error	StdDev	Gen0	Gen1	Allocated
Bool_aweXpect	225.8 ns	3.12 ns	2.91 ns	0.0281	-	472 B
Bool_FluentAssertions	255.9 ns	5.77 ns	5.39 ns	0.0567	-	952 B
Bool_TUnit	947.6 ns	19.03 ns	17.80 ns	0.1431	-	2416 B
Equivalency_aweXpect	303,103.9 ns	2,503.31 ns	2,341.60 ns	16.6016	0.4883	284940 B
Equivalency_FluentAssertions	2,548,698.8 ns	36,608.28 ns	34,243.41 ns	273.4375	46.8750	4584416 B
Equivalency_TUnit	692,457.8 ns	4,640.36 ns	4,113.56 ns	51.7578	2.9297	866777 B
Int_GreaterThan_aweXpect	229.0 ns	2.69 ns	2.38 ns	0.0467	-	784 B
Int_GreaterThan_FluentAssertions	261.8 ns	8.73 ns	8.16 ns	0.0730	-	1224 B
Int_GreaterThan_TUnit	1,270.2 ns	18.63 ns	16.51 ns	0.1774	-	2992 B
ItemsCount_AtLeast_aweXpect	477.7 ns	7.29 ns	6.82 ns	0.0849	-	1432 B
ItemsCount_AtLeast_FluentAssertions	511.0 ns	12.79 ns	11.96 ns	0.1192	-	2008 B
ItemsCount_AtLeast_TUnit	23,329.1 ns	307.07 ns	287.24 ns	1.6174	-	27488 B
String_aweXpect	369.0 ns	5.66 ns	5.29 ns	0.0672	-	1128 B
String_FluentAssertions	505.4 ns	12.55 ns	11.73 ns	0.1287	-	2168 B
String_TUnit	1,379.2 ns	11.27 ns	9.41 ns	0.1850	-	3096 B
StringArray_aweXpect	1,378.5 ns	19.09 ns	16.92 ns	0.1640	-	2744 B
StringArray_FluentAssertions	1,402.8 ns	27.33 ns	25.57 ns	0.2480	-	4152 B
StringArray_TUnit	2,848.8 ns	39.00 ns	36.48 ns	0.2708	-	4576 B
StringArrayInAnyOrder_aweXpect	1,635.5 ns	9.08 ns	8.05 ns	0.1736	-	2920 B
StringArrayInAnyOrder_FluentAssertions	154,397.1 ns	846.18 ns	791.52 ns	3.4180	-	64324 B
StringArrayInAnyOrder_TUnit	4,810.3 ns	49.48 ns	46.28 ns	0.3967	-	6744 B

[github-actions]

👽 Mutation Results

aweXpect

Details

File	Score	Killed	Survived	Timeout	No Coverage	Ignored	Compile Errors	Total Detected	Total Undetected	Total Mutants
Results/IsParsableResult.cs	100.00%	3	0	0	0	1	0	3	0	4
That/Strings/ThatString.IsParsableInto.cs	87.10%	27	3	0	1	10	10	27	4	51

The final mutation score is 88.24%

Coverage Thresholds: high:80 low:60 break:0

aweXpect.Core

Details

File	Score	Killed	Survived	Timeout	No Coverage	Ignored	Compile Errors	Total Detected	Total Undetected	Total Mutants

The final mutation score is NaN%

Coverage Thresholds: high:80 low:60 break:0

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
94.3% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[github-actions]

This is addressed in release v2.21.0.