Skip to content

docs: update migration package description to include NSubstitute support#751

Merged
vbreuss merged 1 commit intomainfrom
topic/migration-package-supports-nsubstitute
May 1, 2026
Merged

docs: update migration package description to include NSubstitute support#751
vbreuss merged 1 commit intomainfrom
topic/migration-package-supports-nsubstitute

Conversation

@vbreuss
Copy link
Copy Markdown
Member

@vbreuss vbreuss commented May 1, 2026 •
edited
Loading

Updates the project’s public-facing docs to reflect that the companion Mockolate.Migration package supports migrating from NSubstitute in addition to Moq.

@vbreuss vbreuss self-assigned this May 1, 2026
Copilot AI review requested due to automatic review settings May 1, 2026 20:29
@vbreuss vbreuss added the documentation Improvements or additions to documentation label May 1, 2026
Copilot AI reviewed May 1, 2026
View reviewed changes
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the project’s public-facing docs to reflect that the companion Mockolate.Migration package supports migrating from NSubstitute in addition to Moq.

Changes:

  • Update README migration blurb to mention NSubstitute support.
  • Update docs landing page (00-index) migration blurb to mention NSubstitute support.

Reviewed changes

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

File Description
README.md Updates Mockolate.Migration description to include NSubstitute migration support.
Docs/pages/00-index.md Mirrors the README wording update on the docs homepage.

@vbreuss vbreuss enabled auto-merge (squash) May 1, 2026 20:33
@sonarqubecloud
Copy link
Copy Markdown

sonarqubecloud Bot commented May 1, 2026

Quality Gate Passed Quality Gate passed

Issues
0 New issues
0 Accepted issues

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

See analysis details on SonarQube Cloud

@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 1, 2026

Test Results

    24 files  ±0      24 suites  ±0   11m 45s ⏱️ +53s
 4 086 tests ±0   4 084 ✅ ±0  2 💤 ±0  0 ❌ ±0 
26 388 runs  ±0  26 384 ✅ ±0  4 💤 ±0  0 ❌ ±0 

Results for commit 4b53d60. ± Comparison against base commit c28709e.

@vbreuss vbreuss merged commit 200d0bb into main May 1, 2026
21 checks passed
@vbreuss vbreuss deleted the topic/migration-package-supports-nsubstitute branch May 1, 2026 20:40
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 1, 2026

🚀 Benchmark Results

Details 
BenchmarkDotNet v0.15.8, Linux Ubuntu 24.04.4 LTS (Noble Numbat)

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

.NET SDK 10.0.203

[Host] : .NET 10.0.7 (10.0.7, 10.0.726.21808), X64 RyuJIT x86-64-v3


Job=InProcess  Toolchain=InProcessEmitToolchain  IterationCount=15

LaunchCount=1  WarmupCount=10
CreateMock Mean Error StdDev Ratio Allocated Alloc Ratio
baseline* 61.69 ns 0.357 ns 0.334 ns 0.99 440 B 1.00
Mockolate 62.43 ns 1.022 ns 0.956 ns 1.00 440 B 1.00
Imposter 276.23 ns 7.043 ns 6.588 ns 4.43 2248 B 5.11
TUnitMocks 40.80 ns 0.908 ns 0.849 ns 0.65 224 B 0.51
Moq 1,410.50 ns 14.696 ns 13.747 ns 22.60 2096 B 4.76
NSubstitute 1,990.27 ns 24.903 ns 23.294 ns 31.89 5048 B 11.47
FakeItEasy 1,719.34 ns 6.813 ns 6.373 ns 27.55 2763 B 6.28
Details 
BenchmarkDotNet v0.15.8, Linux Ubuntu 24.04.4 LTS (Noble Numbat)

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

.NET SDK 10.0.203

[Host] : .NET 10.0.7 (10.0.7, 10.0.726.21808), X64 RyuJIT x86-64-v3


Job=InProcess  Toolchain=InProcessEmitToolchain  IterationCount=15

LaunchCount=1  WarmupCount=10
Event Mean Error StdDev Ratio Allocated Alloc Ratio
baseline* 299.0 ns 3.71 ns 3.47 ns 0.95 1.78 KB 1.00
Mockolate 315.1 ns 4.28 ns 3.80 ns 1.00 1.78 KB 1.00
Imposter 1,381.6 ns 40.51 ns 37.90 ns 4.38 8.8 KB 4.94
TUnitMocks 207.8 ns 4.31 ns 4.03 ns 0.66 1.37 KB 0.77
Moq 15,919.1 ns 147.02 ns 114.78 ns 50.52 12.51 KB 7.02
NSubstitute 5,969.2 ns 31.48 ns 29.45 ns 18.95 9.05 KB 5.08
FakeItEasy 215,768.6 ns 951.04 ns 889.60 ns 684.80 15.26 KB 8.57
Details 
BenchmarkDotNet v0.15.8, Linux Ubuntu 24.04.4 LTS (Noble Numbat)

Intel Xeon Platinum 8370C CPU 2.80GHz, 1 CPU, 4 logical and 2 physical cores

.NET SDK 10.0.203

[Host] : .NET 10.0.7 (10.0.7, 10.0.726.21808), X64 RyuJIT x86-64-v4


Job=InProcess  Toolchain=InProcessEmitToolchain  IterationCount=15

LaunchCount=1  WarmupCount=10
Indexer N Mean Error StdDev Ratio Allocated Alloc Ratio
baseline* 1 1,012.0 ns 34.45 ns 32.23 ns 0.93 3.81 KB 1.00
Mockolate 1 1.085 μs 0.0090 μs 0.0084 μs 1.00 3.81 KB 1.00
Imposter 1 1.021 μs 0.0098 μs 0.0087 μs 0.94 5.16 KB 1.35
Moq 1 165.742 μs 0.7335 μs 0.6503 μs 152.71 20.36 KB 5.34
NSubstitute 1 9.651 μs 0.0267 μs 0.0237 μs 8.89 12.84 KB 3.37
FakeItEasy 1 11.382 μs 0.0382 μs 0.0339 μs 10.49 13.62 KB 3.57
baseline* 10 2,706.6 ns 20.48 ns 19.16 ns 0.92 4.87 KB 1.00
Mockolate 10 2.931 μs 0.0108 μs 0.0090 μs 1.00 4.87 KB 1.00
Imposter 10 2.351 μs 0.0238 μs 0.0211 μs 0.80 7.97 KB 1.64
Moq 10 176.584 μs 0.8568 μs 0.7595 μs 60.26 29.89 KB 6.14
NSubstitute 10 22.845 μs 0.0783 μs 0.0732 μs 7.80 26.13 KB 5.37
FakeItEasy 10 23.801 μs 0.2839 μs 0.2371 μs 8.12 32.98 KB 6.78
Details 
BenchmarkDotNet v0.15.8, Linux Ubuntu 24.04.4 LTS (Noble Numbat)

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

.NET SDK 10.0.203

[Host] : .NET 10.0.7 (10.0.7, 10.0.726.21808), X64 RyuJIT x86-64-v3


Job=InProcess  Toolchain=InProcessEmitToolchain  IterationCount=15

LaunchCount=1  WarmupCount=10
Method N Mean Error StdDev Ratio Allocated Alloc Ratio
baseline* 1 403.5 ns 6.72 ns 6.29 ns 1.10 2.04 KB 1.00
Mockolate 1 367.7 ns 5.67 ns 5.31 ns 1.00 2.04 KB 1.00
Imposter 1 604.3 ns 15.16 ns 14.18 ns 1.64 4.04 KB 1.98
TUnitMocks 1 707.6 ns 11.51 ns 9.61 ns 1.92 2.9 KB 1.42
Moq 1 183,680.5 ns 782.13 ns 653.11 ns 499.67 14.58 KB 7.15
NSubstitute 1 5,670.2 ns 25.52 ns 23.87 ns 15.42 9.06 KB 4.44
FakeItEasy 1 6,041.2 ns 45.23 ns 42.31 ns 16.43 8.05 KB 3.95
baseline* 10 660.5 ns 5.02 ns 4.69 ns 0.97 2.25 KB 1.00
Mockolate 10 683.8 ns 9.88 ns 9.25 ns 1.00 2.25 KB 1.00
Imposter 10 1,171.8 ns 16.11 ns 15.07 ns 1.71 5.52 KB 2.45
TUnitMocks 10 1,766.2 ns 17.46 ns 16.34 ns 2.58 4.49 KB 2.00
Moq 10 186,973.1 ns 948.09 ns 886.84 ns 273.49 18.48 KB 8.21
NSubstitute 10 8,604.4 ns 55.83 ns 52.22 ns 12.59 11.52 KB 5.12
FakeItEasy 10 9,577.9 ns 75.90 ns 67.29 ns 14.01 15.42 KB 6.85
Details 
BenchmarkDotNet v0.15.8, Linux Ubuntu 24.04.4 LTS (Noble Numbat)

AMD EPYC 9V74 2.60GHz, 1 CPU, 4 logical and 2 physical cores

.NET SDK 10.0.203

[Host] : .NET 10.0.7 (10.0.7, 10.0.726.21808), X64 RyuJIT x86-64-v3


Job=InProcess  Toolchain=InProcessEmitToolchain  IterationCount=15

LaunchCount=1  WarmupCount=10
Property N Mean Error StdDev Ratio Allocated Alloc Ratio
baseline* 1 580.5 ns 4.93 ns 4.37 ns 1.09 2.46 KB 1.00
Mockolate 1 530.3 ns 4.44 ns 3.71 ns 1.00 2.46 KB 1.00
Imposter 1 453.4 ns 9.31 ns 8.71 ns 0.85 3.13 KB 1.27
TUnitMocks 1 744.5 ns 16.40 ns 15.34 ns 1.40 2.51 KB 1.02
Moq 1 10,429.7 ns 119.11 ns 111.41 ns 19.67 10.39 KB 4.22
NSubstitute 1 7,086.7 ns 53.29 ns 47.24 ns 13.36 11.45 KB 4.65
FakeItEasy 1 7,284.3 ns 156.22 ns 146.13 ns 13.74 11.24 KB 4.57
baseline* 10 1,162.4 ns 18.17 ns 17.00 ns 1.07 2.95 KB 1.00
Mockolate 10 1,082.1 ns 12.54 ns 11.73 ns 1.00 2.95 KB 1.00
Imposter 10 1,073.5 ns 18.64 ns 17.43 ns 0.99 4.67 KB 1.58
TUnitMocks 10 2,231.4 ns 23.09 ns 21.60 ns 2.06 4.66 KB 1.58
Moq 10 17,154.6 ns 80.27 ns 75.09 ns 15.85 18.28 KB 6.19
NSubstitute 10 16,374.3 ns 79.52 ns 70.49 ns 15.13 21.08 KB 7.14
FakeItEasy 10 18,105.3 ns 98.68 ns 92.31 ns 16.73 30.81 KB 10.43
Details 
BenchmarkDotNet v0.15.8, Linux Ubuntu 24.04.4 LTS (Noble Numbat)

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

.NET SDK 10.0.203

[Host] : .NET 10.0.7 (10.0.7, 10.0.726.21808), X64 RyuJIT x86-64-v3


Job=InProcess  Toolchain=InProcessEmitToolchain  IterationCount=15

LaunchCount=1  WarmupCount=10
Callback Mean Error StdDev Ratio Allocated Alloc Ratio
baseline* 377.7 ns 7.67 ns 7.17 ns 1.12 1.68 KB 1.00
Mockolate 337.7 ns 6.92 ns 6.47 ns 1.00 1.68 KB 1.00
Imposter 440.4 ns 12.41 ns 11.61 ns 1.30 2.38 KB 1.42
TUnitMocks 635.6 ns 7.85 ns 7.34 ns 1.88 2.63 KB 1.56
Moq 98,266.7 ns 560.94 ns 497.25 ns 291.13 8.88 KB 5.29
NSubstitute 4,457.1 ns 52.42 ns 49.04 ns 13.20 7.74 KB 4.61
FakeItEasy 4,858.1 ns 38.42 ns 35.94 ns 14.39 6.81 KB 4.05

baseline* rows show the corresponding Mockolate benchmark from the most recent successful main branch build with results, for regression comparison.

@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 2, 2026

This is addressed in release v3.1.0.

@github-actions github-actions Bot added the state: released The issue is released label May 2, 2026
This was referenced May 2, 2026
Merged
Merged
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot Copilot left review comments

Assignees

@vbreuss vbreuss

Labels

documentation Improvements or additions to documentation state: released The issue is released

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@vbreuss