Bogus 6.1.1-beta-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.

No packages depend on Bogus.

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, () => 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 "dotnet5.4" moniker support.
  • BREAKING: Fake "seeded" 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 "content" 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 => 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() -> 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 '*' replace with letter or digit.
  • Added Lorem.Letter(num).
  • Can switch locale on Name: f.Name["en"].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 "A foo bar."
  • 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('ru') but not English('en').
  • Corrected abbreviation for Yukon to reflect its official abbreviation of "YT".

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'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.

.NET Framework 4.0

DNX 4.5.1

DNXCore 5.0

.NETPlatform 5.4

Version Downloads Last updated
35.6.5 1 12/30/2025
35.6.4 0 09/26/2025
35.6.3 0 04/12/2025
35.6.2 0 02/21/2025
35.6.1 0 09/02/2024
35.6.0 0 07/19/2024
35.5.1 0 04/28/2024
35.5.0 0 03/09/2024
35.4.1 0 03/02/2024
35.4.0 0 01/14/2024
35.3.2 0 01/14/2024
35.3.1 0 01/13/2024
35.3.0 0 01/01/2024
35.2.0 0 12/26/2023
35.0.1 0 12/12/2023
34.0.2 0 03/27/2022
34.0.1 0 11/23/2021
33.1.1 0 08/29/2021
33.0.2 0 02/21/2021
33.0.1 0 02/07/2021
32.1.1 0 01/31/2021
32.0.2 0 12/12/2020
32.0.1 0 11/28/2020
31.0.3 0 10/04/2020
30.0.4 0 08/15/2020
30.0.1-beta-4 0 07/24/2020
30.0.1-beta-3 0 06/30/2020
30.0.1-beta-2 0 06/21/2020
30.0.1-beta-1 0 06/15/2020
29.0.2 0 04/11/2020
29.0.1 0 02/10/2020
28.4.4 0 12/10/2019
28.4.3 0 12/04/2019
28.4.2 0 11/30/2019
28.4.1 0 10/15/2019
28.3.2 0 10/04/2019
28.3.1 0 09/21/2019
28.2.1 0 09/10/2019
28.1.1 0 09/10/2019
28.0.3 0 08/28/2019
28.0.2 0 07/07/2019
28.0.1 0 07/02/2019
27.0.1 0 05/02/2019
26.0.2 0 03/22/2019
26.0.1 0 02/26/2019
25.0.4 0 01/18/2019
25.0.3 0 01/06/2019
25.0.2 0 12/11/2018
25.0.1 0 11/27/2018
24.3.1 0 11/03/2018
24.3.0 0 10/02/2018
24.2.0 0 09/27/2018
23.0.2 0 08/13/2018
22.3.2 0 07/18/2018
22.3.1 0 07/05/2018
22.2.1 1 12/30/2025
22.1.4 0 06/26/2018
22.1.3 0 06/14/2018
22.1.2 0 05/29/2018
22.1.1 0 05/21/2018
22.0.9 0 05/17/2018
22.0.8 0 04/10/2018
22.0.7 0 04/01/2018
22.0.6 0 03/29/2018
22.0.5 0 03/03/2018
22.0.3 0 02/27/2018
22.0.2 0 01/06/2018
22.0.1 0 12/23/2017
21.0.5 0 12/16/2017
21.0.4 0 12/13/2017
21.0.2 0 12/08/2017
20.0.2 1 12/30/2025
20.0.1 1 12/30/2025
19.0.2 0 11/01/2017
18.0.2 0 09/14/2017
18.0.1 0 09/13/2017
17.0.1 0 08/25/2017
16.0.3 0 08/24/2017
16.0.2 0 08/23/2017
15.0.7 0 08/21/2017
15.0.6 0 08/03/2017
15.0.5 0 07/28/2017
15.0.3 0 05/07/2017
15.0.1 0 04/11/2017
12.0.1 0 03/27/2017
11.0.5 0 03/20/2017
11.0.4 0 03/15/2017
11.0.3 0 03/13/2017
11.0.2 1 12/30/2025
11.0.1 0 02/21/2017
10.0.1 0 02/18/2017
9.0.2 0 01/19/2017
9.0.1 0 01/18/2017
8.0.4 0 01/17/2017
8.0.3 0 12/20/2016
8.0.2 0 12/07/2016
8.0.1 0 11/25/2016
8.0.1-beta-1 0 10/22/2016
7.1.7 0 10/11/2016
7.1.6 0 08/08/2016
7.1.5 0 07/27/2016
7.1.4 0 07/07/2016
7.1.3 0 06/28/2016
7.1.3-beta-1 0 05/20/2016
7.1.2 0 05/16/2016
7.1.2-beta-1 0 05/16/2016
7.1.1 0 05/15/2016
7.1.1-beta-1 0 05/15/2016
6.1.1 0 03/30/2016
6.1.1-beta-1 1 12/30/2025
5.1.1-beta-3 0 03/23/2016
5.1.1-beta-2 0 03/22/2016
5.1.1-beta-1 0 03/21/2016
5.0.1 0 02/25/2016
5.0.1-beta-2 0 02/25/2016
4.0.1 0 02/16/2016
4.0.1-beta-1 0 02/16/2016
3.0.6 0 01/21/2016
3.0.6-beta-1 0 01/21/2016
3.0.5 0 01/21/2016
3.0.5-beta-4 0 01/20/2016
3.0.5-beta-3 1 12/30/2025
3.0.5-beta-2 0 01/12/2016
3.0.4 0 12/10/2015
3.0.3 0 12/09/2015
3.0.2 0 11/24/2015
3.0.1 0 10/22/2015
3.0.0.3 0 07/21/2015
3.0.0.2 0 07/12/2015
3.0.0.1 0 07/12/2015
2.1.5.2 0 06/22/2015
2.1.5.1 0 06/11/2015
2.1.4.2 0 06/11/2015
2.1.4.1 0 06/10/2015
2.1.4 1 12/30/2025