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

Release Notes

## 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
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.
goblinfactory/konsole
Home of the simple console library consisting of ProgressBar, Window, Form, Draw & MockConsole (C# console progress bar with support for single or multithreaded progress updates) Window is a 100%-ish console compatible window, supporting all normal console writing to a windowed section of the screen, supporting scrolling and clipping of console output.

Read more about the GitHub Usage information on our documentation.

Version History

Version Downloads Last updated
29.0.1 1,256 2/10/2020
28.4.4 104,741 12/10/2019
28.4.3 24,046 12/4/2019
28.4.2 5,328 11/30/2019
28.4.1 176,208 10/15/2019
28.3.2 34,189 10/4/2019
28.3.1 65,954 9/21/2019
28.2.1 88,699 9/10/2019
28.1.1 1,835 9/10/2019
28.0.3 36,330 8/28/2019
28.0.2 262,746 7/7/2019
28.0.1 15,686 7/2/2019
27.0.1 342,508 5/2/2019
26.0.2 185,860 3/22/2019
26.0.1 186,306 2/26/2019
25.0.4 201,444 1/18/2019
25.0.3 72,669 1/6/2019
25.0.2 119,499 12/11/2018
25.0.1 69,559 11/27/2018
24.3.1 106,686 11/3/2018
24.3.0 259,568 10/2/2018
24.2.0 21,373 9/27/2018
23.0.2 75,366 8/13/2018
22.3.2 104,747 7/18/2018
22.3.1 73,946 7/5/2018
22.2.1 16,544 6/29/2018
22.1.4 10,053 6/26/2018
22.1.3 34,999 6/14/2018
22.1.2 117,755 5/29/2018
22.1.1 10,262 5/21/2018
22.0.9 2,371 5/17/2018
22.0.8 208,602 4/10/2018
22.0.7 28,667 4/1/2018
22.0.6 4,614 3/29/2018
22.0.5 88,406 3/3/2018
22.0.3 11,341 2/27/2018
22.0.2 98,149 1/6/2018
22.0.1 38,184 12/23/2017
21.0.5 5,453 12/16/2017
21.0.4 7,477 12/13/2017
21.0.2 8,078 12/8/2017
20.0.2 40,677 11/6/2017
20.0.1 4,236 11/5/2017
19.0.2 21,209 11/1/2017
18.0.2 89,174 9/14/2017
18.0.1 9,197 9/13/2017
17.0.1 30,644 8/25/2017
16.0.3 10,229 8/24/2017
16.0.2 1,688 8/23/2017
15.0.7 5,014 8/21/2017
15.0.6 14,192 8/3/2017
15.0.5 4,845 7/28/2017
15.0.3 119,357 5/7/2017
15.0.1 29,403 4/11/2017
12.0.1 8,219 3/27/2017
11.0.5 8,158 3/20/2017
11.0.4 21,502 3/15/2017
11.0.3 2,365 3/13/2017
11.0.2 13,647 2/23/2017
11.0.1 1,474 2/21/2017
10.0.1 1,287 2/18/2017
9.0.2 18,617 1/19/2017
9.0.1 901 1/18/2017
8.0.4 1,057 1/17/2017
8.0.3 27,750 12/20/2016
8.0.2 6,542 12/7/2016
8.0.1 8,880 11/25/2016
8.0.1-beta-1 18,900 10/22/2016
7.1.7 44,220 10/11/2016
7.1.6 32,237 8/8/2016
7.1.5 1,172 7/27/2016
7.1.4 4,074 7/7/2016
7.1.3 4,490 6/28/2016
7.1.3-beta-1 680 5/20/2016
7.1.2 7,672 5/16/2016
7.1.2-beta-1 637 5/16/2016
7.1.1 751 5/15/2016
7.1.1-beta-1 666 5/15/2016
6.1.1 5,888 3/30/2016
6.1.1-beta-1 870 3/29/2016
5.1.1-beta-3 684 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,559 2/25/2016
5.0.1-beta-2 680 2/25/2016
4.0.1 842 2/16/2016
4.0.1-beta-1 666 2/16/2016
3.0.6 2,511 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 723 12/9/2015
3.0.2 846 11/24/2015
3.0.1 977 10/22/2015
3.0.0.3 1,424 7/21/2015
3.0.0.2 2,113 7/12/2015
3.0.0.1 6,207 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,375 6/9/2015
Show less