Bogus 6.1.1

A simple and sane data generator for populating objects that supports different locales. A delightful port of the famed faker.js and inspired by FluentValidation. Use it to create and load databases and UIs with mockup data. Get started by using Faker class or a DataSet directly.

There is a newer version of this package available.
See the version list below for details.
Install-Package Bogus -Version 6.1.1
dotnet add package Bogus --version 6.1.1
<PackageReference Include="Bogus" Version="6.1.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Bogus --version 6.1.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Release Notes

## v6.1.1
* Roll-up Release for .NET Framework since v4.0.1.
* CoreCLR users please continue using latest beta release until CoreCLR is RTM.

## v6.1.1-beta-1
* Fixed index out of bounds bug in faker.Random.Word().
* Commerce.Department output may have changed as a result of this fix.

## v5.1.1-beta-3
* Removed RuleFor(x = x.Prop, constantValue), was confusing the API.
* Added 0-arity RuleFor(x = x.Prop, () =&gt; someValue)

## v5.1.1-beta-2
* Make f.UniqueIndex as int for convenience.
* Use generic RuleFor(x = x.Prop, constantValue).

## v5.1.1-beta-1
* New RuleFor(x = x.Prop, constantValue)
* Support for Hashids.net: RuleFor(x = x.Id, f = f.Hashids.Encode())
* New f.UniqueIndex, useful for composing property values that require uniqueness.

## v5.0.1
* Roll-up Release for .NET Framework since v4.0.1.
* CoreCLR users please continue using latest beta release until CoreCLR is RTM.

## v5.0.1-beta-2
* JvanderStad PR15: Lazy load Person. Avoids extra Seed.Next calls that may interfere with seeded content.
* JvanderStad PR16: Better address generation. Respects locale address formats.
* Added &quot;dotnet5.4&quot; moniker support.
* BREAKING: Fake &quot;seeded&quot; data generated by Bogus may be different from previous versions.

## v4.0.1
* Roll-up Release for .NET Framework since v3.0.6.
* CoreCLR users please continue using latest beta release until CoreCLR is RTM.

## v4.0.1-beta-1
* Bogus - Feature parity with faker.js.
* System module added. Generate random file names and extensions.
* Randomizer - Added Uuid().
* Locales Updated: en_GB, sv, sk, de_CH, en.
* Locales Added: id_ID, el, lv.
* Prevent apostrophes in return value of Internet.DomainWords
* Added more parameters for Image data set.
* BREAKING API METHODS:
* Lorem - Better API methods: Seeded tests based on &quot;content&quot; will fail due to upgrade.

## v3.0.6
* Roll-up Release for .NET Framework since v3.0.5.
* CoreCLR users please continue using latest beta release until CoreCLR is RTM.

## v3.0.6-beta-1
* Issue #13: Fixed StrictMode to exclude private fields.
* New Feature: Ignore property or field in StrictMode: Faker[Order].Ignore(o =&gt; o.OrderId).
* CoreCLR users please continue using latest beta release until CoreCLR is RTM.

## v3.0.5
* Roll-up Release for .NET Framework since v3.0.4.
* CoreCLR users please continue using latest beta release until CoreCLR is RTM.

## v3.0.5-beta-4
* Issue #13: StrictMode() now ignores read-only properties.
* Newtonsoft.Json v8 compatibility.
* CoreCLR users please continue using latest beta release until CoreCLR is RTM.

## v3.0.5-beta-3
* Issue #12: Make Bogus thread-safe on Generate() and DataSets. Avoids threading issues in test runners.
* CoreCLR users please continue using latest beta release until CoreCLR is RTM.

## v3.0.5-beta-2
* CoreCLR support (CoreCLR users please continue using latest beta release until CoreCLR is RTM.).

## v3.0.4
* Issue 10: Make Bogus work with fields also, not just properties. Fixes LINQPad issues.

## v3.0.3
* PR 9: quantumplation - Fixed typo in Lorem.Sentance() -&gt; Lorem.Sentence()

## v3.0.2
* Generate US: SSN - Social Security Numbers.
* Generate Canada: SIN - Social Insurance Numbers.
* Generate Brazil: Cadastro de Pessoas Fisicas - CPF Numbers.
* Generate Finland: Henkilotunnus - Person ID numbers
* Generate Denmark: Det Centrale Personregister - Person ID numbers.
* Allow exclude values on Randomizer.Enum.
* Randomizer.Replace accepts &apos;*&apos; replace with letter or digit.
* Added Lorem.Letter(num).
* Can switch locale on Name: f.Name[&quot;en&quot;].LastName()

## v3.0.1
* Added debug symbols to symbolsource.org.
* PR#6: Fixed lastname and empty list exception -salixzs
* Switch to semantic versioning at par with FakerJS.

## v3.0.0.4
* Adding generators: Date.Month(), Date.Weekday()
* Sentences using lexically correct &quot;A foo bar.&quot;
* Added Spanish Mexico (es_MX) locale.

## v3.0.0.3
* Issue #2: Use latest Newtonsoft.Json 7.0.0.0 -Mpdreamz

## v3.0.0.2
* Includes Ireland (English) locale.

## v3.0.0.1
* Migrated to new FakerJS datafile format. Build system uses gulp file to directly import FakerJS locales.
* Faker.Parse() can now tokenize and replace handlebar formats.
* Added Faker.Hacker and Faker.Company properties.
* Added Custom separator on Lorem.Paragraph.
* Added Canada (French) (fr_CA) locale.
* Added Ukrainian (uk) locale.
* Added Ireland (en_IE) locale.
* Added Internet.Mac for mac addresses.
* Support for Canadian post/zip codes.
* Exposed Name.JobTitle, Name.JobDescriptor, Name.JobArea, Name.JobType
* Exposed Address.CountryCode
* Replace symbols in domain words so it generates output for all locales
* Support for gender names, but only for locales that support it. Russian(&apos;ru&apos;) but not English(&apos;en&apos;).
* Corrected abbreviation for Yukon to reflect its official abbreviation of &quot;YT&quot;.

## v2.1.5.2:
* Fixed instantiating a Person in a non-US locale. -antongeorgiev

## v2.1.5.1:
* Added Georgian, Turkish, and Chinese (Taiwan) locales.
* Added Name.JobTitle()
* Added Internet.Url() and Internet.Protocol().
* Sync&apos;d up with faker.js v2.1.5.

## v2.1.4.2:
* Fixed bug in Faker.Person and Faker[T] that generates new person context after every new object.
* Added support for .FinishWith() for post-processing that runs after all rules but before returning new instance.
* Added Newtonsoft.Json as NuGet dependency.

## v2.1.4.1:
* Minor changes, mostly XML doc update and Person moved from DataSet to Bogus namespace.

## v2.1.4.0:
* Initial port from faker.js 2.1.4.

Showing the top 10 GitHub repositories that depend on Bogus:

Repository Stars
graphql-dotnet/graphql-dotnet
GraphQL for .NET
umbraco/Umbraco-CMS
The simple, flexible and friendly ASP.NET CMS used by more than 500.000 websites
elastic/elasticsearch-net
Elasticsearch.Net & NEST
skoruba/IdentityServer4.Admin
The administration for the IdentityServer4 and Asp.Net Core Identity
Windows-XAML/Template10
Making Windows 10 apps great again
OfficeDev/TrainingContent
Training Content used for developer.microsoft.com/office
riganti/dotvvm
Open source MVVM framework for Web Apps
json-api-dotnet/JsonApiDotNetCore
JSONAPI Framework for ASP.Net Core
AArnott/CodeGeneration.Roslyn
Assists in performing Roslyn-based code generation during a build.
bchavez/RethinkDb.Driver
:headphones: A NoSQL C#/.NET RethinkDB database driver with 100% ReQL API coverage.

Read more about the GitHub Usage information on our documentation.

Version History

Version Downloads Last updated
29.0.1 71,465 2/10/2020
28.4.4 196,452 12/10/2019
28.4.3 32,728 12/4/2019
28.4.2 6,514 11/30/2019
28.4.1 217,156 10/15/2019
28.3.2 40,416 10/4/2019
28.3.1 76,943 9/21/2019
28.2.1 110,278 9/10/2019
28.1.1 1,857 9/10/2019
28.0.3 42,134 8/28/2019
28.0.2 295,104 7/7/2019
28.0.1 17,286 7/2/2019
27.0.1 378,835 5/2/2019
26.0.2 197,753 3/22/2019
26.0.1 200,521 2/26/2019
25.0.4 216,344 1/18/2019
25.0.3 75,706 1/6/2019
25.0.2 125,175 12/11/2018
25.0.1 72,365 11/27/2018
24.3.1 110,108 11/3/2018
24.3.0 270,777 10/2/2018
24.2.0 23,962 9/27/2018
23.0.2 78,283 8/13/2018
22.3.2 107,603 7/18/2018
22.3.1 75,512 7/5/2018
22.2.1 16,935 6/29/2018
22.1.4 10,305 6/26/2018
22.1.3 36,392 6/14/2018
22.1.2 125,877 5/29/2018
22.1.1 10,489 5/21/2018
22.0.9 2,463 5/17/2018
22.0.8 216,905 4/10/2018
22.0.7 29,895 4/1/2018
22.0.6 4,642 3/29/2018
22.0.5 90,786 3/3/2018
22.0.3 11,428 2/27/2018
22.0.2 100,814 1/6/2018
22.0.1 38,391 12/23/2017
21.0.5 5,496 12/16/2017
21.0.4 7,521 12/13/2017
21.0.2 8,319 12/8/2017
20.0.2 42,928 11/6/2017
20.0.1 4,470 11/5/2017
19.0.2 21,848 11/1/2017
18.0.2 91,824 9/14/2017
18.0.1 9,500 9/13/2017
17.0.1 32,132 8/25/2017
16.0.3 10,244 8/24/2017
16.0.2 1,696 8/23/2017
15.0.7 5,026 8/21/2017
15.0.6 14,631 8/3/2017
15.0.5 4,866 7/28/2017
15.0.3 122,891 5/7/2017
15.0.1 29,591 4/11/2017
12.0.1 8,446 3/27/2017
11.0.5 8,192 3/20/2017
11.0.4 21,698 3/15/2017
11.0.3 2,372 3/13/2017
11.0.2 14,583 2/23/2017
11.0.1 1,480 2/21/2017
10.0.1 1,293 2/18/2017
9.0.2 18,929 1/19/2017
9.0.1 910 1/18/2017
8.0.4 1,067 1/17/2017
8.0.3 29,678 12/20/2016
8.0.2 6,594 12/7/2016
8.0.1 9,068 11/25/2016
8.0.1-beta-1 18,907 10/22/2016
7.1.7 44,842 10/11/2016
7.1.6 33,830 8/8/2016
7.1.5 1,181 7/27/2016
7.1.4 4,084 7/7/2016
7.1.3 4,501 6/28/2016
7.1.3-beta-1 687 5/20/2016
7.1.2 7,756 5/16/2016
7.1.2-beta-1 645 5/16/2016
7.1.1 762 5/15/2016
7.1.1-beta-1 671 5/15/2016
6.1.1 5,907 3/30/2016
6.1.1-beta-1 877 3/29/2016
5.1.1-beta-3 692 3/23/2016
5.1.1-beta-2 655 3/22/2016
5.1.1-beta-1 654 3/21/2016
5.0.1 2,575 2/25/2016
5.0.1-beta-2 688 2/25/2016
4.0.1 849 2/16/2016
4.0.1-beta-1 673 2/16/2016
3.0.6 2,567 1/21/2016
3.0.6-beta-1 635 1/21/2016
3.0.5 4,915 1/21/2016
3.0.5-beta-4 661 1/20/2016
3.0.5-beta-3 698 1/18/2016
3.0.5-beta-2 1,764 1/12/2016
3.0.4 1,663 12/10/2015
3.0.3 732 12/9/2015
3.0.2 854 11/24/2015
3.0.1 986 10/22/2015
3.0.0.3 1,432 7/21/2015
3.0.0.2 2,123 7/12/2015
3.0.0.1 7,115 7/12/2015
2.1.5.2 1,106 6/22/2015
2.1.5.1 789 6/11/2015
2.1.4.2 746 6/11/2015
2.1.4.1 793 6/10/2015
2.1.4 1,436 6/9/2015
Show less