不一样的虚假(Bogus)和骗子(Faker)

首先声明，Bogus是一个Nuget包的名称，Faker是它内部的一个类，这个库的作用就是模拟生成实体类的数据，特别适合测试时的场景，不用苦思冥想，辛辛苦苦来造不同的实体类了。当然，造出来的都是虚假的(Bogus)，骗人的(Faker)。它家在这里：https://github.com/bchavez/Bogus

假如我有个会员类

    enum Sex
    {
        男,
        女
    }
    class Memmber
    {
        public Guid ID { get; set; }
        public long NO { get; set; }
        public string Name { get; set; }
        public Sex Sex { get; set; }
        public int Age { get; set; }
        public string Email { get; set; }
        public string Phone { get; set; }
        public decimal Balance { get; set; }
        public DateTime CreateOn { get; set; }
    }

这个类在测试时，要手动实例化，穿梭于各个层和方法中间，现在把构建这个类的对象(实例)，交给Bogus。

首先引入Bogus包

Install-Package Bogus

接下来就可以告诉Faker怎么来“骗人”了

var options = new JsonSerializerOptions();
options.Encoder = System.Text.Encodings.Web.JavaScriptEncoder.Create(UnicodeRanges.All);
while (true)
{
    var personFaker = new Faker<Memmber>()
        .RuleFor(x => x.ID, x => x.Random.Guid())
        .RuleFor(x=>x.NO,x=>x.Random.Long(100000000000,999999999999))
        .RuleFor(x => x.Name, x => x.Person.LastName + x.Person.FirstName)
        .RuleFor(x => x.Sex, x => x.Random.Enum<Sex>())
        .RuleFor(x => x.Email, x => x.Person.Email)
        .RuleFor(x => x.Phone, x => x.Person.Phone)
        .RuleFor(x => x.Age, x => x.Random.Int(0, 120))
        .RuleFor(x=>x.Balance,x=>x.Finance.Amount(0,1000))                    
        .RuleFor(x => x.CreateOn, x => x.Date.Past(1));


    Console.WriteLine(JsonSerializer.Serialize(personFaker.Generate(), options));
    Console.ReadLine();
}

看一下效果：

{
  "ID":"5f3d97f6-52da-7fb6-e73f-153fd3a41bfb",
  "NO":539140308276,
  "Name":"KoeppErick",
  "Sex":0,
  "Age":48,
  "Email":"[e-mail]",
  "Phone":"[phone]",
  "Balance":45.34,
  "CreateOn":"2021-02-14T13:32:19.892062+09:00"
}

---

看来，Faker是通过RuleFor来给每个属性来模拟那种格式的数据的，比如RuleFor(x => x.Email, x => x.Person.Email)，告诉Faker，这是一个Email格式，记得骗人的时候，给人家一个email格式的数据，内容随便你，那问题来了，是不是有一大组格式呢？当然，这也是这个库的作用，都有哪些？

Bogus API Support

• Address

• • ZipCode - Get a zipcode.

  • City - Get a city name.

  • StreetAddress - Get a street address.

  • CityPrefix - Get a city prefix.

  • CitySuffix - Get a city suffix.

  • StreetName - Get a street name.

  • BuildingNumber - Get a building number.

  • StreetSuffix - Get a street suffix.

  • SecondaryAddress - Get a secondary address like 'Apt. 2' or 'Suite 321'.

  • County - Get a county.

  • Country - Get a country.

  • FullAddress - Get a full address like Street, City, Country.

  • CountryCode - Get a random ISO 3166-1 country code.

  • State - Get a random state state.

  • StateAbbr - Get a state abbreviation.

  • Latitude - Get a Latitude.

  • Longitude - Get a Longitude.

  • Direction - Generates a cardinal or ordinal direction. IE: Northwest, South, SW, E.

  • CardinalDirection - Generates a cardinal direction. IE: North, South, E, W.

  • OrdinalDirection - Generates an ordinal direction. IE: Northwest, Southeast, SW, NE.

• Commerce

• • Department - Get a random commerce department.

  • Price - Get a random product price.

  • Categories - Get random product categories.

  • ProductName - Get a random product name.

  • Color - Get a random color.

  • Product - Get a random product.

  • ProductAdjective - Random product adjective.

  • ProductMaterial - Random product material.

  • Ean8 - Get a random EAN-8 barcode number.

  • Ean13 - Get a random EAN-13 barcode number.

• Company

• • CompanySuffix - Get a company suffix. "Inc" and "LLC" etc.

  • CompanyName - Get a company name.

  • CatchPhrase - Get a company catch phrase.

  • Bs - Get a company BS phrase.

• Database

• • Column - Generates a column name.

  • Type - Generates a column type.

  • Collation - Generates a collation.

  • Engine - Generates a storage engine.

• Date

• • Past - Get a DateTime in the past between refDate and yearsToGoBack.

  • PastOffset - Get a DateTimeOffset in the past between refDate and yearsToGoBack.

  • Soon - Get a DateTime that will happen soon.

  • SoonOffset - Get a DateTimeOffset that will happen soon.

  • Future - Get a DateTime in the future between refDate and yearsToGoForward.

  • FutureOffset - Get a DateTimeOffset in the future between refDate and yearsToGoForward.

  • Between - Get a random DateTime between start and end.

  • BetweenOffset - Get a random DateTimeOffset between start and end.

  • Recent - Get a random DateTime within the last few days.

  • RecentOffset - Get a random DateTimeOffset within the last few days.

  • Timespan - Get a random TimeSpan.

  • Month - Get a random month

  • Weekday - Get a random weekday

• Finance

• • Account - Get an account number. Default length is 8 digits.

  • AccountName - Get an account name. Like "savings", "checking", "Home Loan" etc..

  • Amount - Get a random amount. Default 0 - 1000.

  • TransactionType - Get a transaction type: "deposit", "withdrawal", "payment", or "invoice".

  • Currency - Get a random currency.

  • CreditCardNumber - Generate a random credit card number with valid Luhn checksum.

  • CreditCardCvv - Generate a credit card CVV

  • BitcoinAddress - Generates a random Bitcoin address.

  • EthereumAddress - Generate a random Ethereum address.

  • RoutingNumber - Generates an ABA routing number with valid check digit.

  • Bic - Generates Bank Identifier Code (BIC) code.

  • Iban - Generates an International Bank Account Number (IBAN).

• Hacker

• • Abbreviation - Returns an abbreviation.

  • Adjective - Returns a adjective.

  • Noun - Returns a noun.

  • Verb - Returns a verb.

  • IngVerb - Returns a verb ending with -ing.

  • Phrase - Returns a phrase.

• Images

• • Abstract - Gets an abstract looking image.

  • Animals - Gets an image of an animal.

  • Business - Gets a business looking image.

  • Cats - Gets a picture of a cat.

  • City - Gets a city looking image.

  • Food - Gets an image of food.

  • Nightlife - Gets an image with city looking nightlife.

  • Fashion - Gets an image in the fashion category.

  • People - Gets an image of humans.

  • Nature - Gets an image of nature.

  • Sports - Gets an image related to sports.

  • Technics - Get a technology related image.

  • Transport - Get a transportation related image.

  • DataUri - Get a SVG data URI image with a specific width and height.

  • PicsumUrl - Get an image from the https://picsum.photos service.

  • PlaceholderUrl - Get an image from https://placeholder.com service.

  • LoremFlickrUrl - Get an image from https://loremflickr.com service.

  • LoremPixelUrl - Creates an image URL with http://lorempixel.com. Note: This service is slow. Consider using PicsumUrl() as a faster alternative.

• Internet

• • Avatar - Generates a legit Internet URL avatar from twitter accounts.

  • Email - Generates an email address.

  • ExampleEmail - Generates an example email with @example.com.

  • UserName - Generates user names.

  • UserNameUnicode - Generates a user name preserving Unicode characters.

  • DomainName - Generates a random domain name.

  • DomainWord - Generates a domain word used for domain names.

  • DomainSuffix - Generates a domain name suffix like .com, .net, .org

  • Ip - Gets a random IPv4 address string.

  • Port - Generates a random port number.

  • IpAddress - Gets a random IPv4 IPAddress type.

  • IpEndPoint - Gets a random IPv4 IPEndPoint.

  • Ipv6 - Generates a random IPv6 address string.

  • Ipv6Address - Generate a random IPv6 IPAddress type.

  • Ipv6EndPoint - Gets a random IPv6 IPEndPoint.

  • UserAgent - Generates a random user agent.

  • Mac - Gets a random mac address.

  • Password - Generates a random password.

  • Color - Gets a random aesthetically pleasing color near the base RGB. See here.

  • Protocol - Returns a random protocol. HTTP or HTTPS.

  • Url - Generates a random URL.

  • UrlWithPath - Get an absolute URL with random path.

  • UrlRootedPath - Get a rooted URL path like: /foo/bar. Optionally with file extension.

• Lorem

• • Word - Get a random lorem word.

  • Words - Get an array of random lorem words.

  • Letter - Get a character letter.

  • Sentence - Get a random sentence of specific number of words.

  • Sentences - Get some sentences.

  • Paragraph - Get a paragraph.

  • Paragraphs - Get a specified number of paragraphs.

  • Text - Get random text on a random lorem methods.

  • Lines - Get lines of lorem.

  • Slug - Slugify lorem words.

• Name

• • FirstName - Get a first name. Getting a gender specific name is only supported on locales that support it.

  • LastName - Get a last name. Getting a gender specific name is only supported on locales that support it.

  • FullName - Get a full name, concatenation of calling FirstName and LastName.

  • Prefix - Gets a random prefix for a name.

  • Suffix - Gets a random suffix for a name.

  • FindName - Gets a full name.

  • JobTitle - Gets a random job title.

  • JobDescriptor - Get a job description.

  • JobArea - Get a job area expertise.

  • JobType - Get a type of job.

• Phone

• • PhoneNumber - Get a phone number.

  • PhoneNumberFormat - Gets a phone number based on the locale's phone_number.formats[] array index.

• Rant

• • Review - Generates a random user review.

  • Reviews - Generate an array of random reviews.

• System

• • FileName - Get a random file name.

  • DirectoryPath - Get a random directory path (Unix).

  • FilePath - Get a random file path (Unix).

  • CommonFileName - Generates a random file name with a common file extension.

  • MimeType - Get a random mime type

  • CommonFileType - Returns a commonly used file type.

  • CommonFileExt - Returns a commonly used file extension.

  • FileType - Returns any file type available as mime-type.

  • FileExt - Gets a random extension for the given mime type.

  • Semver - Get a random semver version string.

  • Version - Get a random Version.

  • Exception - Get a random Exception with a fake stack trace.

  • AndroidId - Get a random GCM registration ID.

  • ApplePushToken - Get a random Apple Push Token

  • BlackBerryPin - Get a random BlackBerry Device PIN

• Vehicle

• • Vin - Generate a vehicle identification number (VIN).

  • Manufacturer - Get a vehicle manufacture name. IE: Toyota, Ford, Porsche.

  • Model - Get a vehicle model. IE: Camry, Civic, Accord.

  • Type - Get a vehicle type. IE: Minivan, SUV, Sedan.

  • Fuel - Get a vehicle fuel type. IE: Electric, Gasoline, Diesel.

• Random/Randomizer

• • Number - Get an int from 0 to max.

  • Digits - Get a random sequence of digits.

  • Even - Returns a random even number.

  • Odd - Returns a random odd number.

  • Double - Get a random double, between 0.0 and 1.0.

  • Decimal - Get a random decimal, between 0.0 and 1.0.

  • Float - Get a random float, between 0.0 and 1.0.

  • Byte - Generate a random byte between 0 and 255.

  • Bytes - Get a random sequence of bytes.

  • SByte - Generate a random sbyte between -128 and 127.

  • Int - Generate a random int between MinValue and MaxValue.

  • UInt - Generate a random uint between MinValue and MaxValue.

  • ULong - Generate a random ulong between -128 and 127.

  • Long - Generate a random long between MinValue and MaxValue.

  • Short - Generate a random short between MinValue and MaxValue.

  • UShort - Generate a random ushort between MinValue and MaxValue.

  • Char - Generate a random char between MinValue and MaxValue.

  • Chars - Generate a random chars between MinValue and MaxValue.

  • String - Get a string of characters of a specific length.

  • String2 - Get a string of characters with a specific length drawing characters from chars.

  • Hash - Return a random hex hash. Default 40 characters, aka SHA-1.

  • Bool - Get a random boolean.

  • ArrayElement<T> - Get a random array element.

  • ArrayElement - Get a random array element.

  • ArrayElements<T> - Get a random subset of an array.

  • ListItem<T> - Get a random list item.

  • ListItems<T> - Get a random subset of a List.

  • CollectionItem<T> - Get a random collection item.

  • ReplaceNumbers - Replaces symbols with numbers.

  • ReplaceSymbols - Replaces each character instance in a string.

  • Replace - Replaces symbols with numbers and letters. # = number, ? = letter, * = number or letter.

  • ClampString - Clamps the length of a string between min and max characters.

  • Enum<T> - Picks a random Enum of T. Works only with Enums.

  • Shuffle<T> - Shuffles an IEnumerable source.

  • Word - Returns a single word or phrase in English.

  • Words - Gets some random words and phrases in English.

  • WordsArray - Get a range of words in an array (English).

  • Guid - Get a random GUID.

  • Uuid - Get a random GUID. Alias for Randomizer.Guid().

  • RandomLocale - Returns a random locale.

  • AlphaNumeric - Returns a random set of alpha numeric characters 0-9, a-z.

  • Hexadecimal - Generates a random hexadecimal string.

  • WeightedRandom<T> - Returns a selection of T[] based on a weighted distribution of probability.

---

是不是挺丰富的，一般场景应该够用了，如果有特殊数据模拟，也只能自已动手了。

对，我是一个祖国的程序员，Member类生成的实例是外国的，这不行，换一下：

            var options = new JsonSerializerOptions();
            options.Encoder = System.Text.Encodings.Web.JavaScriptEncoder.Create(UnicodeRanges.All);
            while (true)
            {
                var personFaker = new Faker<Memmber>("zh_CN")
                    .RuleFor(x => x.ID, x => x.Random.Guid())
                    .RuleFor(x=>x.NO,x=>x.Random.Long(100000000000,999999999999))
                    .RuleFor(x => x.Name, x => x.Person.LastName + x.Person.FirstName)
                    .RuleFor(x => x.Sex, x => x.Random.Enum<Sex>())
                    .RuleFor(x => x.Email, x => x.Person.Email)
                    .RuleFor(x => x.Phone, x => x.Person.Phone)
                    .RuleFor(x => x.Age, x => x.Random.Int(0, 120))
                    .RuleFor(x=>x.Balance,x=>x.Finance.Amount(0,1000))                    
                    .RuleFor(x => x.CreateOn, x => x.Date.Past(1));


                Console.WriteLine(JsonSerializer.Serialize(personFaker.Generate(), options));
                Console.ReadLine();
            }

只需要在new Faker<T>时告这个骗子是要骗祖国的程序，就可以了，看结果吧：

{
  "ID":"219d56ca-ea21-3a02-84b5-d9950ae8f384",
  "NO":362783628351,
  "Name":"徐思远",
  "Sex":0,
  "Age":100,
  "Email":"[e-mail]",
  "Phone":"024-65735687",
  "Balance":623.22,
  "CreateOn":"2021-01-19T19:38:30.1504231+09:00"
}

其中的名字还真像个真人名，电话号也换成祖国的了。

那还支持其他国家吗？当然

Locale Code	Language		Locale Code	Language
af_ZA	Afrikaans		fr_CH	French  (Switzerland)
ar	Arabic		ge	Georgian
az	Azerbaijani		hr	Hrvatski
cz	Czech		id_ID	Indonesia
de	German		it	Italian
de_AT	German  (Austria)		ja	Japanese
de_CH	German  (Switzerland)		ko	Korean
el	Greek		lv	Latvian
en	English		nb_NO	Norwegian
en_AU	English  (Australia)		ne	Nepalese
en_AU_ocker	English  (Australia Ocker)		nl	Dutch
en_BORK	English (Bork)		nl_BE	Dutch  (Belgium)
en_CA	English  (Canada)		pl	Polish
en_GB	English (Great  Britain)		pt_BR	Portuguese  (Brazil)
en_IE	English  (Ireland)		pt_PT	Portuguese  (Portugal)
en_IND	English  (India)		ro	Romanian
en_NG	Nigeria  (English)		ru	Russian
en_US	English  (United States)		sk	Slovakian
en_ZA	English (South  Africa)		sv	Swedish
es	Spanish		tr	Turkish
es_MX	Spanish  (Mexico)		uk	Ukrainian
fa	Farsi		vi	Vietnamese
fi	Finnish		zh_CN	Chinese
fr	French		zh_TW	Chinese  (Taiwan)
fr_CA	French  (Canada)		zu_ZA	Zulu (South  Africa)

其实还有Bogus有很多其他功能，大家可以自行探索。