v6 – github.com/brianvoe/gofakeit/v6 Index | Examples | Files | Directories

package gofakeit

import "github.com/brianvoe/gofakeit/v6"

Package gofakeit provides a set of functions that generate random data

Example

Code:

{
	Seed(11)
	fmt.Println("Name:", Name())
	fmt.Println("Email:", Email())
	fmt.Println("Phone:", Phone())
	fmt.Println("Address:", Address().Address)
	fmt.Println("BS:", BS())
	fmt.Println("Beer Name:", BeerName())
	fmt.Println("Color:", Color())
	fmt.Println("Company:", Company())
	fmt.Println("Credit Card:", CreditCardNumber(nil))
	fmt.Println("Hacker Phrase:", HackerPhrase())
	fmt.Println("Job Title:", JobTitle())
	fmt.Println("Password:", Password(true, true, true, true, false, 32))
	// Output:
	// Name: Markus Moen
	// Email: alaynawuckert@kozey.biz
	// Phone: 9948995369
	// Address: 35300 South Roads haven, Miami, Tennessee 58302
	// BS: streamline
	// Beer Name: Pliny The Elder
	// Color: Gray
	// Company: Center for Responsive Politics
	// Credit Card: 3821714800889989
	// Hacker Phrase: Overriding the capacitor won't do anything, we need to compress the online SMTP protocol!
	// Job Title: Supervisor
	// Password: a8TyS<2l(pRLB4QU7V,O9nKUYcMD0(*g
}

Output:

Name: Markus Moen
Email: alaynawuckert@kozey.biz
Phone: 9948995369
Address: 35300 South Roads haven, Miami, Tennessee 58302
BS: streamline
Beer Name: Pliny The Elder
Color: Gray
Company: Center for Responsive Politics
Credit Card: 3821714800889989
Hacker Phrase: Overriding the capacitor won't do anything, we need to compress the online SMTP protocol!
Job Title: Supervisor
Password: a8TyS<2l(pRLB4QU7V,O9nKUYcMD0(*g
Example (Custom)

Code:

{
	Seed(11)

	AddFuncLookup("friendname", Info{
		Category:    "custom",
		Description: "Random friend name",
		Example:     "bill",
		Output:      "string",
		Generate: func(r *rand.Rand, m *MapParams, info *Info) (interface{}, error) {
			return RandomString([]string{"bill", "bob", "sally"}), nil
		},
	})

	type Foo struct {
		FriendName string `fake:"{friendname}"`
	}

	var f Foo
	Struct(&f)

	fmt.Printf("%s", f.FriendName)
	// Output: bill
}

Output:

bill
Example (Custom_with_params)

Code:

{
	Seed(11)

	AddFuncLookup("jumbleword", Info{
		Category:    "jumbleword",
		Description: "Take a word and jumple it up",
		Example:     "loredlowlh",
		Output:      "string",
		Params: []Param{
			{Field: "word", Type: "int", Description: "Word you want to jumble"},
		},
		Generate: func(r *rand.Rand, m *MapParams, info *Info) (interface{}, error) {
			word, err := info.GetString(m, "word")
			if err != nil {
				return nil, err
			}

			split := strings.Split(word, "")
			ShuffleStrings(split)
			return strings.Join(split, ""), nil
		},
	})

	type Foo struct {
		JumbleWord string `fake:"{jumbleword:helloworld}"`
	}

	var f Foo
	Struct(&f)

	fmt.Printf("%s", f.JumbleWord)
	// Output: loredlowlh
}

Output:

loredlowlh

Index

Examples

Variables

var FuncLookups map[string]Info

FuncLookups is the primary map array with mapping to all available data

Functions

func AchAccount

func AchAccount() string

AchAccount will generate a 12 digit account number

Example

Code:

{
	Seed(11)
	fmt.Println(AchAccount())
	// Output: 413645994899
}

Output:

413645994899

func AchRouting

func AchRouting() string

AchRouting will generate a 9 digit routing number

Example

Code:

{
	Seed(11)
	fmt.Println(AchRouting())
	// Output: 713645994
}

Output:

713645994

func AddFuncLookup

func AddFuncLookup(functionName string, info Info)

AddFuncLookup takes a field and adds it to map

func Adjective

func Adjective() string

Adjective will generate a random adjective

Example

Code:

{
	Seed(11)
	fmt.Println(Adjective())
	// Output: Dutch
}

Output:

Dutch

func AdjectiveDemonstrative

func AdjectiveDemonstrative() string

AdjectiveDemonstrative will generate a random demonstrative adjective

Example

Code:

{
	Seed(11)
	fmt.Println(AdjectiveDemonstrative())
	// Output: this
}

Output:

this

func AdjectiveDescriptive

func AdjectiveDescriptive() string

AdjectiveDescriptive will generate a random descriptive adjective

Example

Code:

{
	Seed(11)
	fmt.Println(AdjectiveDescriptive())
	// Output: brave
}

Output:

brave

func AdjectiveIndefinite

func AdjectiveIndefinite() string

AdjectiveIndefinite will generate a random indefinite adjective

Example

Code:

{
	Seed(11)
	fmt.Println(AdjectiveIndefinite())
	// Output: few
}

Output:

few

func AdjectiveInterrogative

func AdjectiveInterrogative() string

AdjectiveInterrogative will generate a random interrogative adjective

Example

Code:

{
	Seed(11)
	fmt.Println(AdjectiveInterrogative())
	// Output: what
}

Output:

what

func AdjectivePossessive

func AdjectivePossessive() string

AdjectivePossessive will generate a random possessive adjective

Example

Code:

{
	Seed(11)
	fmt.Println(AdjectivePossessive())
	// Output: our
}

Output:

our

func AdjectiveProper

func AdjectiveProper() string

AdjectiveProper will generate a random proper adjective

Example

Code:

{
	Seed(11)
	fmt.Println(AdjectiveProper())
	// Output: Afghan
}

Output:

Afghan

func AdjectiveQuantitative

func AdjectiveQuantitative() string

AdjectiveQuantitative will generate a random quantitative adjective

Example

Code:

{
	Seed(11)
	fmt.Println(AdjectiveQuantitative())
	// Output: a little
}

Output:

a little

func Adverb

func Adverb() string

Adverb will generate a random adverb

Example

Code:

{
	Seed(11)
	fmt.Println(Adverb())
	// Output: over
}

Output:

over

func AdverbDegree

func AdverbDegree() string

AdverbDegree will generate a random degree adverb

Example

Code:

{
	Seed(11)
	fmt.Println(AdverbDegree())
	// Output: intensely
}

Output:

intensely

func AdverbFrequencyDefinite

func AdverbFrequencyDefinite() string

AdverbFrequencyDefinite will generate a random frequency definite adverb

Example

Code:

{
	Seed(11)
	fmt.Println(AdverbFrequencyDefinite())
	// Output: hourly
}

Output:

hourly

func AdverbFrequencyIndefinite

func AdverbFrequencyIndefinite() string

AdverbFrequencyIndefinite will generate a random frequency indefinite adverb

Example

Code:

{
	Seed(11)
	fmt.Println(AdverbFrequencyIndefinite())
	// Output: occasionally
}

Output:

occasionally

func AdverbManner

func AdverbManner() string

AdverbManner will generate a random manner adverb

Example

Code:

{
	Seed(11)
	fmt.Println(AdverbManner())
	// Output: stupidly
}

Output:

stupidly

func AdverbPlace

func AdverbPlace() string

AdverbPlace will generate a random place adverb

Example

Code:

{
	Seed(11)
	fmt.Println(AdverbPlace())
	// Output: east
}

Output:

east

func AdverbTimeDefinite

func AdverbTimeDefinite() string

AdverbTimeDefinite will generate a random time definite adverb

Example

Code:

{
	Seed(11)
	fmt.Println(AdverbTimeDefinite())
	// Output: now
}

Output:

now

func AdverbTimeIndefinite

func AdverbTimeIndefinite() string

AdverbTimeIndefinite will generate a random time indefinite adverb

Example

Code:

{
	Seed(11)
	fmt.Println(AdverbTimeIndefinite())
	// Output: already
}

Output:

already

func Animal

func Animal() string

Animal will return a random animal

Example

Code:

{
	Seed(11)
	fmt.Println(Animal())
	// Output: elk
}

Output:

elk

func AnimalType

func AnimalType() string

AnimalType will return a random animal type

Example

Code:

{
	Seed(11)
	fmt.Println(AnimalType())
	// Output: amphibians
}

Output:

amphibians

func AppAuthor

func AppAuthor() string

AppAuthor will generate a random company or person name

Example

Code:

{
	Seed(11)
	fmt.Println(AppAuthor())
	// Output: Marcel Pagac
}

Output:

Marcel Pagac

func AppName

func AppName() string

AppName will generate a random app name

Example

Code:

{
	Seed(11)
	fmt.Println(AppName())
	// Output: Oxbeing
}

Output:

Oxbeing

func AppVersion

func AppVersion() string

AppVersion will generate a random app version

Example

Code:

{
	Seed(11)
	fmt.Println(AppVersion())
	// Output: 1.17.20
}

Output:

1.17.20

func BS

func BS() string

BS will generate a random company bs string

Example

Code:

{
	Seed(11)
	fmt.Println(BS())
	// Output: front-end
}

Output:

front-end

func BeerAlcohol

func BeerAlcohol() string

BeerAlcohol will return a random beer alcohol level between 2.0 and 10.0

Example

Code:

{
	Seed(11)
	fmt.Println(BeerAlcohol())
	// Output: 2.7%
}

Output:

2.7%

func BeerBlg

func BeerBlg() string

BeerBlg will return a random beer blg between 5.0 and 20.0

Example

Code:

{
	Seed(11)
	fmt.Println(BeerBlg())
	// Output: 6.4°Blg
}

Output:

6.4°Blg

func BeerHop

func BeerHop() string

BeerHop will return a random beer hop

Example

Code:

{
	Seed(11)
	fmt.Println(BeerHop())
	// Output: Glacier
}

Output:

Glacier

func BeerIbu

func BeerIbu() string

BeerIbu will return a random beer ibu value between 10 and 100

Example

Code:

{
	Seed(11)
	fmt.Println(BeerIbu())
	// Output: 47 IBU
}

Output:

47 IBU

func BeerMalt

func BeerMalt() string

BeerMalt will return a random beer malt

Example

Code:

{
	Seed(11)
	fmt.Println(BeerMalt())
	// Output: Munich
}

Output:

Munich

func BeerName

func BeerName() string

BeerName will return a random beer name

Example

Code:

{
	Seed(11)
	fmt.Println(BeerName())
	// Output: Duvel
}

Output:

Duvel

func BeerStyle

func BeerStyle() string

BeerStyle will return a random beer style

Example

Code:

{
	Seed(11)
	fmt.Println(BeerStyle())
	// Output: European Amber Lager
}

Output:

European Amber Lager

func BeerYeast

func BeerYeast() string

BeerYeast will return a random beer yeast

Example

Code:

{
	Seed(11)
	fmt.Println(BeerYeast())
	// Output: 1388 - Belgian Strong Ale
}

Output:

1388 - Belgian Strong Ale

func BitcoinAddress

func BitcoinAddress() string

BitcoinAddress will generate a random bitcoin address consisting of numbers, upper and lower characters

Example

Code:

{
	Seed(11)
	fmt.Println(BitcoinAddress())
	// Output: 1lYcxjqWkJWv7cLADX0q6BIXbVXHo6jV
}

Output:

1lYcxjqWkJWv7cLADX0q6BIXbVXHo6jV

func BitcoinPrivateKey

func BitcoinPrivateKey() string

BitcoinPrivateKey will generate a random bitcoin private key base58 consisting of numbers, upper and lower characters

Example

Code:

{
	Seed(11)
	fmt.Println(BitcoinPrivateKey())
	// Output: 5KWjEJ7SnBNJyDjdPUjLuYByYzM9rG1trax8c2NTSBtv7YtR57v
}

Output:

5KWjEJ7SnBNJyDjdPUjLuYByYzM9rG1trax8c2NTSBtv7YtR57v

func Bool

func Bool() bool

Bool will generate a random boolean value

Example

Code:

{
	Seed(11)
	fmt.Println(Bool())
	// Output: true
}

Output:

true

func Breakfast

func Breakfast() string

Breakfast will return a random breakfast name

Example

Code:

{
	Seed(11)
	fmt.Println(Breakfast())
	// Output: Blueberry banana happy face pancakes
}

Output:

Blueberry banana happy face pancakes

func BuzzWord

func BuzzWord() string

BuzzWord will generate a random company buzz word string

Example

Code:

{
	Seed(11)
	fmt.Println(BuzzWord())
	// Output: disintermediate
}

Output:

disintermediate

func CSV

func CSV(co *CSVOptions) ([]byte, error)

CSV generates an object or an array of objects in json format

Example (Array)

Code:

{
	Seed(11)

	value, err := CSV(&CSVOptions{
		RowCount: 3,
		Fields: []Field{
			{Name: "id", Function: "autoincrement"},
			{Name: "first_name", Function: "firstname"},
			{Name: "last_name", Function: "lastname"},
			{Name: "password", Function: "password", Params: MapParams{"special": {"false"}}},
		},
	})
	if err != nil {
		fmt.Println(err)
	}

	fmt.Println(string(value))

	// Output:
	// id,first_name,last_name,password
	// 1,Markus,Moen,Dc0VYXjkWABx
	// 2,Osborne,Hilll,XPJ9OVNbs5lm
	// 3,Mertie,Halvorson,eyl3bhwfV8wA
}

Output:

id,first_name,last_name,password
1,Markus,Moen,Dc0VYXjkWABx
2,Osborne,Hilll,XPJ9OVNbs5lm
3,Mertie,Halvorson,eyl3bhwfV8wA

func CarFuelType

func CarFuelType() string

CarFuelType will return a random fuel type

Example

Code:

{
	Seed(11)
	fmt.Println(CarFuelType())
	// Output: CNG
}

Output:

CNG

func CarMaker

func CarMaker() string

CarMaker will return a random car maker

Example

Code:

{
	Seed(11)
	fmt.Println(CarMaker())
	// Output: Nissan
}

Output:

Nissan

func CarModel

func CarModel() string

CarModel will return a random car model

Example

Code:

{
	Seed(11)
	fmt.Println(CarModel())
	// Output: Aveo
}

Output:

Aveo

func CarTransmissionType

func CarTransmissionType() string

CarTransmissionType will return a random transmission type

Example

Code:

{
	Seed(11)
	fmt.Println(CarTransmissionType())
	// Output: Manual
}

Output:

Manual

func CarType

func CarType() string

CarType will generate a random car type string

Example

Code:

{
	Seed(11)
	fmt.Println(CarType())
	// Output: Passenger car mini
}

Output:

Passenger car mini

func Cat

func Cat() string

Cat will return a random cat breed

Example

Code:

{
	Seed(11)
	fmt.Println(Cat())
	// Output: Sokoke
}

Output:

Sokoke

func Categories

func Categories() map[string][]string

Categories will return a map string array of available data categories and sub categories

func CelebrityActor

func CelebrityActor() string

CelebrityActor will generate a random celebrity actor

Example

Code:

{
	Seed(11)
	fmt.Println(CelebrityActor())
	// Output: Owen Wilson
}

Output:

Owen Wilson

func CelebrityBusiness

func CelebrityBusiness() string

CelebrityBusiness will generate a random celebrity business person

Example

Code:

{
	Seed(11)
	fmt.Println(CelebrityBusiness())
	// Output: Cameron Diaz
}

Output:

Cameron Diaz

func CelebritySport

func CelebritySport() string

CelebritySport will generate a random celebrity sport person

Example

Code:

{
	Seed(11)
	fmt.Println(CelebritySport())
	// Output: Hicham El Guerrouj
}

Output:

Hicham El Guerrouj

func ChromeUserAgent

func ChromeUserAgent() string

ChromeUserAgent will generate a random chrome browser user agent string

Example

Code:

{
	Seed(11)
	fmt.Println(ChromeUserAgent())
	// Output: Mozilla/5.0 (X11; Linux i686) AppleWebKit/5360 (KHTML, like Gecko) Chrome/40.0.889.0 Mobile Safari/5360
}

Output:

Mozilla/5.0 (X11; Linux i686) AppleWebKit/5360 (KHTML, like Gecko) Chrome/40.0.889.0 Mobile Safari/5360

func City

func City() string

City will generate a random city string

Example

Code:

{
	Seed(11)
	fmt.Println(City())
	// Output: Plano
}

Output:

Plano

func Color

func Color() string

Color will generate a random color string

Example

Code:

{
	Seed(11)
	fmt.Println(Color())
	// Output: MediumOrchid
}

Output:

MediumOrchid

func Company

func Company() string

Company will generate a random company name string

Example

Code:

{
	Seed(11)
	fmt.Println(Company())
	// Output: ClearHealthCosts
}

Output:

ClearHealthCosts

func CompanySuffix

func CompanySuffix() string

CompanySuffix will generate a random company suffix string

Example

Code:

{
	Seed(11)
	fmt.Println(CompanySuffix())
	// Output: Inc
}

Output:

Inc

func Connective

func Connective() string

Connective will generate a random connective

Example

Code:

{
	Seed(11)
	fmt.Println(Connective())
	// Output: such as
}

Output:

such as

func ConnectiveCasual

func ConnectiveCasual() string

ConnectiveCasual will generate a random casual connective

Example

Code:

{
	Seed(11)
	fmt.Println(ConnectiveCasual())
	// Output: an outcome of
}

Output:

an outcome of

func ConnectiveComparitive

func ConnectiveComparitive() string

ConnectiveComparitive will generate a random comparative connective

Example

Code:

{
	Seed(11)
	fmt.Println(ConnectiveComparitive())
	// Output: in addition
}

Output:

in addition

func ConnectiveComplaint

func ConnectiveComplaint() string

ConnectiveComplaint will generate a random complaint connective

Example

Code:

{
	Seed(11)
	fmt.Println(ConnectiveComplaint())
	// Output: besides
}

Output:

besides

func ConnectiveExamplify

func ConnectiveExamplify() string

ConnectiveExamplify will generate a random examplify connective

Example

Code:

{
	Seed(11)
	fmt.Println(ConnectiveExamplify())
	// Output: then
}

Output:

then

func ConnectiveListing

func ConnectiveListing() string

ConnectiveListing will generate a random listing connective

Example

Code:

{
	Seed(11)
	fmt.Println(ConnectiveListing())
	// Output: firstly
}

Output:

firstly

func ConnectiveTime

func ConnectiveTime() string

ConnectiveTime will generate a random connective time

Example

Code:

{
	Seed(11)
	fmt.Println(ConnectiveTime())
	// Output: finally
}

Output:

finally

func Country

func Country() string

Country will generate a random country string

Example

Code:

{
	Seed(11)
	fmt.Println(Country())
	// Output: Cabo Verde
}

Output:

Cabo Verde

func CountryAbr

func CountryAbr() string

CountryAbr will generate a random abbreviated country string

Example

Code:

{
	Seed(11)
	fmt.Println(CountryAbr())
	// Output: CV
}

Output:

CV

func CreditCardCvv

func CreditCardCvv() string

CreditCardCvv will generate a random CVV number Its a string because you could have 017 as an exp date

Example

Code:

{
	Seed(11)
	fmt.Println(CreditCardCvv())
	// Output: 513
}

Output:

513

func CreditCardExp

func CreditCardExp() string

CreditCardExp will generate a random credit card expiration date string Exp date will always be a future date

Example

Code:

{
	Seed(11)
	fmt.Println(CreditCardExp())
	// Output: 06/29
}

Output:

06/29

func CreditCardNumber

func CreditCardNumber(cco *CreditCardOptions) string

CreditCardNumber will generate a random luhn credit card number

Example

Code:

{
	Seed(11)
	fmt.Println(CreditCardNumber(nil))
	fmt.Println(CreditCardNumber(&CreditCardOptions{Types: []string{"visa", "discover"}}))
	fmt.Println(CreditCardNumber(&CreditCardOptions{Bins: []string{"4111"}}))
	fmt.Println(CreditCardNumber(&CreditCardOptions{Gaps: true}))
	// Output:
	// 4136459948995375
	// 4635300425914586
	// 4111232020276132
	// 3054 800889 9827
}

Output:

4136459948995375
4635300425914586
4111232020276132
3054 800889 9827

func CreditCardType

func CreditCardType() string

CreditCardType will generate a random credit card type string

Example

Code:

{
	Seed(11)
	fmt.Println(CreditCardType())
	// Output: Visa
}

Output:

Visa

func CurrencyLong

func CurrencyLong() string

CurrencyLong will generate a random long currency name

Example

Code:

{
	Seed(11)
	fmt.Println(CurrencyLong())
	// Output: Iraq Dinar
}

Output:

Iraq Dinar

func CurrencyShort

func CurrencyShort() string

CurrencyShort will generate a random short currency value

Example

Code:

{
	Seed(11)
	fmt.Println(CurrencyShort())
	// Output: IQD
}

Output:

IQD

func Date

func Date() time.Time

Date will generate a random time.Time struct

Example

Code:

{
	Seed(11)
	fmt.Println(Date())
	// Output: 1995-01-24 13:00:35.820738079 +0000 UTC
}

Output:

1995-01-24 13:00:35.820738079 +0000 UTC

func DateRange

func DateRange(start, end time.Time) time.Time

DateRange will generate a random time.Time struct between a start and end date

Example

Code:

{
	Seed(11)
	fmt.Println(DateRange(time.Unix(0, 484633944473634951), time.Unix(0, 1431318744473668209))) // May 10, 1985 years to May 10, 2015
	// Output: 2012-02-04 14:10:37.166933216 +0000 UTC
}

Output:

2012-02-04 14:10:37.166933216 +0000 UTC

func Day

func Day() int

Day will generate a random day between 1 - 31

Example

Code:

{
	Seed(11)
	fmt.Println(Day())
	// Output: 23
}

Output:

23

func Dessert

func Dessert() string

Dessert will return a random dessert name

Example

Code:

{
	Seed(11)
	fmt.Println(Dessert())
	// Output: French napoleons
}

Output:

French napoleons

func Digit

func Digit() string

Digit will generate a single ASCII digit

Example

Code:

{
	Seed(11)
	fmt.Println(Digit())
	// Output: 0
}

Output:

0

func DigitN

func DigitN(n uint) string

DigitN will generate a random string of length N consists of ASCII digits (note it can start with 0).

Example

Code:

{
	Seed(11)
	fmt.Println(DigitN(10))
	// Output: 0136459948
}

Output:

0136459948

func Dinner

func Dinner() string

Dinner will return a random dinner name

Example

Code:

{
	Seed(11)
	fmt.Println(Dinner())
	// Output: Wild addicting dip
}

Output:

Wild addicting dip

func Dog

func Dog() string

Dog will return a random dog breed

Example

Code:

{
	Seed(11)
	fmt.Println(Dog())
	// Output: Norwich Terrier
}

Output:

Norwich Terrier

func DomainName

func DomainName() string

DomainName will generate a random url domain name

Example

Code:

{
	Seed(11)
	fmt.Println(DomainName())
	// Output: centraltarget.biz
}

Output:

centraltarget.biz

func DomainSuffix

func DomainSuffix() string

DomainSuffix will generate a random domain suffix

Example

Code:

{
	Seed(11)
	fmt.Println(DomainSuffix())
	// Output: org
}

Output:

org

func Email

func Email() string

Email will generate a random email string

Example

Code:

{
	Seed(11)
	fmt.Println(Email())
	// Output: markusmoen@pagac.net
}

Output:

markusmoen@pagac.net

func Emoji

func Emoji() string

Emoji will return a random fun emoji

Example

Code:

{
	Seed(11)
	fmt.Println(Emoji())
	// Output: 🧛
}

Output:

🧛

func EmojiAlias

func EmojiAlias() string

EmojiAlias will return a random fun emoji alias

Example

Code:

{
	Seed(11)
	fmt.Println(EmojiAlias())
	// Output: deaf_person
}

Output:

deaf_person

func EmojiCategory

func EmojiCategory() string

EmojiCategory will return a random fun emoji category

Example

Code:

{
	Seed(11)
	fmt.Println(EmojiCategory())
	// Output: Food & Drink
}

Output:

Food & Drink

func EmojiDescription

func EmojiDescription() string

EmojiDescription will return a random fun emoji description

Example

Code:

{
	Seed(11)
	fmt.Println(EmojiDescription())
	// Output: confetti ball
}

Output:

confetti ball

func EmojiTag

func EmojiTag() string

EmojiTag will return a random fun emoji tag

Example

Code:

{
	Seed(11)
	fmt.Println(EmojiTag())
	// Output: strong
}

Output:

strong

func FarmAnimal

func FarmAnimal() string

FarmAnimal will return a random animal that usually lives on a farm

Example

Code:

{
	Seed(11)
	fmt.Println(FarmAnimal())
	// Output: Chicken
}

Output:

Chicken

func FileExtension

func FileExtension() string

FileExtension will generate a random file extension

Example

Code:

{
	Seed(11)
	fmt.Println(FileExtension())
	// Output: nes
}

Output:

nes

func FileMimeType

func FileMimeType() string

FileMimeType will generate a random mime file type

Example

Code:

{
	Seed(11)
	fmt.Println(FileMimeType())
	// Output: application/dsptype
}

Output:

application/dsptype

func FirefoxUserAgent

func FirefoxUserAgent() string

FirefoxUserAgent will generate a random firefox broswer user agent string

Example

Code:

{
	Seed(11)
	fmt.Println(FirefoxUserAgent())
	// Output: Mozilla/5.0 (Macintosh; U; PPC Mac OS X 10_9_10 rv:7.0) Gecko/1995-24-01 Firefox/36.0
}

Output:

Mozilla/5.0 (Macintosh; U; PPC Mac OS X 10_9_10 rv:7.0) Gecko/1995-24-01 Firefox/36.0

func FirstName

func FirstName() string

FirstName will generate a random first name

Example

Code:

{
	Seed(11)
	fmt.Println(FirstName())
	// Output: Markus
}

Output:

Markus

func FlipACoin

func FlipACoin() string

FlipACoin will return a random value of Heads or Tails

Example

Code:

{
	Seed(11)
	fmt.Println(FlipACoin())
	// Output: Heads
}

Output:

Heads

func Float32

func Float32() float32

Float32 will generate a random float32 value

Example

Code:

{
	Seed(11)
	fmt.Println(Float32())
	// Output: 3.1128167e+37
}

Output:

3.1128167e+37

func Float32Range

func Float32Range(min, max float32) float32

Float32Range will generate a random float32 value between min and max

Example

Code:

{
	Seed(11)
	fmt.Println(Float32Range(0, 9999999))
	// Output: 914774.6
}

Output:

914774.6

func Float64

func Float64() float64

Float64 will generate a random float64 value

Example

Code:

{
	Seed(11)
	fmt.Println(Float64())
	// Output: 1.644484108270445e+307
}

Output:

1.644484108270445e+307

func Float64Range

func Float64Range(min, max float64) float64

Float64Range will generate a random float64 value between min and max

Example

Code:

{
	Seed(11)
	fmt.Println(Float64Range(0, 9999999))
	// Output: 914774.5585333086
}

Output:

914774.5585333086

func Fruit

func Fruit() string

Fruit will return a random fruit name

Example

Code:

{
	Seed(11)
	fmt.Println(Fruit())
	// Output: Peach
}

Output:

Peach

func Gamertag

func Gamertag() string

Gamertag will generate a random video game username

Example

Code:

{
	Seed(11)
	fmt.Println(Gamertag())
	// Output: PurpleSheep5
}

Output:

PurpleSheep5

func Gender

func Gender() string

Gender will generate a random gender string

Example

Code:

{
	Seed(11)
	fmt.Println(Gender())
	// Output: male
}

Output:

male

func Generate

func Generate(dataVal string) string

Generate fake information from given string. Replaceable values should be within {}

Functions Ex: {firstname} - billy Ex: {sentence:3} - Record river mind. Ex: {number:1,10} - 4 Ex: {uuid} - 590c1440-9888-45b0-bd51-a817ee07c3f2

Letters/Numbers Ex: ### - 481 - random numbers Ex: ??? - fda - random letters

For a complete list of runnable functions use FuncsLookup

Example

Code:

{
	Seed(11)

	fmt.Println(Generate("{firstname} {lastname} ssn is {ssn} and lives at {street}"))
	fmt.Println(Generate("{sentence:3}"))
	fmt.Println(Generate("{shuffleints:[1,2,3]}"))
	fmt.Println(Generate("{number:1,50}"))
	fmt.Println(Generate("{shufflestrings:[key:value,int:string,1:2,a:b]}"))
	// Output: Markus Moen ssn is 526643139 and lives at 599 Dale ton
	// Niche backwards caused.
	// [1 3 2]
	// 27
	// [a:b key:value int:string 1:2]
}

Output:

Markus Moen ssn is 526643139 and lives at 599 Dale ton
Niche backwards caused.
[1 3 2]
27
[a:b key:value int:string 1:2]

func HTTPMethod

func HTTPMethod() string

HTTPMethod will generate a random http method

Example

Code:

{
	Seed(11)
	fmt.Println(HTTPMethod())
	// Output: HEAD
}

Output:

HEAD

func HTTPStatusCode

func HTTPStatusCode() int

HTTPStatusCode will generate a random status code

Example

Code:

{
	Seed(11)
	fmt.Println(HTTPStatusCode())
	// Output: 404
}

Output:

404

func HTTPStatusCodeSimple

func HTTPStatusCodeSimple() int

HTTPStatusCodeSimple will generate a random simple status code

Example

Code:

{
	Seed(11)
	fmt.Println(HTTPStatusCodeSimple())
	// Output: 200
}

Output:

200

func HTTPVersion

func HTTPVersion() string

HTTPVersion will generate a random http version

Example

Code:

{
	Seed(11)
	fmt.Println(HTTPVersion())
	// Output: HTTP/1.0
}

Output:

HTTP/1.0

func HackerAbbreviation

func HackerAbbreviation() string

HackerAbbreviation will return a random hacker abbreviation

Example

Code:

{
	Seed(11)
	fmt.Println(HackerAbbreviation())
	// Output: ADP
}

Output:

ADP

func HackerAdjective

func HackerAdjective() string

HackerAdjective will return a random hacker adjective

Example

Code:

{
	Seed(11)
	fmt.Println(HackerAdjective())
	// Output: wireless
}

Output:

wireless

func HackerNoun

func HackerNoun() string

HackerNoun will return a random hacker noun

Example

Code:

{
	Seed(11)
	fmt.Println(HackerNoun())
	// Output: driver
}

Output:

driver

func HackerPhrase

func HackerPhrase() string

HackerPhrase will return a random hacker sentence

Example

Code:

{
	Seed(11)
	fmt.Println(HackerPhrase())
	// Output: If we calculate the program, we can get to the AI pixel through the redundant XSS matrix!
}

Output:

If we calculate the program, we can get to the AI pixel through the redundant XSS matrix!

func HackerVerb

func HackerVerb() string

HackerVerb will return a random hacker verb

Example

Code:

{
	Seed(11)
	fmt.Println(HackerVerb())
	// Output: synthesize
}

Output:

synthesize

func HackeringVerb

func HackeringVerb() string

HackeringVerb will return a random hacker ingverb

Example

Code:

{
	Seed(11)
	fmt.Println(HackeringVerb())
	// Output: connecting
}

Output:

connecting

func HexColor

func HexColor() string

HexColor will generate a random hexadecimal color string

Example

Code:

{
	Seed(11)
	fmt.Println(HexColor())
	// Output: #a99fb4
}

Output:

#a99fb4

func HexUint128

func HexUint128() string

HexUint128 will generate a random uint128 hex value with "0x" prefix

Example

Code:

{
	Seed(11)
	fmt.Println(HexUint128())
	// Output: 0x875469578e51b5e56c95b64681d147a1
}

Output:

0x875469578e51b5e56c95b64681d147a1

func HexUint16

func HexUint16() string

HexUint16 will generate a random uint16 hex value with "0x" prefix

Example

Code:

{
	Seed(11)
	fmt.Println(HexUint16())
	// Output: 0x8754
}

Output:

0x8754

func HexUint256

func HexUint256() string

HexUint256 will generate a random uint256 hex value with "0x" prefix

Example

Code:

{
	Seed(11)
	fmt.Println(HexUint256())
	// Output: 0x875469578e51b5e56c95b64681d147a12cde48a4f417231b0c486abbc263e48d
}

Output:

0x875469578e51b5e56c95b64681d147a12cde48a4f417231b0c486abbc263e48d

func HexUint32

func HexUint32() string

HexUint32 will generate a random uint32 hex value with "0x" prefix

Example

Code:

{
	Seed(11)
	fmt.Println(HexUint32())
	// Output: 0x87546957
}

Output:

0x87546957

func HexUint64

func HexUint64() string

HexUint64 will generate a random uint64 hex value with "0x" prefix

Example

Code:

{
	Seed(11)
	fmt.Println(HexUint64())
	// Output: 0x875469578e51b5e5
}

Output:

0x875469578e51b5e5

func HexUint8

func HexUint8() string

HexUint8 will generate a random uint8 hex value with "0x" prefix

Example

Code:

{
	Seed(11)
	fmt.Println(HexUint8())
	// Output: 0x87
}

Output:

0x87

func HipsterParagraph

func HipsterParagraph(paragraphCount int, sentenceCount int, wordCount int, separator string) string

HipsterParagraph will generate a random paragraphGenerator Set Paragraph Count Set Sentence Count Set Word Count Set Paragraph Separator

Example

Code:

{
	Seed(11)
	fmt.Println(HipsterParagraph(3, 5, 12, "\n"))
	// Output: Microdosing roof chia echo pickled meditation cold-pressed raw denim fingerstache normcore sriracha pork belly. Wolf try-hard pop-up blog tilde hashtag health butcher waistcoat paleo portland vinegar. Microdosing sartorial blue bottle slow-carb freegan five dollar toast you probably haven't heard of them asymmetrical chia farm-to-table narwhal banjo. Gluten-free blog authentic literally synth vinyl meh ethical health fixie banh mi Yuccie. Try-hard drinking squid seitan cray VHS echo chillwave hammock kombucha food truck sustainable.
	// Pug bushwick hella tote bag cliche direct trade waistcoat yr waistcoat knausgaard pour-over master. Pitchfork jean shorts franzen flexitarian distillery hella meggings austin knausgaard crucifix wolf heirloom. Crucifix food truck you probably haven't heard of them trust fund fixie gentrify pitchfork stumptown mlkshk umami chambray blue bottle. 3 wolf moon swag +1 biodiesel knausgaard semiotics taxidermy meh artisan hoodie +1 blue bottle. Fashion axe forage mixtape Thundercats pork belly whatever 90's beard selfies chambray cred mlkshk.
	// Shabby chic typewriter VHS readymade lo-fi bitters PBR&B gentrify lomo raw denim freegan put a bird on it. Raw denim cliche dreamcatcher pug fixie park trust fund migas fingerstache sriracha +1 mustache. Tilde shoreditch kickstarter franzen dreamcatcher green juice mustache neutra polaroid stumptown organic schlitz. Flexitarian ramps chicharrones kogi lo-fi mustache tilde forage street church-key williamsburg taxidermy. Chia mustache plaid mumblecore squid slow-carb disrupt Thundercats goth shoreditch master direct trade.
}

Output:

Microdosing roof chia echo pickled meditation cold-pressed raw denim fingerstache normcore sriracha pork belly. Wolf try-hard pop-up blog tilde hashtag health butcher waistcoat paleo portland vinegar. Microdosing sartorial blue bottle slow-carb freegan five dollar toast you probably haven't heard of them asymmetrical chia farm-to-table narwhal banjo. Gluten-free blog authentic literally synth vinyl meh ethical health fixie banh mi Yuccie. Try-hard drinking squid seitan cray VHS echo chillwave hammock kombucha food truck sustainable.
Pug bushwick hella tote bag cliche direct trade waistcoat yr waistcoat knausgaard pour-over master. Pitchfork jean shorts franzen flexitarian distillery hella meggings austin knausgaard crucifix wolf heirloom. Crucifix food truck you probably haven't heard of them trust fund fixie gentrify pitchfork stumptown mlkshk umami chambray blue bottle. 3 wolf moon swag +1 biodiesel knausgaard semiotics taxidermy meh artisan hoodie +1 blue bottle. Fashion axe forage mixtape Thundercats pork belly whatever 90's beard selfies chambray cred mlkshk.
Shabby chic typewriter VHS readymade lo-fi bitters PBR&B gentrify lomo raw denim freegan put a bird on it. Raw denim cliche dreamcatcher pug fixie park trust fund migas fingerstache sriracha +1 mustache. Tilde shoreditch kickstarter franzen dreamcatcher green juice mustache neutra polaroid stumptown organic schlitz. Flexitarian ramps chicharrones kogi lo-fi mustache tilde forage street church-key williamsburg taxidermy. Chia mustache plaid mumblecore squid slow-carb disrupt Thundercats goth shoreditch master direct trade.

func HipsterSentence

func HipsterSentence(wordCount int) string

HipsterSentence will generate a random sentence

Example

Code:

{
	Seed(11)
	fmt.Println(HipsterSentence(5))
	// Output: Microdosing roof chia echo pickled.
}

Output:

Microdosing roof chia echo pickled.

func HipsterWord

func HipsterWord() string

HipsterWord will return a single hipster word

Example

Code:

{
	Seed(11)
	fmt.Println(HipsterWord())
	// Output: microdosing
}

Output:

microdosing

func Hobby

func Hobby() string

Hobby will generate a random hobby string

Example

Code:

{
	Seed(11)
	fmt.Println(Hobby())
	// Output: Transit map collecting
}

Output:

Transit map collecting

func Hour

func Hour() int

Hour will generate a random hour - in military time

Example

Code:

{
	Seed(11)
	fmt.Println(Hour())
	// Output: 17
}

Output:

17

func IPv4Address

func IPv4Address() string

IPv4Address will generate a random version 4 ip address

Example

Code:

{
	Seed(11)
	fmt.Println(IPv4Address())
	// Output: 152.23.53.100
}

Output:

152.23.53.100

func IPv6Address

func IPv6Address() string

IPv6Address will generate a random version 6 ip address

Example

Code:

{
	Seed(11)
	fmt.Println(IPv6Address())
	// Output: 8898:ee17:bc35:9064:5866:d019:3b95:7857
}

Output:

8898:ee17:bc35:9064:5866:d019:3b95:7857

func Image

func Image(width int, height int) *img.RGBA

Image generates a random rgba image

Example

Code:

{
	Seed(11)
	fmt.Println(Image(1, 1))
	// Output: &{[89 176 195 255] 4 (0,0)-(1,1)}
}

Output:

&{[89 176 195 255] 4 (0,0)-(1,1)}

func ImageJpeg

func ImageJpeg(width int, height int) []byte

ImageJpeg generates a random rgba jpeg image

Example

Code:

{
	Seed(11)
	fmt.Println(ImageJpeg(1, 1))
	// Output: [255 216 255 219 0 132 0 8 6 6 7 6 5 8 7 7 7 9 9 8 10 12 20 13 12 11 11 12 25 18 19 15 20 29 26 31 30 29 26 28 28 32 36 46 39 32 34 44 35 28 28 40 55 41 44 48 49 52 52 52 31 39 57 61 56 50 60 46 51 52 50 1 9 9 9 12 11 12 24 13 13 24 50 33 28 33 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 255 192 0 17 8 0 1 0 1 3 1 34 0 2 17 1 3 17 1 255 196 1 162 0 0 1 5 1 1 1 1 1 1 0 0 0 0 0 0 0 0 1 2 3 4 5 6 7 8 9 10 11 16 0 2 1 3 3 2 4 3 5 5 4 4 0 0 1 125 1 2 3 0 4 17 5 18 33 49 65 6 19 81 97 7 34 113 20 50 129 145 161 8 35 66 177 193 21 82 209 240 36 51 98 114 130 9 10 22 23 24 25 26 37 38 39 40 41 42 52 53 54 55 56 57 58 67 68 69 70 71 72 73 74 83 84 85 86 87 88 89 90 99 100 101 102 103 104 105 106 115 116 117 118 119 120 121 122 131 132 133 134 135 136 137 138 146 147 148 149 150 151 152 153 154 162 163 164 165 166 167 168 169 170 178 179 180 181 182 183 184 185 186 194 195 196 197 198 199 200 201 202 210 211 212 213 214 215 216 217 218 225 226 227 228 229 230 231 232 233 234 241 242 243 244 245 246 247 248 249 250 1 0 3 1 1 1 1 1 1 1 1 1 0 0 0 0 0 0 1 2 3 4 5 6 7 8 9 10 11 17 0 2 1 2 4 4 3 4 7 5 4 4 0 1 2 119 0 1 2 3 17 4 5 33 49 6 18 65 81 7 97 113 19 34 50 129 8 20 66 145 161 177 193 9 35 51 82 240 21 98 114 209 10 22 36 52 225 37 241 23 24 25 26 38 39 40 41 42 53 54 55 56 57 58 67 68 69 70 71 72 73 74 83 84 85 86 87 88 89 90 99 100 101 102 103 104 105 106 115 116 117 118 119 120 121 122 130 131 132 133 134 135 136 137 138 146 147 148 149 150 151 152 153 154 162 163 164 165 166 167 168 169 170 178 179 180 181 182 183 184 185 186 194 195 196 197 198 199 200 201 202 210 211 212 213 214 215 216 217 218 226 227 228 229 230 231 232 233 234 242 243 244 245 246 247 248 249 250 255 218 0 12 3 1 0 2 17 3 17 0 63 0 216 162 138 43 213 62 92 255 217]
}

Output:

[255 216 255 219 0 132 0 8 6 6 7 6 5 8 7 7 7 9 9 8 10 12 20 13 12 11 11 12 25 18 19 15 20 29 26 31 30 29 26 28 28 32 36 46 39 32 34 44 35 28 28 40 55 41 44 48 49 52 52 52 31 39 57 61 56 50 60 46 51 52 50 1 9 9 9 12 11 12 24 13 13 24 50 33 28 33 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 255 192 0 17 8 0 1 0 1 3 1 34 0 2 17 1 3 17 1 255 196 1 162 0 0 1 5 1 1 1 1 1 1 0 0 0 0 0 0 0 0 1 2 3 4 5 6 7 8 9 10 11 16 0 2 1 3 3 2 4 3 5 5 4 4 0 0 1 125 1 2 3 0 4 17 5 18 33 49 65 6 19 81 97 7 34 113 20 50 129 145 161 8 35 66 177 193 21 82 209 240 36 51 98 114 130 9 10 22 23 24 25 26 37 38 39 40 41 42 52 53 54 55 56 57 58 67 68 69 70 71 72 73 74 83 84 85 86 87 88 89 90 99 100 101 102 103 104 105 106 115 116 117 118 119 120 121 122 131 132 133 134 135 136 137 138 146 147 148 149 150 151 152 153 154 162 163 164 165 166 167 168 169 170 178 179 180 181 182 183 184 185 186 194 195 196 197 198 199 200 201 202 210 211 212 213 214 215 216 217 218 225 226 227 228 229 230 231 232 233 234 241 242 243 244 245 246 247 248 249 250 1 0 3 1 1 1 1 1 1 1 1 1 0 0 0 0 0 0 1 2 3 4 5 6 7 8 9 10 11 17 0 2 1 2 4 4 3 4 7 5 4 4 0 1 2 119 0 1 2 3 17 4 5 33 49 6 18 65 81 7 97 113 19 34 50 129 8 20 66 145 161 177 193 9 35 51 82 240 21 98 114 209 10 22 36 52 225 37 241 23 24 25 26 38 39 40 41 42 53 54 55 56 57 58 67 68 69 70 71 72 73 74 83 84 85 86 87 88 89 90 99 100 101 102 103 104 105 106 115 116 117 118 119 120 121 122 130 131 132 133 134 135 136 137 138 146 147 148 149 150 151 152 153 154 162 163 164 165 166 167 168 169 170 178 179 180 181 182 183 184 185 186 194 195 196 197 198 199 200 201 202 210 211 212 213 214 215 216 217 218 226 227 228 229 230 231 232 233 234 242 243 244 245 246 247 248 249 250 255 218 0 12 3 1 0 2 17 3 17 0 63 0 216 162 138 43 213 62 92 255 217]

func ImagePng

func ImagePng(width int, height int) []byte

ImagePng generates a random rgba png image

Example

Code:

{
	Seed(11)
	fmt.Println(ImagePng(1, 1))
	// Output: [137 80 78 71 13 10 26 10 0 0 0 13 73 72 68 82 0 0 0 1 0 0 0 1 8 2 0 0 0 144 119 83 222 0 0 0 16 73 68 65 84 120 156 98 138 220 112 24 16 0 0 255 255 3 58 1 207 38 214 44 234 0 0 0 0 73 69 78 68 174 66 96 130]
}

Output:

[137 80 78 71 13 10 26 10 0 0 0 13 73 72 68 82 0 0 0 1 0 0 0 1 8 2 0 0 0 144 119 83 222 0 0 0 16 73 68 65 84 120 156 98 138 220 112 24 16 0 0 255 255 3 58 1 207 38 214 44 234 0 0 0 0 73 69 78 68 174 66 96 130]

func ImageURL

func ImageURL(width int, height int) string

ImageURL will generate a random Image Based Upon Height And Width. https://picsum.photos/

Example

Code:

{
	Seed(11)
	fmt.Println(ImageURL(640, 480))
	// Output: https://picsum.photos/640/480
}

Output:

https://picsum.photos/640/480

func Int16

func Int16() int16

Int16 will generate a random int16 value

Example

Code:

{
	Seed(11)
	fmt.Println(Int16())
	// Output: -29607
}

Output:

-29607

func Int32

func Int32() int32

Int32 will generate a random int32 value

Example

Code:

{
	Seed(11)
	fmt.Println(Int32())
	// Output: -1072427943
}

Output:

-1072427943

func Int64

func Int64() int64

Int64 will generate a random int64 value

Example

Code:

{
	Seed(11)
	fmt.Println(Int64())
	// Output: -1072427943
}

Output:

-1072427943

func Int8

func Int8() int8

Int8 will generate a random Int8 value

Example

Code:

{
	Seed(11)
	fmt.Println(Int8())
	// Output: -39
}

Output:

-39

func IntRange

func IntRange(min, max int) int

IntRange will generate a random int value between min and max

Example

Code:

{
	Seed(11)
	fmt.Println(IntRange(1, 10))
	// Output: 6
}

Output:

6

func JSON

func JSON(jo *JSONOptions) ([]byte, error)

JSON generates an object or an array of objects in json format

Example (Array)

Code:

{
	Seed(11)

	value, err := JSON(&JSONOptions{
		Type: "array",
		Fields: []Field{
			{Name: "id", Function: "autoincrement"},
			{Name: "first_name", Function: "firstname"},
			{Name: "last_name", Function: "lastname"},
			{Name: "password", Function: "password", Params: MapParams{"special": {"false"}}},
		},
		RowCount: 3,
		Indent:   true,
	})
	if err != nil {
		fmt.Println(err)
	}

	fmt.Println(string(value))

	// Output: [
	//     {
	//         "id": 1,
	//         "first_name": "Markus",
	//         "last_name": "Moen",
	//         "password": "Dc0VYXjkWABx"
	//     },
	//     {
	//         "id": 2,
	//         "first_name": "Osborne",
	//         "last_name": "Hilll",
	//         "password": "XPJ9OVNbs5lm"
	//     },
	//     {
	//         "id": 3,
	//         "first_name": "Mertie",
	//         "last_name": "Halvorson",
	//         "password": "eyl3bhwfV8wA"
	//     }
	// ]
}

Output:

[
    {
        "id": 1,
        "first_name": "Markus",
        "last_name": "Moen",
        "password": "Dc0VYXjkWABx"
    },
    {
        "id": 2,
        "first_name": "Osborne",
        "last_name": "Hilll",
        "password": "XPJ9OVNbs5lm"
    },
    {
        "id": 3,
        "first_name": "Mertie",
        "last_name": "Halvorson",
        "password": "eyl3bhwfV8wA"
    }
]
Example (Object)

Code:

{
	Seed(11)

	value, err := JSON(&JSONOptions{
		Type: "object",
		Fields: []Field{
			{Name: "first_name", Function: "firstname"},
			{Name: "last_name", Function: "lastname"},
			{Name: "address", Function: "address"},
			{Name: "password", Function: "password", Params: MapParams{"special": {"false"}}},
		},
		Indent: true,
	})
	if err != nil {
		fmt.Println(err)
	}

	fmt.Println(string(value))

	// Output: {
	//     "first_name": "Markus",
	//     "last_name": "Moen",
	//     "address": {
	//         "address": "4599 Dale ton, Norfolk, New Jersey 36906",
	//         "street": "4599 Dale ton",
	//         "city": "Norfolk",
	//         "state": "New Jersey",
	//         "zip": "36906",
	//         "country": "Tokelau",
	//         "latitude": 23.058758,
	//         "longitude": 89.022594
	//     },
	//     "password": "qjXy56JHcVlZ"
	// }
}

Output:

{
    "first_name": "Markus",
    "last_name": "Moen",
    "address": {
        "address": "4599 Dale ton, Norfolk, New Jersey 36906",
        "street": "4599 Dale ton",
        "city": "Norfolk",
        "state": "New Jersey",
        "zip": "36906",
        "country": "Tokelau",
        "latitude": 23.058758,
        "longitude": 89.022594
    },
    "password": "qjXy56JHcVlZ"
}

func JobDescriptor

func JobDescriptor() string

JobDescriptor will generate a random job descriptor string

Example

Code:

{
	Seed(11)
	fmt.Println(JobDescriptor())
	// Output: Central
}

Output:

Central

func JobLevel

func JobLevel() string

JobLevel will generate a random job level string

Example

Code:

{
	Seed(11)
	fmt.Println(JobLevel())
	// Output: Assurance
}

Output:

Assurance

func JobTitle

func JobTitle() string

JobTitle will generate a random job title string

Example

Code:

{
	Seed(11)
	fmt.Println(JobTitle())
	// Output: Director
}

Output:

Director

func Language

func Language() string

Language will return a random language

Example

Code:

{
	Seed(11)
	fmt.Println(Language())
	// Output: Kazakh
}

Output:

Kazakh

func LanguageAbbreviation

func LanguageAbbreviation() string

LanguageAbbreviation will return a random language abbreviation

Example

Code:

{
	Seed(11)
	fmt.Println(LanguageAbbreviation())
	// Output: kk
}

Output:

kk

func LanguageBCP

func LanguageBCP() string

LanguageBCP will return a random language BCP (Best Current Practices)

Example

Code:

{
	Seed(11)
	fmt.Println(LanguageBCP())
	// Output: de-DE
}

Output:

de-DE

func LastName

func LastName() string

LastName will generate a random last name

Example

Code:

{
	Seed(11)
	fmt.Println(LastName())
	// Output: Daniel
}

Output:

Daniel

func Latitude

func Latitude() float64

Latitude will generate a random latitude float64

Example

Code:

{
	Seed(11)
	fmt.Println(Latitude())
	// Output: -73.534057
}

Output:

-73.534057

func LatitudeInRange

func LatitudeInRange(min, max float64) (float64, error)

LatitudeInRange will generate a random latitude within the input range

Example

Code:

{
	Seed(11)
	lat, _ := LatitudeInRange(21, 42)
	fmt.Println(lat)
	// Output: 22.921026
}

Output:

22.921026

func Letter

func Letter() string

Letter will generate a single random lower case ASCII letter

Example

Code:

{
	Seed(11)
	fmt.Println(Letter())
	// Output: g
}

Output:

g

func LetterN

func LetterN(n uint) string

LetterN will generate a random ASCII string with length N

Example

Code:

{
	Seed(11)
	fmt.Println(LetterN(10))
	// Output: gbRMaRxHki
}

Output:

gbRMaRxHki

func Lexify

func Lexify(str string) string

Lexify will replace ? with random generated letters

Example

Code:

{
	Seed(11)
	fmt.Println(Lexify("?????"))
	// Output: gbRMa
}

Output:

gbRMa

func LogLevel

func LogLevel(logType string) string

LogLevel will generate a random log level See data/LogLevels for list of available levels

Example

Code:

{
	Seed(11)
	fmt.Println(LogLevel("")) // This will also use general
	fmt.Println(LogLevel("syslog"))
	fmt.Println(LogLevel("apache"))
	// Output: error
	// debug
	// trace1-8
}

Output:

error
debug
trace1-8

func Longitude

func Longitude() float64

Longitude will generate a random longitude float64

Example

Code:

{
	Seed(11)
	fmt.Println(Longitude())
	// Output: -147.068113
}

Output:

-147.068113

func LongitudeInRange

func LongitudeInRange(min, max float64) (float64, error)

LongitudeInRange will generate a random longitude within the input range

Example

Code:

{
	Seed(11)
	long, _ := LongitudeInRange(-10, 10)
	fmt.Println(long)
	// Output: -8.170451
}

Output:

-8.170451

func LoremIpsumParagraph

func LoremIpsumParagraph(paragraphCount int, sentenceCount int, wordCount int, separator string) string

LoremIpsumParagraph will generate a random paragraphGenerator

Example

Code:

{
	Seed(11)
	fmt.Println(LoremIpsumParagraph(3, 5, 12, "\n"))
	// Output: Quia quae repellat consequatur quidem nisi quo qui voluptatum accusantium quisquam amet. Quas et ut non dolorem ipsam aut enim assumenda mollitia harum ut. Dicta similique veniam nulla voluptas at excepturi non ad maxime at non. Eaque hic repellat praesentium voluptatem qui consequuntur dolor iusto autem velit aut. Fugit tempore exercitationem harum consequatur voluptatum modi minima aut eaque et et.
	// Aut ea voluptatem dignissimos expedita odit tempore quod aut beatae ipsam iste. Minus voluptatibus dolorem maiores eius sed nihil vel enim odio voluptatem accusamus. Natus quibusdam temporibus tenetur cumque sint necessitatibus dolorem ex ducimus iusto ex. Voluptatem neque dicta explicabo officiis et ducimus sit ut ut praesentium pariatur. Illum molestias nisi at dolore ut voluptatem accusantium et fugiat et ut.
	// Explicabo incidunt reprehenderit non quia dignissimos recusandae vitae soluta quia et quia. Aut veniam voluptas consequatur placeat sapiente non eveniet voluptatibus magni velit eum. Nobis vel repellendus sed est qui autem laudantium quidem quam ullam consequatur. Aut iusto ut commodi similique quae voluptatem atque qui fugiat eum aut. Quis distinctio consequatur voluptatem vel aliquid aut laborum facere officiis iure tempora.
}

Output:

Quia quae repellat consequatur quidem nisi quo qui voluptatum accusantium quisquam amet. Quas et ut non dolorem ipsam aut enim assumenda mollitia harum ut. Dicta similique veniam nulla voluptas at excepturi non ad maxime at non. Eaque hic repellat praesentium voluptatem qui consequuntur dolor iusto autem velit aut. Fugit tempore exercitationem harum consequatur voluptatum modi minima aut eaque et et.
Aut ea voluptatem dignissimos expedita odit tempore quod aut beatae ipsam iste. Minus voluptatibus dolorem maiores eius sed nihil vel enim odio voluptatem accusamus. Natus quibusdam temporibus tenetur cumque sint necessitatibus dolorem ex ducimus iusto ex. Voluptatem neque dicta explicabo officiis et ducimus sit ut ut praesentium pariatur. Illum molestias nisi at dolore ut voluptatem accusantium et fugiat et ut.
Explicabo incidunt reprehenderit non quia dignissimos recusandae vitae soluta quia et quia. Aut veniam voluptas consequatur placeat sapiente non eveniet voluptatibus magni velit eum. Nobis vel repellendus sed est qui autem laudantium quidem quam ullam consequatur. Aut iusto ut commodi similique quae voluptatem atque qui fugiat eum aut. Quis distinctio consequatur voluptatem vel aliquid aut laborum facere officiis iure tempora.

func LoremIpsumSentence

func LoremIpsumSentence(wordCount int) string

LoremIpsumSentence will generate a random sentence

Example

Code:

{
	Seed(11)
	fmt.Println(LoremIpsumSentence(5))
	// Output: Quia quae repellat consequatur quidem.
}

Output:

Quia quae repellat consequatur quidem.

func LoremIpsumWord

func LoremIpsumWord() string

LoremIpsumWord will generate a random word

Example

Code:

{
	Seed(11)
	fmt.Println(LoremIpsumWord())
	// Output: quia
}

Output:

quia

func Lunch

func Lunch() string

Lunch will return a random lunch name

Example

Code:

{
	Seed(11)
	fmt.Println(Lunch())
	// Output: No bake hersheys bar pie
}

Output:

No bake hersheys bar pie

func MacAddress

func MacAddress() string

MacAddress will generate a random mac address

Example

Code:

{
	Seed(11)
	fmt.Println(MacAddress())
	// Output: e1:74:cb:01:77:91
}

Output:

e1:74:cb:01:77:91

func Map

func Map() map[string]interface{}

Map will generate a random set of map data

Example

Code:

{
	Seed(11)
	fmt.Println(Map())
	// Output: map[contrast:Associate gauva:map[jump:scale] generally:8504801 him:[them whomever ours hence here his] its:8335564 table:map[did:[these delay these]] therefore:map[nearly:784141.8] thing:map[everything:[where caused why week hourly]]]
}

Output:

map[contrast:Associate gauva:map[jump:scale] generally:8504801 him:[them whomever ours hence here his] its:8335564 table:map[did:[these delay these]] therefore:map[nearly:784141.8] thing:map[everything:[where caused why week hourly]]]

func MinecraftAnimal

func MinecraftAnimal() string

MinecraftAnimal will generate a random Minecraft animal

Example

Code:

{
	Seed(11)
	fmt.Println(MinecraftAnimal())
	// Output:
	// chicken
}

Output:

chicken

func MinecraftArmorPart

func MinecraftArmorPart() string

MinecraftArmorPart will generate a random Minecraft armor part

Example

Code:

{
	Seed(11)
	fmt.Println(MinecraftArmorPart())
	// Output:
	// helmet
}

Output:

helmet

func MinecraftArmorTier

func MinecraftArmorTier() string

MinecraftArmorTier will generate a random Minecraft armor tier

Example

Code:

{
	Seed(11)
	fmt.Println(MinecraftArmorTier())
	// Output:
	// leather
}

Output:

leather

func MinecraftBiome

func MinecraftBiome() string

MinecraftBiome will generate a random Minecraft biome

Example

Code:

{
	Seed(11)
	fmt.Println(MinecraftBiome())
	// Output:
	// stone shore
}

Output:

stone shore

func MinecraftDye

func MinecraftDye() string

MinecraftDye will generate a random Minecraft dye

Example

Code:

{
	Seed(11)
	fmt.Println(MinecraftDye())
	// Output:
	// light gray
}

Output:

light gray

func MinecraftFood

func MinecraftFood() string

MinecraftFood will generate a random Minecraft food

Example

Code:

{
	Seed(11)
	fmt.Println(MinecraftFood())
	// Output:
	// beetroot
}

Output:

beetroot

func MinecraftMobBoss

func MinecraftMobBoss() string

MinecraftMobBoss will generate a random Minecraft mob boss

Example

Code:

{
	Seed(11)
	fmt.Println(MinecraftMobBoss())
	// Output:
	// ender dragon
}

Output:

ender dragon

func MinecraftMobHostile

func MinecraftMobHostile() string

MinecraftMobHostile will generate a random Minecraft mob hostile

Example

Code:

{
	Seed(11)
	fmt.Println(MinecraftMobHostile())
	// Output:
	// blaze
}

Output:

blaze

func MinecraftMobNeutral

func MinecraftMobNeutral() string

MinecraftMobNeutral will generate a random Minecraft mob neutral

Example

Code:

{
	Seed(11)
	fmt.Println(MinecraftMobNeutral())
	// Output:
	// wolf
}

Output:

wolf

func MinecraftMobPassive

func MinecraftMobPassive() string

MinecraftMobPassive will generate a random Minecraft mob passive

Example

Code:

{
	Seed(11)
	fmt.Println(MinecraftMobPassive())
	// Output:
	// chicken
}

Output:

chicken

func MinecraftOre

func MinecraftOre() string

MinecraftOre will generate a random Minecraft ore

Example

Code:

{
	Seed(11)
	fmt.Println(MinecraftOre())
	// Output:
	// coal
}

Output:

coal

func MinecraftTool

func MinecraftTool() string

MinecraftTool will generate a random Minecraft tool

Example

Code:

{
	Seed(11)
	fmt.Println(MinecraftTool())
	// Output:
	// pickaxe
}

Output:

pickaxe

func MinecraftVillagerJob

func MinecraftVillagerJob() string

MinecraftVillagerJob will generate a random Minecraft villager job

Example

Code:

{
	Seed(11)
	fmt.Println(MinecraftVillagerJob())
	// Output:
	// toolsmith
}

Output:

toolsmith

func MinecraftVillagerLevel

func MinecraftVillagerLevel() string

MinecraftVillagerLevel will generate a random Minecraft villager level

Example

Code:

{
	Seed(11)
	fmt.Println(MinecraftVillagerLevel())
	// Output:
	// novice
}

Output:

novice

func MinecraftVillagerStation

func MinecraftVillagerStation() string

MinecraftVillagerStation will generate a random Minecraft villager station

Example

Code:

{
	Seed(11)
	fmt.Println(MinecraftVillagerStation())
	// Output:
	// cauldron
}

Output:

cauldron

func MinecraftWeapon

func MinecraftWeapon() string

MinecraftWeapon will generate a random Minecraft weapon

Example

Code:

{
	Seed(11)
	fmt.Println(MinecraftWeapon())
	// Output:
	// sword
}

Output:

sword

func MinecraftWeather

func MinecraftWeather() string

MinecraftWeather will generate a random Minecraft weather

Example

Code:

{
	Seed(11)
	fmt.Println(MinecraftWeather())
	// Output:
	// clear
}

Output:

clear

func MinecraftWood

func MinecraftWood() string

MinecraftWood will generate a random Minecraft wood

Example

Code:

{
	Seed(11)
	fmt.Println(MinecraftWood())
	// Output:
	// oak
}

Output:

oak

func Minute

func Minute() int

Minute will generate a random minute

Example

Code:

{
	Seed(11)
	fmt.Println(Minute())
	// Output: 5
}

Output:

5

func Month

func Month() int

Month will generate a random month int

Example

Code:

{
	Seed(11)
	fmt.Println(Month())
	// Output: 6
}

Output:

6

func MonthString

func MonthString() string

MonthString will generate a random month string

Example

Code:

{
	Seed(11)
	fmt.Println(MonthString())
	// Output: June
}

Output:

June

func Name

func Name() string

Name will generate a random First and Last Name

Example

Code:

{
	Seed(11)
	fmt.Println(Name())
	// Output: Markus Moen
}

Output:

Markus Moen

func NamePrefix

func NamePrefix() string

NamePrefix will generate a random name prefix

Example

Code:

{
	Seed(11)
	fmt.Println(NamePrefix())
	// Output: Mr.
}

Output:

Mr.

func NameSuffix

func NameSuffix() string

NameSuffix will generate a random name suffix

Example

Code:

{
	Seed(11)
	fmt.Println(NameSuffix())
	// Output: Jr.
}

Output:

Jr.

func NanoSecond

func NanoSecond() int

NanoSecond will generate a random nano second

Example

Code:

{
	Seed(11)
	fmt.Println(NanoSecond())
	// Output: 693298265
}

Output:

693298265

func Noun

func Noun() string

Noun will generate a random noun

Example

Code:

{
	Seed(11)
	fmt.Println(Noun())
	// Output: aunt
}

Output:

aunt

func NounAbstract

func NounAbstract() string

NounAbstract will generate a random abstract noun

Example

Code:

{
	Seed(11)
	fmt.Println(NounAbstract())
	// Output: confusion
}

Output:

confusion

func NounCollectiveAnimal

func NounCollectiveAnimal() string

NounCollectiveAnimal will generate a random collective noun animal

Example

Code:

{
	Seed(11)
	fmt.Println(NounCollectiveAnimal())
	// Output: party
}

Output:

party

func NounCollectivePeople

func NounCollectivePeople() string

NounCollectivePeople will generate a random collective noun person

Example

Code:

{
	Seed(11)
	fmt.Println(NounCollectivePeople())
	// Output: body
}

Output:

body

func NounCollectiveThing

func NounCollectiveThing() string

NounCollectiveThing will generate a random collective noun thing

Example

Code:

{
	Seed(11)
	fmt.Println(NounCollectiveThing())
	// Output: hand
}

Output:

hand

func NounCommon

func NounCommon() string

NounCommon will generate a random common noun

Example

Code:

{
	Seed(11)
	fmt.Println(NounCommon())
	// Output: part
}

Output:

part

func NounConcrete

func NounConcrete() string

NounConcrete will generate a random concrete noun

Example

Code:

{
	Seed(11)
	fmt.Println(NounConcrete())
	// Output: snowman
}

Output:

snowman

func NounCountable

func NounCountable() string

NounCountable will generate a random countable noun

Example

Code:

{
	Seed(11)
	fmt.Println(NounCountable())
	// Output: neck
}

Output:

neck

func NounProper

func NounProper() string

NounProper will generate a random proper noun

Example

Code:

{
	Seed(11)
	fmt.Println(NounProper())
	// Output: Marcel
}

Output:

Marcel

func NounUncountable

func NounUncountable() string

NounUncountable will generate a random uncountable noun

Example

Code:

{
	Seed(11)
	fmt.Println(NounUncountable())
	// Output: seafood
}

Output:

seafood

func Number

func Number(min int, max int) int

Number will generate a random number between given min And max

Example

Code:

{
	Seed(11)
	fmt.Println(Number(50, 23456))
	// Output: 12583
}

Output:

12583

func Numerify

func Numerify(str string) string

Numerify will replace # with random numerical values

Example

Code:

{
	Seed(11)
	fmt.Println(Numerify("###-###-####"))
	// Output: 613-645-9948
}

Output:

613-645-9948

func OperaUserAgent

func OperaUserAgent() string

OperaUserAgent will generate a random opera browser user agent string

Example

Code:

{
	Seed(11)
	fmt.Println(OperaUserAgent())
	// Output: Opera/8.20 (Macintosh; U; PPC Mac OS X 10_9_10; en-US) Presto/2.9.198 Version/11.00
}

Output:

Opera/8.20 (Macintosh; U; PPC Mac OS X 10_9_10; en-US) Presto/2.9.198 Version/11.00

func Paragraph

func Paragraph(paragraphCount int, sentenceCount int, wordCount int, separator string) string

Paragraph will generate a random paragraphGenerator

Example

Code:

{
	Seed(11)
	fmt.Println(Paragraph(3, 5, 12, "\n"))
	// Output: There had result everything niche backwards caused quarterly without week it hungry. Thing someone him regularly today whomever this revolt hence from his timing. As quantity us these yours live these frantic not may another how. This ours his them those whose them batch its Iraqi most that. Few abroad cheese this whereas next how there gorgeous genetics time choir.
	// Fiction therefore yourselves am those infrequently heap software quarterly rather punctuation yellow. Where several his orchard to frequently hence victorious boxers each does auspicious. Yourselves first soup tomorrow this that must conclude anyway some yearly who. Cough laugh himself both yet rarely me dolphin intensely block would leap. Plane us first then down them eager would hundred super throughout animal.
	// Yet themselves been group flock shake part purchase up usually it her. None it hers boat what their there Turkmen moreover one Lebanese to. Brace these shower in it everybody should whatever those uninterested several nobody. Yours thankful innocent power to any from its few luxury none boy. Religion themselves it there might must near theirs mine thing tonight outside.
}

Output:

There had result everything niche backwards caused quarterly without week it hungry. Thing someone him regularly today whomever this revolt hence from his timing. As quantity us these yours live these frantic not may another how. This ours his them those whose them batch its Iraqi most that. Few abroad cheese this whereas next how there gorgeous genetics time choir.
Fiction therefore yourselves am those infrequently heap software quarterly rather punctuation yellow. Where several his orchard to frequently hence victorious boxers each does auspicious. Yourselves first soup tomorrow this that must conclude anyway some yearly who. Cough laugh himself both yet rarely me dolphin intensely block would leap. Plane us first then down them eager would hundred super throughout animal.
Yet themselves been group flock shake part purchase up usually it her. None it hers boat what their there Turkmen moreover one Lebanese to. Brace these shower in it everybody should whatever those uninterested several nobody. Yours thankful innocent power to any from its few luxury none boy. Religion themselves it there might must near theirs mine thing tonight outside.

func Password

func Password(lower bool, upper bool, numeric bool, special bool, space bool, num int) string

Password will generate a random password. Minimum number length of 5 if less than.

Example

Code:

{
	Seed(11)
	fmt.Println(Password(true, false, false, false, false, 32))
	fmt.Println(Password(false, true, false, false, false, 32))
	fmt.Println(Password(false, false, true, false, false, 32))
	fmt.Println(Password(false, false, false, true, false, 32))
	fmt.Println(Password(true, true, true, true, true, 32))
	fmt.Println(Password(true, true, true, true, true, 4))
	// Output: vodnqxzsuptgehrzylximvylxzoywexw
	// ZSRQWJFJWCSTVGXKYKWMLIAFGFELFJRG
	// 61718615932495608398906260648432
	// @$,@#:,(,).{?:%?)>*..<=};#$(:{==
	// CkF{wwb:?Kb},w?vdz{Zox C&>Prt99:
	// j ;9X
}

Output:

vodnqxzsuptgehrzylximvylxzoywexw
ZSRQWJFJWCSTVGXKYKWMLIAFGFELFJRG
61718615932495608398906260648432
@$,@#:,(,).{?:%?)>*..<=};#$(:{==
CkF{wwb:?Kb},w?vdz{Zox C&>Prt99:
j ;9X

func PetName

func PetName() string

PetName will return a random fun pet name

Example

Code:

{
	Seed(11)
	fmt.Println(PetName())
	// Output: Ozzy Pawsborne
}

Output:

Ozzy Pawsborne

func Phone

func Phone() string

Phone will generate a random phone number string

Example

Code:

{
	Seed(11)
	fmt.Println(Phone())
	// Output: 6136459948
}

Output:

6136459948

func PhoneFormatted

func PhoneFormatted() string

PhoneFormatted will generate a random phone number string

Example

Code:

{
	Seed(11)
	fmt.Println(PhoneFormatted())
	// Output: 136-459-9489
}

Output:

136-459-9489

func Phrase

func Phrase() string

Phrase will return a random phrase

Example

Code:

{
	Seed(11)
	fmt.Println(Phrase())
	// Output: horses for courses
}

Output:

horses for courses

func PhraseAdverb

func PhraseAdverb() string

PhraseAdverb will return a random adverb phrase

Example

Code:

{
	Seed(11)
	fmt.Println(PhraseAdverb())
	// Output: fully gladly
}

Output:

fully gladly

func PhraseNoun

func PhraseNoun() string

PhraseNoun will return a random noun phrase

Example

Code:

{
	Seed(11)
	fmt.Println(PhraseNoun())
	// Output: the purple tribe
}

Output:

the purple tribe

func PhrasePreposition

func PhrasePreposition() string

PhrasePreposition will return a random preposition phrase

Example

Code:

{
	Seed(11)
	fmt.Println(PhrasePreposition())
	// Output: out the tribe
}

Output:

out the tribe

func PhraseVerb

func PhraseVerb() string

PhraseVerb will return a random preposition phrase

Example

Code:

{
	Seed(11)
	fmt.Println(PhraseVerb())
	// Output: gladly dream indeed swiftly till a problem poorly
}

Output:

gladly dream indeed swiftly till a problem poorly

func Preposition

func Preposition() string

Preposition will generate a random preposition

Example

Code:

{
	Seed(11)
	fmt.Println(Preposition())
	// Output: other than
}

Output:

other than

func PrepositionCompound

func PrepositionCompound() string

PrepositionCompound will generate a random compound preposition

Example

Code:

{
	Seed(11)
	fmt.Println(PrepositionCompound())
	// Output: according to
}

Output:

according to

func PrepositionDouble

func PrepositionDouble() string

PrepositionDouble will generate a random double preposition

Example

Code:

{
	Seed(11)
	fmt.Println(PrepositionDouble())
	// Output: before
}

Output:

before

func PrepositionSimple

func PrepositionSimple() string

PrepositionSimple will generate a random simple preposition

Example

Code:

{
	Seed(11)
	fmt.Println(PrepositionSimple())
	// Output: out
}

Output:

out

func Price

func Price(min, max float64) float64

Price will take in a min and max value and return a formatted price

Example

Code:

{
	Seed(11)
	fmt.Printf("%.2f", Price(0.8618, 1000))
	// Output: 92.26
}

Output:

92.26

func ProgrammingLanguage

func ProgrammingLanguage() string

ProgrammingLanguage will return a random programming language

Example

Code:

{
	Seed(464)
	fmt.Println(ProgrammingLanguage())
	// Output: Go
}

Output:

Go

func ProgrammingLanguageBest

func ProgrammingLanguageBest() string

ProgrammingLanguageBest will return a random programming language

Example

Code:

{
	Seed(11)
	fmt.Println(ProgrammingLanguageBest())
	// Output: Go
}

Output:

Go

func Pronoun

func Pronoun() string

Pronoun will generate a random pronoun

Example

Code:

{
	Seed(11)
	fmt.Println(Pronoun())
	// Output: me
}

Output:

me

func PronounDemonstrative

func PronounDemonstrative() string

PronounDemonstrative will generate a random demonstrative pronoun

Example

Code:

{
	Seed(11)
	fmt.Println(PronounDemonstrative())
	// Output: this
}

Output:

this

func PronounIndefinite

func PronounIndefinite() string

PronounIndefinite will generate a random indefinite pronoun

Example

Code:

{
	Seed(11)
	fmt.Println(PronounIndefinite())
	// Output: few
}

Output:

few

func PronounInterrogative

func PronounInterrogative() string

PronounInterrogative will generate a random interrogative pronoun

Example

Code:

{
	Seed(11)
	fmt.Println(PronounInterrogative())
	// Output: what
}

Output:

what

func PronounObject

func PronounObject() string

PronounObject will generate a random object pronoun

Example

Code:

{
	Seed(11)
	fmt.Println(PronounObject())
	// Output: it
}

Output:

it

func PronounPersonal

func PronounPersonal() string

PronounPersonal will generate a random personal pronoun

Example

Code:

{
	Seed(11)
	fmt.Println(PronounPersonal())
	// Output: it
}

Output:

it

func PronounPossessive

func PronounPossessive() string

PronounPossessive will generate a random possessive pronoun

Example

Code:

{
	Seed(11)
	fmt.Println(PronounPossessive())
	// Output: mine
}

Output:

mine

func PronounReflective

func PronounReflective() string

PronounReflective will generate a random reflective pronoun

Example

Code:

{
	Seed(11)
	fmt.Println(PronounReflective())
	// Output: myself
}

Output:

myself

func PronounRelative

func PronounRelative() string

PronounRelative will generate a random relative pronoun

Example

Code:

{
	Seed(11)
	fmt.Println(PronounRelative())
	// Output: as
}

Output:

as

func Question

func Question() string

Question will return a random question

Example

Code:

{
	Seed(11)
	fmt.Println(Question())
	// Output: Roof chia echo pickled?
}

Output:

Roof chia echo pickled?

func Quote

func Quote() string

Quote will return a random quote from a random person

Example

Code:

{
	Seed(11)
	fmt.Println(Quote())
	// Output: "Roof chia echo pickled." - Marques Jakubowski
}

Output:

"Roof chia echo pickled." - Marques Jakubowski

func RGBColor

func RGBColor() []int

RGBColor will generate a random int slice color

Example

Code:

{
	Seed(11)
	fmt.Println(RGBColor())
	// Output: [89 176 195]
}

Output:

[89 176 195]

func RandomInt

func RandomInt(i []int) int

RandomInt will take in a slice of int and return a randomly selected value

Example

Code:

{
	Seed(11)

	ints := []int{52, 854, 941, 74125, 8413, 777, 89416, 841657}
	fmt.Println(RandomInt(ints))
	// Output: 52
}

Output:

52

func RandomMapKey

func RandomMapKey(mapI interface{}) interface{}

RandomMapKey will return a random key from a map

func RandomString

func RandomString(a []string) string

RandomString will take in a slice of string and return a randomly selected value

Example

Code:

{
	Seed(11)
	fmt.Println(RandomString([]string{"hello", "world"}))
	// Output: hello
}

Output:

hello

func RandomUint

func RandomUint(u []uint) uint

RandomUint will take in a slice of uint and return a randomly selected value

Example

Code:

{
	Seed(11)

	ints := []uint{52, 854, 941, 74125, 8413, 777, 89416, 841657}
	fmt.Println(RandomUint(ints))
	// Output: 52
}

Output:

52

func Regex

func Regex(regexStr string) string

Regex will generate a string based upon a RE2 syntax

Example

Code:

{
	Seed(11)

	fmt.Println(Regex("[abcdef]{5}"))
	fmt.Println(Regex("[[:upper:]]{5}"))
	fmt.Println(Regex("(hello|world|whats|up)"))
	fmt.Println(Regex(`^[a-z]{5,10}@[a-z]{5,10}\.(com|net|org)$`))
	// Output: affec
	// RXHKI
	// world
	// tapwyjdnsm@gtlxw.net
}

Output:

affec
RXHKI
world
tapwyjdnsm@gtlxw.net

func RemoveFuncLookup

func RemoveFuncLookup(functionName string)

RemoveFuncLookup will remove a function from lookup

func SSN

func SSN() string

SSN will generate a random Social Security Number

Example

Code:

{
	Seed(11)
	fmt.Println(SSN())
	// Output: 493298265
}

Output:

493298265

func SafariUserAgent

func SafariUserAgent() string

SafariUserAgent will generate a random safari browser user agent string

Example

Code:

{
	Seed(11)
	fmt.Println(SafariUserAgent())
	// Output: Mozilla/5.0 (iPad; CPU OS 7_0_2 like Mac OS X; en-US) AppleWebKit/536.4.4 (KHTML, like Gecko) Version/3.0.5 Mobile/8B120 Safari/6536.4.4
}

Output:

Mozilla/5.0 (iPad; CPU OS 7_0_2 like Mac OS X; en-US) AppleWebKit/536.4.4 (KHTML, like Gecko) Version/3.0.5 Mobile/8B120 Safari/6536.4.4

func SafeColor

func SafeColor() string

SafeColor will generate a random safe color string

Example

Code:

{
	Seed(11)
	fmt.Println(SafeColor())
	// Output: black
}

Output:

black

func Second

func Second() int

Second will generate a random second

Example

Code:

{
	Seed(11)
	fmt.Println(Second())
	// Output: 5
}

Output:

5

func Seed

func Seed(seed int64)

Seed will set the global random value. Setting seed to 0 will use crypto/rand

func Sentence

func Sentence(wordCount int) string

Sentence will generate a random sentence

Example

Code:

{
	Seed(11)
	fmt.Println(Sentence(5))
	// Output: There had result everything niche.
}

Output:

There had result everything niche.

func SentenceSimple

func SentenceSimple() string

SentenceSimple will generate a random simple sentence

Example

Code:

{
	Seed(11)
	fmt.Println(SentenceSimple())
	// Output: The purple tribe indeed swiftly laugh.
}

Output:

The purple tribe indeed swiftly laugh.

func SetGlobalFaker

func SetGlobalFaker(faker *Faker)

SetGlobalFaker will allow you to set what type of faker is globally used. Defailt is math/rand

Example

Code:

{
	cryptoFaker := NewCrypto()
	SetGlobalFaker(cryptoFaker)
}

func ShuffleAnySlice

func ShuffleAnySlice(v interface{})

ShuffleAnySlice takes in a slice and outputs it in a random order

Example

Code:

{
	Seed(11)

	strings := []string{"happy", "times", "for", "everyone", "have", "a", "good", "day"}
	ShuffleAnySlice(strings)
	fmt.Println(strings)

	ints := []int{52, 854, 941, 74125, 8413, 777, 89416, 841657}
	ShuffleAnySlice(ints)
	fmt.Println(ints)
	// Output:
	// [good everyone have for times a day happy]
	// [777 74125 941 854 89416 52 8413 841657]
}

Output:

[good everyone have for times a day happy]
[777 74125 941 854 89416 52 8413 841657]

func ShuffleInts

func ShuffleInts(a []int)

ShuffleInts will randomize a slice of ints

Example

Code:

{
	Seed(11)

	ints := []int{52, 854, 941, 74125, 8413, 777, 89416, 841657}
	ShuffleInts(ints)
	fmt.Println(ints)
	// Output: [74125 777 941 89416 8413 854 52 841657]
}

Output:

[74125 777 941 89416 8413 854 52 841657]

func ShuffleStrings

func ShuffleStrings(a []string)

ShuffleStrings will randomize a slice of strings

Example

Code:

{
	Seed(11)
	strings := []string{"happy", "times", "for", "everyone", "have", "a", "good", "day"}
	ShuffleStrings(strings)
	fmt.Println(strings)
	// Output: [good everyone have for times a day happy]
}

Output:

[good everyone have for times a day happy]

func Slice

func Slice(v interface{})

Slice fills built-in types and exported fields of a struct with random data.

Example

Code:

{
	Seed(11)

	var S []string
	Slice(&S)

	I := make([]int8, 3)
	Slice(&I)

	fmt.Println(S)
	fmt.Println(I)

	// Output: [RMaRxHkiJ PtapWYJdn MKgtlxwnq qclaYkWw oRLOPxLIok qanPAKaXS]
	// [-88 -101 60]
}

Output:

[RMaRxHkiJ PtapWYJdn MKgtlxwnq qclaYkWw oRLOPxLIok qanPAKaXS]
[-88 -101 60]
Example (Struct)

Code:

{
	Seed(11)

	type Basic struct {
		S string `fake:"{firstname}"`
		I int
		F float32
	}

	var B []Basic
	Slice(&B)

	fmt.Println(B)
	// Output: [{Marcel -652938557 1.9343967e+38} {Lura -101175613 2.670526e+38} {Lucinda 1412367049 1.0427679e+38} {Santino 1631045574 2.2573786e+38} {Dawn -924758850 4.249854e+37} {Alice -937677379 1.0573345e+38}]
}

Output:

[{Marcel -652938557 1.9343967e+38} {Lura -101175613 2.670526e+38} {Lucinda 1412367049 1.0427679e+38} {Santino 1631045574 2.2573786e+38} {Dawn -924758850 4.249854e+37} {Alice -937677379 1.0573345e+38}]

func Snack

func Snack() string

Snack will return a random snack name

Example

Code:

{
	Seed(11)
	fmt.Println(Snack())
	// Output: Hoisin marinated wing pieces
}

Output:

Hoisin marinated wing pieces

func State

func State() string

State will generate a random state string

Example

Code:

{
	Seed(11)
	fmt.Println(State())
	// Output: Hawaii
}

Output:

Hawaii

func StateAbr

func StateAbr() string

StateAbr will generate a random abbreviated state string

Example

Code:

{
	Seed(11)
	fmt.Println(StateAbr())
	// Output: CO
}

Output:

CO

func Street

func Street() string

Street will generate a random address street string

Example

Code:

{
	Seed(11)
	fmt.Println(Street())
	// Output: 364 Unions ville
}

Output:

364 Unions ville

func StreetName

func StreetName() string

StreetName will generate a random address street name string

Example

Code:

{
	Seed(11)
	fmt.Println(StreetName())
	// Output: View
}

Output:

View

func StreetNumber

func StreetNumber() string

StreetNumber will generate a random address street number string

Example

Code:

{
	Seed(11)
	fmt.Println(StreetNumber())
	// Output: 13645
}

Output:

13645

func StreetPrefix

func StreetPrefix() string

StreetPrefix will generate a random address street prefix string

Example

Code:

{
	Seed(11)
	fmt.Println(StreetPrefix())
	// Output: Lake
}

Output:

Lake

func StreetSuffix

func StreetSuffix() string

StreetSuffix will generate a random address street suffix string

Example

Code:

{
	Seed(11)
	fmt.Println(StreetSuffix())
	// Output: land
}

Output:

land

func Struct

func Struct(v interface{}) error

Struct fills in exported fields of a struct with random data based on the value of `fake` tag of exported fields. Use `fake:"skip"` to explicitly skip an element. All built-in types are supported, with templating support for string types.

Example

Code:

{
	Seed(11)

	type Bar struct {
		Name   string
		Number int
		Float  float32
	}

	type Foo struct {
		Str     string
		Int     int
		Pointer *int
		Name    string            `fake:"{firstname}"`
		Number  string            `fake:"{number:1,10}"`
		Skip    *string           `fake:"skip"`
		Array   []string          `fakesize:"2"`
		Map     map[string]string `fakesize:"2"`
		Bar     Bar
	}

	var f Foo
	Struct(&f)

	fmt.Printf("%s\n", f.Str)
	fmt.Printf("%d\n", f.Int)
	fmt.Printf("%d\n", *f.Pointer)
	fmt.Printf("%v\n", f.Name)
	fmt.Printf("%v\n", f.Number)
	fmt.Printf("%v\n", f.Skip)
	fmt.Printf("%v\n", f.Array)
	fmt.Printf("%v\n", f.Map)
	fmt.Printf("%+v\n", f.Bar)

	// Output: bRMaRx
	// -605057214
	// 1412367049
	// Andre
	// 1
	// <nil>
	// [PtapWYJdn MKgtlxwnq]
	// map[qanPAKaXS:QFpZysVaHG qclaYkWw:oRLOPxLIok]
	// {Name:yvqqdH Number:-356428491 Float:2.8838284e+38}
}

Output:

bRMaRx
-605057214
1412367049
Andre
1
<nil>
[PtapWYJdn MKgtlxwnq]
map[qanPAKaXS:QFpZysVaHG qclaYkWw:oRLOPxLIok]
{Name:yvqqdH Number:-356428491 Float:2.8838284e+38}
Example (Array)

Code:

{
	Seed(11)

	type Foo struct {
		Bar    string
		Int    int
		Name   string  `fake:"{firstname}"`
		Number string  `fake:"{number:1,10}"`
		Skip   *string `fake:"skip"`
	}

	type FooMany struct {
		Foos  []Foo    `fakesize:"1"`
		Names []string `fake:"{firstname}" fakesize:"3"`
	}

	var fm FooMany
	Struct(&fm)

	fmt.Printf("%v\n", fm.Foos)
	fmt.Printf("%v\n", fm.Names)

	// Output:
	// [{bRMaRx -605057214 Paolo 4 <nil>}]
	// [Santino Carole Enrique]
}

Output:

[{bRMaRx -605057214 Paolo 4 <nil>}]
[Santino Carole Enrique]

func Teams

func Teams(peopleArray []string, teamsArray []string) map[string][]string

Teams takes in an array of people and team names and randomly places the people into teams as evenly as possible

Example

Code:

{
	Seed(11)
	fmt.Println(Teams(
		[]string{"Billy", "Sharon", "Jeff", "Connor", "Steve", "Justin", "Fabian", "Robert"},
		[]string{"Team 1", "Team 2", "Team 3"},
	))
	// Output: map[Team 1:[Fabian Connor Steve] Team 2:[Jeff Sharon Justin] Team 3:[Robert Billy]]
}

Output:

map[Team 1:[Fabian Connor Steve] Team 2:[Jeff Sharon Justin] Team 3:[Robert Billy]]

func TimeZone

func TimeZone() string

TimeZone will select a random timezone string

Example

Code:

{
	Seed(11)
	fmt.Println(TimeZone())
	// Output: Kaliningrad Standard Time
}

Output:

Kaliningrad Standard Time

func TimeZoneAbv

func TimeZoneAbv() string

TimeZoneAbv will select a random timezone abbreviation string

Example

Code:

{
	Seed(11)
	fmt.Println(TimeZoneAbv())
	// Output: KST
}

Output:

KST

func TimeZoneFull

func TimeZoneFull() string

TimeZoneFull will select a random full timezone string

Example

Code:

{
	Seed(11)
	fmt.Println(TimeZoneFull())
	// Output: (UTC+03:00) Kaliningrad, Minsk
}

Output:

(UTC+03:00) Kaliningrad, Minsk

func TimeZoneOffset

func TimeZoneOffset() float32

TimeZoneOffset will select a random timezone offset

Example

Code:

{
	Seed(11)
	fmt.Println(TimeZoneOffset())
	// Output: 3
}

Output:

3

func TimeZoneRegion

func TimeZoneRegion() string

TimeZoneRegion will select a random region style timezone string, e.g. "America/Chicago"

Example

Code:

{
	Seed(11)
	fmt.Println(TimeZoneRegion())
	// Output: America/Vancouver
}

Output:

America/Vancouver

func URL

func URL() string

URL will generate a random url string

Example

Code:

{
	Seed(11)
	fmt.Println(URL())
	// Output: https://www.dynamiciterate.name/target/seamless
}

Output:

https://www.dynamiciterate.name/target/seamless

func UUID

func UUID() string

UUID (version 4) will generate a random unique identifier based upon random numbers Format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Example

Code:

{
	Seed(11)
	fmt.Println(UUID())
	// Output: 590c1440-9888-45b0-bd51-a817ee07c3f2
}

Output:

590c1440-9888-45b0-bd51-a817ee07c3f2

func Uint16

func Uint16() uint16

Uint16 will generate a random uint16 value

Example

Code:

{
	Seed(11)
	fmt.Println(Uint16())
	// Output: 34968
}

Output:

34968

func Uint32

func Uint32() uint32

Uint32 will generate a random uint32 value

Example

Code:

{
	Seed(11)
	fmt.Println(Uint32())
	// Output: 1075055705
}

Output:

1075055705

func Uint64

func Uint64() uint64

Uint64 will generate a random uint64 value

Example

Code:

{
	Seed(11)
	fmt.Println(Uint64())
	// Output: 10067102729548074073
}

Output:

10067102729548074073

func Uint8

func Uint8() uint8

Uint8 will generate a random uint8 value

Example

Code:

{
	Seed(11)
	fmt.Println(Uint8())
	// Output: 152
}

Output:

152

func UintRange

func UintRange(min, max uint) uint

UintRange will generate a random uint value between min and max

Example

Code:

{
	Seed(11)
	fmt.Println(UintRange(1, 10))
	// Output: 1
}

Output:

1

func UserAgent

func UserAgent() string

UserAgent will generate a random broswer user agent

Example

Code:

{
	Seed(11)
	fmt.Println(UserAgent())
	// Output: Mozilla/5.0 (Windows NT 5.0) AppleWebKit/5312 (KHTML, like Gecko) Chrome/40.0.800.0 Mobile Safari/5312
}

Output:

Mozilla/5.0 (Windows NT 5.0) AppleWebKit/5312 (KHTML, like Gecko) Chrome/40.0.800.0 Mobile Safari/5312

func Username

func Username() string

Username will generate a random username based upon picking a random lastname and random numbers at the end

Example

Code:

{
	Seed(11)
	fmt.Println(Username())
	// Output: Daniel1364
}

Output:

Daniel1364

func Vegetable

func Vegetable() string

Vegetable will return a random vegetable name

Example

Code:

{
	Seed(11)
	fmt.Println(Vegetable())
	// Output: Amaranth Leaves
}

Output:

Amaranth Leaves

func Verb

func Verb() string

Verb will generate a random verb

Example

Code:

{
	Seed(11)
	fmt.Println(Verb())
	// Output: does
}

Output:

does

func VerbAction

func VerbAction() string

VerbAction will generate a random action verb

Example

Code:

{
	Seed(11)
	fmt.Println(VerbAction())
	// Output: close
}

Output:

close

func VerbHelping

func VerbHelping() string

VerbHelping will generate a random helping verb

Example

Code:

{
	Seed(11)
	fmt.Println(VerbHelping())
	// Output: be
}

Output:

be

func VerbIntransitive

func VerbIntransitive() string

VerbIntransitive will generate a random intransitive verb

Example

Code:

{
	Seed(11)
	fmt.Println(VerbIntransitive())
	// Output: laugh
}

Output:

laugh

func VerbLinking

func VerbLinking() string

VerbLinking will generate a random linking verb

Example

Code:

{
	Seed(11)
	fmt.Println(VerbLinking())
	// Output: was
}

Output:

was

func VerbTransitive

func VerbTransitive() string

VerbTransitive will generate a random transitive verb

Example

Code:

{
	Seed(11)
	fmt.Println(VerbTransitive())
	// Output: follow
}

Output:

follow

func WeekDay

func WeekDay() string

WeekDay will generate a random weekday string (Monday-Sunday)

Example

Code:

{
	Seed(11)
	fmt.Println(WeekDay())
	// Output: Tuesday
}

Output:

Tuesday

func Weighted

func Weighted(options []interface{}, weights []float32) (interface{}, error)

Weighted will take in an array of options and weights and return a random selection based upon its indexed weight

Example

Code:

{
	Seed(11)

	options := []interface{}{"hello", 2, 6.9}
	weights := []float32{1, 2, 3}
	option, _ := Weighted(options, weights)

	fmt.Println(option)
	// Output: hello
}

Output:

hello

func Word

func Word() string

Word will generate a random word

Example

Code:

{
	Seed(11)
	fmt.Println(Word())
	// Output: there
}

Output:

there

func XML

func XML(xo *XMLOptions) ([]byte, error)

XML generates an object or an array of objects in json format

Example (Array)

Code:

{
	Seed(11)

	value, err := XML(&XMLOptions{
		Type:          "array",
		RootElement:   "xml",
		RecordElement: "record",
		RowCount:      2,
		Indent:        true,
		Fields: []Field{
			{Name: "first_name", Function: "firstname"},
			{Name: "last_name", Function: "lastname"},
			{Name: "password", Function: "password", Params: MapParams{"special": {"false"}}},
		},
	})
	if err != nil {
		fmt.Println(err)
	}

	fmt.Println(string(value))

	// Output:
	// <xml>
	//     <record>
	//         <first_name>Markus</first_name>
	//         <last_name>Moen</last_name>
	//         <password>Dc0VYXjkWABx</password>
	//     </record>
	//     <record>
	//         <first_name>Osborne</first_name>
	//         <last_name>Hilll</last_name>
	//         <password>XPJ9OVNbs5lm</password>
	//     </record>
	// </xml>
}

Output:

<xml>
    <record>
        <first_name>Markus</first_name>
        <last_name>Moen</last_name>
        <password>Dc0VYXjkWABx</password>
    </record>
    <record>
        <first_name>Osborne</first_name>
        <last_name>Hilll</last_name>
        <password>XPJ9OVNbs5lm</password>
    </record>
</xml>
Example (Single)

Code:

{
	Seed(11)

	value, err := XML(&XMLOptions{
		Type:          "single",
		RootElement:   "xml",
		RecordElement: "record",
		RowCount:      2,
		Indent:        true,
		Fields: []Field{
			{Name: "first_name", Function: "firstname"},
			{Name: "last_name", Function: "lastname"},
			{Name: "password", Function: "password", Params: MapParams{"special": {"false"}}},
		},
	})
	if err != nil {
		fmt.Println(err)
	}

	fmt.Println(string(value))

	// Output:
	// <xml>
	//     <first_name>Markus</first_name>
	//     <last_name>Moen</last_name>
	//     <password>Dc0VYXjkWABx</password>
	// </xml>
}

Output:

<xml>
    <first_name>Markus</first_name>
    <last_name>Moen</last_name>
    <password>Dc0VYXjkWABx</password>
</xml>

func Year

func Year() int

Year will generate a random year between 1900 - current year

Example

Code:

{
	Seed(11)
	fmt.Println(Year())
	// Output: 1995
}

Output:

1995

func Zip

func Zip() string

Zip will generate a random Zip code string

Example

Code:

{
	Seed(11)
	fmt.Println(Zip())
	// Output: 13645
}

Output:

13645

Types

type AddressInfo

type AddressInfo struct {
	Address   string  `json:"address" xml:"address"`
	Street    string  `json:"street" xml:"street"`
	City      string  `json:"city" xml:"city"`
	State     string  `json:"state" xml:"state"`
	Zip       string  `json:"zip" xml:"zip"`
	Country   string  `json:"country" xml:"country"`
	Latitude  float64 `json:"latitude" xml:"latitude"`
	Longitude float64 `json:"longitude" xml:"longitude"`
}

AddressInfo is a struct full of address information

func Address

func Address() *AddressInfo

Address will generate a struct of address information

Example

Code:

{
	Seed(11)
	address := Address()
	fmt.Println(address.Address)
	fmt.Println(address.Street)
	fmt.Println(address.City)
	fmt.Println(address.State)
	fmt.Println(address.Zip)
	fmt.Println(address.Country)
	fmt.Println(address.Latitude)
	fmt.Println(address.Longitude)
	// Output: 364 Unions ville, Norfolk, Ohio 99536
	// 364 Unions ville
	// Norfolk
	// Ohio
	// 99536
	// Lesotho
	// 88.792592
	// 174.504681
}

Output:

364 Unions ville, Norfolk, Ohio 99536
364 Unions ville
Norfolk
Ohio
99536
Lesotho
88.792592
174.504681

type CSVOptions

type CSVOptions struct {
	Delimiter string  `json:"delimiter" xml:"delimiter"`
	RowCount  int     `json:"row_count" xml:"row_count"`
	Fields    []Field `json:"fields" xml:"fields"`
}

CSVOptions defines values needed for csv generation

type CarInfo

type CarInfo struct {
	Type         string `json:"type" xml:"type"`
	Fuel         string `json:"fuel" xml:"fuel"`
	Transmission string `json:"transmission" xml:"transmission"`
	Brand        string `json:"brand" xml:"brand"`
	Model        string `json:"model" xml:"model"`
	Year         int    `json:"year" xml:"year"`
}

CarInfo is a struct dataset of all car information

func Car

func Car() *CarInfo

Car will generate a struct with car information

Example

Code:

{
	Seed(11)
	car := Car()
	fmt.Println(car.Brand)
	fmt.Println(car.Fuel)
	fmt.Println(car.Model)
	fmt.Println(car.Transmission)
	fmt.Println(car.Type)
	fmt.Println(car.Year)

	// Output: Fiat
	// Gasoline
	// Freestyle Fwd
	// Automatic
	// Passenger car mini
	// 1989
}

Output:

Fiat
Gasoline
Freestyle Fwd
Automatic
Passenger car mini
1989

type ContactInfo

type ContactInfo struct {
	Phone string `json:"phone" xml:"phone"`
	Email string `json:"email" xml:"email"`
}

ContactInfo struct full of contact info

func Contact

func Contact() *ContactInfo

Contact will generate a struct with information randomly populated contact information

Example

Code:

{
	Seed(11)
	contact := Contact()
	fmt.Println(contact.Phone)
	fmt.Println(contact.Email)
	// Output: 6136459948
	// carolecarroll@bosco.com
}

Output:

6136459948
carolecarroll@bosco.com

type CreditCardInfo

type CreditCardInfo struct {
	Type   string `json:"type" xml:"type"`
	Number string `json:"number" xml:"number"`
	Exp    string `json:"exp" xml:"exp"`
	Cvv    string `json:"cvv" xml:"cvv"`
}

CreditCardInfo is a struct containing credit variables

func CreditCard

func CreditCard() *CreditCardInfo

CreditCard will generate a struct full of credit card information

Example

Code:

{
	Seed(11)
	ccInfo := CreditCard()
	fmt.Println(ccInfo.Type)
	fmt.Println(ccInfo.Number)
	fmt.Println(ccInfo.Exp)
	fmt.Println(ccInfo.Cvv)
	// Output:
	// UnionPay
	// 4364599489953698
	// 02/23
	// 300
}

Output:

UnionPay
4364599489953698
02/23
300

type CreditCardOptions

type CreditCardOptions struct {
	Types []string `json:"types"`
	Bins  []string `json:"bins"` // optional parameter of prepended numbers
	Gaps  bool     `json:"gaps"`
}

CreditCardOptions is the options for credit card number

type CurrencyInfo

type CurrencyInfo struct {
	Short string `json:"short" xml:"short"`
	Long  string `json:"long" xml:"long"`
}

CurrencyInfo is a struct of currency information

func Currency

func Currency() *CurrencyInfo

Currency will generate a struct with random currency information

Example

Code:

{
	Seed(11)
	currency := Currency()
	fmt.Printf("%s - %s", currency.Short, currency.Long)
	// Output: IQD - Iraq Dinar
}

Output:

IQD - Iraq Dinar

type Faker

type Faker struct {
	Rand *rand.Rand
}

Faker struct is the primary struct for using localized.

func New

func New(seed int64) *Faker

New will utilize math/rand for concurrent random usage. Setting seed to 0 will use crypto/rand for the initial seed number.

Example

Code:

{
	// Create new pseudo random faker struct and set initial seed
	fake := New(11)

	// All global functions are also available in the structs methods
	fmt.Println("Name:", fake.Name())
	fmt.Println("Email:", fake.Email())
	fmt.Println("Phone:", fake.Phone())
	// Output:
	// Name: Markus Moen
	// Email: alaynawuckert@kozey.biz
	// Phone: 9948995369
}

Output:

Name: Markus Moen
Email: alaynawuckert@kozey.biz
Phone: 9948995369

func NewCrypto

func NewCrypto() *Faker

NewCrypto will utilize crypto/rand for concurrent random usage.

Example

Code:

{
	// Create new crypto faker struct
	fake := NewCrypto()

	// All global functions are also available in the structs methods
	fmt.Println("Name:", fake.Name())
	fmt.Println("Email:", fake.Email())
	fmt.Println("Phone:", fake.Phone())

	// Cannot output example as crypto/rand cant be predicted
}

func NewCustom

func NewCustom(source rand.Source64) *Faker

NewCustom will utilize a custom rand.Source64 for concurrent random usage See https://golang.org/src/math/rand/rand.go for required interface methods

Example

Code:

{
	// Setup stuct and methods required to meet interface needs
	// type customRand struct {}
	// func (c *customRand) Seed(seed int64) {}
	// func (c *customRand) Uint64() uint64 { return 8675309 }
	// func (c *customRand) Int63() int64 { return int64(c.Uint64() & ^uint64(1<<63)) }

	// Create new custom faker struct
	fake := NewCustom(&customRand{})

	// All global functions are also available in the structs methods
	fmt.Println("Name:", fake.Name())
	fmt.Println("Email:", fake.Email())
	fmt.Println("Phone:", fake.Phone())
	// Output:
	// Name: Aaliyah Abbott
	// Email: aaliyahabbott@abbott.com
	// Phone: 1000000000
}

Output:

Name: Aaliyah Abbott
Email: aaliyahabbott@abbott.com
Phone: 1000000000

func NewUnlocked

func NewUnlocked(seed int64) *Faker

NewUnlocked will utilize math/rand for non concurrent safe random usage. Setting seed to 0 will use crypto/rand for the initial seed number. NewUnlocked is more performant but not safe to run concurrently.

Example

Code:

{
	fake := NewUnlocked(11)

	// All global functions are also available in the structs methods
	fmt.Println("Name:", fake.Name())
	fmt.Println("Email:", fake.Email())
	fmt.Println("Phone:", fake.Phone())
	// Output:
	// Name: Markus Moen
	// Email: alaynawuckert@kozey.biz
	// Phone: 9948995369
}

Output:

Name: Markus Moen
Email: alaynawuckert@kozey.biz
Phone: 9948995369

func (*Faker) AchAccount

func (f *Faker) AchAccount() string

AchAccount will generate a 12 digit account number

Example

Code:

{
	f := New(11)
	fmt.Println(f.AchAccount())
	// Output: 413645994899
}

Output:

413645994899

func (*Faker) AchRouting

func (f *Faker) AchRouting() string

AchRouting will generate a 9 digit routing number

Example

Code:

{
	f := New(11)
	fmt.Println(f.AchRouting())
	// Output: 713645994
}

Output:

713645994

func (*Faker) Address

func (f *Faker) Address() *AddressInfo

Address will generate a struct of address information

Example

Code:

{
	f := New(11)
	address := f.Address()
	fmt.Println(address.Address)
	fmt.Println(address.Street)
	fmt.Println(address.City)
	fmt.Println(address.State)
	fmt.Println(address.Zip)
	fmt.Println(address.Country)
	fmt.Println(address.Latitude)
	fmt.Println(address.Longitude)
	// Output: 364 Unions ville, Norfolk, Ohio 99536
	// 364 Unions ville
	// Norfolk
	// Ohio
	// 99536
	// Lesotho
	// 88.792592
	// 174.504681
}

Output:

364 Unions ville, Norfolk, Ohio 99536
364 Unions ville
Norfolk
Ohio
99536
Lesotho
88.792592
174.504681

func (*Faker) Adjective

func (f *Faker) Adjective() string

Adjective will generate a random adjective

Example

Code:

{
	f := New(11)
	fmt.Println(f.Adjective())
	// Output: Dutch
}

Output:

Dutch

func (*Faker) AdjectiveDemonstrative

func (f *Faker) AdjectiveDemonstrative() string

AdjectiveDemonstrative will generate a random demonstrative adjective

Example

Code:

{
	f := New(11)
	fmt.Println(f.AdjectiveDemonstrative())
	// Output: this
}

Output:

this

func (*Faker) AdjectiveDescriptive

func (f *Faker) AdjectiveDescriptive() string

AdjectiveDescriptive will generate a random descriptive adjective

Example

Code:

{
	f := New(11)
	fmt.Println(f.AdjectiveDescriptive())
	// Output: brave
}

Output:

brave

func (*Faker) AdjectiveIndefinite

func (f *Faker) AdjectiveIndefinite() string

AdjectiveIndefinite will generate a random indefinite adjective

Example

Code:

{
	f := New(11)
	fmt.Println(f.AdjectiveIndefinite())
	// Output: few
}

Output:

few

func (*Faker) AdjectiveInterrogative

func (f *Faker) AdjectiveInterrogative() string

AdjectiveInterrogative will generate a random interrogative adjective

Example

Code:

{
	f := New(11)
	fmt.Println(f.AdjectiveInterrogative())
	// Output: what
}

Output:

what

func (*Faker) AdjectivePossessive

func (f *Faker) AdjectivePossessive() string

AdjectivePossessive will generate a random possessive adjective

Example

Code:

{
	f := New(11)
	fmt.Println(f.AdjectivePossessive())
	// Output: our
}

Output:

our

func (*Faker) AdjectiveProper

func (f *Faker) AdjectiveProper() string

AdjectiveProper will generate a random proper adjective

Example

Code:

{
	f := New(11)
	fmt.Println(f.AdjectiveProper())
	// Output: Afghan
}

Output:

Afghan

func (*Faker) AdjectiveQuantitative

func (f *Faker) AdjectiveQuantitative() string

AdjectiveQuantitative will generate a random quantitative adjective

Example

Code:

{
	f := New(11)
	fmt.Println(f.AdjectiveQuantitative())
	// Output: a little
}

Output:

a little

func (*Faker) Adverb

func (f *Faker) Adverb() string

Adverb will generate a random adverb

Example

Code:

{
	f := New(11)
	fmt.Println(f.Adverb())
	// Output: over
}

Output:

over

func (*Faker) AdverbDegree

func (f *Faker) AdverbDegree() string

AdverbDegree will generate a random degree adverb

Example

Code:

{
	f := New(11)
	fmt.Println(f.AdverbDegree())
	// Output: intensely
}

Output:

intensely

func (*Faker) AdverbFrequencyDefinite

func (f *Faker) AdverbFrequencyDefinite() string

AdverbFrequencyDefinite will generate a random frequency definite adverb

Example

Code:

{
	f := New(11)
	fmt.Println(f.AdverbFrequencyDefinite())
	// Output: hourly
}

Output:

hourly

func (*Faker) AdverbFrequencyIndefinite

func (f *Faker) AdverbFrequencyIndefinite() string

AdverbFrequencyIndefinite will generate a random frequency indefinite adverb

Example

Code:

{
	f := New(11)
	fmt.Println(f.AdverbFrequencyIndefinite())
	// Output: occasionally
}

Output:

occasionally

func (*Faker) AdverbManner

func (f *Faker) AdverbManner() string

AdverbManner will generate a random manner adverb

Example

Code:

{
	f := New(11)
	fmt.Println(f.AdverbManner())
	// Output: stupidly
}

Output:

stupidly

func (*Faker) AdverbPlace

func (f *Faker) AdverbPlace() string

AdverbPlace will generate a random place adverb

Example

Code:

{
	f := New(11)
	fmt.Println(f.AdverbPlace())
	// Output: east
}

Output:

east

func (*Faker) AdverbTimeDefinite

func (f *Faker) AdverbTimeDefinite() string

AdverbTimeDefinite will generate a random time definite adverb

Example

Code:

{
	f := New(11)
	fmt.Println(f.AdverbTimeDefinite())
	// Output: now
}

Output:

now

func (*Faker) AdverbTimeIndefinite

func (f *Faker) AdverbTimeIndefinite() string

AdverbTimeIndefinite will generate a random time indefinite adverb

Example

Code:

{
	f := New(11)
	fmt.Println(f.AdverbTimeIndefinite())
	// Output: already
}

Output:

already

func (*Faker) Animal

func (f *Faker) Animal() string

Animal will return a random animal

Example

Code:

{
	f := New(11)
	fmt.Println(f.Animal())
	// Output: elk
}

Output:

elk

func (*Faker) AnimalType

func (f *Faker) AnimalType() string

AnimalType will return a random animal type

Example

Code:

{
	f := New(11)
	fmt.Println(f.AnimalType())
	// Output: amphibians
}

Output:

amphibians

func (*Faker) AppAuthor

func (f *Faker) AppAuthor() string

AppAuthor will generate a random company or person name

Example

Code:

{
	f := New(11)
	fmt.Println(f.AppAuthor())
	// Output: Marcel Pagac
}

Output:

Marcel Pagac

func (*Faker) AppName

func (f *Faker) AppName() string

AppName will generate a random app name

Example

Code:

{
	f := New(11)
	fmt.Println(f.AppName())
	// Output: Oxbeing
}

Output:

Oxbeing

func (*Faker) AppVersion

func (f *Faker) AppVersion() string

AppVersion will generate a random app version

Example

Code:

{
	f := New(11)
	fmt.Println(f.AppVersion())
	// Output: 1.17.20
}

Output:

1.17.20

func (*Faker) BS

func (f *Faker) BS() string

BS will generate a random company bs string

Example

Code:

{
	f := New(11)
	fmt.Println(f.BS())
	// Output: front-end
}

Output:

front-end

func (*Faker) BeerAlcohol

func (f *Faker) BeerAlcohol() string

BeerAlcohol will return a random beer alcohol level between 2.0 and 10.0

Example

Code:

{
	f := New(11)
	fmt.Println(f.BeerAlcohol())
	// Output: 2.7%
}

Output:

2.7%

func (*Faker) BeerBlg

func (f *Faker) BeerBlg() string

BeerBlg will return a random beer blg between 5.0 and 20.0

Example

Code:

{
	f := New(11)
	fmt.Println(f.BeerBlg())
	// Output: 6.4°Blg
}

Output:

6.4°Blg

func (*Faker) BeerHop

func (f *Faker) BeerHop() string

BeerHop will return a random beer hop

Example

Code:

{
	f := New(11)
	fmt.Println(f.BeerHop())
	// Output: Glacier
}

Output:

Glacier

func (*Faker) BeerIbu

func (f *Faker) BeerIbu() string

BeerIbu will return a random beer ibu value between 10 and 100

Example

Code:

{
	f := New(11)
	fmt.Println(f.BeerIbu())
	// Output: 47 IBU
}

Output:

47 IBU

func (*Faker) BeerMalt

func (f *Faker) BeerMalt() string

BeerMalt will return a random beer malt

Example

Code:

{
	f := New(11)
	fmt.Println(f.BeerMalt())
	// Output: Munich
}

Output:

Munich

func (*Faker) BeerName

func (f *Faker) BeerName() string

BeerName will return a random beer name

Example

Code:

{
	f := New(11)
	fmt.Println(f.BeerName())
	// Output: Duvel
}

Output:

Duvel

func (*Faker) BeerStyle

func (f *Faker) BeerStyle() string

BeerStyle will return a random beer style

Example

Code:

{
	f := New(11)
	fmt.Println(f.BeerStyle())
	// Output: European Amber Lager
}

Output:

European Amber Lager

func (*Faker) BeerYeast

func (f *Faker) BeerYeast() string

BeerYeast will return a random beer yeast

Example

Code:

{
	f := New(11)
	fmt.Println(f.BeerYeast())
	// Output: 1388 - Belgian Strong Ale
}

Output:

1388 - Belgian Strong Ale

func (*Faker) BitcoinAddress

func (f *Faker) BitcoinAddress() string

BitcoinAddress will generate a random bitcoin address consisting of numbers, upper and lower characters

Example

Code:

{
	f := New(11)
	fmt.Println(f.BitcoinAddress())
	// Output: 1lYcxjqWkJWv7cLADX0q6BIXbVXHo6jV
}

Output:

1lYcxjqWkJWv7cLADX0q6BIXbVXHo6jV

func (*Faker) BitcoinPrivateKey

func (f *Faker) BitcoinPrivateKey() string

BitcoinPrivateKey will generate a random bitcoin private key base58 consisting of numbers, upper and lower characters

Example

Code:

{
	f := New(11)
	fmt.Println(f.BitcoinPrivateKey())
	// Output: 5KWjEJ7SnBNJyDjdPUjLuYByYzM9rG1trax8c2NTSBtv7YtR57v
}

Output:

5KWjEJ7SnBNJyDjdPUjLuYByYzM9rG1trax8c2NTSBtv7YtR57v

func (*Faker) Bool

func (f *Faker) Bool() bool

Bool will generate a random boolean value

Example

Code:

{
	f := New(11)
	fmt.Println(f.Bool())
	// Output: true
}

Output:

true

func (*Faker) Breakfast

func (f *Faker) Breakfast() string

Breakfast will return a random breakfast name

Example

Code:

{
	f := New(11)
	fmt.Println(f.Breakfast())
	// Output: Blueberry banana happy face pancakes
}

Output:

Blueberry banana happy face pancakes

func (*Faker) BuzzWord

func (f *Faker) BuzzWord() string

BuzzWord will generate a random company buzz word string

Example

Code:

{
	f := New(11)
	fmt.Println(f.BuzzWord())
	// Output: disintermediate
}

Output:

disintermediate

func (*Faker) CSV

func (f *Faker) CSV(co *CSVOptions) ([]byte, error)

CSV generates an object or an array of objects in json format

Example (Array)

Code:

{
	f := New(11)

	value, err := f.CSV(&CSVOptions{
		RowCount: 3,
		Fields: []Field{
			{Name: "id", Function: "autoincrement"},
			{Name: "first_name", Function: "firstname"},
			{Name: "last_name", Function: "lastname"},
			{Name: "password", Function: "password", Params: MapParams{"special": {"false"}}},
		},
	})
	if err != nil {
		fmt.Println(err)
	}

	fmt.Println(string(value))

	// Output:
	// id,first_name,last_name,password
	// 1,Markus,Moen,Dc0VYXjkWABx
	// 2,Osborne,Hilll,XPJ9OVNbs5lm
	// 3,Mertie,Halvorson,eyl3bhwfV8wA
}

Output:

id,first_name,last_name,password
1,Markus,Moen,Dc0VYXjkWABx
2,Osborne,Hilll,XPJ9OVNbs5lm
3,Mertie,Halvorson,eyl3bhwfV8wA

func (*Faker) Car

func (f *Faker) Car() *CarInfo

Car will generate a struct with car information

Example

Code:

{
	f := New(11)
	car := f.Car()
	fmt.Println(car.Brand)
	fmt.Println(car.Fuel)
	fmt.Println(car.Model)
	fmt.Println(car.Transmission)
	fmt.Println(car.Type)
	fmt.Println(car.Year)

	// Output: Fiat
	// Gasoline
	// Freestyle Fwd
	// Automatic
	// Passenger car mini
	// 1989
}

Output:

Fiat
Gasoline
Freestyle Fwd
Automatic
Passenger car mini
1989

func (*Faker) CarFuelType

func (f *Faker) CarFuelType() string

CarFuelType will return a random fuel type

Example

Code:

{
	f := New(11)
	fmt.Println(f.CarFuelType())
	// Output: CNG
}

Output:

CNG

func (*Faker) CarMaker

func (f *Faker) CarMaker() string

CarMaker will return a random car maker

Example

Code:

{
	f := New(11)
	fmt.Println(f.CarMaker())
	// Output: Nissan
}

Output:

Nissan

func (*Faker) CarModel

func (f *Faker) CarModel() string

CarModel will return a random car model

Example

Code:

{
	f := New(11)
	fmt.Println(f.CarModel())
	// Output: Aveo
}

Output:

Aveo

func (*Faker) CarTransmissionType

func (f *Faker) CarTransmissionType() string

CarTransmissionType will return a random transmission type

Example

Code:

{
	f := New(11)
	fmt.Println(f.CarTransmissionType())
	// Output: Manual
}

Output:

Manual

func (*Faker) CarType

func (f *Faker) CarType() string

CarType will generate a random car type string

Example

Code:

{
	f := New(11)
	fmt.Println(f.CarType())
	// Output: Passenger car mini
}

Output:

Passenger car mini

func (*Faker) Cat

func (f *Faker) Cat() string

Cat will return a random cat breed

Example

Code:

{
	f := New(11)
	fmt.Println(f.Cat())
	// Output: Sokoke
}

Output:

Sokoke

func (*Faker) CelebrityActor

func (f *Faker) CelebrityActor() string

CelebrityActor will generate a random celebrity actor

Example

Code:

{
	f := New(11)
	fmt.Println(f.CelebrityActor())
	// Output: Owen Wilson
}

Output:

Owen Wilson

func (*Faker) CelebrityBusiness

func (f *Faker) CelebrityBusiness() string

CelebrityBusiness will generate a random celebrity business person

Example

Code:

{
	f := New(11)
	fmt.Println(f.CelebrityBusiness())
	// Output: Cameron Diaz
}

Output:

Cameron Diaz

func (*Faker) CelebritySport

func (f *Faker) CelebritySport() string

CelebritySport will generate a random celebrity sport person

Example

Code:

{
	f := New(11)
	fmt.Println(f.CelebritySport())
	// Output: Hicham El Guerrouj
}

Output:

Hicham El Guerrouj

func (*Faker) ChromeUserAgent

func (f *Faker) ChromeUserAgent() string

ChromeUserAgent will generate a random chrome browser user agent string

Example

Code:

{
	f := New(11)
	fmt.Println(f.ChromeUserAgent())
	// Output: Mozilla/5.0 (X11; Linux i686) AppleWebKit/5360 (KHTML, like Gecko) Chrome/40.0.889.0 Mobile Safari/5360
}

Output:

Mozilla/5.0 (X11; Linux i686) AppleWebKit/5360 (KHTML, like Gecko) Chrome/40.0.889.0 Mobile Safari/5360

func (*Faker) City

func (f *Faker) City() string

City will generate a random city string

Example

Code:

{
	f := New(11)
	fmt.Println(f.City())
	// Output: Plano
}

Output:

Plano

func (*Faker) Color

func (f *Faker) Color() string

Color will generate a random color string

Example

Code:

{
	f := New(11)
	fmt.Println(f.Color())
	// Output: MediumOrchid
}

Output:

MediumOrchid

func (*Faker) Company

func (f *Faker) Company() string

Company will generate a random company name string

Example

Code:

{
	f := New(11)
	fmt.Println(f.Company())
	// Output: ClearHealthCosts
}

Output:

ClearHealthCosts

func (*Faker) CompanySuffix

func (f *Faker) CompanySuffix() string

CompanySuffix will generate a random company suffix string

Example

Code:

{
	f := New(11)
	fmt.Println(f.CompanySuffix())
	// Output: Inc
}

Output:

Inc

func (*Faker) Connective

func (f *Faker) Connective() string

Connective will generate a random connective

Example

Code:

{
	f := New(11)
	fmt.Println(f.Connective())
	// Output: such as
}

Output:

such as

func (*Faker) ConnectiveCasual

func (f *Faker) ConnectiveCasual() string

ConnectiveCasual will generate a random casual connective

Example

Code:

{
	f := New(11)
	fmt.Println(f.ConnectiveCasual())
	// Output: an outcome of
}

Output:

an outcome of

func (*Faker) ConnectiveComparitive

func (f *Faker) ConnectiveComparitive() string

ConnectiveComparitive will generate a random comparative connective

Example

Code:

{
	f := New(11)
	fmt.Println(f.ConnectiveComparitive())
	// Output: in addition
}

Output:

in addition

func (*Faker) ConnectiveComplaint

func (f *Faker) ConnectiveComplaint() string

ConnectiveComplaint will generate a random complaint connective

Example

Code:

{
	f := New(11)
	fmt.Println(f.ConnectiveComplaint())
	// Output: besides
}

Output:

besides

func (*Faker) ConnectiveExamplify

func (f *Faker) ConnectiveExamplify() string

ConnectiveExamplify will generate a random examplify connective

Example

Code:

{
	f := New(11)
	fmt.Println(f.ConnectiveExamplify())
	// Output: then
}

Output:

then

func (*Faker) ConnectiveListing

func (f *Faker) ConnectiveListing() string

ConnectiveListing will generate a random listing connective

Example

Code:

{
	f := New(11)
	fmt.Println(f.ConnectiveListing())
	// Output: firstly
}

Output:

firstly

func (*Faker) ConnectiveTime

func (f *Faker) ConnectiveTime() string
Example

Code:

{
	f := New(11)
	fmt.Println(f.ConnectiveTime())
	// Output: finally
}

Output:

finally

func (*Faker) Contact

func (f *Faker) Contact() *ContactInfo

Contact will generate a struct with information randomly populated contact information

Example

Code:

{
	f := New(11)
	contact := f.Contact()
	fmt.Println(contact.Phone)
	fmt.Println(contact.Email)
	// Output: 6136459948
	// carolecarroll@bosco.com
}

Output:

6136459948
carolecarroll@bosco.com

func (*Faker) Country

func (f *Faker) Country() string

Country will generate a random country string

Example

Code:

{
	f := New(11)
	fmt.Println(f.Country())
	// Output: Cabo Verde
}

Output:

Cabo Verde

func (*Faker) CountryAbr

func (f *Faker) CountryAbr() string

CountryAbr will generate a random abbreviated country string

Example

Code:

{
	f := New(11)
	fmt.Println(f.CountryAbr())
	// Output: CV
}

Output:

CV

func (*Faker) CreditCard

func (f *Faker) CreditCard() *CreditCardInfo

CreditCard will generate a struct full of credit card information

Example

Code:

{
	f := New(11)
	ccInfo := f.CreditCard()
	fmt.Println(ccInfo.Type)
	fmt.Println(ccInfo.Number)
	fmt.Println(ccInfo.Exp)
	fmt.Println(ccInfo.Cvv)
	// Output:
	// UnionPay
	// 4364599489953698
	// 02/23
	// 300
}

Output:

UnionPay
4364599489953698
02/23
300

func (*Faker) CreditCardCvv

func (f *Faker) CreditCardCvv() string

CreditCardCvv will generate a random CVV number Its a string because you could have 017 as an exp date

Example

Code:

{
	f := New(11)
	fmt.Println(f.CreditCardCvv())
	// Output: 513
}

Output:

513

func (*Faker) CreditCardExp

func (f *Faker) CreditCardExp() string

CreditCardExp will generate a random credit card expiration date string Exp date will always be a future date

Example

Code:

{
	f := New(11)
	fmt.Println(f.CreditCardExp())
	// Output: 06/29
}

Output:

06/29

func (*Faker) CreditCardNumber

func (f *Faker) CreditCardNumber(cco *CreditCardOptions) string

CreditCardNumber will generate a random luhn credit card number

Example

Code:

{
	f := New(11)
	fmt.Println(f.CreditCardNumber(nil))
	fmt.Println(f.CreditCardNumber(&CreditCardOptions{Types: []string{"visa", "discover"}}))
	fmt.Println(f.CreditCardNumber(&CreditCardOptions{Bins: []string{"4111"}}))
	fmt.Println(f.CreditCardNumber(&CreditCardOptions{Gaps: true}))
	// Output:
	// 4136459948995375
	// 4635300425914586
	// 4111232020276132
	// 3054 800889 9827
}

Output:

4136459948995375
4635300425914586
4111232020276132
3054 800889 9827

func (*Faker) CreditCardType

func (f *Faker) CreditCardType() string

CreditCardType will generate a random credit card type string

Example

Code:

{
	f := New(11)
	fmt.Println(f.CreditCardType())
	// Output: Visa
}

Output:

Visa

func (*Faker) Currency

func (f *Faker) Currency() *CurrencyInfo

Currency will generate a struct with random currency information

Example

Code:

{
	f := New(11)
	currency := f.Currency()
	fmt.Printf("%s - %s", currency.Short, currency.Long)
	// Output: IQD - Iraq Dinar
}

Output:

IQD - Iraq Dinar

func (*Faker) CurrencyLong

func (f *Faker) CurrencyLong() string

CurrencyLong will generate a random long currency name

Example

Code:

{
	f := New(11)
	fmt.Println(f.CurrencyLong())
	// Output: Iraq Dinar
}

Output:

Iraq Dinar

func (*Faker) CurrencyShort

func (f *Faker) CurrencyShort() string

CurrencyShort will generate a random short currency value

Example

Code:

{
	f := New(11)
	fmt.Println(f.CurrencyShort())
	// Output: IQD
}

Output:

IQD

func (*Faker) Date

func (f *Faker) Date() time.Time

Date will generate a random time.Time struct

Example

Code:

{
	f := New(11)
	fmt.Println(f.Date())
	// Output: 1995-01-24 13:00:35.820738079 +0000 UTC
}

Output:

1995-01-24 13:00:35.820738079 +0000 UTC

func (*Faker) DateRange

func (f *Faker) DateRange(start, end time.Time) time.Time

DateRange will generate a random time.Time struct between a start and end date

Example

Code:

{
	f := New(11)
	fmt.Println(f.DateRange(time.Unix(0, 484633944473634951), time.Unix(0, 1431318744473668209))) // May 10, 1985 years to May 10, 2015
	// Output: 2012-02-04 14:10:37.166933216 +0000 UTC
}

Output:

2012-02-04 14:10:37.166933216 +0000 UTC

func (*Faker) Day

func (f *Faker) Day() int

Day will generate a random day between 1 - 31

Example

Code:

{
	f := New(11)
	fmt.Println(f.Day())
	// Output: 23
}

Output:

23

func (*Faker) Dessert

func (f *Faker) Dessert() string

Dessert will return a random dessert name

Example

Code:

{
	f := New(11)
	fmt.Println(f.Dessert())
	// Output: French napoleons
}

Output:

French napoleons

func (*Faker) Digit

func (f *Faker) Digit() string

Digit will generate a single ASCII digit

Example

Code:

{
	f := New(11)
	fmt.Println(f.Digit())
	// Output: 0
}

Output:

0

func (*Faker) DigitN

func (f *Faker) DigitN(n uint) string

DigitN will generate a random string of length N consists of ASCII digits (note it can start with 0).

Example

Code:

{
	f := New(11)
	fmt.Println(f.DigitN(10))
	// Output: 0136459948
}

Output:

0136459948

func (*Faker) Dinner

func (f *Faker) Dinner() string

Dinner will return a random dinner name

Example

Code:

{
	f := New(11)
	fmt.Println(f.Dinner())
	// Output: Wild addicting dip
}

Output:

Wild addicting dip

func (*Faker) Dog

func (f *Faker) Dog() string

Dog will return a random dog breed

Example

Code:

{
	f := New(11)
	fmt.Println(f.Dog())
	// Output: Norwich Terrier
}

Output:

Norwich Terrier

func (*Faker) DomainName

func (f *Faker) DomainName() string

DomainName will generate a random url domain name

Example

Code:

{
	f := New(11)
	fmt.Println(f.DomainName())
	// Output: centraltarget.biz
}

Output:

centraltarget.biz

func (*Faker) DomainSuffix

func (f *Faker) DomainSuffix() string

DomainSuffix will generate a random domain suffix

Example

Code:

{
	f := New(11)
	fmt.Println(f.DomainSuffix())
	// Output: org
}

Output:

org

func (*Faker) Email

func (f *Faker) Email() string

Email will generate a random email string

Example

Code:

{
	f := New(11)
	fmt.Println(f.Email())
	// Output: markusmoen@pagac.net
}

Output:

markusmoen@pagac.net

func (*Faker) Emoji

func (f *Faker) Emoji() string

Emoji will return a random fun emoji

Example

Code:

{
	f := New(11)
	fmt.Println(f.Emoji())
	// Output: 🧛
}

Output:

🧛

func (*Faker) EmojiAlias

func (f *Faker) EmojiAlias() string

EmojiAlias will return a random fun emoji alias

Example

Code:

{
	f := New(11)
	fmt.Println(f.EmojiAlias())
	// Output: deaf_person
}

Output:

deaf_person

func (*Faker) EmojiCategory

func (f *Faker) EmojiCategory() string

EmojiCategory will return a random fun emoji category

Example

Code:

{
	f := New(11)
	fmt.Println(f.EmojiCategory())
	// Output: Food & Drink
}

Output:

Food & Drink

func (*Faker) EmojiDescription

func (f *Faker) EmojiDescription() string

EmojiDescription will return a random fun emoji description

Example

Code:

{
	f := New(11)
	fmt.Println(f.EmojiDescription())
	// Output: confetti ball
}

Output:

confetti ball

func (*Faker) EmojiTag

func (f *Faker) EmojiTag() string

EmojiTag will return a random fun emoji tag

Example

Code:

{
	f := New(11)
	fmt.Println(f.EmojiTag())
	// Output: strong
}

Output:

strong

func (*Faker) FarmAnimal

func (f *Faker) FarmAnimal() string

FarmAnimal will return a random animal that usually lives on a farm

Example

Code:

{
	f := New(11)
	fmt.Println(f.FarmAnimal())
	// Output: Chicken
}

Output:

Chicken

func (*Faker) FileExtension

func (f *Faker) FileExtension() string

FileExtension will generate a random file extension

Example

Code:

{
	f := New(11)
	fmt.Println(f.FileExtension())
	// Output: nes
}

Output:

nes

func (*Faker) FileMimeType

func (f *Faker) FileMimeType() string

FileMimeType will generate a random mime file type

Example

Code:

{
	f := New(11)
	fmt.Println(f.FileMimeType())
	// Output: application/dsptype
}

Output:

application/dsptype

func (*Faker) FirefoxUserAgent

func (f *Faker) FirefoxUserAgent() string

FirefoxUserAgent will generate a random firefox broswer user agent string

Example

Code:

{
	f := New(11)
	fmt.Println(f.FirefoxUserAgent())
	// Output: Mozilla/5.0 (Macintosh; U; PPC Mac OS X 10_9_10 rv:7.0) Gecko/1995-24-01 Firefox/36.0
}

Output:

Mozilla/5.0 (Macintosh; U; PPC Mac OS X 10_9_10 rv:7.0) Gecko/1995-24-01 Firefox/36.0

func (*Faker) FirstName

func (f *Faker) FirstName() string

FirstName will generate a random first name

Example

Code:

{
	f := New(11)
	fmt.Println(f.FirstName())
	// Output: Markus
}

Output:

Markus

func (*Faker) FlipACoin

func (f *Faker) FlipACoin() string

FlipACoin will return a random value of Heads or Tails

Example

Code:

{
	f := New(11)
	fmt.Println(f.FlipACoin())
	// Output: Heads
}

Output:

Heads

func (*Faker) Float32

func (f *Faker) Float32() float32

Float32 will generate a random float32 value

Example

Code:

{
	f := New(11)
	fmt.Println(f.Float32())
	// Output: 3.1128167e+37
}

Output:

3.1128167e+37

func (*Faker) Float32Range

func (f *Faker) Float32Range(min, max float32) float32

Float32Range will generate a random float32 value between min and max

Example

Code:

{
	f := New(11)
	fmt.Println(f.Float32Range(0, 9999999))
	// Output: 914774.6
}

Output:

914774.6

func (*Faker) Float64

func (f *Faker) Float64() float64

Float64 will generate a random float64 value

Example

Code:

{
	f := New(11)
	fmt.Println(f.Float64())
	// Output: 1.644484108270445e+307
}

Output:

1.644484108270445e+307

func (*Faker) Float64Range

func (f *Faker) Float64Range(min, max float64) float64

Float64Range will generate a random float64 value between min and max

Example

Code:

{
	f := New(11)
	fmt.Println(f.Float64Range(0, 9999999))
	// Output: 914774.5585333086
}

Output:

914774.5585333086

func (*Faker) Fruit

func (f *Faker) Fruit() string

Fruit will return a random fruit name

Example

Code:

{
	f := New(11)
	fmt.Println(f.Fruit())
	// Output: Peach
}

Output:

Peach

func (*Faker) Gamertag

func (f *Faker) Gamertag() string

Gamertag will generate a random video game username

Example

Code:

{
	f := New(11)
	fmt.Println(f.Gamertag())
	// Output: PurpleSheep5
}

Output:

PurpleSheep5

func (*Faker) Gender

func (f *Faker) Gender() string

Gender will generate a random gender string

Example

Code:

{
	f := New(11)
	fmt.Println(f.Gender())
	// Output: male
}

Output:

male

func (*Faker) Generate

func (f *Faker) Generate(dataVal string) string

Generate fake information from given string. Replaceable values should be within {}

Functions Ex: {firstname} - billy Ex: {sentence:3} - Record river mind. Ex: {number:1,10} - 4 Ex: {uuid} - 590c1440-9888-45b0-bd51-a817ee07c3f2

Letters/Numbers Ex: ### - 481 - random numbers Ex: ??? - fda - random letters

For a complete list of runnable functions use FuncsLookup

Example

Code:

{
	f := New(11)

	fmt.Println(f.Generate("{firstname} {lastname} ssn is {ssn} and lives at {street}"))
	fmt.Println(f.Generate("{sentence:3}"))
	fmt.Println(f.Generate("{shuffleints:[1,2,3]}"))
	fmt.Println(f.Generate("{number:1,50}"))
	fmt.Println(f.Generate("{shufflestrings:[key:value,int:string,1:2,a:b]}"))
	// Output: Markus Moen ssn is 526643139 and lives at 599 Dale ton
	// Niche backwards caused.
	// [1 3 2]
	// 27
	// [a:b key:value int:string 1:2]
}

Output:

Markus Moen ssn is 526643139 and lives at 599 Dale ton
Niche backwards caused.
[1 3 2]
27
[a:b key:value int:string 1:2]

func (*Faker) HTTPMethod

func (f *Faker) HTTPMethod() string

HTTPMethod will generate a random http method

Example

Code:

{
	f := New(11)
	fmt.Println(f.HTTPMethod())
	// Output: HEAD
}

Output:

HEAD

func (*Faker) HTTPStatusCode

func (f *Faker) HTTPStatusCode() int

HTTPStatusCode will generate a random status code

Example

Code:

{
	f := New(11)
	fmt.Println(f.HTTPStatusCode())
	// Output: 404
}

Output:

404

func (*Faker) HTTPStatusCodeSimple

func (f *Faker) HTTPStatusCodeSimple() int

HTTPStatusCodeSimple will generate a random simple status code

Example

Code:

{
	f := New(11)
	fmt.Println(f.HTTPStatusCodeSimple())
	// Output: 200
}

Output:

200

func (*Faker) HTTPVersion

func (f *Faker) HTTPVersion() string

HTTPVersion will generate a random http version

Example

Code:

{
	f := New(11)
	fmt.Println(f.HTTPVersion())
	// Output: HTTP/1.0
}

Output:

HTTP/1.0

func (*Faker) HackerAbbreviation

func (f *Faker) HackerAbbreviation() string

HackerAbbreviation will return a random hacker abbreviation

Example

Code:

{
	f := New(11)
	fmt.Println(f.HackerAbbreviation())
	// Output: ADP
}

Output:

ADP

func (*Faker) HackerAdjective

func (f *Faker) HackerAdjective() string

HackerAdjective will return a random hacker adjective

Example

Code:

{
	f := New(11)
	fmt.Println(f.HackerAdjective())
	// Output: wireless
}

Output:

wireless

func (*Faker) HackerNoun

func (f *Faker) HackerNoun() string

HackerNoun will return a random hacker noun

Example

Code:

{
	f := New(11)
	fmt.Println(f.HackerNoun())
	// Output: driver
}

Output:

driver

func (*Faker) HackerPhrase

func (f *Faker) HackerPhrase() string

HackerPhrase will return a random hacker sentence

Example

Code:

{
	f := New(11)
	fmt.Println(f.HackerPhrase())
	// Output: If we calculate the program, we can get to the AI pixel through the redundant XSS matrix!
}

Output:

If we calculate the program, we can get to the AI pixel through the redundant XSS matrix!

func (*Faker) HackerVerb

func (f *Faker) HackerVerb() string

HackerVerb will return a random hacker verb

Example

Code:

{
	f := New(11)
	fmt.Println(f.HackerVerb())
	// Output: synthesize
}

Output:

synthesize

func (*Faker) HackeringVerb

func (f *Faker) HackeringVerb() string

HackeringVerb will return a random hacker ingverb

Example

Code:

{
	f := New(11)
	fmt.Println(f.HackeringVerb())
	// Output: connecting
}

Output:

connecting

func (*Faker) HexColor

func (f *Faker) HexColor() string

HexColor will generate a random hexadecimal color string

Example

Code:

{
	f := New(11)
	fmt.Println(f.HexColor())
	// Output: #a99fb4
}

Output:

#a99fb4

func (*Faker) HexUint128

func (f *Faker) HexUint128() string

HexUint128 will generate a random uint128 hex value with "0x" prefix

Example

Code:

{
	f := New(11)
	fmt.Println(f.HexUint128())
	// Output: 0x875469578e51b5e56c95b64681d147a1
}

Output:

0x875469578e51b5e56c95b64681d147a1

func (*Faker) HexUint16

func (f *Faker) HexUint16() string

HexUint16 will generate a random uint16 hex value with "0x" prefix

Example

Code:

{
	f := New(11)
	fmt.Println(f.HexUint16())
	// Output: 0x8754
}

Output:

0x8754

func (*Faker) HexUint256

func (f *Faker) HexUint256() string

HexUint256 will generate a random uint256 hex value with "0x" prefix

Example

Code:

{
	f := New(11)
	fmt.Println(f.HexUint256())
	// Output: 0x875469578e51b5e56c95b64681d147a12cde48a4f417231b0c486abbc263e48d
}

Output:

0x875469578e51b5e56c95b64681d147a12cde48a4f417231b0c486abbc263e48d

func (*Faker) HexUint32

func (f *Faker) HexUint32() string

HexUint32 will generate a random uint32 hex value with "0x" prefix

Example

Code:

{
	f := New(11)
	fmt.Println(f.HexUint32())
	// Output: 0x87546957
}

Output:

0x87546957

func (*Faker) HexUint64

func (f *Faker) HexUint64() string

HexUint64 will generate a random uint64 hex value with "0x" prefix

Example

Code:

{
	f := New(11)
	fmt.Println(f.HexUint64())
	// Output: 0x875469578e51b5e5
}

Output:

0x875469578e51b5e5

func (*Faker) HexUint8

func (f *Faker) HexUint8() string

HexUint8 will generate a random uint8 hex value with "0x" prefix

Example

Code:

{
	f := New(11)
	fmt.Println(f.HexUint8())
	// Output: 0x87
}

Output:

0x87

func (*Faker) HipsterParagraph

func (f *Faker) HipsterParagraph(paragraphCount int, sentenceCount int, wordCount int, separator string) string

HipsterParagraph will generate a random paragraphGenerator Set Paragraph Count Set Sentence Count Set Word Count Set Paragraph Separator

Example

Code:

{
	f := New(11)
	fmt.Println(f.HipsterParagraph(3, 5, 12, "\n"))
	// Output: Microdosing roof chia echo pickled meditation cold-pressed raw denim fingerstache normcore sriracha pork belly. Wolf try-hard pop-up blog tilde hashtag health butcher waistcoat paleo portland vinegar. Microdosing sartorial blue bottle slow-carb freegan five dollar toast you probably haven't heard of them asymmetrical chia farm-to-table narwhal banjo. Gluten-free blog authentic literally synth vinyl meh ethical health fixie banh mi Yuccie. Try-hard drinking squid seitan cray VHS echo chillwave hammock kombucha food truck sustainable.
	// Pug bushwick hella tote bag cliche direct trade waistcoat yr waistcoat knausgaard pour-over master. Pitchfork jean shorts franzen flexitarian distillery hella meggings austin knausgaard crucifix wolf heirloom. Crucifix food truck you probably haven't heard of them trust fund fixie gentrify pitchfork stumptown mlkshk umami chambray blue bottle. 3 wolf moon swag +1 biodiesel knausgaard semiotics taxidermy meh artisan hoodie +1 blue bottle. Fashion axe forage mixtape Thundercats pork belly whatever 90's beard selfies chambray cred mlkshk.
	// Shabby chic typewriter VHS readymade lo-fi bitters PBR&B gentrify lomo raw denim freegan put a bird on it. Raw denim cliche dreamcatcher pug fixie park trust fund migas fingerstache sriracha +1 mustache. Tilde shoreditch kickstarter franzen dreamcatcher green juice mustache neutra polaroid stumptown organic schlitz. Flexitarian ramps chicharrones kogi lo-fi mustache tilde forage street church-key williamsburg taxidermy. Chia mustache plaid mumblecore squid slow-carb disrupt Thundercats goth shoreditch master direct trade.
}

Output:

Microdosing roof chia echo pickled meditation cold-pressed raw denim fingerstache normcore sriracha pork belly. Wolf try-hard pop-up blog tilde hashtag health butcher waistcoat paleo portland vinegar. Microdosing sartorial blue bottle slow-carb freegan five dollar toast you probably haven't heard of them asymmetrical chia farm-to-table narwhal banjo. Gluten-free blog authentic literally synth vinyl meh ethical health fixie banh mi Yuccie. Try-hard drinking squid seitan cray VHS echo chillwave hammock kombucha food truck sustainable.
Pug bushwick hella tote bag cliche direct trade waistcoat yr waistcoat knausgaard pour-over master. Pitchfork jean shorts franzen flexitarian distillery hella meggings austin knausgaard crucifix wolf heirloom. Crucifix food truck you probably haven't heard of them trust fund fixie gentrify pitchfork stumptown mlkshk umami chambray blue bottle. 3 wolf moon swag +1 biodiesel knausgaard semiotics taxidermy meh artisan hoodie +1 blue bottle. Fashion axe forage mixtape Thundercats pork belly whatever 90's beard selfies chambray cred mlkshk.
Shabby chic typewriter VHS readymade lo-fi bitters PBR&B gentrify lomo raw denim freegan put a bird on it. Raw denim cliche dreamcatcher pug fixie park trust fund migas fingerstache sriracha +1 mustache. Tilde shoreditch kickstarter franzen dreamcatcher green juice mustache neutra polaroid stumptown organic schlitz. Flexitarian ramps chicharrones kogi lo-fi mustache tilde forage street church-key williamsburg taxidermy. Chia mustache plaid mumblecore squid slow-carb disrupt Thundercats goth shoreditch master direct trade.

func (*Faker) HipsterSentence

func (f *Faker) HipsterSentence(wordCount int) string

HipsterSentence will generate a random sentence

Example

Code:

{
	f := New(11)
	fmt.Println(f.HipsterSentence(5))
	// Output: Microdosing roof chia echo pickled.
}

Output:

Microdosing roof chia echo pickled.

func (*Faker) HipsterWord

func (f *Faker) HipsterWord() string

HipsterWord will return a single hipster word

Example

Code:

{
	f := New(11)
	fmt.Println(f.HipsterWord())
	// Output: microdosing
}

Output:

microdosing

func (*Faker) Hobby

func (f *Faker) Hobby() string

Hobby will generate a random hobby string

Example

Code:

{
	f := New(11)
	fmt.Println(f.Hobby())
	// Output: Transit map collecting
}

Output:

Transit map collecting

func (*Faker) Hour

func (f *Faker) Hour() int

Hour will generate a random hour - in military time

Example

Code:

{
	f := New(11)
	fmt.Println(f.Hour())
	// Output: 17
}

Output:

17

func (*Faker) IPv4Address

func (f *Faker) IPv4Address() string

IPv4Address will generate a random version 4 ip address

Example

Code:

{
	f := New(11)
	fmt.Println(f.IPv4Address())
	// Output: 152.23.53.100
}

Output:

152.23.53.100

func (*Faker) IPv6Address

func (f *Faker) IPv6Address() string

IPv6Address will generate a random version 6 ip address

Example

Code:

{
	f := New(11)
	fmt.Println(f.IPv6Address())
	// Output: 8898:ee17:bc35:9064:5866:d019:3b95:7857
}

Output:

8898:ee17:bc35:9064:5866:d019:3b95:7857

func (*Faker) Image

func (f *Faker) Image(width int, height int) *img.RGBA

Image generates a random rgba image

Example

Code:

{
	f := New(11)
	fmt.Println(f.Image(1, 1))
	// Output: &{[89 176 195 255] 4 (0,0)-(1,1)}
}

Output:

&{[89 176 195 255] 4 (0,0)-(1,1)}

func (*Faker) ImageJpeg

func (f *Faker) ImageJpeg(width int, height int) []byte

ImageJpeg generates a random rgba jpeg image

Example

Code:

{
	f := New(11)
	fmt.Println(f.ImageJpeg(1, 1))
	// Output: [255 216 255 219 0 132 0 8 6 6 7 6 5 8 7 7 7 9 9 8 10 12 20 13 12 11 11 12 25 18 19 15 20 29 26 31 30 29 26 28 28 32 36 46 39 32 34 44 35 28 28 40 55 41 44 48 49 52 52 52 31 39 57 61 56 50 60 46 51 52 50 1 9 9 9 12 11 12 24 13 13 24 50 33 28 33 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 255 192 0 17 8 0 1 0 1 3 1 34 0 2 17 1 3 17 1 255 196 1 162 0 0 1 5 1 1 1 1 1 1 0 0 0 0 0 0 0 0 1 2 3 4 5 6 7 8 9 10 11 16 0 2 1 3 3 2 4 3 5 5 4 4 0 0 1 125 1 2 3 0 4 17 5 18 33 49 65 6 19 81 97 7 34 113 20 50 129 145 161 8 35 66 177 193 21 82 209 240 36 51 98 114 130 9 10 22 23 24 25 26 37 38 39 40 41 42 52 53 54 55 56 57 58 67 68 69 70 71 72 73 74 83 84 85 86 87 88 89 90 99 100 101 102 103 104 105 106 115 116 117 118 119 120 121 122 131 132 133 134 135 136 137 138 146 147 148 149 150 151 152 153 154 162 163 164 165 166 167 168 169 170 178 179 180 181 182 183 184 185 186 194 195 196 197 198 199 200 201 202 210 211 212 213 214 215 216 217 218 225 226 227 228 229 230 231 232 233 234 241 242 243 244 245 246 247 248 249 250 1 0 3 1 1 1 1 1 1 1 1 1 0 0 0 0 0 0 1 2 3 4 5 6 7 8 9 10 11 17 0 2 1 2 4 4 3 4 7 5 4 4 0 1 2 119 0 1 2 3 17 4 5 33 49 6 18 65 81 7 97 113 19 34 50 129 8 20 66 145 161 177 193 9 35 51 82 240 21 98 114 209 10 22 36 52 225 37 241 23 24 25 26 38 39 40 41 42 53 54 55 56 57 58 67 68 69 70 71 72 73 74 83 84 85 86 87 88 89 90 99 100 101 102 103 104 105 106 115 116 117 118 119 120 121 122 130 131 132 133 134 135 136 137 138 146 147 148 149 150 151 152 153 154 162 163 164 165 166 167 168 169 170 178 179 180 181 182 183 184 185 186 194 195 196 197 198 199 200 201 202 210 211 212 213 214 215 216 217 218 226 227 228 229 230 231 232 233 234 242 243 244 245 246 247 248 249 250 255 218 0 12 3 1 0 2 17 3 17 0 63 0 216 162 138 43 213 62 92 255 217]
}

Output:

[255 216 255 219 0 132 0 8 6 6 7 6 5 8 7 7 7 9 9 8 10 12 20 13 12 11 11 12 25 18 19 15 20 29 26 31 30 29 26 28 28 32 36 46 39 32 34 44 35 28 28 40 55 41 44 48 49 52 52 52 31 39 57 61 56 50 60 46 51 52 50 1 9 9 9 12 11 12 24 13 13 24 50 33 28 33 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 255 192 0 17 8 0 1 0 1 3 1 34 0 2 17 1 3 17 1 255 196 1 162 0 0 1 5 1 1 1 1 1 1 0 0 0 0 0 0 0 0 1 2 3 4 5 6 7 8 9 10 11 16 0 2 1 3 3 2 4 3 5 5 4 4 0 0 1 125 1 2 3 0 4 17 5 18 33 49 65 6 19 81 97 7 34 113 20 50 129 145 161 8 35 66 177 193 21 82 209 240 36 51 98 114 130 9 10 22 23 24 25 26 37 38 39 40 41 42 52 53 54 55 56 57 58 67 68 69 70 71 72 73 74 83 84 85 86 87 88 89 90 99 100 101 102 103 104 105 106 115 116 117 118 119 120 121 122 131 132 133 134 135 136 137 138 146 147 148 149 150 151 152 153 154 162 163 164 165 166 167 168 169 170 178 179 180 181 182 183 184 185 186 194 195 196 197 198 199 200 201 202 210 211 212 213 214 215 216 217 218 225 226 227 228 229 230 231 232 233 234 241 242 243 244 245 246 247 248 249 250 1 0 3 1 1 1 1 1 1 1 1 1 0 0 0 0 0 0 1 2 3 4 5 6 7 8 9 10 11 17 0 2 1 2 4 4 3 4 7 5 4 4 0 1 2 119 0 1 2 3 17 4 5 33 49 6 18 65 81 7 97 113 19 34 50 129 8 20 66 145 161 177 193 9 35 51 82 240 21 98 114 209 10 22 36 52 225 37 241 23 24 25 26 38 39 40 41 42 53 54 55 56 57 58 67 68 69 70 71 72 73 74 83 84 85 86 87 88 89 90 99 100 101 102 103 104 105 106 115 116 117 118 119 120 121 122 130 131 132 133 134 135 136 137 138 146 147 148 149 150 151 152 153 154 162 163 164 165 166 167 168 169 170 178 179 180 181 182 183 184 185 186 194 195 196 197 198 199 200 201 202 210 211 212 213 214 215 216 217 218 226 227 228 229 230 231 232 233 234 242 243 244 245 246 247 248 249 250 255 218 0 12 3 1 0 2 17 3 17 0 63 0 216 162 138 43 213 62 92 255 217]

func (*Faker) ImagePng

func (f *Faker) ImagePng(width int, height int) []byte

ImagePng generates a random rgba png image

Example

Code:

{
	f := New(11)
	fmt.Println(f.ImagePng(1, 1))
	// Output: [137 80 78 71 13 10 26 10 0 0 0 13 73 72 68 82 0 0 0 1 0 0 0 1 8 2 0 0 0 144 119 83 222 0 0 0 16 73 68 65 84 120 156 98 138 220 112 24 16 0 0 255 255 3 58 1 207 38 214 44 234 0 0 0 0 73 69 78 68 174 66 96 130]
}

Output:

[137 80 78 71 13 10 26 10 0 0 0 13 73 72 68 82 0 0 0 1 0 0 0 1 8 2 0 0 0 144 119 83 222 0 0 0 16 73 68 65 84 120 156 98 138 220 112 24 16 0 0 255 255 3 58 1 207 38 214 44 234 0 0 0 0 73 69 78 68 174 66 96 130]

func (*Faker) ImageURL

func (f *Faker) ImageURL(width int, height int) string

ImageURL will generate a random Image Based Upon Height And Width. https://picsum.photos/

Example

Code:

{
	f := New(11)
	fmt.Println(f.ImageURL(640, 480))
	// Output: https://picsum.photos/640/480
}

Output:

https://picsum.photos/640/480

func (*Faker) Int16

func (f *Faker) Int16() int16

Int16 will generate a random int16 value

Example

Code:

{
	f := New(11)
	fmt.Println(f.Int16())
	// Output: -29607
}

Output:

-29607

func (*Faker) Int32

func (f *Faker) Int32() int32

Int32 will generate a random int32 value

Example

Code:

{
	f := New(11)
	fmt.Println(f.Int32())
	// Output: -1072427943
}

Output:

-1072427943

func (*Faker) Int64

func (f *Faker) Int64() int64

Int64 will generate a random int64 value

Example

Code:

{
	f := New(11)
	fmt.Println(f.Int64())
	// Output: -1072427943
}

Output:

-1072427943

func (*Faker) Int8

func (f *Faker) Int8() int8

Int8 will generate a random Int8 value

Example

Code:

{
	f := New(11)
	fmt.Println(f.Int8())
	// Output: -39
}

Output:

-39

func (*Faker) IntRange

func (f *Faker) IntRange(min, max int) int

IntRange will generate a random int value between min and max

Example

Code:

{
	f := New(11)
	fmt.Println(f.IntRange(1, 10))
	// Output: 6
}

Output:

6

func (*Faker) JSON

func (f *Faker) JSON(jo *JSONOptions) ([]byte, error)

JSON generates an object or an array of objects in json format

Example (Array)

Code:

{
	f := New(11)

	value, err := f.JSON(&JSONOptions{
		Type: "array",
		Fields: []Field{
			{Name: "id", Function: "autoincrement"},
			{Name: "first_name", Function: "firstname"},
			{Name: "last_name", Function: "lastname"},
			{Name: "password", Function: "password", Params: MapParams{"special": {"false"}}},
		},
		RowCount: 3,
		Indent:   true,
	})
	if err != nil {
		fmt.Println(err)
	}

	fmt.Println(string(value))

	// Output: [
	//     {
	//         "id": 1,
	//         "first_name": "Markus",
	//         "last_name": "Moen",
	//         "password": "Dc0VYXjkWABx"
	//     },
	//     {
	//         "id": 2,
	//         "first_name": "Osborne",
	//         "last_name": "Hilll",
	//         "password": "XPJ9OVNbs5lm"
	//     },
	//     {
	//         "id": 3,
	//         "first_name": "Mertie",
	//         "last_name": "Halvorson",
	//         "password": "eyl3bhwfV8wA"
	//     }
	// ]
}

Output:

[
    {
        "id": 1,
        "first_name": "Markus",
        "last_name": "Moen",
        "password": "Dc0VYXjkWABx"
    },
    {
        "id": 2,
        "first_name": "Osborne",
        "last_name": "Hilll",
        "password": "XPJ9OVNbs5lm"
    },
    {
        "id": 3,
        "first_name": "Mertie",
        "last_name": "Halvorson",
        "password": "eyl3bhwfV8wA"
    }
]
Example (Object)

Code:

{
	f := New(11)

	value, err := f.JSON(&JSONOptions{
		Type: "object",
		Fields: []Field{
			{Name: "first_name", Function: "firstname"},
			{Name: "last_name", Function: "lastname"},
			{Name: "address", Function: "address"},
			{Name: "password", Function: "password", Params: MapParams{"special": {"false"}}},
		},
		Indent: true,
	})
	if err != nil {
		fmt.Println(err)
	}

	fmt.Println(string(value))

	// Output: {
	//     "first_name": "Markus",
	//     "last_name": "Moen",
	//     "address": {
	//         "address": "4599 Dale ton, Norfolk, New Jersey 36906",
	//         "street": "4599 Dale ton",
	//         "city": "Norfolk",
	//         "state": "New Jersey",
	//         "zip": "36906",
	//         "country": "Tokelau",
	//         "latitude": 23.058758,
	//         "longitude": 89.022594
	//     },
	//     "password": "qjXy56JHcVlZ"
	// }
}

Output:

{
    "first_name": "Markus",
    "last_name": "Moen",
    "address": {
        "address": "4599 Dale ton, Norfolk, New Jersey 36906",
        "street": "4599 Dale ton",
        "city": "Norfolk",
        "state": "New Jersey",
        "zip": "36906",
        "country": "Tokelau",
        "latitude": 23.058758,
        "longitude": 89.022594
    },
    "password": "qjXy56JHcVlZ"
}

func (*Faker) Job

func (f *Faker) Job() *JobInfo

Job will generate a struct with random job information

Example

Code:

{
	f := New(11)
	jobInfo := f.Job()
	fmt.Println(jobInfo.Company)
	fmt.Println(jobInfo.Title)
	fmt.Println(jobInfo.Descriptor)
	fmt.Println(jobInfo.Level)
	// Output: ClearHealthCosts
	// Agent
	// Future
	// Tactics
}

Output:

ClearHealthCosts
Agent
Future
Tactics

func (*Faker) JobDescriptor

func (f *Faker) JobDescriptor() string

JobDescriptor will generate a random job descriptor string

Example

Code:

{
	f := New(11)
	fmt.Println(f.JobDescriptor())
	// Output: Central
}

Output:

Central

func (*Faker) JobLevel

func (f *Faker) JobLevel() string

JobLevel will generate a random job level string

Example

Code:

{
	f := New(11)
	fmt.Println(f.JobLevel())
	// Output: Assurance
}

Output:

Assurance

func (*Faker) JobTitle

func (f *Faker) JobTitle() string

JobTitle will generate a random job title string

Example

Code:

{
	f := New(11)
	fmt.Println(f.JobTitle())
	// Output: Director
}

Output:

Director

func (*Faker) Language

func (f *Faker) Language() string

Language will return a random language

Example

Code:

{
	f := New(11)
	fmt.Println(f.Language())
	// Output: Kazakh
}

Output:

Kazakh

func (*Faker) LanguageAbbreviation

func (f *Faker) LanguageAbbreviation() string

LanguageAbbreviation will return a random language abbreviation

Example

Code:

{
	f := New(11)
	fmt.Println(f.LanguageAbbreviation())
	// Output: kk
}

Output:

kk

func (*Faker) LanguageBCP

func (f *Faker) LanguageBCP() string

LanguageBCP will return a random language BCP (Best Current Practices)

Example

Code:

{
	f := New(11)
	fmt.Println(f.LanguageBCP())
	// Output: de-DE
}

Output:

de-DE

func (*Faker) LastName

func (f *Faker) LastName() string

LastName will generate a random last name

Example

Code:

{
	f := New(11)
	fmt.Println(f.LastName())
	// Output: Daniel
}

Output:

Daniel

func (*Faker) Latitude

func (f *Faker) Latitude() float64

Latitude will generate a random latitude float64

Example

Code:

{
	f := New(11)
	fmt.Println(f.Latitude())
	// Output: -73.534057
}

Output:

-73.534057

func (*Faker) LatitudeInRange

func (f *Faker) LatitudeInRange(min, max float64) (float64, error)

LatitudeInRange will generate a random latitude within the input range

Example

Code:

{
	f := New(11)
	lat, _ := f.LatitudeInRange(21, 42)
	fmt.Println(lat)
	// Output: 22.921026
}

Output:

22.921026

func (*Faker) Letter

func (f *Faker) Letter() string

Letter will generate a single random lower case ASCII letter

Example

Code:

{
	f := New(11)
	fmt.Println(f.Letter())
	// Output: g
}

Output:

g

func (*Faker) LetterN

func (f *Faker) LetterN(n uint) string

LetterN will generate a random ASCII string with length N

Example

Code:

{
	f := New(11)
	fmt.Println(f.LetterN(10))
	// Output: gbRMaRxHki
}

Output:

gbRMaRxHki

func (*Faker) Lexify

func (f *Faker) Lexify(str string) string

Lexify will replace ? with random generated letters

Example

Code:

{
	f := New(11)
	fmt.Println(f.Lexify("?????"))
	// Output: gbRMa
}

Output:

gbRMa

func (*Faker) LogLevel

func (f *Faker) LogLevel(logType string) string

LogLevel will generate a random log level See data/LogLevels for list of available levels

Example

Code:

{
	f := New(11)
	fmt.Println(f.LogLevel("")) // This will also use general
	fmt.Println(f.LogLevel("syslog"))
	fmt.Println(f.LogLevel("apache"))
	// Output: error
	// debug
	// trace1-8
}

Output:

error
debug
trace1-8

func (*Faker) Longitude

func (f *Faker) Longitude() float64

Longitude will generate a random longitude float64

Example

Code:

{
	f := New(11)
	fmt.Println(f.Longitude())
	// Output: -147.068113
}

Output:

-147.068113

func (*Faker) LongitudeInRange

func (f *Faker) LongitudeInRange(min, max float64) (float64, error)

LongitudeInRange will generate a random longitude within the input range

Example

Code:

{
	f := New(11)
	long, _ := f.LongitudeInRange(-10, 10)
	fmt.Println(long)
	// Output: -8.170451
}

Output:

-8.170451

func (*Faker) LoremIpsumParagraph

func (f *Faker) LoremIpsumParagraph(paragraphCount int, sentenceCount int, wordCount int, separator string) string

LoremIpsumParagraph will generate a random paragraphGenerator

Example

Code:

{
	f := New(11)
	fmt.Println(f.LoremIpsumParagraph(3, 5, 12, "\n"))
	// Output: Quia quae repellat consequatur quidem nisi quo qui voluptatum accusantium quisquam amet. Quas et ut non dolorem ipsam aut enim assumenda mollitia harum ut. Dicta similique veniam nulla voluptas at excepturi non ad maxime at non. Eaque hic repellat praesentium voluptatem qui consequuntur dolor iusto autem velit aut. Fugit tempore exercitationem harum consequatur voluptatum modi minima aut eaque et et.
	// Aut ea voluptatem dignissimos expedita odit tempore quod aut beatae ipsam iste. Minus voluptatibus dolorem maiores eius sed nihil vel enim odio voluptatem accusamus. Natus quibusdam temporibus tenetur cumque sint necessitatibus dolorem ex ducimus iusto ex. Voluptatem neque dicta explicabo officiis et ducimus sit ut ut praesentium pariatur. Illum molestias nisi at dolore ut voluptatem accusantium et fugiat et ut.
	// Explicabo incidunt reprehenderit non quia dignissimos recusandae vitae soluta quia et quia. Aut veniam voluptas consequatur placeat sapiente non eveniet voluptatibus magni velit eum. Nobis vel repellendus sed est qui autem laudantium quidem quam ullam consequatur. Aut iusto ut commodi similique quae voluptatem atque qui fugiat eum aut. Quis distinctio consequatur voluptatem vel aliquid aut laborum facere officiis iure tempora.
}

Output:

Quia quae repellat consequatur quidem nisi quo qui voluptatum accusantium quisquam amet. Quas et ut non dolorem ipsam aut enim assumenda mollitia harum ut. Dicta similique veniam nulla voluptas at excepturi non ad maxime at non. Eaque hic repellat praesentium voluptatem qui consequuntur dolor iusto autem velit aut. Fugit tempore exercitationem harum consequatur voluptatum modi minima aut eaque et et.
Aut ea voluptatem dignissimos expedita odit tempore quod aut beatae ipsam iste. Minus voluptatibus dolorem maiores eius sed nihil vel enim odio voluptatem accusamus. Natus quibusdam temporibus tenetur cumque sint necessitatibus dolorem ex ducimus iusto ex. Voluptatem neque dicta explicabo officiis et ducimus sit ut ut praesentium pariatur. Illum molestias nisi at dolore ut voluptatem accusantium et fugiat et ut.
Explicabo incidunt reprehenderit non quia dignissimos recusandae vitae soluta quia et quia. Aut veniam voluptas consequatur placeat sapiente non eveniet voluptatibus magni velit eum. Nobis vel repellendus sed est qui autem laudantium quidem quam ullam consequatur. Aut iusto ut commodi similique quae voluptatem atque qui fugiat eum aut. Quis distinctio consequatur voluptatem vel aliquid aut laborum facere officiis iure tempora.

func (*Faker) LoremIpsumSentence

func (f *Faker) LoremIpsumSentence(wordCount int) string

LoremIpsumSentence will generate a random sentence

Example

Code:

{
	f := New(11)
	fmt.Println(f.LoremIpsumSentence(5))
	// Output: Quia quae repellat consequatur quidem.
}

Output:

Quia quae repellat consequatur quidem.

func (*Faker) LoremIpsumWord

func (f *Faker) LoremIpsumWord() string

LoremIpsumWord will generate a random word

Example

Code:

{
	f := New(11)
	fmt.Println(f.LoremIpsumWord())
	// Output: quia
}

Output:

quia

func (*Faker) Lunch

func (f *Faker) Lunch() string

Lunch will return a random lunch name

Example

Code:

{
	f := New(11)
	fmt.Println(f.Lunch())
	// Output: No bake hersheys bar pie
}

Output:

No bake hersheys bar pie

func (*Faker) MacAddress

func (f *Faker) MacAddress() string

MacAddress will generate a random mac address

Example

Code:

{
	f := New(11)
	fmt.Println(f.MacAddress())
	// Output: e1:74:cb:01:77:91
}

Output:

e1:74:cb:01:77:91

func (*Faker) Map

func (f *Faker) Map() map[string]interface{}

Map will generate a random set of map data

Example

Code:

{
	f := New(11)
	fmt.Println(f.Map())
	// Output: map[contrast:Associate gauva:map[jump:scale] generally:8504801 him:[them whomever ours hence here his] its:8335564 table:map[did:[these delay these]] therefore:map[nearly:784141.8] thing:map[everything:[where caused why week hourly]]]
}

Output:

map[contrast:Associate gauva:map[jump:scale] generally:8504801 him:[them whomever ours hence here his] its:8335564 table:map[did:[these delay these]] therefore:map[nearly:784141.8] thing:map[everything:[where caused why week hourly]]]

func (*Faker) MinecraftAnimal

func (f *Faker) MinecraftAnimal() string

MinecraftAnimal will generate a random Minecraft animal

Example

Code:

{
	f := New(11)
	fmt.Println(f.MinecraftAnimal())
	// Output:
	// chicken
}

Output:

chicken

func (*Faker) MinecraftArmorPart

func (f *Faker) MinecraftArmorPart() string

MinecraftArmorPart will generate a random Minecraft armor part

Example

Code:

{
	f := New(11)
	fmt.Println(f.MinecraftArmorPart())
	// Output:
	// helmet
}

Output:

helmet

func (*Faker) MinecraftArmorTier

func (f *Faker) MinecraftArmorTier() string

MinecraftArmorTier will generate a random Minecraft armor tier

Example

Code:

{
	f := New(11)
	fmt.Println(f.MinecraftArmorTier())
	// Output:
	// leather
}

Output:

leather

func (*Faker) MinecraftBiome

func (f *Faker) MinecraftBiome() string

MinecraftBiome will generate a random Minecraft biome

Example

Code:

{
	f := New(11)
	fmt.Println(f.MinecraftBiome())
	// Output:
	// stone shore
}

Output:

stone shore

func (*Faker) MinecraftDye

func (f *Faker) MinecraftDye() string

MinecraftDye will generate a random Minecraft dye

Example

Code:

{
	f := New(11)
	fmt.Println(f.MinecraftDye())
	// Output:
	// light gray
}

Output:

light gray

func (*Faker) MinecraftFood

func (f *Faker) MinecraftFood() string

MinecraftFood will generate a random Minecraft food

Example

Code:

{
	f := New(11)
	fmt.Println(f.MinecraftFood())
	// Output:
	// beetroot
}

Output:

beetroot

func (*Faker) MinecraftMobBoss

func (f *Faker) MinecraftMobBoss() string

MinecraftMobBoss will generate a random Minecraft mob boss

Example

Code:

{
	f := New(11)
	fmt.Println(f.MinecraftMobBoss())
	// Output:
	// ender dragon
}

Output:

ender dragon

func (*Faker) MinecraftMobHostile

func (f *Faker) MinecraftMobHostile() string

MinecraftMobHostile will generate a random Minecraft mob hostile

Example

Code:

{
	f := New(11)
	fmt.Println(f.MinecraftMobHostile())
	// Output:
	// blaze
}

Output:

blaze

func (*Faker) MinecraftMobNeutral

func (f *Faker) MinecraftMobNeutral() string

MinecraftMobNeutral will generate a random Minecraft mob neutral

Example

Code:

{
	f := New(11)
	fmt.Println(f.MinecraftMobNeutral())
	// Output:
	// wolf
}

Output:

wolf

func (*Faker) MinecraftMobPassive

func (f *Faker) MinecraftMobPassive() string

MinecraftMobPassive will generate a random Minecraft mob passive

Example

Code:

{
	f := New(11)
	fmt.Println(f.MinecraftMobPassive())
	// Output:
	// chicken
}

Output:

chicken

func (*Faker) MinecraftOre

func (f *Faker) MinecraftOre() string

MinecraftOre will generate a random Minecraft ore

Example

Code:

{
	f := New(11)
	fmt.Println(f.MinecraftOre())
	// Output:
	// coal
}

Output:

coal

func (*Faker) MinecraftTool

func (f *Faker) MinecraftTool() string

MinecraftTool will generate a random Minecraft tool

Example

Code:

{
	f := New(11)
	fmt.Println(f.MinecraftTool())
	// Output:
	// pickaxe
}

Output:

pickaxe

func (*Faker) MinecraftVillagerJob

func (f *Faker) MinecraftVillagerJob() string

MinecraftVillagerJob will generate a random Minecraft villager job

Example

Code:

{
	f := New(11)
	fmt.Println(f.MinecraftVillagerJob())
	// Output:
	// toolsmith
}

Output:

toolsmith

func (*Faker) MinecraftVillagerLevel

func (f *Faker) MinecraftVillagerLevel() string

MinecraftVillagerLevel will generate a random Minecraft villager level

Example

Code:

{
	f := New(11)
	fmt.Println(f.MinecraftVillagerLevel())
	// Output:
	// novice
}

Output:

novice

func (*Faker) MinecraftVillagerStation

func (f *Faker) MinecraftVillagerStation() string

MinecraftVillagerStation will generate a random Minecraft villager station

Example

Code:

{
	f := New(11)
	fmt.Println(f.MinecraftVillagerStation())
	// Output:
	// cauldron
}

Output:

cauldron

func (*Faker) MinecraftWeapon

func (f *Faker) MinecraftWeapon() string

MinecraftWeapon will generate a random Minecraft weapon

Example

Code:

{
	f := New(11)
	fmt.Println(f.MinecraftWeapon())
	// Output:
	// sword
}

Output:

sword

func (*Faker) MinecraftWeather

func (f *Faker) MinecraftWeather() string

MinecraftWeather will generate a random Minecraft weather

Example

Code:

{
	f := New(11)
	fmt.Println(f.MinecraftWeather())
	// Output:
	// clear
}

Output:

clear

func (*Faker) MinecraftWood

func (f *Faker) MinecraftWood() string

MinecraftWood will generate a random Minecraft wood

Example

Code:

{
	f := New(11)
	fmt.Println(f.MinecraftWood())
	// Output:
	// oak
}

Output:

oak

func (*Faker) Minute

func (f *Faker) Minute() int

Minute will generate a random minute

Example

Code:

{
	f := New(11)
	fmt.Println(f.Minute())
	// Output: 5
}

Output:

5

func (*Faker) Month

func (f *Faker) Month() int

Month will generate a random month int

Example

Code:

{
	f := New(11)
	fmt.Println(f.Month())
	// Output: 6
}

Output:

6

func (*Faker) MonthString

func (f *Faker) MonthString() string

MonthString will generate a random month string

Example

Code:

{
	f := New(11)
	fmt.Println(f.MonthString())
	// Output: June
}

Output:

June

func (*Faker) Name

func (f *Faker) Name() string

Name will generate a random First and Last Name

Example

Code:

{
	f := New(11)
	fmt.Println(f.Name())
	// Output: Markus Moen
}

Output:

Markus Moen

func (*Faker) NamePrefix

func (f *Faker) NamePrefix() string

NamePrefix will generate a random name prefix

Example

Code:

{
	f := New(11)
	fmt.Println(f.NamePrefix())
	// Output: Mr.
}

Output:

Mr.

func (*Faker) NameSuffix

func (f *Faker) NameSuffix() string

NameSuffix will generate a random name suffix

Example

Code:

{
	f := New(11)
	fmt.Println(f.NameSuffix())
	// Output: Jr.
}

Output:

Jr.

func (*Faker) NanoSecond

func (f *Faker) NanoSecond() int

NanoSecond will generate a random nano second

Example

Code:

{
	f := New(11)
	fmt.Println(f.NanoSecond())
	// Output: 693298265
}

Output:

693298265

func (*Faker) Noun

func (f *Faker) Noun() string

Noun will generate a random noun

Example

Code:

{
	f := New(11)
	fmt.Println(f.Noun())
	// Output: aunt
}

Output:

aunt

func (*Faker) NounAbstract

func (f *Faker) NounAbstract() string

NounAbstract will generate a random abstract noun

Example

Code:

{
	f := New(11)
	fmt.Println(f.NounAbstract())
	// Output: confusion
}

Output:

confusion

func (*Faker) NounCollectiveAnimal

func (f *Faker) NounCollectiveAnimal() string

NounCollectiveAnimal will generate a random collective noun animal

Example

Code:

{
	f := New(11)
	fmt.Println(f.NounCollectiveAnimal())
	// Output: party
}

Output:

party

func (*Faker) NounCollectivePeople

func (f *Faker) NounCollectivePeople() string

NounCollectivePeople will generate a random collective noun person

Example

Code:

{
	f := New(11)
	fmt.Println(f.NounCollectivePeople())
	// Output: body
}

Output:

body

func (*Faker) NounCollectiveThing

func (f *Faker) NounCollectiveThing() string

NounCollectiveThing will generate a random collective noun thing

Example

Code:

{
	f := New(11)
	fmt.Println(f.NounCollectiveThing())
	// Output: hand
}

Output:

hand

func (*Faker) NounCommon

func (f *Faker) NounCommon() string

NounCommon will generate a random common noun

Example

Code:

{
	f := New(11)
	fmt.Println(f.NounCommon())
	// Output: part
}

Output:

part

func (*Faker) NounConcrete

func (f *Faker) NounConcrete() string

NounConcrete will generate a random concrete noun

Example

Code:

{
	f := New(11)
	fmt.Println(f.NounConcrete())
	// Output: snowman
}

Output:

snowman

func (*Faker) NounCountable

func (f *Faker) NounCountable() string

NounCountable will generate a random countable noun

Example

Code:

{
	f := New(11)
	fmt.Println(f.NounCountable())
	// Output: neck
}

Output:

neck

func (*Faker) NounProper

func (f *Faker) NounProper() string

NounProper will generate a random proper noun

Example

Code:

{
	f := New(11)
	fmt.Println(f.NounProper())
	// Output: Marcel
}

Output:

Marcel

func (*Faker) NounUncountable

func (f *Faker) NounUncountable() string

NounUncountable will generate a random uncountable noun

Example

Code:

{
	f := New(11)
	fmt.Println(f.NounUncountable())
	// Output: seafood
}

Output:

seafood

func (*Faker) Number

func (f *Faker) Number(min int, max int) int

Number will generate a random number between given min And max

Example

Code:

{
	f := New(11)
	fmt.Println(f.Number(50, 23456))
	// Output: 12583
}

Output:

12583

func (*Faker) Numerify

func (f *Faker) Numerify(str string) string

Numerify will replace # with random numerical values

Example

Code:

{
	f := New(11)
	fmt.Println(f.Numerify("###-###-####"))
	// Output: 613-645-9948
}

Output:

613-645-9948

func (*Faker) OperaUserAgent

func (f *Faker) OperaUserAgent() string

OperaUserAgent will generate a random opera browser user agent string

Example

Code:

{
	f := New(11)
	fmt.Println(f.OperaUserAgent())
	// Output: Opera/8.20 (Macintosh; U; PPC Mac OS X 10_9_10; en-US) Presto/2.9.198 Version/11.00
}

Output:

Opera/8.20 (Macintosh; U; PPC Mac OS X 10_9_10; en-US) Presto/2.9.198 Version/11.00

func (*Faker) Paragraph

func (f *Faker) Paragraph(paragraphCount int, sentenceCount int, wordCount int, separator string) string

Paragraph will generate a random paragraphGenerator

Example

Code:

{
	f := New(11)
	fmt.Println(f.Paragraph(3, 5, 12, "\n"))
	// Output: There had result everything niche backwards caused quarterly without week it hungry. Thing someone him regularly today whomever this revolt hence from his timing. As quantity us these yours live these frantic not may another how. This ours his them those whose them batch its Iraqi most that. Few abroad cheese this whereas next how there gorgeous genetics time choir.
	// Fiction therefore yourselves am those infrequently heap software quarterly rather punctuation yellow. Where several his orchard to frequently hence victorious boxers each does auspicious. Yourselves first soup tomorrow this that must conclude anyway some yearly who. Cough laugh himself both yet rarely me dolphin intensely block would leap. Plane us first then down them eager would hundred super throughout animal.
	// Yet themselves been group flock shake part purchase up usually it her. None it hers boat what their there Turkmen moreover one Lebanese to. Brace these shower in it everybody should whatever those uninterested several nobody. Yours thankful innocent power to any from its few luxury none boy. Religion themselves it there might must near theirs mine thing tonight outside.
}

Output:

There had result everything niche backwards caused quarterly without week it hungry. Thing someone him regularly today whomever this revolt hence from his timing. As quantity us these yours live these frantic not may another how. This ours his them those whose them batch its Iraqi most that. Few abroad cheese this whereas next how there gorgeous genetics time choir.
Fiction therefore yourselves am those infrequently heap software quarterly rather punctuation yellow. Where several his orchard to frequently hence victorious boxers each does auspicious. Yourselves first soup tomorrow this that must conclude anyway some yearly who. Cough laugh himself both yet rarely me dolphin intensely block would leap. Plane us first then down them eager would hundred super throughout animal.
Yet themselves been group flock shake part purchase up usually it her. None it hers boat what their there Turkmen moreover one Lebanese to. Brace these shower in it everybody should whatever those uninterested several nobody. Yours thankful innocent power to any from its few luxury none boy. Religion themselves it there might must near theirs mine thing tonight outside.

func (*Faker) Password

func (f *Faker) Password(lower bool, upper bool, numeric bool, special bool, space bool, num int) string

Password will generate a random password. Minimum number length of 5 if less than.

Example

Code:

{
	f := New(11)
	fmt.Println(f.Password(true, false, false, false, false, 32))
	fmt.Println(f.Password(false, true, false, false, false, 32))
	fmt.Println(f.Password(false, false, true, false, false, 32))
	fmt.Println(f.Password(false, false, false, true, false, 32))
	fmt.Println(f.Password(true, true, true, true, true, 32))
	fmt.Println(f.Password(true, true, true, true, true, 4))
	// Output: vodnqxzsuptgehrzylximvylxzoywexw
	// ZSRQWJFJWCSTVGXKYKWMLIAFGFELFJRG
	// 61718615932495608398906260648432
	// @$,@#:,(,).{?:%?)>*..<=};#$(:{==
	// CkF{wwb:?Kb},w?vdz{Zox C&>Prt99:
	// j ;9X
}

Output:

vodnqxzsuptgehrzylximvylxzoywexw
ZSRQWJFJWCSTVGXKYKWMLIAFGFELFJRG
61718615932495608398906260648432
@$,@#:,(,).{?:%?)>*..<=};#$(:{==
CkF{wwb:?Kb},w?vdz{Zox C&>Prt99:
j ;9X

func (*Faker) Person

func (f *Faker) Person() *PersonInfo

Person will generate a struct with person information

Example

Code:

{
	f := New(11)
	person := f.Person()
	job := person.Job
	address := person.Address
	contact := person.Contact
	creditCard := person.CreditCard

	fmt.Println(person.FirstName)
	fmt.Println(person.LastName)
	fmt.Println(person.Gender)
	fmt.Println(person.SSN)
	fmt.Println(person.Image)

	fmt.Println(job.Company)
	fmt.Println(job.Title)
	fmt.Println(job.Descriptor)
	fmt.Println(job.Level)

	fmt.Println(address.Address)
	fmt.Println(address.Street)
	fmt.Println(address.City)
	fmt.Println(address.State)
	fmt.Println(address.Zip)
	fmt.Println(address.Country)
	fmt.Println(address.Latitude)
	fmt.Println(address.Longitude)

	fmt.Println(contact.Phone)
	fmt.Println(contact.Email)

	fmt.Println(creditCard.Type)
	fmt.Println(creditCard.Number)
	fmt.Println(creditCard.Exp)
	fmt.Println(creditCard.Cvv)

	// Output:
	// Markus
	// Moen
	// male
	// 275413589
	// https://picsum.photos/300/300/people
	// Morgan Stanley
	// Associate
	// Human
	// Usability
	// 99536 Pine mouth, Fremont, Indiana 30042
	// 99536 Pine mouth
	// Fremont
	// Indiana
	// 30042
	// Madagascar
	// -75.631793
	// -83.487777
	// 4583023202
	// jalonrolfson@quigley.info
	// Hiper
	// 4011781714800889
	// 09/26
	// 272
}

Output:

Markus
Moen
male
275413589
https://picsum.photos/300/300/people
Morgan Stanley
Associate
Human
Usability
99536 Pine mouth, Fremont, Indiana 30042
99536 Pine mouth
Fremont
Indiana
30042
Madagascar
-75.631793
-83.487777
4583023202
jalonrolfson@quigley.info
Hiper
4011781714800889
09/26
272

func (*Faker) PetName

func (f *Faker) PetName() string

PetName will return a random fun pet name

Example

Code:

{
	f := New(11)
	fmt.Println(f.PetName())
	// Output: Ozzy Pawsborne
}

Output:

Ozzy Pawsborne

func (*Faker) Phone

func (f *Faker) Phone() string

Phone will generate a random phone number string

Example

Code:

{
	f := New(11)
	fmt.Println(f.Phone())
	// Output: 6136459948
}

Output:

6136459948

func (*Faker) PhoneFormatted

func (f *Faker) PhoneFormatted() string

PhoneFormatted will generate a random phone number string

Example

Code:

{
	f := New(11)
	fmt.Println(f.PhoneFormatted())
	// Output: 136-459-9489
}

Output:

136-459-9489

func (*Faker) Phrase

func (f *Faker) Phrase() string

Phrase will return a random phrase

Example

Code:

{
	f := New(11)
	fmt.Println(f.Phrase())
	// Output: horses for courses
}

Output:

horses for courses

func (*Faker) PhraseAdverb

func (f *Faker) PhraseAdverb() string

PhraseAdverb will return a random adverb phrase

Example

Code:

{
	f := New(11)
	fmt.Println(f.PhraseAdverb())
	// Output: fully gladly
}

Output:

fully gladly

func (*Faker) PhraseNoun

func (f *Faker) PhraseNoun() string

PhraseNoun will return a random noun phrase

Example

Code:

{
	f := New(11)
	fmt.Println(f.PhraseNoun())
	// Output: the purple tribe
}

Output:

the purple tribe

func (*Faker) PhrasePreposition

func (f *Faker) PhrasePreposition() string

PhrasePreposition will return a random preposition phrase

Example

Code:

{
	f := New(11)
	fmt.Println(f.PhrasePreposition())
	// Output: out the tribe
}

Output:

out the tribe

func (*Faker) PhraseVerb

func (f *Faker) PhraseVerb() string

PhraseVerb will return a random preposition phrase

Example

Code:

{
	f := New(11)
	fmt.Println(f.PhraseVerb())
	// Output: gladly dream indeed swiftly till a problem poorly
}

Output:

gladly dream indeed swiftly till a problem poorly

func (*Faker) Preposition

func (f *Faker) Preposition() string

Preposition will generate a random preposition

Example

Code:

{
	f := New(11)
	fmt.Println(f.Preposition())
	// Output: other than
}

Output:

other than

func (*Faker) PrepositionCompound

func (f *Faker) PrepositionCompound() string

PrepositionCompound will generate a random compound preposition

Example

Code:

{
	f := New(11)
	fmt.Println(f.PrepositionCompound())
	// Output: according to
}

Output:

according to

func (*Faker) PrepositionDouble

func (f *Faker) PrepositionDouble() string

PrepositionDouble will generate a random double preposition

Example

Code:

{
	f := New(11)
	fmt.Println(f.PrepositionDouble())
	// Output: before
}

Output:

before

func (*Faker) PrepositionSimple

func (f *Faker) PrepositionSimple() string

PrepositionSimple will generate a random simple preposition

Example

Code:

{
	f := New(11)
	fmt.Println(f.PrepositionSimple())
	// Output: out
}

Output:

out

func (*Faker) Price

func (f *Faker) Price(min, max float64) float64

Price will take in a min and max value and return a formatted price

Example

Code:

{
	f := New(11)
	fmt.Printf("%.2f", f.Price(0.8618, 1000))
	// Output: 92.26
}

Output:

92.26

func (*Faker) ProgrammingLanguage

func (f *Faker) ProgrammingLanguage() string

ProgrammingLanguage will return a random programming language

Example

Code:

{
	f := New(464)
	fmt.Println(f.ProgrammingLanguage())
	// Output: Go
}

Output:

Go

func (*Faker) ProgrammingLanguageBest

func (f *Faker) ProgrammingLanguageBest() string

ProgrammingLanguageBest will return a random programming language

Example

Code:

{
	f := New(11)
	fmt.Println(f.ProgrammingLanguageBest())
	// Output: Go
}

Output:

Go

func (*Faker) Pronoun

func (f *Faker) Pronoun() string

Pronoun will generate a random pronoun

Example

Code:

{
	f := New(11)
	fmt.Println(f.Pronoun())
	// Output: me
}

Output:

me

func (*Faker) PronounDemonstrative

func (f *Faker) PronounDemonstrative() string

PronounDemonstrative will generate a random demonstrative pronoun

Example

Code:

{
	f := New(11)
	fmt.Println(f.PronounDemonstrative())
	// Output: this
}

Output:

this

func (*Faker) PronounIndefinite

func (f *Faker) PronounIndefinite() string

PronounIndefinite will generate a random indefinite pronoun

Example

Code:

{
	f := New(11)
	fmt.Println(f.PronounIndefinite())
	// Output: few
}

Output:

few

func (*Faker) PronounInterrogative

func (f *Faker) PronounInterrogative() string

PronounInterrogative will generate a random interrogative pronoun

Example

Code:

{
	f := New(11)
	fmt.Println(f.PronounInterrogative())
	// Output: what
}

Output:

what

func (*Faker) PronounObject

func (f *Faker) PronounObject() string

PronounObject will generate a random object pronoun

Example

Code:

{
	f := New(11)
	fmt.Println(f.PronounObject())
	// Output: it
}

Output:

it

func (*Faker) PronounPersonal

func (f *Faker) PronounPersonal() string

PronounPersonal will generate a random personal pronoun

Example

Code:

{
	f := New(11)
	fmt.Println(f.PronounPersonal())
	// Output: it
}

Output:

it

func (*Faker) PronounPossessive

func (f *Faker) PronounPossessive() string

PronounPossessive will generate a random possessive pronoun

Example

Code:

{
	f := New(11)
	fmt.Println(f.PronounPossessive())
	// Output: mine
}

Output:

mine

func (*Faker) PronounReflective

func (f *Faker) PronounReflective() string

PronounReflective will generate a random reflective pronoun

Example

Code:

{
	f := New(11)
	fmt.Println(f.PronounReflective())
	// Output: myself
}

Output:

myself

func (*Faker) PronounRelative

func (f *Faker) PronounRelative() string

PronounRelative will generate a random relative pronoun

Example

Code:

{
	f := New(11)
	fmt.Println(f.PronounRelative())
	// Output: as
}

Output:

as

func (*Faker) Question

func (f *Faker) Question() string

Question will return a random question

Example

Code:

{
	f := New(11)
	fmt.Println(f.Question())
	// Output: Roof chia echo pickled?
}

Output:

Roof chia echo pickled?

func (*Faker) Quote

func (f *Faker) Quote() string

Quote will return a random quote from a random person

Example

Code:

{
	f := New(11)
	fmt.Println(f.Quote())
	// Output: "Roof chia echo pickled." - Marques Jakubowski
}

Output:

"Roof chia echo pickled." - Marques Jakubowski

func (*Faker) RGBColor

func (f *Faker) RGBColor() []int

RGBColor will generate a random int slice color

Example

Code:

{
	f := New(11)
	fmt.Println(f.RGBColor())
	// Output: [89 176 195]
}

Output:

[89 176 195]

func (*Faker) RandomInt

func (f *Faker) RandomInt(i []int) int

RandomInt will take in a slice of int and return a randomly selected value

Example

Code:

{
	f := New(11)

	ints := []int{52, 854, 941, 74125, 8413, 777, 89416, 841657}
	fmt.Println(f.RandomInt(ints))
	// Output: 52
}

Output:

52

func (*Faker) RandomMapKey

func (f *Faker) RandomMapKey(mapI interface{}) interface{}

RandomMapKey will return a random key from a map

func (*Faker) RandomString

func (f *Faker) RandomString(a []string) string

RandomString will take in a slice of string and return a randomly selected value

Example

Code:

{
	f := New(11)
	fmt.Println(f.RandomString([]string{"hello", "world"}))
	// Output: hello
}

Output:

hello

func (*Faker) RandomUint

func (f *Faker) RandomUint(u []uint) uint

RandomUint will take in a slice of uint and return a randomly selected value

Example

Code:

{
	f := New(11)

	ints := []uint{52, 854, 941, 74125, 8413, 777, 89416, 841657}
	fmt.Println(f.RandomUint(ints))
	// Output: 52
}

Output:

52

func (*Faker) Regex

func (f *Faker) Regex(regexStr string) string

Regex will generate a string based upon a RE2 syntax

Example

Code:

{
	f := New(11)

	fmt.Println(f.Regex("[abcdef]{5}"))
	fmt.Println(f.Regex("[[:upper:]]{5}"))
	fmt.Println(f.Regex("(hello|world|whats|up)"))
	fmt.Println(f.Regex(`^[a-z]{5,10}@[a-z]{5,10}\.(com|net|org)$`))
	// Output: affec
	// RXHKI
	// world
	// tapwyjdnsm@gtlxw.net
}

Output:

affec
RXHKI
world
tapwyjdnsm@gtlxw.net

func (*Faker) SSN

func (f *Faker) SSN() string

SSN will generate a random Social Security Number

Example

Code:

{
	f := New(11)
	fmt.Println(f.SSN())
	// Output: 493298265
}

Output:

493298265

func (*Faker) SafariUserAgent

func (f *Faker) SafariUserAgent() string

SafariUserAgent will generate a random safari browser user agent string

Example

Code:

{
	f := New(11)
	fmt.Println(f.SafariUserAgent())
	// Output: Mozilla/5.0 (iPad; CPU OS 7_0_2 like Mac OS X; en-US) AppleWebKit/536.4.4 (KHTML, like Gecko) Version/3.0.5 Mobile/8B120 Safari/6536.4.4
}

Output:

Mozilla/5.0 (iPad; CPU OS 7_0_2 like Mac OS X; en-US) AppleWebKit/536.4.4 (KHTML, like Gecko) Version/3.0.5 Mobile/8B120 Safari/6536.4.4

func (*Faker) SafeColor

func (f *Faker) SafeColor() string

SafeColor will generate a random safe color string

Example

Code:

{
	f := New(11)
	fmt.Println(f.SafeColor())
	// Output: black
}

Output:

black

func (*Faker) Second

func (f *Faker) Second() int

Second will generate a random second

Example

Code:

{
	f := New(11)
	fmt.Println(f.Second())
	// Output: 5
}

Output:

5

func (*Faker) Sentence

func (f *Faker) Sentence(wordCount int) string

Sentence will generate a random sentence

Example

Code:

{
	f := New(11)
	fmt.Println(f.Sentence(5))
	// Output: There had result everything niche.
}

Output:

There had result everything niche.

func (*Faker) SentenceSimple

func (f *Faker) SentenceSimple() string

SentenceSimple will generate a random simple sentence

Example

Code:

{
	f := New(11)
	fmt.Println(f.SentenceSimple())
	// Output: The purple tribe indeed swiftly laugh.
}

Output:

The purple tribe indeed swiftly laugh.

func (*Faker) ShuffleAnySlice

func (f *Faker) ShuffleAnySlice(v interface{})

ShuffleAnySlice takes in a slice and outputs it in a random order

Example

Code:

{
	f := New(11)

	strings := []string{"happy", "times", "for", "everyone", "have", "a", "good", "day"}
	f.ShuffleAnySlice(strings)
	fmt.Println(strings)

	ints := []int{52, 854, 941, 74125, 8413, 777, 89416, 841657}
	f.ShuffleAnySlice(ints)
	fmt.Println(ints)
	// Output:
	// [good everyone have for times a day happy]
	// [777 74125 941 854 89416 52 8413 841657]
}

Output:

[good everyone have for times a day happy]
[777 74125 941 854 89416 52 8413 841657]

func (*Faker) ShuffleInts

func (f *Faker) ShuffleInts(a []int)

ShuffleInts will randomize a slice of ints

Example

Code:

{
	f := New(11)

	ints := []int{52, 854, 941, 74125, 8413, 777, 89416, 841657}
	f.ShuffleInts(ints)
	fmt.Println(ints)
	// Output: [74125 777 941 89416 8413 854 52 841657]
}

Output:

[74125 777 941 89416 8413 854 52 841657]

func (*Faker) ShuffleStrings

func (f *Faker) ShuffleStrings(a []string)

ShuffleStrings will randomize a slice of strings

Example

Code:

{
	f := New(11)
	strings := []string{"happy", "times", "for", "everyone", "have", "a", "good", "day"}
	f.ShuffleStrings(strings)
	fmt.Println(strings)
	// Output: [good everyone have for times a day happy]
}

Output:

[good everyone have for times a day happy]

func (*Faker) Slice

func (f *Faker) Slice(v interface{})

Slice fills built-in types and exported fields of a struct with random data.

Example

Code:

{
	f := New(11)

	var S []string
	f.Slice(&S)

	I := make([]int8, 3)
	f.Slice(&I)

	fmt.Println(S)
	fmt.Println(I)

	// Output: [RMaRxHkiJ PtapWYJdn MKgtlxwnq qclaYkWw oRLOPxLIok qanPAKaXS]
	// [-88 -101 60]
}

Output:

[RMaRxHkiJ PtapWYJdn MKgtlxwnq qclaYkWw oRLOPxLIok qanPAKaXS]
[-88 -101 60]
Example (Struct)

Code:

{
	f := New(11)

	type Basic struct {
		S string `fake:"{firstname}"`
		I int
		F float32
	}

	var B []Basic
	f.Slice(&B)

	fmt.Println(B)
	// Output: [{Marcel -652938557 1.9343967e+38} {Lura -101175613 2.670526e+38} {Lucinda 1412367049 1.0427679e+38} {Santino 1631045574 2.2573786e+38} {Dawn -924758850 4.249854e+37} {Alice -937677379 1.0573345e+38}]
}

Output:

[{Marcel -652938557 1.9343967e+38} {Lura -101175613 2.670526e+38} {Lucinda 1412367049 1.0427679e+38} {Santino 1631045574 2.2573786e+38} {Dawn -924758850 4.249854e+37} {Alice -937677379 1.0573345e+38}]

func (*Faker) Snack

func (f *Faker) Snack() string

Snack will return a random snack name

Example

Code:

{
	f := New(11)
	fmt.Println(f.Snack())
	// Output: Hoisin marinated wing pieces
}

Output:

Hoisin marinated wing pieces

func (*Faker) State

func (f *Faker) State() string

State will generate a random state string

Example

Code:

{
	f := New(11)
	fmt.Println(f.State())
	// Output: Hawaii
}

Output:

Hawaii

func (*Faker) StateAbr

func (f *Faker) StateAbr() string

StateAbr will generate a random abbreviated state string

Example

Code:

{
	f := New(11)
	fmt.Println(f.StateAbr())
	// Output: CO
}

Output:

CO

func (*Faker) Street

func (f *Faker) Street() string

Street will generate a random address street string

Example

Code:

{
	f := New(11)
	fmt.Println(f.Street())
	// Output: 364 Unions ville
}

Output:

364 Unions ville

func (*Faker) StreetName

func (f *Faker) StreetName() string

StreetName will generate a random address street name string

Example

Code:

{
	f := New(11)
	fmt.Println(f.StreetName())
	// Output: View
}

Output:

View

func (*Faker) StreetNumber

func (f *Faker) StreetNumber() string

StreetNumber will generate a random address street number string

Example

Code:

{
	f := New(11)
	fmt.Println(f.StreetNumber())
	// Output: 13645
}

Output:

13645

func (*Faker) StreetPrefix

func (f *Faker) StreetPrefix() string

StreetPrefix will generate a random address street prefix string

Example

Code:

{
	f := New(11)
	fmt.Println(f.StreetPrefix())
	// Output: Lake
}

Output:

Lake

func (*Faker) StreetSuffix

func (f *Faker) StreetSuffix() string

StreetSuffix will generate a random address street suffix string

Example

Code:

{
	f := New(11)
	fmt.Println(f.StreetSuffix())
	// Output: land
}

Output:

land

func (*Faker) Struct

func (f *Faker) Struct(v interface{}) error

Struct fills in exported fields of a struct with random data based on the value of `fake` tag of exported fields. Use `fake:"skip"` to explicitly skip an element. All built-in types are supported, with templating support for string types.

Example

Code:

{
	fake := New(11)

	type Bar struct {
		Name   string
		Number int
		Float  float32
	}

	type Foo struct {
		Str     string
		Int     int
		Pointer *int
		Name    string            `fake:"{firstname}"`
		Number  string            `fake:"{number:1,10}"`
		Skip    *string           `fake:"skip"`
		Array   []string          `fakesize:"2"`
		Map     map[string]string `fakesize:"2"`
		Bar     Bar
	}

	var f Foo
	fake.Struct(&f)

	fmt.Printf("%s\n", f.Str)
	fmt.Printf("%d\n", f.Int)
	fmt.Printf("%d\n", *f.Pointer)
	fmt.Printf("%v\n", f.Name)
	fmt.Printf("%v\n", f.Number)
	fmt.Printf("%v\n", f.Skip)
	fmt.Printf("%v\n", f.Array)
	fmt.Printf("%v\n", f.Map)
	fmt.Printf("%+v\n", f.Bar)

	// Output: bRMaRx
	// -605057214
	// 1412367049
	// Andre
	// 1
	// <nil>
	// [PtapWYJdn MKgtlxwnq]
	// map[qanPAKaXS:QFpZysVaHG qclaYkWw:oRLOPxLIok]
	// {Name:yvqqdH Number:-356428491 Float:2.8838284e+38}
}

Output:

bRMaRx
-605057214
1412367049
Andre
1
<nil>
[PtapWYJdn MKgtlxwnq]
map[qanPAKaXS:QFpZysVaHG qclaYkWw:oRLOPxLIok]
{Name:yvqqdH Number:-356428491 Float:2.8838284e+38}
Example (Array)

Code:

{
	f := New(11)

	type Foo struct {
		Bar    string
		Int    int
		Name   string  `fake:"{firstname}"`
		Number string  `fake:"{number:1,10}"`
		Skip   *string `fake:"skip"`
	}

	type FooMany struct {
		Foos  []Foo    `fakesize:"1"`
		Names []string `fake:"{firstname}" fakesize:"3"`
	}

	var fm FooMany
	f.Struct(&fm)

	fmt.Printf("%v\n", fm.Foos)
	fmt.Printf("%v\n", fm.Names)

	// Output:
	// [{bRMaRx -605057214 Paolo 4 <nil>}]
	// [Santino Carole Enrique]
}

Output:

[{bRMaRx -605057214 Paolo 4 <nil>}]
[Santino Carole Enrique]

func (*Faker) Teams

func (f *Faker) Teams(peopleArray []string, teamsArray []string) map[string][]string

Teams takes in an array of people and team names and randomly places the people into teams as evenly as possible

Example

Code:

{
	f := New(11)
	fmt.Println(f.Teams(
		[]string{"Billy", "Sharon", "Jeff", "Connor", "Steve", "Justin", "Fabian", "Robert"},
		[]string{"Team 1", "Team 2", "Team 3"},
	))
	// Output: map[Team 1:[Fabian Connor Steve] Team 2:[Jeff Sharon Justin] Team 3:[Robert Billy]]
}

Output:

map[Team 1:[Fabian Connor Steve] Team 2:[Jeff Sharon Justin] Team 3:[Robert Billy]]

func (*Faker) TimeZone

func (f *Faker) TimeZone() string

TimeZone will select a random timezone string

Example

Code:

{
	f := New(11)
	fmt.Println(f.TimeZone())
	// Output: Kaliningrad Standard Time
}

Output:

Kaliningrad Standard Time

func (*Faker) TimeZoneAbv

func (f *Faker) TimeZoneAbv() string

TimeZoneAbv will select a random timezone abbreviation string

Example

Code:

{
	f := New(11)
	fmt.Println(f.TimeZoneAbv())
	// Output: KST
}

Output:

KST

func (*Faker) TimeZoneFull

func (f *Faker) TimeZoneFull() string

TimeZoneFull will select a random full timezone string

Example

Code:

{
	f := New(11)
	fmt.Println(f.TimeZoneFull())
	// Output: (UTC+03:00) Kaliningrad, Minsk
}

Output:

(UTC+03:00) Kaliningrad, Minsk

func (*Faker) TimeZoneOffset

func (f *Faker) TimeZoneOffset() float32

TimeZoneOffset will select a random timezone offset

Example

Code:

{
	f := New(11)
	fmt.Println(f.TimeZoneOffset())
	// Output: 3
}

Output:

3

func (*Faker) TimeZoneRegion

func (f *Faker) TimeZoneRegion() string

TimeZoneRegion will select a random region style timezone string, e.g. "America/Chicago"

Example

Code:

{
	f := New(11)
	fmt.Println(f.TimeZoneRegion())
	// Output: America/Vancouver
}

Output:

America/Vancouver

func (*Faker) URL

func (f *Faker) URL() string

URL will generate a random url string

Example

Code:

{
	f := New(11)
	fmt.Println(f.URL())
	// Output: https://www.dynamiciterate.name/target/seamless
}

Output:

https://www.dynamiciterate.name/target/seamless

func (*Faker) UUID

func (f *Faker) UUID() string

UUID (version 4) will generate a random unique identifier based upon random numbers Format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Example

Code:

{
	f := New(11)
	fmt.Println(f.UUID())
	// Output: 590c1440-9888-45b0-bd51-a817ee07c3f2
}

Output:

590c1440-9888-45b0-bd51-a817ee07c3f2

func (*Faker) Uint16

func (f *Faker) Uint16() uint16

Uint16 will generate a random uint16 value

Example

Code:

{
	f := New(11)
	fmt.Println(f.Uint16())
	// Output: 34968
}

Output:

34968

func (*Faker) Uint32

func (f *Faker) Uint32() uint32

Uint32 will generate a random uint32 value

Example

Code:

{
	f := New(11)
	fmt.Println(f.Uint32())
	// Output: 1075055705
}

Output:

1075055705

func (*Faker) Uint64

func (f *Faker) Uint64() uint64

Uint64 will generate a random uint64 value

Example

Code:

{
	f := New(11)
	fmt.Println(f.Uint64())
	// Output: 10067102729548074073
}

Output:

10067102729548074073

func (*Faker) Uint8

func (f *Faker) Uint8() uint8

Uint8 will generate a random uint8 value

Example

Code:

{
	f := New(11)
	fmt.Println(f.Uint8())
	// Output: 152
}

Output:

152

func (*Faker) UintRange

func (f *Faker) UintRange(min, max uint) uint

UintRange will generate a random uint value between min and max

Example

Code:

{
	f := New(11)
	fmt.Println(f.UintRange(1, 10))
	// Output: 1
}

Output:

1

func (*Faker) UserAgent

func (f *Faker) UserAgent() string

UserAgent will generate a random broswer user agent

Example

Code:

{
	f := New(11)
	fmt.Println(f.UserAgent())
	// Output: Mozilla/5.0 (Windows NT 5.0) AppleWebKit/5312 (KHTML, like Gecko) Chrome/40.0.800.0 Mobile Safari/5312
}

Output:

Mozilla/5.0 (Windows NT 5.0) AppleWebKit/5312 (KHTML, like Gecko) Chrome/40.0.800.0 Mobile Safari/5312

func (*Faker) Username

func (f *Faker) Username() string

Username will generate a random username based upon picking a random lastname and random numbers at the end

Example

Code:

{
	f := New(11)
	fmt.Println(f.Username())
	// Output: Daniel1364
}

Output:

Daniel1364

func (*Faker) Vegetable

func (f *Faker) Vegetable() string

Vegetable will return a random vegetable name

Example

Code:

{
	f := New(11)
	fmt.Println(f.Vegetable())
	// Output: Amaranth Leaves
}

Output:

Amaranth Leaves

func (*Faker) Verb

func (f *Faker) Verb() string

Verb will generate a random verb

Example

Code:

{
	f := New(11)
	fmt.Println(f.Verb())
	// Output: does
}

Output:

does

func (*Faker) VerbAction

func (f *Faker) VerbAction() string

VerbAction will generate a random action verb

Example

Code:

{
	f := New(11)
	fmt.Println(f.VerbAction())
	// Output: close
}

Output:

close

func (*Faker) VerbHelping

func (f *Faker) VerbHelping() string

VerbHelping will generate a random helping verb

Example

Code:

{
	f := New(11)
	fmt.Println(f.VerbHelping())
	// Output: be
}

Output:

be

func (*Faker) VerbIntransitive

func (f *Faker) VerbIntransitive() string

VerbIntransitive will generate a random intransitive verb

Example

Code:

{
	f := New(11)
	fmt.Println(f.VerbIntransitive())
	// Output: laugh
}

Output:

laugh

func (*Faker) VerbLinking

func (f *Faker) VerbLinking() string

VerbLinking will generate a random linking verb

Example

Code:

{
	f := New(11)
	fmt.Println(f.VerbLinking())
	// Output: was
}

Output:

was

func (*Faker) VerbTransitive

func (f *Faker) VerbTransitive() string

VerbTransitive will generate a random transitive verb

Example

Code:

{
	f := New(11)
	fmt.Println(f.VerbTransitive())
	// Output: follow
}

Output:

follow

func (*Faker) WeekDay

func (f *Faker) WeekDay() string

WeekDay will generate a random weekday string (Monday-Sunday)

Example

Code:

{
	f := New(11)
	fmt.Println(f.WeekDay())
	// Output: Tuesday
}

Output:

Tuesday

func (*Faker) Weighted

func (f *Faker) Weighted(options []interface{}, weights []float32) (interface{}, error)

Weighted will take in an array of options and weights and return a random selection based upon its indexed weight

func (*Faker) Word

func (f *Faker) Word() string

Word will generate a random word

Example

Code:

{
	f := New(11)
	fmt.Println(f.Word())
	// Output: there
}

Output:

there

func (*Faker) XML

func (f *Faker) XML(xo *XMLOptions) ([]byte, error)

XML generates an object or an array of objects in json format

Example (Array)

Code:

{
	f := New(11)

	value, err := f.XML(&XMLOptions{
		Type:          "array",
		RootElement:   "xml",
		RecordElement: "record",
		RowCount:      2,
		Indent:        true,
		Fields: []Field{
			{Name: "first_name", Function: "firstname"},
			{Name: "last_name", Function: "lastname"},
			{Name: "password", Function: "password", Params: MapParams{"special": {"false"}}},
		},
	})
	if err != nil {
		fmt.Println(err)
	}

	fmt.Println(string(value))

	// Output:
	// <xml>
	//     <record>
	//         <first_name>Markus</first_name>
	//         <last_name>Moen</last_name>
	//         <password>Dc0VYXjkWABx</password>
	//     </record>
	//     <record>
	//         <first_name>Osborne</first_name>
	//         <last_name>Hilll</last_name>
	//         <password>XPJ9OVNbs5lm</password>
	//     </record>
	// </xml>
}

Output:

<xml>
    <record>
        <first_name>Markus</first_name>
        <last_name>Moen</last_name>
        <password>Dc0VYXjkWABx</password>
    </record>
    <record>
        <first_name>Osborne</first_name>
        <last_name>Hilll</last_name>
        <password>XPJ9OVNbs5lm</password>
    </record>
</xml>
Example (Single)

Code:

{
	f := New(11)

	value, err := f.XML(&XMLOptions{
		Type:          "single",
		RootElement:   "xml",
		RecordElement: "record",
		RowCount:      2,
		Indent:        true,
		Fields: []Field{
			{Name: "first_name", Function: "firstname"},
			{Name: "last_name", Function: "lastname"},
			{Name: "password", Function: "password", Params: MapParams{"special": {"false"}}},
		},
	})
	if err != nil {
		fmt.Println(err)
	}

	fmt.Println(string(value))

	// Output:
	// <xml>
	//     <first_name>Markus</first_name>
	//     <last_name>Moen</last_name>
	//     <password>Dc0VYXjkWABx</password>
	// </xml>
}

Output:

<xml>
    <first_name>Markus</first_name>
    <last_name>Moen</last_name>
    <password>Dc0VYXjkWABx</password>
</xml>

func (*Faker) Year

func (f *Faker) Year() int

Year will generate a random year between 1900 - current year

Example

Code:

{
	f := New(11)
	fmt.Println(f.Year())
	// Output: 1995
}

Output:

1995

func (*Faker) Zip

func (f *Faker) Zip() string

Zip will generate a random Zip code string

Example

Code:

{
	f := New(11)
	fmt.Println(f.Zip())
	// Output: 13645
}

Output:

13645

type Field

type Field struct {
	Name     string    `json:"name"`
	Function string    `json:"function"`
	Params   MapParams `json:"params"`
}

Field is used for defining what name and function you to generate for file outuputs

type Info

type Info struct {
	Display     string                                                            `json:"display"`
	Category    string                                                            `json:"category"`
	Description string                                                            `json:"description"`
	Example     string                                                            `json:"example"`
	Output      string                                                            `json:"output"`
	ContentType string                                                            `json:"content_type"`
	Params      []Param                                                           `json:"params"`
	Generate    func(r *rand.Rand, m *MapParams, info *Info) (interface{}, error) `json:"-"`
}

Info structures fields to better break down what each one generates

func GetFuncLookup

func GetFuncLookup(functionName string) *Info

GetFuncLookup will lookup

func (*Info) GetBool

func (i *Info) GetBool(m *MapParams, field string) (bool, error)

GetBool will retrieve boolean field from data

func (*Info) GetField

func (i *Info) GetField(m *MapParams, field string) (*Param, []string, error)

GetField will retrieve field from data

func (*Info) GetFloat32

func (i *Info) GetFloat32(m *MapParams, field string) (float32, error)

GetFloat32 will retrieve int field from data

func (*Info) GetFloat32Array

func (i *Info) GetFloat32Array(m *MapParams, field string) ([]float32, error)

GetFloat32Array will retrieve []float field from data

func (*Info) GetFloat64

func (i *Info) GetFloat64(m *MapParams, field string) (float64, error)

GetFloat64 will retrieve int field from data

func (*Info) GetInt

func (i *Info) GetInt(m *MapParams, field string) (int, error)

GetInt will retrieve int field from data

func (*Info) GetIntArray

func (i *Info) GetIntArray(m *MapParams, field string) ([]int, error)

GetIntArray will retrieve []int field from data

func (*Info) GetString

func (i *Info) GetString(m *MapParams, field string) (string, error)

GetString will retrieve string field from data

func (*Info) GetStringArray

func (i *Info) GetStringArray(m *MapParams, field string) ([]string, error)

GetStringArray will retrieve []string field from data

func (*Info) GetUint

func (i *Info) GetUint(m *MapParams, field string) (uint, error)

GetUint will retrieve uint field from data

type JSONOptions

type JSONOptions struct {
	Type     string  `json:"type" xml:"type"` // array or object
	RowCount int     `json:"row_count" xml:"row_count"`
	Fields   []Field `json:"fields" xml:"fields"`
	Indent   bool    `json:"indent" xml:"indent"`
}

JSONOptions defines values needed for json generation

type JobInfo

type JobInfo struct {
	Company    string `json:"company" xml:"company"`
	Title      string `json:"title" xml:"title"`
	Descriptor string `json:"descriptor" xml:"descriptor"`
	Level      string `json:"level" xml:"level"`
}

JobInfo is a struct of job information

func Job

func Job() *JobInfo

Job will generate a struct with random job information

Example

Code:

{
	Seed(11)
	jobInfo := Job()
	fmt.Println(jobInfo.Company)
	fmt.Println(jobInfo.Title)
	fmt.Println(jobInfo.Descriptor)
	fmt.Println(jobInfo.Level)
	// Output: ClearHealthCosts
	// Agent
	// Future
	// Tactics
}

Output:

ClearHealthCosts
Agent
Future
Tactics

type MapParams

type MapParams map[string]MapParamsValue

MapParams is the values to pass into a lookup generate

func NewMapParams

func NewMapParams() *MapParams

NewMapParams will create a new MapParams

func (*MapParams) Add

func (m *MapParams) Add(field string, value string)

Add will take in a field and value and add it to the map params type

func (*MapParams) Get

func (m *MapParams) Get(field string) []string

Get will return the array of string from the provided field

func (*MapParams) Size

func (m *MapParams) Size() int

Size will return the total size of the underlying map

type MapParamsValue

type MapParamsValue []string

func (*MapParamsValue) UnmarshalJSON

func (m *MapParamsValue) UnmarshalJSON(data []byte) error

UnmarshalJSON will unmarshal the json into the []string

type Param

type Param struct {
	Field       string   `json:"field"`
	Display     string   `json:"display"`
	Type        string   `json:"type"`
	Optional    bool     `json:"optional"`
	Default     string   `json:"default"`
	Options     []string `json:"options"`
	Description string   `json:"description"`
}

Param is a breakdown of param requirements and type definition

type PersonInfo

type PersonInfo struct {
	FirstName  string          `json:"first_name" xml:"first_name"`
	LastName   string          `json:"last_name" xml:"last_name"`
	Gender     string          `json:"gender" xml:"gender"`
	SSN        string          `json:"ssn" xml:"ssn"`
	Image      string          `json:"image" xml:"image"`
	Job        *JobInfo        `json:"job" xml:"job"`
	Address    *AddressInfo    `json:"address" xml:"address"`
	Contact    *ContactInfo    `json:"contact" xml:"contact"`
	CreditCard *CreditCardInfo `json:"credit_card" xml:"credit_card"`
}

PersonInfo is a struct of person information

func Person

func Person() *PersonInfo

Person will generate a struct with person information

Example

Code:

{
	Seed(11)
	person := Person()
	job := person.Job
	address := person.Address
	contact := person.Contact
	creditCard := person.CreditCard

	fmt.Println(person.FirstName)
	fmt.Println(person.LastName)
	fmt.Println(person.Gender)
	fmt.Println(person.SSN)
	fmt.Println(person.Image)

	fmt.Println(job.Company)
	fmt.Println(job.Title)
	fmt.Println(job.Descriptor)
	fmt.Println(job.Level)

	fmt.Println(address.Address)
	fmt.Println(address.Street)
	fmt.Println(address.City)
	fmt.Println(address.State)
	fmt.Println(address.Zip)
	fmt.Println(address.Country)
	fmt.Println(address.Latitude)
	fmt.Println(address.Longitude)

	fmt.Println(contact.Phone)
	fmt.Println(contact.Email)

	fmt.Println(creditCard.Type)
	fmt.Println(creditCard.Number)
	fmt.Println(creditCard.Exp)
	fmt.Println(creditCard.Cvv)

	// Output:
	// Markus
	// Moen
	// male
	// 275413589
	// https://picsum.photos/300/300/people
	// Morgan Stanley
	// Associate
	// Human
	// Usability
	// 99536 Pine mouth, Fremont, Indiana 30042
	// 99536 Pine mouth
	// Fremont
	// Indiana
	// 30042
	// Madagascar
	// -75.631793
	// -83.487777
	// 4583023202
	// jalonrolfson@quigley.info
	// Hiper
	// 4011781714800889
	// 09/26
	// 272
}

Output:

Markus
Moen
male
275413589
https://picsum.photos/300/300/people
Morgan Stanley
Associate
Human
Usability
99536 Pine mouth, Fremont, Indiana 30042
99536 Pine mouth
Fremont
Indiana
30042
Madagascar
-75.631793
-83.487777
4583023202
jalonrolfson@quigley.info
Hiper
4011781714800889
09/26
272

type XMLOptions

type XMLOptions struct {
	Type          string  `json:"type" xml:"type"` // single or multiple
	RootElement   string  `json:"root_element" xml:"root_element"`
	RecordElement string  `json:"record_element" xml:"record_element"`
	RowCount      int     `json:"row_count" xml:"row_count"`
	Fields        []Field `json:"fields" xml:"fields"`
	Indent        bool    `json:"indent" xml:"indent"`
}

XMLOptions defines values needed for json generation

Source Files

address.go animal.go app.go auth.go beer.go car.go celebrity.go color.go company.go csv.go doc.go emoji.go faker.go file.go food.go game.go generate.go hacker.go helpers.go hipster.go image.go internet.go json.go languages.go lookup.go lorem.go minecraft.go misc.go number.go payment.go person.go slice.go string.go struct.go time.go weighted.go word_adjective.go word_adverb.go word_connective.go word_general.go word_grammar.go word_helper.go word_noun.go word_phrase.go word_preposition.go word_pronoun.go word_sentence.go word_verb.go xml.go

Directories

PathSynopsis
cmd
cmd/gofakeit
cmd/gofakeitserver
data
Version
v6.13.1
Published
Jan 14, 2022
Platform
js/wasm
Imports
23 packages
Last checked
now

Tools for package owners.