feat: add negated char expectations with source generator

[vbreuss]

This PR introduces a source generator to simplify the creation of negated character expectations in the aweXpect assertion library. The key change is replacing manual implementation of char validation methods with source generator attributes that automatically create both positive and negative assertions.

Key changes:

• Introduces aweXpect.SourceGenerators project with attribute-based code generation for expectations
• Converts existing char validation methods (IsALetter, IsANumber, IsAnAsciiLetter, IsWhiteSpace) to use source generation
• Adds corresponding test files for the new negated expectations (IsNotALetter, IsNotANumber, etc.)

[Copilot]

Pull Request Overview

This PR introduces a source generator to simplify the creation of negated character expectations in the aweXpect assertion library. The key change is replacing manual implementation of char validation methods with source generator attributes that automatically create both positive and negative assertions.

• Introduces aweXpect.SourceGenerators project with attribute-based code generation for expectations
• Converts existing char validation methods (IsALetter, IsANumber, IsAnAsciiLetter, IsWhiteSpace) to use source generation
• Adds corresponding test files for the new negated expectations (IsNotALetter, IsNotANumber, etc.)

Reviewed Changes

Copilot reviewed 19 out of 19 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
aweXpect.sln	Adds the new SourceGenerators project to the solution
Source/aweXpect.SourceGenerators/*	Implements source generator infrastructure with attribute-based expectation creation
Source/aweXpect/That/Chars/*	Converts manual char validation implementations to source generator attributes
Tests/aweXpect.Tests/Chars/*	Adds comprehensive test coverage for new negated char expectations
Tests/aweXpect.Api.Tests/Expected/*	Updates API surface documentation to reflect new public methods
Source/aweXpect/aweXpect.csproj	References the new source generator project
Pipeline/Build.cs	Simplifies build targets (temporary change)

[github-actions]

🚀 Benchmark Results

Details

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

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

.NET SDK 8.0.414

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

LaunchCount=1  WarmupCount=10

Method	Mean	Error	StdDev	Gen0	Gen1	Allocated
Bool_aweXpect	235.1 ns	2.80 ns	2.48 ns	0.0300	-	504 B
Bool_FluentAssertions	257.0 ns	2.30 ns	2.04 ns	0.0567	-	952 B
Bool_TUnit	915.8 ns	4.94 ns	4.62 ns	0.1431	-	2408 B
Equivalency_aweXpect	301,555.8 ns	1,984.46 ns	1,759.17 ns	20.0195	0.9766	335556 B
Equivalency_FluentAssertions	2,223,508.1 ns	12,841.90 ns	12,012.32 ns	273.4375	46.8750	4584416 B
Equivalency_TUnit	694,421.7 ns	3,614.03 ns	3,380.57 ns	51.7578	2.9297	880545 B
Int_GreaterThan_aweXpect	250.7 ns	2.48 ns	2.32 ns	0.0486	-	816 B
Int_GreaterThan_FluentAssertions	256.0 ns	3.45 ns	3.22 ns	0.0730	-	1224 B
Int_GreaterThan_TUnit	1,176.8 ns	3.83 ns	3.20 ns	0.1774	-	2984 B
ItemsCount_AtLeast_aweXpect	502.3 ns	3.17 ns	2.97 ns	0.0868	-	1464 B
ItemsCount_AtLeast_FluentAssertions	498.3 ns	7.31 ns	6.84 ns	0.1192	-	2008 B
ItemsCount_AtLeast_TUnit	16,224.2 ns	102.39 ns	95.77 ns	1.6174	-	27480 B
String_aweXpect	472.5 ns	9.28 ns	8.68 ns	0.0734	-	1232 B
String_FluentAssertions	478.3 ns	10.58 ns	9.38 ns	0.1287	-	2168 B
String_TUnit	1,240.0 ns	8.07 ns	7.55 ns	0.1831	-	3072 B
StringArray_aweXpect	1,773.1 ns	8.91 ns	7.90 ns	0.1717	-	2888 B
StringArray_FluentAssertions	1,379.6 ns	6.68 ns	6.25 ns	0.2480	-	4152 B
StringArray_TUnit	3,366.3 ns	26.27 ns	24.57 ns	0.3128	-	5296 B
StringArrayInAnyOrder_aweXpect	2,247.5 ns	16.49 ns	15.42 ns	0.1831	-	3080 B
StringArrayInAnyOrder_FluentAssertions	153,581.3 ns	490.25 ns	434.59 ns	3.4180	-	63788 B
StringArrayInAnyOrder_TUnit	3,947.0 ns	44.69 ns	37.32 ns	0.3815	-	6488 B

[github-actions]

👽 Mutation Results

aweXpect

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

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

[github-actions]

Test Results

    14 files   -  16      14 suites   - 16   4m 45s ⏱️ +56s
17 720 tests +102  17 718 ✅ +102  2 💤 ±0  0 ❌ ±0 
49 824 runs  +342  49 822 ✅ +342  2 💤 ±0  0 ❌ ±0 

Results for commit aa19dc5. ± Comparison against base commit 3b87eb7.

This pull request removes 1569 and adds 1671 tests. Note that renamed tests count towards both.

aweXpect.Core.Tests.Core.Exceptions.FailExceptionTests ‑ Message_ShouldBeSet(message: "message25ed9aee-3376-49aa-b0d2-730f4e589074")
aweXpect.Core.Tests.Core.Exceptions.FailExceptionTests ‑ Message_ShouldBeSet(message: "message48311928-a4de-40fc-b8d0-6d2aca157f36")
aweXpect.Core.Tests.Core.Exceptions.FailExceptionTests ‑ Message_ShouldBeSet(message: "message625c04a1-0f39-42d4-b162-84751d005c76")
aweXpect.Core.Tests.Core.Exceptions.SkipExceptionTests ‑ Message_ShouldBeSet(message: "message591a708c-06b2-455e-899e-267842c13f61")
aweXpect.Core.Tests.Core.Exceptions.SkipExceptionTests ‑ Message_ShouldBeSet(message: "message5dc080bb-a2d2-4ddd-94b0-43713657bf62")
aweXpect.Core.Tests.Core.Exceptions.SkipExceptionTests ‑ Message_ShouldBeSet(message: "message98bb56c7-c8b1-4221-a8af-0b32e53fa173")
aweXpect.Core.Tests.FailTests ‑ Test_ShouldThrowException(reason: "reason71650922-f3b1-451c-8440-0afc8aa74f37")
aweXpect.Core.Tests.FailTests ‑ Test_ShouldThrowException(reason: "reason7eaffbc6-d9c6-4887-bdc0-5a35d991cf7d")
aweXpect.Core.Tests.FailTests ‑ Test_ShouldThrowException(reason: "reason8133f5b0-7ad8-4632-a815-a5b12520837e")
aweXpect.Core.Tests.FailTests ‑ Unless_ShouldThrowException(condition: False, reason: "reason9cae835f-edbd-4d7b-9ee8-2c0ded925508")
…

aweXpect.Core.Tests.Core.Exceptions.FailExceptionTests ‑ Message_ShouldBeSet(message: "message333600f4-eb6f-4e44-849f-1e1e064ab31d")
aweXpect.Core.Tests.Core.Exceptions.FailExceptionTests ‑ Message_ShouldBeSet(message: "messagea731685a-d20d-4e08-969d-f43698dc0fa8")
aweXpect.Core.Tests.Core.Exceptions.FailExceptionTests ‑ Message_ShouldBeSet(message: "messagedf6dfe3f-ee7f-4393-ad15-6d4791a99e7b")
aweXpect.Core.Tests.Core.Exceptions.SkipExceptionTests ‑ Message_ShouldBeSet(message: "message103989e2-61ce-4f3d-9a7b-4cc0d931bec0")
aweXpect.Core.Tests.Core.Exceptions.SkipExceptionTests ‑ Message_ShouldBeSet(message: "message4a0d3a60-d7c8-4156-9375-716cf155c9c1")
aweXpect.Core.Tests.Core.Exceptions.SkipExceptionTests ‑ Message_ShouldBeSet(message: "messagebbda1a35-67ff-407b-9702-3b6fbf13d822")
aweXpect.Core.Tests.FailTests ‑ Test_ShouldThrowException(reason: "reason2f0d80d3-f155-4429-9a44-d20d2e84b25d")
aweXpect.Core.Tests.FailTests ‑ Test_ShouldThrowException(reason: "reason8bf41054-1eed-4268-843c-09019b375f1a")
aweXpect.Core.Tests.FailTests ‑ Test_ShouldThrowException(reason: "reasona2956e32-ee07-4e70-8d45-31351ae4fb8e")
aweXpect.Core.Tests.FailTests ‑ Unless_ShouldThrowException(condition: False, reason: "reason281412b0-4995-4151-8042-325b2e46fa13")
…

♻️ This comment has been updated with latest results.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
1 Accepted issue

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

See analysis details on SonarQube Cloud

[github-actions]

This is addressed in release v2.24.0.