Bogus 5.0.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 5.0.1
dotnet add package Bogus --version 5.0.1
<PackageReference Include="Bogus" Version="5.0.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Bogus --version 5.0.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Release Notes

## 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 8,026 2/10/2020
28.4.4 121,346 12/10/2019
28.4.3 25,473 12/4/2019
28.4.2 5,607 11/30/2019
28.4.1 184,290 10/15/2019
28.3.2 35,025 10/4/2019
28.3.1 67,512 9/21/2019
28.2.1 91,952 9/10/2019
28.1.1 1,837 9/10/2019
28.0.3 37,420 8/28/2019
28.0.2 267,940 7/7/2019
28.0.1 15,867 7/2/2019
27.0.1 348,180 5/2/2019
26.0.2 187,673 3/22/2019
26.0.1 188,501 2/26/2019
25.0.4 203,613 1/18/2019
25.0.3 73,191 1/6/2019
25.0.2 120,383 12/11/2018
25.0.1 70,007 11/27/2018
24.3.1 107,147 11/3/2018
24.3.0 261,507 10/2/2018
24.2.0 21,622 9/27/2018
23.0.2 75,896 8/13/2018
22.3.2 105,224 7/18/2018
22.3.1 74,153 7/5/2018
22.2.1 16,665 6/29/2018
22.1.4 10,074 6/26/2018
22.1.3 35,265 6/14/2018
22.1.2 120,122 5/29/2018
22.1.1 10,302 5/21/2018
22.0.9 2,384 5/17/2018
22.0.8 210,048 4/10/2018
22.0.7 28,876 4/1/2018
22.0.6 4,618 3/29/2018
22.0.5 88,781 3/3/2018
22.0.3 11,362 2/27/2018
22.0.2 98,549 1/6/2018
22.0.1 38,216 12/23/2017
21.0.5 5,458 12/16/2017
21.0.4 7,483 12/13/2017
21.0.2 8,112 12/8/2017
20.0.2 40,970 11/6/2017
20.0.1 4,274 11/5/2017
19.0.2 21,297 11/1/2017
18.0.2 89,556 9/14/2017
18.0.1 9,250 9/13/2017
17.0.1 30,951 8/25/2017
16.0.3 10,230 8/24/2017
16.0.2 1,689 8/23/2017
15.0.7 5,016 8/21/2017
15.0.6 14,280 8/3/2017
15.0.5 4,846 7/28/2017
15.0.3 119,917 5/7/2017
15.0.1 29,410 4/11/2017
12.0.1 8,257 3/27/2017
11.0.5 8,161 3/20/2017
11.0.4 21,528 3/15/2017
11.0.3 2,365 3/13/2017
11.0.2 13,800 2/23/2017
11.0.1 1,474 2/21/2017
10.0.1 1,287 2/18/2017
9.0.2 18,683 1/19/2017
9.0.1 901 1/18/2017
8.0.4 1,062 1/17/2017
8.0.3 27,895 12/20/2016
8.0.2 6,551 12/7/2016
8.0.1 8,911 11/25/2016
8.0.1-beta-1 18,900 10/22/2016
7.1.7 44,305 10/11/2016
7.1.6 32,413 8/8/2016
7.1.5 1,172 7/27/2016
7.1.4 4,074 7/7/2016
7.1.3 4,491 6/28/2016
7.1.3-beta-1 683 5/20/2016
7.1.2 7,685 5/16/2016
7.1.2-beta-1 640 5/16/2016
7.1.1 751 5/15/2016
7.1.1-beta-1 666 5/15/2016
6.1.1 5,892 3/30/2016
6.1.1-beta-1 873 3/29/2016
5.1.1-beta-3 687 3/23/2016
5.1.1-beta-2 647 3/22/2016
5.1.1-beta-1 647 3/21/2016
5.0.1 2,562 2/25/2016
5.0.1-beta-2 683 2/25/2016
4.0.1 842 2/16/2016
4.0.1-beta-1 669 2/16/2016
3.0.6 2,523 1/21/2016
3.0.6-beta-1 627 1/21/2016
3.0.5 4,903 1/21/2016
3.0.5-beta-4 654 1/20/2016
3.0.5-beta-3 691 1/18/2016
3.0.5-beta-2 1,760 1/12/2016
3.0.4 1,654 12/10/2015
3.0.3 726 12/9/2015
3.0.2 846 11/24/2015
3.0.1 977 10/22/2015
3.0.0.3 1,427 7/21/2015
3.0.0.2 2,117 7/12/2015
3.0.0.1 6,400 7/12/2015
2.1.5.2 1,097 6/22/2015
2.1.5.1 780 6/11/2015
2.1.4.2 737 6/11/2015
2.1.4.1 784 6/10/2015
2.1.4 1,386 6/9/2015
Show less