Soenneker.Utils.AutoBogus
2.1.289
Prefix Reserved
See the version list below for details.
dotnet add package Soenneker.Utils.AutoBogus --version 2.1.289
NuGet\Install-Package Soenneker.Utils.AutoBogus -Version 2.1.289
<PackageReference Include="Soenneker.Utils.AutoBogus" Version="2.1.289" />
paket add Soenneker.Utils.AutoBogus --version 2.1.289
#r "nuget: Soenneker.Utils.AutoBogus, 2.1.289"
// Install Soenneker.Utils.AutoBogus as a Cake Addin #addin nuget:?package=Soenneker.Utils.AutoBogus&version=2.1.289 // Install Soenneker.Utils.AutoBogus as a Cake Tool #tool nuget:?package=Soenneker.Utils.AutoBogus&version=2.1.289
Soenneker.Utils.AutoBogus
The .NET Autogenerator
This project is an automatic creator and populator for the fake data generator Bogus. It's a replacement for the abandoned AutoBogus library.
The goals:
- Be fast
- Support the latest types in .NET
It uses the fastest .NET Reflection cache: soenneker.reflection.cache. Bogus updates are automatically integrated.
.NET 6+ is supported.
Installation
dotnet add package Soenneker.Utils.AutoBogus
Usage
- Create an
AutoFaker
instance:
var optionalConfig = new AutoFakerConfig();
var autoFaker = new AutoFaker(optionalConfig);
- Call
Generate<>()
on any type you want:
var randomWord = autoFaker.Generate<string>();
var dictionary = autoFaker.Generate<Dictionary<int, string>>();
var order = autoFaker.Generate<Order>();
- It's also possible to generate types via an argument:
var randomWord = autoFaker.Generate(typeof(string));
- Set a faker, configuration, rules, etc:
autoFaker.Config.Faker = new Faker("de");
autoFaker.Config.RepeatCount = 3;
...
AutoFakerOverride
This is the recommended way for controlling type customization:
public class OrderOverride : AutoFakerOverride<Order>
{
public override void Generate(AutoFakerOverrideContext context)
{
var target = (context.Instance as Order)!;
target.Id = 123;
// Faker is available
target.Name = context.Faker.Random.Word();
// AutoFaker is also available
target.Customer = context.AutoFaker.Generate<Customer>();
}
}
Then just add AutoFakerOverride
to the AutoFaker.Config
instance:
autoFaker.Config.Overrides = new List<AutoFakerGeneratorOverride>();
autoFaker.Config.Overrides.Add(new OrderOverride());
AutoFaker<T>
This inherits from Bogus.Faker
, and can be used to designate rules specific to the AutoFaker
instance.
var autoFaker = new AutoFaker<Order>();
autoFaker.RuleFor(x => x.Id, f => f.Random.Number());
var order = autoFaker.Generate();
Tips
- ⚠️ Instantiating an
AutoFaker
takes a non-trivial amount of time because of BogusFaker
initialization (almost 1ms). It's recommended that a single instance be used if possible. AutoFaker.GenerateStatic<T>()
is also available, but should be avoided (as it creates a newAutoFaker
/Faker
on each call).
Notes
- Some patterns that existed in AutoBogus have been removed due to the complexity and performance impact.
- This is a work in progress. Contribution is welcomed.
Benchmarks
Soenneker.Utils.AutoBogus - AutoFaker
Method | Mean | Error | StdDev |
---|---|---|---|
Generate_int | 79.40 ns | 0.635 ns | 0.563 ns |
Generate_string | 241.35 ns | 3.553 ns | 3.324 ns |
Generate_complex | 6,782.34 ns | 43.811 ns | 38.837 ns |
Soenneker.Utils.AutoBogus - AutoFaker<T>
Method | Mean | Error | StdDev |
---|---|---|---|
Generate_string | 283.6 ns | 3.28 ns | 3.07 ns |
Generate_complex | 8,504.0 ns | 76.58 ns | 67.89 ns |
AutoBogus
Method | Mean | Error | StdDev |
---|---|---|---|
Generate_int | 1.17 ms | 0.033 ms | 0.026 ms |
Generate_complex | 10.91 ms | 0.181 ms | 0.236 ms |
Bogus
Method | Mean | Error | StdDev |
---|---|---|---|
Bogus_int | 19.70 ns | 0.176 ns | 0.165 ns |
Bogus_string | 171.75 ns | 2.763 ns | 2.585 ns |
Bogus_ctor | 730,669.06 ns | 8,246.622 ns | 7,310.416 ns |
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 is compatible. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net6.0
- Bogus (>= 35.6.0)
- Soenneker.Extensions.FieldInfo (>= 2.1.15)
- Soenneker.Extensions.MemberInfo (>= 2.1.15)
- Soenneker.Reflection.Cache (>= 2.1.166)
- System.Collections.Immutable (>= 8.0.0)
-
net7.0
- Bogus (>= 35.6.0)
- Soenneker.Extensions.FieldInfo (>= 2.1.15)
- Soenneker.Extensions.MemberInfo (>= 2.1.15)
- Soenneker.Reflection.Cache (>= 2.1.166)
- System.Collections.Immutable (>= 8.0.0)
-
net8.0
- Bogus (>= 35.6.0)
- Soenneker.Extensions.FieldInfo (>= 2.1.15)
- Soenneker.Extensions.MemberInfo (>= 2.1.15)
- Soenneker.Reflection.Cache (>= 2.1.166)
- System.Collections.Immutable (>= 8.0.0)
NuGet packages (6)
Showing the top 5 NuGet packages that depend on Soenneker.Utils.AutoBogus:
Package | Downloads |
---|---|
Soenneker.Tests.Unit
A base test providing faker and autofaker capabilities |
|
Soenneker.Fixtures.Unit
A base xUnit fixture providing injectable log output, DI mechanisms like IServiceCollection and ServiceProvider, and AutoFaker/Faker for generating test data. |
|
Soenneker.AutoFaker.Overrides.IdNamePair
An AutoFaker (AutoBogus) override for the DTO IdNamePair |
|
Soenneker.Utils.AutoBogus.Moq
An AutoFakerBinder for interfaces and abstract objects using Moq |
|
Soenneker.Utils.AutoBogus.NSubstitute
An AutoFakerBinder for interfaces and abstract objects using NSubstitute |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
2.1.354 | 0 | 9/26/2024 |
2.1.353 | 1 | 9/26/2024 |
2.1.351 | 3,299 | 9/26/2024 |
2.1.350 | 1,906 | 9/25/2024 |
2.1.349 | 34 | 9/25/2024 |
2.1.348 | 36 | 9/25/2024 |
2.1.347 | 4,016 | 9/23/2024 |
2.1.346 | 1,934 | 9/23/2024 |
2.1.345 | 1,790 | 9/23/2024 |
2.1.344 | 69 | 9/23/2024 |
2.1.343 | 103 | 9/23/2024 |
2.1.342 | 3,621 | 9/23/2024 |
2.1.341 | 64 | 9/23/2024 |
2.1.340 | 72 | 9/23/2024 |
2.1.339 | 1,294 | 9/23/2024 |
2.1.338 | 63 | 9/23/2024 |
2.1.337 | 1,379 | 9/22/2024 |
2.1.336 | 5,319 | 9/17/2024 |
2.1.335 | 68 | 9/17/2024 |
2.1.334 | 3,187 | 9/17/2024 |
2.1.333 | 2,064 | 9/17/2024 |
2.1.332 | 72 | 9/17/2024 |
2.1.331 | 64 | 9/17/2024 |
2.1.330 | 121 | 9/17/2024 |
2.1.328 | 15,031 | 9/12/2024 |
2.1.327 | 2,578 | 9/11/2024 |
2.1.326 | 881 | 9/11/2024 |
2.1.325 | 2,626 | 9/11/2024 |
2.1.324 | 87 | 9/11/2024 |
2.1.323 | 6,833 | 9/10/2024 |
2.1.322 | 1,196 | 9/10/2024 |
2.1.320 | 2,083 | 9/9/2024 |
2.1.319 | 1,310 | 9/9/2024 |
2.1.318 | 1,777 | 9/9/2024 |
2.1.317 | 4,962 | 9/9/2024 |
2.1.316 | 82 | 9/9/2024 |
2.1.315 | 2,753 | 9/9/2024 |
2.1.314 | 3,751 | 9/6/2024 |
2.1.313 | 2,906 | 9/6/2024 |
2.1.312 | 2,010 | 9/5/2024 |
2.1.311 | 90 | 9/5/2024 |
2.1.310 | 382 | 9/5/2024 |
2.1.309 | 78 | 9/5/2024 |
2.1.308 | 1,608 | 9/5/2024 |
2.1.307 | 81 | 9/5/2024 |
2.1.306 | 92 | 9/5/2024 |
2.1.305 | 83 | 9/5/2024 |
2.1.304 | 88 | 9/5/2024 |
2.1.303 | 92 | 9/5/2024 |
2.1.302 | 6,071 | 9/4/2024 |
2.1.301 | 1,030 | 9/4/2024 |
2.1.300 | 4,268 | 9/3/2024 |
2.1.299 | 2,597 | 9/3/2024 |
2.1.298 | 3,002 | 9/3/2024 |
2.1.297 | 421 | 9/2/2024 |
2.1.296 | 4,219 | 8/29/2024 |
2.1.295 | 3,197 | 8/25/2024 |
2.1.294 | 4,243 | 8/21/2024 |
2.1.293 | 93 | 8/21/2024 |
2.1.292 | 94 | 8/21/2024 |
2.1.291 | 923 | 8/20/2024 |
2.1.290 | 108 | 8/20/2024 |
2.1.289 | 848 | 8/20/2024 |
2.1.288 | 108 | 8/20/2024 |
2.1.287 | 1,889 | 8/20/2024 |
2.1.286 | 95 | 8/20/2024 |
2.1.285 | 94 | 8/20/2024 |
2.1.284 | 6,063 | 8/19/2024 |
2.1.283 | 5,994 | 8/13/2024 |
2.1.282 | 7,890 | 8/6/2024 |
2.1.281 | 980 | 8/6/2024 |
2.1.280 | 3,841 | 8/1/2024 |
2.1.279 | 2,895 | 7/31/2024 |
2.1.278 | 4,660 | 7/25/2024 |
2.1.277 | 67 | 7/25/2024 |
2.1.276 | 1,859 | 7/24/2024 |
2.1.275 | 628 | 7/24/2024 |
2.1.274 | 8,783 | 7/19/2024 |
2.1.273 | 3,545 | 7/14/2024 |
2.1.272 | 1,855 | 7/14/2024 |
2.1.271 | 4,804 | 7/10/2024 |
2.1.270 | 2,547 | 7/10/2024 |
2.1.269 | 890 | 7/10/2024 |
2.1.268 | 85 | 7/10/2024 |
2.1.267 | 404 | 7/10/2024 |
2.1.266 | 598 | 7/10/2024 |
2.1.265 | 91 | 7/10/2024 |
2.1.264 | 1,627 | 7/9/2024 |
2.1.261 | 155 | 7/9/2024 |
2.1.260 | 4,628 | 7/9/2024 |
2.1.259 | 3,225 | 7/9/2024 |
2.1.258 | 89 | 7/9/2024 |
2.1.257 | 661 | 7/9/2024 |
2.1.256 | 97 | 7/9/2024 |
2.1.255 | 1,707 | 7/9/2024 |
2.1.254 | 87 | 7/9/2024 |
2.1.253 | 2,399 | 7/9/2024 |
2.1.252 | 94 | 7/9/2024 |
2.1.251 | 548 | 7/9/2024 |
2.1.249 | 98 | 7/8/2024 |
2.1.248 | 106 | 7/8/2024 |
2.1.247 | 92 | 7/8/2024 |
2.1.246 | 603 | 7/8/2024 |
2.1.245 | 106 | 7/8/2024 |
2.1.244 | 96 | 7/8/2024 |
2.1.243 | 6,066 | 7/7/2024 |
2.1.242 | 1,061 | 7/7/2024 |
2.1.241 | 1,029 | 7/7/2024 |
2.1.240 | 580 | 7/7/2024 |
2.1.239 | 8,377 | 7/3/2024 |
2.1.238 | 826 | 7/3/2024 |
2.1.237 | 7,636 | 6/21/2024 |
2.1.236 | 3,658 | 6/15/2024 |
2.1.235 | 1,608 | 6/15/2024 |
2.1.234 | 7,761 | 6/1/2024 |
2.1.233 | 320 | 6/1/2024 |
2.1.232 | 95 | 6/1/2024 |
2.1.231 | 2,557 | 6/1/2024 |
2.1.230 | 2,959 | 5/31/2024 |
2.1.229 | 2,713 | 5/29/2024 |
2.1.228 | 95 | 5/29/2024 |
2.1.227 | 2,916 | 5/28/2024 |
2.1.226 | 81 | 5/28/2024 |
2.1.225 | 2,010 | 5/27/2024 |
2.1.224 | 91 | 5/27/2024 |
2.1.223 | 3,888 | 5/26/2024 |
2.1.221 | 2,569 | 5/26/2024 |
2.1.220 | 94 | 5/26/2024 |
2.1.219 | 1,775 | 5/25/2024 |
2.1.218 | 86 | 5/25/2024 |
2.1.215 | 874 | 5/25/2024 |
2.1.214 | 93 | 5/25/2024 |
2.1.213 | 2,701 | 5/25/2024 |
2.1.212 | 91 | 5/25/2024 |
2.1.211 | 90 | 5/25/2024 |
2.1.210 | 122 | 5/25/2024 |
2.1.208 | 12,122 | 5/23/2024 |
2.1.207 | 155 | 5/23/2024 |
2.1.206 | 93 | 5/23/2024 |
2.1.205 | 1,280 | 5/23/2024 |
2.1.204 | 96 | 5/23/2024 |
2.1.203 | 1,337 | 5/22/2024 |
2.1.202 | 106 | 5/22/2024 |
2.1.201 | 95 | 5/22/2024 |
2.1.200 | 95 | 5/22/2024 |
2.1.199 | 2,394 | 5/22/2024 |
2.1.197 | 595 | 5/22/2024 |
2.1.196 | 4,682 | 5/17/2024 |
2.1.195 | 1,792 | 5/17/2024 |
2.1.194 | 5,517 | 5/14/2024 |
2.1.193 | 111 | 5/14/2024 |
2.1.192 | 3,224 | 5/12/2024 |
2.1.191 | 7,211 | 4/29/2024 |
2.1.190 | 129 | 4/29/2024 |
2.1.189 | 115 | 4/29/2024 |
2.1.188 | 480 | 4/29/2024 |
2.1.187 | 97 | 4/29/2024 |
2.1.186 | 3,119 | 4/28/2024 |
2.1.185 | 108 | 4/28/2024 |
2.1.184 | 2,116 | 4/28/2024 |
2.1.183 | 835 | 4/28/2024 |
2.1.182 | 2,322 | 4/28/2024 |
2.1.181 | 91 | 4/28/2024 |
2.1.180 | 94 | 4/28/2024 |
2.1.179 | 1,575 | 4/28/2024 |
2.1.178 | 125 | 4/27/2024 |
2.1.177 | 83 | 4/27/2024 |
2.1.176 | 5,906 | 4/19/2024 |
2.1.175 | 2,142 | 4/18/2024 |
2.1.174 | 4,205 | 4/12/2024 |
2.1.173 | 1,704 | 4/12/2024 |
2.1.172 | 561 | 4/12/2024 |
2.1.171 | 425 | 4/12/2024 |
2.1.170 | 95 | 4/12/2024 |
2.1.169 | 112 | 4/12/2024 |
2.1.168 | 2,049 | 4/12/2024 |
2.1.167 | 107 | 4/12/2024 |
2.1.166 | 120 | 4/12/2024 |
2.1.165 | 94 | 4/12/2024 |
2.1.164 | 87 | 4/12/2024 |
2.1.163 | 5,998 | 4/9/2024 |
2.1.162 | 3,265 | 4/1/2024 |
2.1.161 | 108 | 4/1/2024 |
2.1.160 | 6,727 | 3/25/2024 |
2.1.159 | 96 | 3/25/2024 |
2.1.158 | 2,322 | 3/20/2024 |
2.1.157 | 2,124 | 3/19/2024 |
2.1.156 | 1,218 | 3/19/2024 |
2.1.155 | 3,327 | 3/15/2024 |
2.1.154 | 2,104 | 3/13/2024 |
2.1.153 | 872 | 3/13/2024 |
2.1.152 | 383 | 3/13/2024 |
2.1.151 | 115 | 3/13/2024 |
2.1.150 | 106 | 3/13/2024 |
2.1.149 | 113 | 3/13/2024 |
2.1.148 | 130 | 3/13/2024 |
2.1.147 | 2,745 | 3/12/2024 |
2.1.146 | 3,457 | 3/11/2024 |
2.1.145 | 111 | 3/11/2024 |
2.1.144 | 1,264 | 3/11/2024 |
2.1.143 | 1,744 | 3/9/2024 |
2.1.142 | 1,959 | 3/8/2024 |
2.1.141 | 1,289 | 3/8/2024 |
2.1.140 | 2,844 | 3/6/2024 |
2.1.139 | 119 | 3/6/2024 |
2.1.138 | 1,977 | 3/4/2024 |
2.1.137 | 102 | 3/4/2024 |
2.1.136 | 2,701 | 3/2/2024 |
2.1.135 | 1,219 | 3/2/2024 |
2.1.134 | 109 | 3/2/2024 |
2.1.133 | 1,548 | 3/2/2024 |
2.1.132 | 822 | 3/2/2024 |
2.1.131 | 1,792 | 2/29/2024 |
2.1.130 | 1,522 | 2/29/2024 |
2.1.129 | 1,798 | 2/26/2024 |
2.1.128 | 1,593 | 2/25/2024 |
2.1.127 | 104 | 2/25/2024 |
2.1.126 | 2,183 | 2/23/2024 |
2.1.125 | 1,806 | 2/22/2024 |
2.1.124 | 1,109 | 2/21/2024 |
2.1.123 | 1,429 | 2/21/2024 |
2.1.122 | 342 | 2/21/2024 |
2.1.121 | 340 | 2/21/2024 |
2.1.120 | 110 | 2/21/2024 |
2.1.119 | 1,338 | 2/21/2024 |
2.1.118 | 110 | 2/21/2024 |
2.1.117 | 109 | 2/21/2024 |
2.1.116 | 660 | 2/21/2024 |
2.1.115 | 1,018 | 2/21/2024 |
2.1.114 | 116 | 2/21/2024 |
2.1.113 | 111 | 2/21/2024 |
2.1.112 | 111 | 2/21/2024 |
2.1.111 | 813 | 2/21/2024 |
2.1.110 | 111 | 2/21/2024 |
2.1.109 | 2,660 | 2/20/2024 |
2.1.108 | 104 | 2/20/2024 |
2.1.107 | 2,639 | 2/19/2024 |
2.1.106 | 298 | 2/19/2024 |
2.1.104 | 2,887 | 2/17/2024 |
2.1.103 | 1,438 | 2/16/2024 |
2.1.102 | 96 | 2/16/2024 |
2.1.101 | 727 | 2/16/2024 |
2.1.100 | 1,196 | 2/16/2024 |
2.1.99 | 104 | 2/16/2024 |
2.1.98 | 100 | 2/16/2024 |
2.1.97 | 729 | 2/16/2024 |
2.1.96 | 103 | 2/16/2024 |
2.1.95 | 97 | 2/16/2024 |
2.1.94 | 1,444 | 2/16/2024 |
2.1.93 | 103 | 2/16/2024 |
2.1.92 | 2,120 | 2/13/2024 |
2.1.91 | 2,122 | 2/13/2024 |
2.1.90 | 818 | 2/13/2024 |
2.1.89 | 102 | 2/13/2024 |
2.1.88 | 684 | 2/13/2024 |
2.1.87 | 2,097 | 2/11/2024 |
2.1.86 | 808 | 2/11/2024 |
2.1.85 | 117 | 2/11/2024 |
2.1.84 | 1,517 | 2/11/2024 |
2.1.83 | 111 | 2/11/2024 |
2.1.82 | 1,126 | 2/11/2024 |
2.1.81 | 111 | 2/11/2024 |
2.1.80 | 100 | 2/11/2024 |
2.1.79 | 113 | 2/11/2024 |
2.1.78 | 110 | 2/11/2024 |
2.1.76 | 2,432 | 2/9/2024 |
2.1.75 | 110 | 2/9/2024 |
2.1.74 | 1,502 | 2/9/2024 |
2.1.73 | 120 | 2/9/2024 |
2.1.72 | 979 | 2/8/2024 |
2.1.71 | 114 | 2/8/2024 |
2.1.70 | 111 | 2/8/2024 |
2.1.69 | 477 | 2/8/2024 |
2.1.68 | 1,137 | 2/8/2024 |
2.1.67 | 114 | 2/8/2024 |
2.1.66 | 108 | 2/8/2024 |
2.1.65 | 1,138 | 2/8/2024 |
2.1.64 | 103 | 2/8/2024 |
2.1.63 | 805 | 2/8/2024 |
2.1.62 | 2,128 | 2/7/2024 |
2.1.61 | 1,090 | 2/6/2024 |
2.1.60 | 117 | 2/6/2024 |
2.1.59 | 1,398 | 2/6/2024 |
2.1.58 | 116 | 2/6/2024 |
2.1.57 | 885 | 2/6/2024 |
2.1.54 | 113 | 2/5/2024 |
2.1.53 | 112 | 2/5/2024 |
2.1.52 | 2,884 | 2/4/2024 |
2.1.51 | 1,307 | 2/2/2024 |
2.1.49 | 103 | 2/1/2024 |
2.1.48 | 1,704 | 1/31/2024 |
2.1.47 | 1,372 | 1/29/2024 |
2.1.46 | 1,380 | 1/29/2024 |
2.1.45 | 641 | 1/29/2024 |
2.1.44 | 865 | 1/28/2024 |
2.1.43 | 102 | 1/28/2024 |
2.1.42 | 889 | 1/28/2024 |
2.1.41 | 87 | 1/28/2024 |
2.1.40 | 103 | 1/28/2024 |
2.1.39 | 739 | 1/28/2024 |
2.1.38 | 946 | 1/28/2024 |
2.1.37 | 709 | 1/28/2024 |
2.1.36 | 89 | 1/28/2024 |
2.1.35 | 99 | 1/28/2024 |
2.1.34 | 100 | 1/28/2024 |
2.1.33 | 929 | 1/27/2024 |
2.1.31 | 321 | 1/27/2024 |
2.1.30 | 1,060 | 1/27/2024 |
2.1.29 | 981 | 1/27/2024 |
2.1.27 | 533 | 1/27/2024 |
2.1.26 | 1,028 | 1/27/2024 |
2.1.25 | 728 | 1/26/2024 |
2.1.24 | 101 | 1/26/2024 |
2.1.23 | 103 | 1/26/2024 |
2.1.22 | 90 | 1/26/2024 |
2.1.21 | 688 | 1/26/2024 |
2.1.20 | 667 | 1/26/2024 |
2.1.19 | 735 | 1/26/2024 |
2.1.18 | 725 | 1/26/2024 |
2.1.17 | 822 | 1/26/2024 |
2.1.16 | 798 | 1/26/2024 |
2.1.15 | 321 | 1/25/2024 |
2.1.14 | 893 | 1/25/2024 |
2.1.13 | 873 | 1/25/2024 |
2.1.12 | 101 | 1/25/2024 |
2.1.11 | 792 | 1/25/2024 |
2.1.10 | 749 | 1/25/2024 |
2.1.9 | 818 | 1/25/2024 |
2.1.7 | 5,203 | 1/15/2024 |
2.1.6 | 1,186 | 1/14/2024 |
2.1.5 | 1,464 | 1/14/2024 |
2.1.4 | 1,387 | 1/13/2024 |
2.1.3 | 1,395 | 1/5/2024 |
2.1.2 | 139 | 1/2/2024 |
2.1.1 | 155 | 12/29/2023 |