gofakeit

package module
v7.14.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Dec 28, 2025 License: MIT Imports: 23 Imported by: 229

README

Gofakeit

Gofakeit Go Report Card Test GoDoc license

Random data generator written in go

Support

ko-fi Buy Me A Coffee

Merch

Merch

Features

Contributors

Thank you to all our Gofakeit contributors!

Installation

go get github.com/brianvoe/gofakeit/v7

Simple Usage

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

gofakeit.Name()                // Markus Moen
gofakeit.Email()               // alaynawuckert@kozey.biz
gofakeit.Phone()               // (570)245-7485
gofakeit.BS()                  // front-end
gofakeit.BeerName()            // Duvel
gofakeit.Color()               // MediumOrchid
gofakeit.Company()             // Moen, Pagac and Wuckert
gofakeit.CreditCardNumber(nil) // 4287271570245748
gofakeit.HackerPhrase()        // Connecting the array won't do anything, we need to generate the haptic COM driver!
gofakeit.JobTitle()            // Director
gofakeit.CurrencyShort()       // USD

See full list of functions

Seed

If you are using the default global usage and dont care about seeding no need to set anything. Gofakeit will seed it with a cryptographically secure number.

If you need a reproducible outcome you can set it via the Seed function call. Every example in this repo sets it for testing purposes.

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

gofakeit.Seed(0) // If 0 will use crypto/rand to generate a number

// or

gofakeit.Seed(8675309) // Set it to whatever number you want

Random Sources

Gofakeit has a few rand sources, by default it uses math/rand/v2 PCG which is a pseudo random number generator and is thread locked.

If you want to see other potential sources you can see the sub package Source for more information.

import (
	"github.com/brianvoe/gofakeit/v7"
	"github.com/brianvoe/gofakeit/v7/source"
	"math/rand/v2"
)

// Uses math/rand/v2(PCG Pseudo) with mutex locking
faker := gofakeit.New(0)

// NewFaker takes in a source and whether or not it should be thread safe
faker := gofakeit.NewFaker(src rand.Source, lock bool)

// PCG Pseudo
faker := gofakeit.NewFaker(rand.NewPCG(11, 11), true)

// ChaCha8
faker := gofakeit.NewFaker(rand.NewChaCha8([32]byte{0, 1, 2, 3, 4, 5}), true)


// Additional from Gofakeit sub package source

// JSF(Jenkins Small Fast)
faker := gofakeit.NewFaker(source.NewJSF(11), true)

// SFC(Simple Fast Counter)
faker := gofakeit.NewFaker(source.NewSFC(11), true)

// Crypto - Uses crypto/rand
faker := gofakeit.NewFaker(source.NewCrypto(), true)

// Dumb - simple incrementing number
faker := gofakeit.NewFaker(source.NewDumb(11), true)

Global Rand Set

If you would like to use the simple function calls but need to use something like crypto/rand you can override the default global with the random source that you want.

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

gofakeit.GlobalFaker = gofakeit.New(0)

Struct

Gofakeit can generate random data for struct fields. For the most part it covers all the basic type as well as some non-basic like time.Time.

Struct fields can also use tags to more specifically generate data for that field type.

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

// Create structs with random injected data
type Foo struct {
	Str           string
	Int           int
	Pointer       *int
	Name          string         `fake:"{firstname}"`         // Any available function all lowercase
	Sentence      string         `fake:"{sentence}"`          
	RandStr       string         `fake:"{randomstring:[hello,world]}"`
	Number        string         `fake:"{number:1,10}"`       // Comma separated for multiple values
	Regex         string         `fake:"{regex:[abcdef]{5}}"` // Generate string from regex
	Map           map[string]int `fakesize:"2"`
	Array         []string       `fakesize:"2"`
	ArrayRange    []string       `fakesize:"2,6"`
	Bar           Bar
	Skip          *string        `fake:"skip"`                // Set to "skip" to not generate data for
	SkipAlt       *string        `fake:"-"`                   // Set to "-" to not generate data for
	Created       time.Time                                   // Can take in a fake tag as well as a format tag
	CreatedFormat time.Time      `fake:"{year}-{month}-{day}" format:"2006-01-02"`
}

type Bar struct {
	Name    string
	Number  int
	Float   float32
}

// Pass your struct as a pointer
var f Foo
err := gofakeit.Struct(&f)

fmt.Println(f.Str)      		// hrukpttuezptneuvunh
fmt.Println(f.Int)      		// -7825289004089916589
fmt.Println(*f.Pointer) 		// -343806609094473732
fmt.Println(f.Name)     		// fred
fmt.Println(f.Sentence) 		// Record river mind.
fmt.Println(f.RandStr)          // world
fmt.Println(f.Number)   		// 4
fmt.Println(f.Regex)    		// cbdfc
fmt.Println(f.Map)    			// map[PxLIo:52 lxwnqhqc:846]
fmt.Println(f.Array)    		// cbdfc
fmt.Printf("%+v", f.Bar)    	// {Name:QFpZ Number:-2882647639396178786 Float:1.7636692e+37}
fmt.Println(f.Skip)     		// <nil>
fmt.Println(f.Created.String()) // 1908-12-07 04:14:25.685339029 +0000 UTC

// Supported formats
// int, int8, int16, int32, int64,
// uint, uint8, uint16, uint32, uint64,
// float32, float64,
// bool, string,
// array, pointers, map
// time.Time // If setting time you can also set a format tag
// Nested Struct Fields and Embedded Fields

Fakeable types

It is possible to extend a struct by implementing the Fakeable interface in order to control the generation.

For example, this is useful when it is not possible to modify the struct that you want to fake by adding struct tags to a field but you still need to be able to control the generation process.

// Custom string that you want to generate your own data for
type Friend string

func (c *Friend) Fake(f *gofakeit.Faker) (any, error) {
	// Can call any other faker methods
	return f.RandomString([]string{"billy", "fred", "susan"}), nil
}

// Custom time that you want to generate your own data for
type Age time.Time

func (c *Age) Fake(f *gofakeit.Faker) (any, error) {
	return Age(f.DateRange(time.Now().AddDate(-100, 0, 0), time.Now().AddDate(-18, 0, 0))), nil
}

// This is the struct that we cannot modify to add struct tags
type User struct {
	Name Friend
	Age *Age
}

var u User
gofakeit.Struct(&u)
fmt.Println(u.Name)            // billy
fmt.Println(time.Time(*u.Age)) // 1990-12-07 04:14:25.685339029 +0000 UTC

Custom Functions

In a lot of situations you may need to use your own random function usage for your specific needs.

If you would like to extend the usage of struct tags, generate function, available usages in the gofakeit server or gofakeit command sub packages. You can do so via the AddFuncLookup. Each function has their own lookup, if you need more reference examples you can look at each files lookups.

// Simple
gofakeit.AddFuncLookup("friendname", gofakeit.Info{
	Category:    "custom",
	Description: "Random friend name",
	Example:     "bill",
	Output:      "string",
	Generate: func(f *gofakeit.Faker, m *gofakeit.MapParams, info *gofakeit.Info) (any, error) {
		return f.RandomString([]string{"bill", "bob", "sally"}), nil
	},
})

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

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

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

var f Foo
gofakeit.Struct(&f)
fmt.Println(f.FriendName) // bill
fmt.Println(f.JumbleWord) // loredlowlh

Templates

Generate custom outputs using golang's template engine https://pkg.go.dev/text/template.

We have added all the available functions to the template engine as well as some additional ones that are useful for template building.

Additional Available Functions

- ToUpper(s string) string   			// Make string upper case
- ToLower(s string) string   			// Make string lower case
- ToString(s any)            			// Convert to string
- ToDate(s string) time.Time 			// Convert string to date
- SpliceAny(args ...any) []any 			// Build a slice of anys, used with Weighted
- SpliceString(args ...string) []string // Build a slice of strings, used with Teams and RandomString
- SpliceUInt(args ...uint) []uint 		// Build a slice of uint, used with Dice and RandomUint
- SpliceInt(args ...int) []int 			// Build a slice of int, used with RandomInt
Unavailable Gofakeit functions 
// Any functions that dont have a return value
- AnythingThatReturnsVoid(): void

// Not available to use in templates
- Template(co *TemplateOptions) ([]byte, error)
- RandomMapKey(mapI any) any
Example Usages
import "github.com/brianvoe/gofakeit/v7"

func main() {
	// Accessing the Lines variable from within the template.
	template := `
	Subject: {{RandomString (SliceString "Greetings" "Hello" "Hi")}}

	Dear {{LastName}},

	{{RandomString (SliceString "Greetings!" "Hello there!" "Hi, how are you?")}}

	{{Paragraph 1 5 10 "\n\n"}}

	{{RandomString (SliceString "Warm regards" "Best wishes" "Sincerely")}}
	{{$person:=Person}}
	{{$person.FirstName}} {{$person.LastName}}
	{{$person.Contact.Email}}
	{{$person.Contact.Phone}}
	`

	value, err := gofakeit.Template(template, &gofakeit.TemplateOptions{Data: 5})

	if err != nil {
		fmt.Println(err)
	}

	fmt.Println(value)
}

Output:

Subject: Hello

Dear Krajcik,

Greetings!

Quia voluptatem voluptatem voluptatem. Quia voluptatem voluptatem voluptatem. Quia voluptatem voluptatem voluptatem.

Warm regards

Kaitlyn Krajcik
kaitlynkrajcik@krajcik
570-245-7485

Functions

All functions also exist as methods on the Faker struct

File

Passing nil to CSV, JSON or XML will auto generate data using default values.

CSV(co *CSVOptions) ([]byte, error)
JSON(jo *JSONOptions) ([]byte, error)
XML(xo *XMLOptions) ([]byte, error)
FileExtension() string
FileMimeType() string
Template

Passing nil will auto generate data using default values.

Template(co *TemplateOptions) (string, error)
Markdown(co *MarkdownOptions) (string, error)
EmailText(co *EmailOptions) (string, error)
FixedWidth(co *FixedWidthOptions) (string, error)
ID
ID() string
UUID() string
Product
Product() *ProductInfo
ProductName() string
ProductDescription() string
ProductCategory() string
ProductFeature() string
ProductMaterial() string
ProductUPC() string
ProductAudience() string
ProductDimension() string
ProductUseCase() string
ProductBenefit() string
ProductSuffix() string
ProductISBN(opts *ISBNOptions) string
Person
Person() *PersonInfo
Name() string
NamePrefix() string
NameSuffix() string
FirstName() string
MiddleName() string
LastName() string
Gender() string
Age() int
Ethnicity() string
SSN() string
EIN() string
Hobby() string
Contact() *ContactInfo
Email() string
Phone() string
PhoneFormatted() string
Teams(peopleArray []string, teamsArray []string) map[string][]string
Generate
Struct(v any)
Slice(v any)
Map() map[string]any
Generate(value string) string
Regex(value string) string
Auth
Username() string
Password(lower bool, upper bool, numeric bool, special bool, space bool, num int) string
Address
Address() *AddressInfo
City() string
Country() string
CountryAbr() string
State() string
StateAbr() string
Street() string
StreetName() string
StreetNumber() string
StreetPrefix() string
StreetSuffix() string
Unit() string
Zip() string
Latitude() float64
LatitudeInRange(min, max float64) (float64, error)
Longitude() float64
LongitudeInRange(min, max float64) (float64, error)
Game
Gamertag() string
Dice(numDice uint, sides []uint) []uint
Beer
BeerAlcohol() string
BeerBlg() string
BeerHop() string
BeerIbu() string
BeerMalt() string
BeerName() string
BeerStyle() string
BeerYeast() string
Car
Car() *CarInfo
CarMaker() string
CarModel() string
CarType() string
CarFuelType() string
CarTransmissionType() string
Words
// Nouns
Noun() string
NounCommon() string
NounConcrete() string
NounAbstract() string
NounCollectivePeople() string
NounCollectiveAnimal() string
NounCollectiveThing() string
NounCountable() string
NounUncountable() string

// Verbs
Verb() string
VerbAction() string
VerbLinking() string
VerbHelping() string

// Adverbs
Adverb() string
AdverbManner() string
AdverbDegree() string
AdverbPlace() string
AdverbTimeDefinite() string
AdverbTimeIndefinite() string
AdverbFrequencyDefinite() string
AdverbFrequencyIndefinite() string

// Propositions
Preposition() string
PrepositionSimple() string
PrepositionDouble() string
PrepositionCompound() string

// Adjectives
Adjective() string
AdjectiveDescriptive() string
AdjectiveQuantitative() string
AdjectiveProper() string
AdjectiveDemonstrative() string
AdjectivePossessive() string
AdjectiveInterrogative() string
AdjectiveIndefinite() string

// Pronouns
Pronoun() string
PronounPersonal() string
PronounObject() string
PronounPossessive() string
PronounReflective() string
PronounDemonstrative() string
PronounInterrogative() string
PronounRelative() string

// Connectives
Connective() string
ConnectiveTime() string
ConnectiveComparative() string
ConnectiveComplaint() string
ConnectiveListing() string
ConnectiveCasual() string
ConnectiveExamplify() string

// Words
Word() string

// Text
Sentence() string
Paragraph() string
LoremIpsumWord() string
LoremIpsumSentence(wordCount int) string
LoremIpsumParagraph(paragraphCount int, sentenceCount int, wordCount int, separator string) string
Question() string
Quote() string
Phrase() string
Foods
Fruit() string
Vegetable() string
Breakfast() string
Lunch() string
Dinner() string
Snack() string
Dessert() string
Misc
Bool() bool
Weighted(options []any, weights []float32) (any, error)
FlipACoin() string
RandomMapKey(mapI any) any
ShuffleAnySlice(v any)
Colors
Color() string
HexColor() string
RGBColor() []int
SafeColor() string
NiceColors() string
Images
Image(width int, height int) *img.RGBA
ImageJpeg(width int, height int) []byte
ImagePng(width int, height int) []byte
Internet
URL() string
UrlSlug(words int) string
DomainName() string
DomainSuffix() string
IPv4Address() string
IPv6Address() string
MacAddress() string
HTTPStatusCode() string
HTTPStatusCodeSimple() int
LogLevel(logType string) string
HTTPMethod() string
HTTPVersion() string
UserAgent() string
ChromeUserAgent() string
FirefoxUserAgent() string
OperaUserAgent() string
SafariUserAgent() string
APIUserAgent() string
HTML
InputName() string
Svg(options *SVGOptions) string
Date/Time
Date() time.Time
PastDate() time.Time
FutureDate() time.Time
DateRange(start, end time.Time) time.Time
NanoSecond() int
Second() int
Minute() int
Hour() int
Month() int
MonthString() string
Day() int
WeekDay() string
Year() int
TimeZone() string
TimeZoneAbv() string
TimeZoneFull() string
TimeZoneOffset() float32
TimeZoneRegion() string
Payment
Price(min, max float64) float64
CreditCard() *CreditCardInfo
CreditCardCvv() string
CreditCardExp() string
CreditCardNumber(*CreditCardOptions) string
CreditCardType() string
Currency() *CurrencyInfo
CurrencyLong() string
CurrencyShort() string
AchRouting() string
AchAccount() string
BitcoinAddress() string
BitcoinPrivateKey() string
BankName() string
BankType() string
Finance
Cusip() string
Isin() string
Company
BS() string
Blurb() string
BuzzWord() string
Company() string
CompanySuffix() string
Job() *JobInfo
JobDescriptor() string
JobLevel() string
JobTitle() string
Slogan() string
Hacker
HackerAbbreviation() string
HackerAdjective() string
Hackeringverb() string
HackerNoun() string
HackerPhrase() string
HackerVerb() string
Hipster
HipsterWord() string
HipsterSentence() string
HipsterParagraph() string
App
AppName() string
AppVersion() string
AppAuthor() string
Animal
PetName() string
Animal() string
AnimalType() string
FarmAnimal() string
Cat() string
Dog() string
Bird() string
Emoji
Emoji() string
EmojiCategory() string
EmojiAlias() string
EmojiTag() string
EmojiFlag() string
EmojiAnimal() string
EmojiFood() string
EmojiPlant() string
EmojiMusic() string
EmojiVehicle() string
EmojiSport() string
EmojiFace() string
EmojiHand() string
EmojiClothing() string
EmojiLandmark() string
EmojiElectronics() string
EmojiGame() string
EmojiTools() string
EmojiWeather() string
EmojiJob() string
EmojiPerson() string
EmojiGesture() string
EmojiCostume() string
EmojiSentence() string
Language
Language() string
LanguageAbbreviation() string
ProgrammingLanguage() string
Number
Number(min int, max int) int
Int() int
IntN(n int) int
Int8() int8
Int16() int16
Int32() int32
Int64() int64
Uint() uint
UintN(n uint) uint
Uint8() uint8
Uint16() uint16
Uint32() uint32
Uint64() uint64
Float32() float32
Float32Range(min, max float32) float32
Float64() float64
Float64Range(min, max float64) float64
ShuffleInts(a []int)
RandomInt(i []int) int
HexUint(bitsize int) string
String
Digit() string
DigitN(n uint) string
Letter() string
LetterN(n uint) string
Lexify(str string) string
Numerify(str string) string
ShuffleStrings(a []string)
RandomString(a []string) string
Celebrity
CelebrityActor() string
CelebrityBusiness() string
CelebritySport() string
Minecraft
MinecraftOre() string
MinecraftWood() string
MinecraftArmorTier() string
MinecraftArmorPart() string
MinecraftWeapon() string
MinecraftTool() string
MinecraftDye() string
MinecraftFood() string
MinecraftAnimal() string
MinecraftVillagerJob() string
MinecraftVillagerStation() string
MinecraftVillagerLevel() string
MinecraftMobPassive() string
MinecraftMobNeutral() string
MinecraftMobHostile() string
MinecraftMobBoss() string
MinecraftBiome() string
MinecraftWeather() string
Book
Book() *BookInfo
BookTitle() string
BookAuthor() string
BookGenre() string
Movie
Movie() *MovieInfo
MovieName() string
MovieGenre() string
Error
Error() error
ErrorDatabase() error
ErrorGRPC() error
ErrorHTTP() error
ErrorHTTPClient() error
ErrorHTTPServer() error
ErrorRuntime() error
School
School() string
Song
Song() *SongInfo
SongName() string
SongArtist() string
SongGenre() string

Documentation

Overview

Package gofakeit provides a set of functions that generate random data

Example 
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: Priscilla Thornton
Email: brookeduncan@maxwell.biz
Phone: 7598907999
Address: 4737 Port Hillstown, Santa Ana, Alabama 41026
BS: interactive
Beer Name: Hercules Double IPA
Color: Chartreuse
Company: Municode
Credit Card: 6449062052570938760
Hacker Phrase: I'll override the back-end USB system, that should encrypt the SCSI port!
Job Title: Journalist
Password: 4i86u.-1.NM4DtZ5M@!@-.Cz4vY*wTqs
Example (Custom) 
Seed(11)

AddFuncLookup("friendname", Info{
	Category:    "custom",
	Description: "Random friend name",
	Example:     "bill",
	Output:      "string",
	Generate: func(f *Faker, m *MapParams, info *Info) (any, 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:

sally
Example (Custom_with_params) 
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(f *Faker, m *MapParams, info *Info) (any, error) {
		word, err := info.GetString(m, "word")
		if err != nil {
			return nil, err
		}

		split := strings.Split(word, "")
		f.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:

hldoolewrl

Index

Examples

Constants

This section is empty.

Variables

View Source 
var FuncLookups map[string]Info

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

View Source 
var RecursiveDepth = 10

RecursiveDepth controls the maximum recursion depth when populating structs. Increase if your data structures are deeply nested; decrease to be more conservative.

Functions

func APIUserAgent added in v7.11.0 

func APIUserAgent() string

APIUserAgent will generate a random API user agent string

Example 
Seed(11)
fmt.Println(APIUserAgent())

Output:

httpie-go/8.1.2

func AchAccount 

func AchAccount() string

AchAccount will generate a 12 digit account number

Example 
Seed(11)
fmt.Println(AchAccount())

Output:

881252759890

func AchRouting 

func AchRouting() string

AchRouting will generate a 9 digit routing number

Example 
Seed(11)
fmt.Println(AchRouting())

Output:

881252759

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 
Seed(11)
fmt.Println(Adjective())

Output:

none

func AdjectiveDemonstrative 

func AdjectiveDemonstrative() string

AdjectiveDemonstrative will generate a random demonstrative adjective

Example 
Seed(11)
fmt.Println(AdjectiveDemonstrative())

Output:

it

func AdjectiveDescriptive 

func AdjectiveDescriptive() string

AdjectiveDescriptive will generate a random descriptive adjective

Example 
Seed(11)
fmt.Println(AdjectiveDescriptive())

Output:

tired

func AdjectiveIndefinite 

func AdjectiveIndefinite() string

AdjectiveIndefinite will generate a random indefinite adjective

Example 
Seed(11)
fmt.Println(AdjectiveIndefinite())

Output:

several

func AdjectiveInterrogative 

func AdjectiveInterrogative() string

AdjectiveInterrogative will generate a random interrogative adjective

Example 
Seed(11)
fmt.Println(AdjectiveInterrogative())

Output:

which

func AdjectivePossessive 

func AdjectivePossessive() string

AdjectivePossessive will generate a random possessive adjective

Example 
Seed(11)
fmt.Println(AdjectivePossessive())

Output:

their

func AdjectiveProper 

func AdjectiveProper() string

AdjectiveProper will generate a random proper adjective

Example 
Seed(11)
fmt.Println(AdjectiveProper())

Output:

Swiss

func AdjectiveQuantitative 

func AdjectiveQuantitative() string

AdjectiveQuantitative will generate a random quantitative adjective

Example 
Seed(11)
fmt.Println(AdjectiveQuantitative())

Output:

sparse

func Adverb 

func Adverb() string

Adverb will generate a random adverb

Example 
Seed(11)
fmt.Println(Adverb())

Output:

ever

func AdverbDegree 

func AdverbDegree() string

AdverbDegree will generate a random degree adverb

Example 
Seed(11)
fmt.Println(AdverbDegree())

Output:

too

func AdverbFrequencyDefinite 

func AdverbFrequencyDefinite() string

AdverbFrequencyDefinite will generate a random frequency definite adverb

Example 
Seed(11)
fmt.Println(AdverbFrequencyDefinite())

Output:

yearly

func AdverbFrequencyIndefinite 

func AdverbFrequencyIndefinite() string

AdverbFrequencyIndefinite will generate a random frequency indefinite adverb

Example 
Seed(11)
fmt.Println(AdverbFrequencyIndefinite())

Output:

generally

func AdverbManner 

func AdverbManner() string

AdverbManner will generate a random manner adverb

Example 
Seed(11)
fmt.Println(AdverbManner())

Output:

tensely

func AdverbPlace 

func AdverbPlace() string

AdverbPlace will generate a random place adverb

Example 
Seed(11)
fmt.Println(AdverbPlace())

Output:

under

func AdverbTimeDefinite 

func AdverbTimeDefinite() string

AdverbTimeDefinite will generate a random time definite adverb

Example 
Seed(11)
fmt.Println(AdverbTimeDefinite())

Output:

yesterday

func AdverbTimeIndefinite 

func AdverbTimeIndefinite() string

AdverbTimeIndefinite will generate a random time indefinite adverb

Example 
Seed(11)
fmt.Println(AdverbTimeIndefinite())

Output:

soon

func Age added in v7.10.0 

func Age() int

Age will generate a random age between 0 and 100

Example 
Seed(11)
fmt.Println(Age())

Output:

90

func AirlineAircraftType added in v7.8.0 

func AirlineAircraftType() string

AirlineAircraftType will generate a random aircraft type

Example 
Seed(11)
fmt.Println(AirlineAircraftType())

Output:

regional

func AirlineAirplane added in v7.8.0 

func AirlineAirplane() string

AirlineAirplane will generate a random airplane model

Example 
Seed(11)
fmt.Println(AirlineAirplane())

Output:

De Havilland Dash 8

func AirlineAirport added in v7.8.0 

func AirlineAirport() string

AirlineAirport will generate a random airport name

Example 
Seed(11)
fmt.Println(AirlineAirport())

Output:

Cairo International Airport

func AirlineAirportIATA added in v7.8.0 

func AirlineAirportIATA() string

AirlineAirportIATA will generate a random airport IATA code

Example 
Seed(11)
fmt.Println(AirlineAirportIATA())

Output:

CAI

func AirlineFlightNumber added in v7.8.0 

func AirlineFlightNumber() string

AirlineFlightNumber will generate a random flight number

Example 
Seed(11)
fmt.Println(AirlineFlightNumber())

Output:

US1996

func AirlineRecordLocator added in v7.8.0 

func AirlineRecordLocator() string

AirlineRecordLocator will generate a random record locator (booking reference)

Example 
Seed(11)
fmt.Println(AirlineRecordLocator())

Output:

USKKBM

func AirlineSeat added in v7.8.0 

func AirlineSeat() string

AirlineSeat will generate a random seat assignment

Example 
Seed(11)
fmt.Println(AirlineSeat())

Output:

54J

func Animal 

func Animal() string

Animal will return a random animal

Example 
Seed(11)
fmt.Println(Animal())

Output:

turtle

func AnimalType 

func AnimalType() string

AnimalType will return a random animal type

Example 
Seed(11)
fmt.Println(AnimalType())

Output:

reptiles

func AppAuthor 

func AppAuthor() string

AppAuthor will generate a random company or person name

Example 
Seed(11)
fmt.Println(AppAuthor())

Output:

StreetEasy

func AppName 

func AppName() string

AppName will generate a random app name

Example 
Seed(11)
fmt.Println(AppName())

Output:

Swanthink

func AppVersion 

func AppVersion() string

AppVersion will generate a random app version

Example 
Seed(11)
fmt.Println(AppVersion())

Output:

5.18.4

func BS 

func BS() string

BS will generate a random company bs string

Example 
Seed(11)
fmt.Println(BS())

Output:

models

func BankName added in v7.3.0 

func BankName() string
Example 
Seed(11)
fmt.Println(BankName())

Output:

Toronto Dominion Bank

func BankType added in v7.3.0 

func BankType() string
Example 
Seed(11)
fmt.Println(BankType())

Output:

Savings Bank

func BeerAlcohol 

func BeerAlcohol() string

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

Example 
Seed(11)
fmt.Println(BeerAlcohol())

Output:

8.2%

func BeerBlg 

func BeerBlg() string

BeerBlg will return a random beer blg between 5.0 and 20.0

Example 
Seed(11)
fmt.Println(BeerBlg())

Output:

16.6°Blg

func BeerHop 

func BeerHop() string

BeerHop will return a random beer hop

Example 
Seed(11)
fmt.Println(BeerHop())

Output:

TriplePearl

func BeerIbu 

func BeerIbu() string

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

Example 
Seed(11)
fmt.Println(BeerIbu())

Output:

91 IBU

func BeerMalt 

func BeerMalt() string

BeerMalt will return a random beer malt

Example 
Seed(11)
fmt.Println(BeerMalt())

Output:

Munich

func BeerName 

func BeerName() string

BeerName will return a random beer name

Example 
Seed(11)
fmt.Println(BeerName())

Output:

Sierra Nevada Bigfoot Barleywine Style Ale

func BeerStyle 

func BeerStyle() string

BeerStyle will return a random beer style

Example 
Seed(11)
fmt.Println(BeerStyle())

Output:

Vegetable Beer

func BeerYeast 

func BeerYeast() string

BeerYeast will return a random beer yeast

Example 
Seed(11)
fmt.Println(BeerYeast())

Output:

2308 - Munich Lager

func Bio added in v7.8.0 

func Bio() string

Bio will generate a random biography using mad libs style templates

Example 
Seed(11)
fmt.Println(Bio())
fmt.Println(Bio())
fmt.Println(Bio())

Output:

Brews Fruit Beer while streaming Country, day job in Memphis as Musician
Singer with a soft spot for Diesel builds and hands-on Weaving in Laredo
Known for a hoodie look and a shelf of PaleGreen weasel art

func Bird 

func Bird() string

Bird will return a random bird species

Example 
Seed(11)
fmt.Println(Bird())

Output:

toucan

func BitcoinAddress 

func BitcoinAddress() string

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

Example 
Seed(11)
fmt.Println(BitcoinAddress())

Output:

1Lcy9SN3ffStpUpP0VlGp4oD9G7t083012

func BitcoinPrivateKey 

func BitcoinPrivateKey() string

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

Example 
Seed(11)
fmt.Println(BitcoinPrivateKey())

Output:

5JMZxkQX2PgaasaHc8wnWLNdMu7rxeU7xS64ev7RWNinacicPfm

func Blurb 

func Blurb() string

Blurb will generate a random company blurb string

Example 
Seed(11)
fmt.Println(Blurb())

Output:

Teamwork

func BookAuthor 

func BookAuthor() string
Example 
Seed(11)
fmt.Println(BookAuthor())

Output:

Vladimir Nabokov

func BookGenre 

func BookGenre() string
Example 
Seed(11)
fmt.Println(BookGenre())

Output:

Thriller

func BookTitle 

func BookTitle() string
Example 
Seed(11)
fmt.Println(BookTitle())

Output:

Things Fall Apart

func Bool 

func Bool() bool

Bool will generate a random boolean value

Example 
Seed(11)
fmt.Println(Bool())

Output:

false

func Breakfast 

func Breakfast() string

Breakfast will return a random breakfast name

Example 
Seed(11)
fmt.Println(Breakfast())

Output:

Purple cow

func BuzzWord 

func BuzzWord() string

BuzzWord will generate a random company buzz word string

Example 
Seed(11)
fmt.Println(BuzzWord())

Output:

open system

func CSV 

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

CSV generates an object or an array of objects in json format A nil CSVOptions returns a randomly structured CSV.

Example (Array) 
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,Priscilla,Thornton,3lGftNp9S908
2,Shaun,Byrd,Lc3G00tpPp7U
3,Grady,Craig,LGAvzZ5xUB6Z

func CarFuelType 

func CarFuelType() string

CarFuelType will return a random fuel type

Example 
Seed(11)
fmt.Println(CarFuelType())

Output:

Electric

func CarMaker 

func CarMaker() string

CarMaker will return a random car maker

Example 
Seed(11)
fmt.Println(CarMaker())

Output:

Spyker

func CarModel 

func CarModel() string

CarModel will return a random car model

Example 
Seed(11)
fmt.Println(CarModel())

Output:

Prius

func CarTransmissionType 

func CarTransmissionType() string

CarTransmissionType will return a random transmission type

Example 
Seed(11)
fmt.Println(CarTransmissionType())

Output:

Manual

func CarType 

func CarType() string

CarType will generate a random car type string

Example 
Seed(11)
fmt.Println(CarType())

Output:

Passenger car heavy

func Cat 

func Cat() string

Cat will return a random cat breed

Example 
Seed(11)
fmt.Println(Cat())

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 
Seed(11)
fmt.Println(CelebrityActor())

Output:

Shah Rukh Khan

func CelebrityBusiness 

func CelebrityBusiness() string

CelebrityBusiness will generate a random celebrity business person

Example 
Seed(11)
fmt.Println(CelebrityBusiness())

Output:

Prescott Bush

func CelebritySport 

func CelebritySport() string

CelebritySport will generate a random celebrity sport person

Example 
Seed(11)
fmt.Println(CelebritySport())

Output:

Grete Waitz

func ChromeUserAgent 

func ChromeUserAgent() string

ChromeUserAgent will generate a random chrome browser user agent string

Example 
Seed(11)
fmt.Println(ChromeUserAgent())

Output:

Mozilla/5.0 (Windows CE) AppleWebKit/5362 (KHTML, like Gecko) Chrome/36.0.820.0 Mobile Safari/5362

func City 

func City() string

City will generate a random city string

Example 
Seed(11)
fmt.Println(City())

Output:

Reno

func Color 

func Color() string

Color will generate a random color string

Example 
Seed(11)
fmt.Println(Color())

Output:

SlateGray

func Comment 

func Comment() string

Comment will generate a random statement or remark expressing an opinion, observation, or reaction

Example 
Seed(11)
fmt.Println(Comment())

Output:

After seeing this fear, maybe drink the trip and adjust the here class

func Company 

func Company() string

Company will generate a random company name string

Example 
Seed(11)
fmt.Println(Company())

Output:

TransparaGov

func CompanySuffix 

func CompanySuffix() string

CompanySuffix will generate a random company suffix string

Example 
Seed(11)
fmt.Println(CompanySuffix())

Output:

Inc

func Connective 

func Connective() string

Connective will generate a random connective

Example 
Seed(11)
fmt.Println(Connective())

Output:

through

func ConnectiveCasual 

func ConnectiveCasual() string

ConnectiveCasual will generate a random casual connective

Example 
Seed(11)
fmt.Println(ConnectiveCasual())

Output:

though

func ConnectiveComparative 

func ConnectiveComparative() string

ConnectiveComparative will generate a random comparative connective

Example 
Seed(11)
fmt.Println(ConnectiveComparative())

Output:

after all

func ConnectiveComplaint 

func ConnectiveComplaint() string

ConnectiveComplaint will generate a random complaint connective

Example 
Seed(11)
fmt.Println(ConnectiveComplaint())

Output:

i.e.

func ConnectiveExamplify 

func ConnectiveExamplify() string

ConnectiveExamplify will generate a random examplify connective

Example 
Seed(11)
fmt.Println(ConnectiveExamplify())

Output:

unless

func ConnectiveListing 

func ConnectiveListing() string

ConnectiveListing will generate a random listing connective

Example 
Seed(11)
fmt.Println(ConnectiveListing())

Output:

in summation

func ConnectiveTime 

func ConnectiveTime() string

ConnectiveTime will generate a random connective time

Example 
Seed(11)
fmt.Println(ConnectiveTime())

Output:

when

func Country 

func Country() string

Country will generate a random country string

Example 
Seed(11)
fmt.Println(Country())

Output:

Tonga

func CountryAbr 

func CountryAbr() string

CountryAbr will generate a random abbreviated country string

Example 
Seed(11)
fmt.Println(CountryAbr())

Output:

TO

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 
Seed(11)
fmt.Println(CreditCardCvv())

Output:

881

func CreditCardExp 

func CreditCardExp() string

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

Example 
Seed(11)
fmt.Println(CreditCardExp())

Output:

11/34

func CreditCardNumber 

func CreditCardNumber(cco *CreditCardOptions) string

CreditCardNumber will generate a random luhn credit card number

Example 
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:

6376121252759896
6449344737930519
4111026894059156
6706 2052 5709 6

func CreditCardType 

func CreditCardType() string

CreditCardType will generate a random credit card type string

Example 
Seed(11)
fmt.Println(CreditCardType())

Output:

Hiper

func CurrencyLong 

func CurrencyLong() string

CurrencyLong will generate a random long currency name

Example 
Seed(11)
fmt.Println(CurrencyLong())

Output:

Uganda Shilling

func CurrencyShort 

func CurrencyShort() string

CurrencyShort will generate a random short currency value

Example 
Seed(11)
fmt.Println(CurrencyShort())

Output:

UGX

func Cusip 

func Cusip() string

CUSIP

Example

CUSIP Tests 

Seed(11)
fmt.Println(Cusip())

Output:

64HHTI0T8

func Date 

func Date() time.Time

Date will generate a random time.Time struct

Example 
Seed(11)
fmt.Println(Date())

Output:

2012-11-07 04:31:13.726582492 +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 
Seed(11)
fmt.Println(DateRange(time.Unix(0, 484633944473634951), time.Unix(0, 1431318744473668209))) // May 10, 1985 years to May 10, 2015

Output:

2012-03-26 09:20:49.250961474 +0000 UTC

func Day 

func Day() int

Day will generate a random day between 1 - 31

Example 
Seed(11)
fmt.Println(Day())

Output:

28

func Dessert 

func Dessert() string

Dessert will return a random dessert name

Example 
Seed(11)
fmt.Println(Dessert())

Output:

Amish cream pie

func Dice 

func Dice(numDice uint, sides []uint) []uint

Dice will generate a random set of dice

Example 
Seed(11)
fmt.Println(Dice(1, []uint{6}))

Output:

[6]

func Digit 

func Digit() string

Digit will generate a single ASCII digit

Example 
Seed(11)
fmt.Println(Digit())

Output:

8

func DigitN 

func DigitN(n uint) string

DigitN will generate a random string of length N consists of ASCII digits. Note that the string generated can start with 0 and this function returns a string with a length of 1 when 0 is passed.

Example 
Seed(11)
fmt.Println(DigitN(10))

Output:

8812527598

func Dinner 

func Dinner() string

Dinner will return a random dinner name

Example 
Seed(11)
fmt.Println(Dinner())

Output:

German apple cake with cream cheese frosting

func Dog 

func Dog() string

Dog will return a random dog breed

Example 
Seed(11)
fmt.Println(Dog())

Output:

Rat Terrier

func DomainName 

func DomainName() string

DomainName will generate a random url domain name

Example 
Seed(11)
fmt.Println(DomainName())

Output:

strategicinfrastructures.biz

func DomainSuffix 

func DomainSuffix() string

DomainSuffix will generate a random domain suffix

Example 
Seed(11)
fmt.Println(DomainSuffix())

Output:

io

func Drink 

func Drink() string

Drink will return a random drink name

Example 
Seed(11)
fmt.Println(Drink())

Output:

Wine

func EIN added in v7.7.0 

func EIN() string

EIN will generate a random Employer Identification Number

Example 
Seed(11)
fmt.Println(EIN())

Output:

90-8125275

func Email 

func Email() string

Email will generate a random email string

Example 
Seed(11)
fmt.Println(Email())

Output:

priscillathornton@duncan.biz

func EmailText 

func EmailText(co *EmailOptions) (string, error)

EmailText will return a single random text email template document

Example 
Seed(11)

value, err := EmailText(&EmailOptions{})
if err != nil {
	fmt.Println(err)
}

fmt.Println(string(value))

Output:

Subject: Hi from Nannie!

Dear Duncan,

Greetings! I hope your day is going well.

I trust this email finds you well. Sending good vibes your way.

Warm starts beat cold company. Launch the person midweek for clarity. Automate problem recovery victoriously. Launch the life midweek for clarity.

Sometimes the point last never. Retire outdated life each quarter. Choose lovely defaults. Deliberately wake the part. Clear time were better than clever week.

Warm starts beat cold child. Systematically improve the woman yearly. Protect the place under grumpy load.

I'm curious to know what you think about it. If you have a moment, please feel free to check out the project on GitLab

Feel free to share your opinions with me. Looking forward to your feedback!

I appreciate your attention to this matter. Wishing you a wonderful day!

Warm regards
Jamal Elliott
janierussell@bailey.io
1-875-720-1747

func Emoji 

func Emoji() string

Emoji will return a random fun emoji

Example 
Seed(11)
fmt.Println(Emoji())

Output:

🛫

func EmojiAlias 

func EmojiAlias() string

EmojiAlias will return a random fun emoji alias

Example 
Seed(11)
fmt.Println(EmojiAlias())

Output:

key

func EmojiAnimal added in v7.8.0 

func EmojiAnimal() string

EmojiAnimal will return a random animal emoji

Example 
Seed(11)
fmt.Println(EmojiAnimal())

Output:

🐌

func EmojiCategory 

func EmojiCategory() string

EmojiCategory will return a random fun emoji category

Example 
Seed(11)
fmt.Println(EmojiCategory())

Output:

Flags

func EmojiClothing added in v7.8.0 

func EmojiClothing() string

EmojiClothing will return a random clothing or accessory emoji

func EmojiCostume added in v7.8.0 

func EmojiCostume() string

EmojiCostume will return a random costume/fantasy emoji

func EmojiElectronics added in v7.8.0 

func EmojiElectronics() string

EmojiElectronics will return a random electronics/media device emoji

func EmojiFace added in v7.8.0 

func EmojiFace() string

EmojiFace will return a random face emoji

func EmojiFlag added in v7.8.0 

func EmojiFlag() string

EmojiFlag will return a random country flag emoji

Example 
Seed(11)
fmt.Println(EmojiFlag())

Output:

🇹🇴

func EmojiFood added in v7.8.0 

func EmojiFood() string

EmojiFood will return a random food emoji

Example 
Seed(11)
fmt.Println(EmojiFood())

Output:

🍾

func EmojiGame added in v7.8.0 

func EmojiGame() string

EmojiGame will return a random game/leisure emoji

func EmojiGesture added in v7.8.0 

func EmojiGesture() string

EmojiGesture will return a random gesture emoji

func EmojiHand added in v7.8.0 

func EmojiHand() string

EmojiHand will return a random hand emoji

func EmojiJob added in v7.8.0 

func EmojiJob() string

EmojiJob will return a random job/occupation emoji

func EmojiLandmark added in v7.8.0 

func EmojiLandmark() string

EmojiLandmark will return a random landmark or place emoji

func EmojiMusic added in v7.8.0 

func EmojiMusic() string

EmojiMusic will return a random music-related emoji

Example 
Seed(11)
fmt.Println(EmojiMusic())

Output:

🎚️

func EmojiPerson added in v7.8.0 

func EmojiPerson() string

EmojiPerson will return a random person variant emoji

func EmojiPlant added in v7.8.0 

func EmojiPlant() string

EmojiPlant will return a random plant emoji

Example 
Seed(11)
fmt.Println(EmojiPlant())

Output:

🍁

func EmojiSentence added in v7.8.0 

func EmojiSentence() string

EmojiSentence will return a random sentence with emojis interspersed

Example 
Seed(11)
fmt.Println(EmojiSentence())

Output:

Category: Symbols 📠.

func EmojiSport added in v7.8.0 

func EmojiSport() string

EmojiSport will return a random sports emoji

func EmojiTag 

func EmojiTag() string

EmojiTag will return a random fun emoji tag

Example 
Seed(11)
fmt.Println(EmojiTag())

Output:

password

func EmojiTools added in v7.8.0 

func EmojiTools() string

EmojiTools will return a random tools/weapons emoji

func EmojiVehicle added in v7.8.0 

func EmojiVehicle() string

EmojiVehicle will return a random vehicle/transport emoji

func EmojiWeather added in v7.8.0 

func EmojiWeather() string

EmojiWeather will return a random weather/celestial emoji

func Error 

func Error() error

Error will return a random generic error

Example 
Seed(11)
fmt.Println(Error())

Output:

variable assigned before declaration

func ErrorDatabase 

func ErrorDatabase() error

ErrorDatabase will return a random database error

Example 
Seed(11)
fmt.Println(ErrorDatabase())

Output:

destination pointer is nil

func ErrorGRPC 

func ErrorGRPC() error

ErrorGRPC will return a random gRPC error

Example 
Seed(11)
fmt.Println(ErrorGRPC())

Output:

connection refused

func ErrorHTTP 

func ErrorHTTP() error

ErrorHTTP will return a random HTTP error

Example 
Seed(11)
fmt.Println(ErrorHTTP())

Output:

wrote more than the declared Content-Length

func ErrorHTTPClient 

func ErrorHTTPClient() error

ErrorHTTPClient will return a random HTTP client error response (400-418)

Example 
Seed(11)
fmt.Println(ErrorHTTPClient())

Output:

expectation failed

func ErrorHTTPServer 

func ErrorHTTPServer() error

ErrorHTTPServer will return a random HTTP server error response (500-511)

Example 
Seed(11)
fmt.Println(ErrorHTTPServer())

Output:

not extended

func ErrorObject 

func ErrorObject() error

ErrorObject will return a random error object word

Example 
Seed(11)
fmt.Println(ErrorObject())

Output:

url

func ErrorRuntime 

func ErrorRuntime() error

ErrorRuntime will return a random runtime error

Example 
Seed(11)
fmt.Println(ErrorRuntime())

Output:

expected 2 arguments, got 3

func ErrorValidation 

func ErrorValidation() error

ErrorValidation will return a random validation error

Example 
Seed(11)
fmt.Println(ErrorValidation())

Output:

payment details cannot be verified

func Ethnicity added in v7.12.1 

func Ethnicity() string

Ethnicity will generate a random ethnicity string

Example 
Seed(11)
fmt.Println(Ethnicity())

Output:

Swiss

func FarmAnimal 

func FarmAnimal() string

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

Example 
Seed(11)
fmt.Println(FarmAnimal())

Output:

Sheep

func FileExtension 

func FileExtension() string

FileExtension will generate a random file extension

Example 
Seed(11)
fmt.Println(FileExtension())

Output:

dtd

func FileMimeType 

func FileMimeType() string

FileMimeType will generate a random mime file type

Example 
Seed(11)
fmt.Println(FileMimeType())

Output:

application/x-wri

func FirefoxUserAgent 

func FirefoxUserAgent() string

FirefoxUserAgent will generate a random firefox broswer user agent string

Example 
Seed(11)
fmt.Println(FirefoxUserAgent())

Output:

Mozilla/5.0 (Windows CE; en-US; rv:1.9.3.20) Gecko/2012-11-07 Firefox/36.0

func FirstName 

func FirstName() string

FirstName will generate a random first name

Example 
Seed(11)
fmt.Println(FirstName())

Output:

Priscilla

func FixedWidth 

func FixedWidth(co *FixedWidthOptions) (string, error)

FixedWidth generates an table of random data in fixed width format A nil FixedWidthOptions returns a randomly structured FixedWidth.

Example 
Seed(11)

value, err := FixedWidth(&FixedWidthOptions{
	RowCount: 3,
	Fields: []Field{
		{Name: "Name", Function: "{firstname} {lastname}"},
		{Name: "Email", Function: "email"},
		{Name: "Password", Function: "password", Params: MapParams{"special": {"false"}}},
		{Name: "Age", Function: "{number:1,100}"},
	},
})
if err != nil {
	fmt.Println(err)
}

fmt.Println(string(value))

Output:

Name                   Email                          Password         Age
Priscilla Thornton     laurelmcclure@wiley.org        L43ypoSV1tDf     62
Brooke Duncan          ramonblack@rutherford.io       rSM78E2ncUt3     9
Gregg Ford             roxannewalsh@hamilton.name     DUB69zQ1WZx8     77
Example (Default) 
Seed(11)

value, err := FixedWidth(nil)
if err != nil {
	fmt.Println(err)
}

fmt.Println(string(value))

Output:

Name                  Email                        Password
Nannie Duncan         lancegraves@sandoval.io      1T2elqD45w8N
Brooklyn Maxwell      danykaadams@morgan.com       V444uNv59i04
Carmen Romero         robinjenkins@cormier.com     eiZz6ipistlz
Hailie Wiley          buddypearson@summers.io      623DddowdELF
Marion Wallace        emmettblack@mcdermott.io     3Ydc69Z00Mcj
Amalia Rutherford     aprilmuller@joseph.net       31mk7arUdpNi
Roxane Webb           jaywashington@barton.net     t9fPK4m8497T
Randy Hamilton        caseybartell@myers.biz       x4KU3IhQ6im7
Elliott Jacobson      janierussell@bailey.io       5aHeXXT8vjF5
Example (NoHeader) 
Seed(11)

value, err := FixedWidth(&FixedWidthOptions{
	RowCount: 3,
	Fields: []Field{
		{Name: "", Function: "{firstname} {lastname}"},
		{Name: "", Function: "email"},
		{Name: "", Function: "password", Params: MapParams{"special": {"false"}}},
		{Name: "", Function: "{number:1,100}"},
	},
})
if err != nil {
	fmt.Println(err)
}

fmt.Println(value)

Output:

Priscilla Thornton     laurelmcclure@wiley.org        L43ypoSV1tDf     62
Brooke Duncan          ramonblack@rutherford.io       rSM78E2ncUt3     9
Gregg Ford             roxannewalsh@hamilton.name     DUB69zQ1WZx8     77

func FlipACoin 

func FlipACoin() string

FlipACoin will return a random value of Heads or Tails

Example 
Seed(11)
fmt.Println(FlipACoin())

Output:

Tails

func Float32 

func Float32() float32

Float32 will generate a random float32 value

Example 
Seed(11)
fmt.Println(Float32())

Output:

0.3462876

func Float32Range 

func Float32Range(min, max float32) float32

Float32Range will generate a random float32 value between min and max

Example 
Seed(11)
fmt.Println(Float32Range(0, 9999999))

Output:

3.4628758e+06

func Float64 

func Float64() float64

Float64 will generate a random float64 value

Example 
Seed(11)
fmt.Println(Float64())

Output:

0.7703009321621068

func Float64Range 

func Float64Range(min, max float64) float64

Float64Range will generate a random float64 value between min and max

Example 
Seed(11)
fmt.Println(Float64Range(0, 9999999))

Output:

7.703008551320136e+06

func Fruit 

func Fruit() string

Fruit will return a random fruit name

Example 
Seed(11)
fmt.Println(Fruit())

Output:

Redcurrant

func FutureDate 

func FutureDate() time.Time

FutureDate will generate a random future time.Time struct

Example 
Seed(11)
fmt.Println(FutureDate())

func Gamertag 

func Gamertag() string

Gamertag will generate a random video game username

Example 
Seed(11)
fmt.Println(Gamertag())

Output:

TurkeyThinker

func Gender 

func Gender() string

Gender will generate a random gender string

Example 
Seed(11)
fmt.Println(Gender())

Output:

female

func Generate 

func Generate(dataVal string) (string, error)

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 
Seed(11)

genStr, _ := Generate("{firstname} {lastname} {email} #?#?#?")
fmt.Println(genStr)
genStr, _ = Generate("{sentence}")
fmt.Println(genStr)
genStr, _ = Generate("{shuffleints:[1,2,3]}")
fmt.Println(genStr)
genStr, _ = Generate("{randomint:[1,2,3,-4]}")
fmt.Println(genStr)
genStr, _ = Generate("{randomuint:[1,2,3,4]}")
fmt.Println(genStr)
genStr, _ = Generate("{number:1,50}")
fmt.Println(genStr)
genStr, _ = Generate("{shufflestrings:[key:value,int:string,1:2,a:b]}")
fmt.Println(genStr)

Output:

Laurel McClure sethsoto@wallace.com 8K8b1M
Automate problem recovery victoriously.
[2 3 1]
2
4
16
[int:string key:value a:b 1:2]

func HTTPMethod 

func HTTPMethod() string

HTTPMethod will generate a random http method

Example 
Seed(11)
fmt.Println(HTTPMethod())

Output:

DELETE

func HTTPStatusCode 

func HTTPStatusCode() int

HTTPStatusCode will generate a random status code

Example 
Seed(11)
fmt.Println(HTTPStatusCode())

Output:

502

func HTTPStatusCodeSimple 

func HTTPStatusCodeSimple() int

HTTPStatusCodeSimple will generate a random simple status code

Example 
Seed(11)
fmt.Println(HTTPStatusCodeSimple())

Output:

500

func HTTPVersion 

func HTTPVersion() string

HTTPVersion will generate a random http version

Example 
Seed(11)
fmt.Println(HTTPVersion())

Output:

HTTP/2.0

func HackerAbbreviation 

func HackerAbbreviation() string

HackerAbbreviation will return a random hacker abbreviation

Example 
Seed(11)
fmt.Println(HackerAbbreviation())

Output:

SCSI

func HackerAdjective 

func HackerAdjective() string

HackerAdjective will return a random hacker adjective

Example 
Seed(11)
fmt.Println(HackerAdjective())

Output:

solid state

func HackerNoun 

func HackerNoun() string

HackerNoun will return a random hacker noun

Example 
Seed(11)
fmt.Println(HackerNoun())

Output:

circuit

func HackerPhrase 

func HackerPhrase() string

HackerPhrase will return a random hacker sentence

Example 
Seed(11)
fmt.Println(HackerPhrase())

Output:

Use the optical CSS microchip, then you can write the open-source monitor!

func HackerVerb 

func HackerVerb() string

HackerVerb will return a random hacker verb

Example 
Seed(11)
fmt.Println(HackerVerb())

Output:

lock

func HackeringVerb 

func HackeringVerb() string

HackeringVerb will return a random hacker ingverb

Example 
Seed(11)
fmt.Println(HackeringVerb())

Output:

compressing

func HexColor 

func HexColor() string

HexColor will generate a random hexadecimal color string

Example 
Seed(11)
fmt.Println(HexColor())

Output:

#ef759a

func HexUint 

func HexUint(bitSize int) string

HexUint will generate a random uint hex value with "0x" prefix

Example 
Seed(11)
fmt.Println(HexUint(16))

Output:

0x425b

func HipsterParagraph 

func HipsterParagraph() string

HipsterParagraph will generate a random hipster paragraph

Example 
Seed(11)
fmt.Println(HipsterParagraph())

Output:

Compared Care meets you probably haven't heard of them ethos. Single-origin austin, double why.

func HipsterSentence 

func HipsterSentence() string

HipsterSentence will generate a random hipster sentence

Example 
Seed(11)
fmt.Println(HipsterSentence())

Output:

Soul loops with you probably haven't heard of them undertones.

func HipsterWord 

func HipsterWord() string

HipsterWord will return a single hipster word

Example 
Seed(11)
fmt.Println(HipsterWord())

Output:

semiotics

func Hobby 

func Hobby() string

Hobby will generate a random hobby string

Example 
Seed(11)
fmt.Println(Hobby())

Output:

Travel

func Hour 

func Hour() int

Hour will generate a random hour - in military time

Example 
Seed(11)
fmt.Println(Hour())

Output:

21

func ID added in v7.9.0 

func ID() string

ID will return a random unique identifier

Example 
Seed(11)
fmt.Println(ID())

Output:

nfrfzjsb87qckh6bpga2

func IPv4Address 

func IPv4Address() string

IPv4Address will generate a random version 4 ip address

Example 
Seed(11)
fmt.Println(IPv4Address())

Output:

180.18.181.251

func IPv6Address 

func IPv6Address() string

IPv6Address will generate a random version 6 ip address

Example 
Seed(11)
fmt.Println(IPv6Address())

Output:

ddb4:9212:aab5:87fb:4e33:17a4:f7b9:bf8e

func Image 

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

Image generates a random rgba image

Example 
Seed(11)
fmt.Println(Image(1, 1))

Output:

&{[180 18 181 255] 4 (0,0)-(1,1)}

func ImageJpeg 

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

ImageJpeg generates a random rgba jpeg image

Example 
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 229 40 162 138 251 3 239 15 255 217]

func ImagePng 

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

ImagePng generates a random rgba png image

Example 
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 218 34 180 21 16 0 0 255 255 3 1 1 126 242 54 123 184 0 0 0 0 73 69 78 68 174 66 96 130]

func InputName 

func InputName() string

InputName will return a random input field name

Example 
Seed(11)
fmt.Println(InputName())

Output:

message

func Int 

func Int() int

Int will generate a random int value

func Int16 

func Int16() int16

Int16 will generate a random int16 value

Example 
Seed(11)
fmt.Println(Int16())

Output:

23988

func Int32 

func Int32() int32

Int32 will generate a random int32 value

Example 
Seed(11)
fmt.Println(Int32())

Output:

1923896103

func Int64 

func Int64() int64

Int64 will generate a random int64 value

Example 
Seed(11)
fmt.Println(Int64())

Output:

7302769650322300340

func Int8 

func Int8() int8

Int8 will generate a random Int8 value

Example 
Seed(11)
fmt.Println(Int8())

Output:

52

func IntN 

func IntN(n int) int

IntN will generate a random int value between 0 and n

func IntRange 

func IntRange(min, max int) int

IntRange will generate a random int value between min and max

Example 
Seed(11)
fmt.Println(IntRange(1, 10))

Output:

9

func Interjection 

func Interjection() string

Interjection will generate a random word expressing emotion

Example 
Seed(11)
fmt.Println(Interjection())

Output:

alas

func Isin 

func Isin() string

ISIN

Example

ISIN Tests 

Seed(11)
fmt.Println(Isin())

Output:

TO4HHTI0T819

func JSON 

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

JSON generates an object or an array of objects in json format. A nil JSONOptions returns a randomly structured JSON.

Example (Array) 
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": "Priscilla",
        "last_name": "Thornton",
        "password": "3lGftNp9S908"
    },
    {
        "id": 2,
        "first_name": "Shaun",
        "last_name": "Byrd",
        "password": "Lc3G00tpPp7U"
    },
    {
        "id": 3,
        "first_name": "Grady",
        "last_name": "Craig",
        "password": "LGAvzZ5xUB6Z"
    }
]
Example (NumberWithTag) 
Seed(11)

type J struct {
	FieldNumber  json.Number `fake:"number:3,7"`
	FieldInt8    json.Number `fake:"int8"`
	FieldInt16   json.Number `fake:"int16"`
	FieldInt32   json.Number `fake:"int32"`
	FieldInt64   json.Number `fake:"int64"`
	FieldUint8   json.Number `fake:"uint8"`
	FieldUint16  json.Number `fake:"uint16"`
	FieldUint32  json.Number `fake:"uint32"`
	FieldUint64  json.Number `fake:"uint64"`
	FieldFloat32 json.Number `fake:"float32"`
	FieldFloat64 json.Number `fake:"float64range:12,72"`
}

var obj J
Struct(&obj)

fmt.Printf("obj.FieldNumber = %+v\n", obj.FieldNumber)
fmt.Printf("obj.FieldInt8 = %+v\n", obj.FieldInt8)
fmt.Printf("obj.FieldInt16 = %+v\n", obj.FieldInt16)
fmt.Printf("obj.FieldInt32 = %+v\n", obj.FieldInt32)
fmt.Printf("obj.FieldInt64 = %+v\n", obj.FieldInt64)
fmt.Printf("obj.FieldUint8 = %+v\n", obj.FieldUint8)
fmt.Printf("obj.FieldUint16 = %+v\n", obj.FieldUint16)
fmt.Printf("obj.FieldUint32 = %+v\n", obj.FieldUint32)
fmt.Printf("obj.FieldUint64 = %+v\n", obj.FieldUint64)
fmt.Printf("obj.FieldFloat32 = %+v\n", obj.FieldFloat32)
fmt.Printf("obj.FieldFloat64 = %+v\n", obj.FieldFloat64)

Output:

obj.FieldNumber = 7
obj.FieldInt8 = -110
obj.FieldInt16 = 10933
obj.FieldInt32 = 430103905
obj.FieldInt64 = 525217394518216243
obj.FieldUint8 = 164
obj.FieldUint16 = 63417
obj.FieldUint32 = 2307233133
obj.FieldUint64 = 17560678512042153749
obj.FieldFloat32 = 0.11857688426971436
obj.FieldFloat64 = 51.03971481390635
Example (Object) 
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": "Priscilla",
    "last_name": "Thornton",
    "address": {
        "address": "52759 Stationside, San Diego, Oregon 99344",
        "street": "52759 Stationside",
        "unit": "",
        "city": "San Diego",
        "state": "Oregon",
        "zip": "99344",
        "country": "France",
        "latitude": 77.259885,
        "longitude": 101.656736
    },
    "password": "B4qp9aqaXYSA"
}

func JobDescriptor 

func JobDescriptor() string

JobDescriptor will generate a random job descriptor string

Example 
Seed(11)
fmt.Println(JobDescriptor())

Output:

Strategic

func JobLevel 

func JobLevel() string

JobLevel will generate a random job level string

Example 
Seed(11)
fmt.Println(JobLevel())

Output:

Solutions

func JobTitle 

func JobTitle() string

JobTitle will generate a random job title string

Example 
Seed(11)
fmt.Println(JobTitle())

Output:

Traffic Controller

func Language 

func Language() string

Language will return a random language

Example 
Seed(11)
fmt.Println(Language())

Output:

Turkish

func LanguageAbbreviation 

func LanguageAbbreviation() string

LanguageAbbreviation will return a random language abbreviation

Example 
Seed(11)
fmt.Println(LanguageAbbreviation())

Output:

tr

func LanguageBCP 

func LanguageBCP() string

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

Example 
Seed(11)
fmt.Println(LanguageBCP())

Output:

tr-TR

func LastName 

func LastName() string

LastName will generate a random last name

Example 
Seed(11)
fmt.Println(LastName())

Output:

Wagner

func Latitude 

func Latitude() float64

Latitude will generate a random latitude float64

Example 
Seed(11)
fmt.Println(Latitude())

Output:

48.654167

func LatitudeInRange 

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

LatitudeInRange will generate a random latitude within the input range

Example 
Seed(11)
lat, _ := LatitudeInRange(21, 42)
fmt.Println(lat)

Output:

37.176319

func Letter 

func Letter() string

Letter will generate a single random lower case ASCII letter

Example 
Seed(11)
fmt.Println(Letter())

Output:

u

func LetterN 

func LetterN(n uint) string

LetterN will generate a random ASCII string with length N. Note that this function returns a string with a length of 1 when 0 is passed.

Example 
Seed(11)
fmt.Println(LetterN(10))

Output:

usKKbMlbxq

func Lexify 

func Lexify(str string) string

Lexify will replace ? with random generated letters

Example 
Seed(11)
fmt.Println(Lexify("?????"))

Output:

usKKb

func LogLevel 

func LogLevel(logType string) string

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

Example 
Seed(11)
fmt.Println(LogLevel("")) // This will also use general
fmt.Println(LogLevel("syslog"))
fmt.Println(LogLevel("apache"))

Output:

debug
crit
alert

func Longitude 

func Longitude() float64

Longitude will generate a random longitude float64

Example 
Seed(11)
fmt.Println(Longitude())

Output:

97.308335

func LongitudeInRange 

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

LongitudeInRange will generate a random longitude within the input range

Example 
Seed(11)
long, _ := LongitudeInRange(-10, 10)
fmt.Println(long)

Output:

5.406018

func LoremIpsumParagraph 

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

LoremIpsumParagraph will generate a random paragraphGenerator

Example 
Seed(11)
fmt.Println(LoremIpsumParagraph(3, 5, 12, "\n"))

Output:

Eveniet vero velit velit non incidunt est sed tenetur consequatur ut architecto. Quod non non et voluptas et esse quisquam ullam placeat molestiae laboriosam. Consequatur in perferendis molestiae quam voluptatem eaque quia facilis quo hic dignissimos. Architecto ut tenetur aut qui et optio id sint quae rerum labore. Quae deserunt quia mollitia id accusantium itaque nisi aut omnis occaecati repellendus.
Ad sunt neque placeat et qui saepe voluptatem blanditiis voluptatum possimus saepe. Velit distinctio quia quas cupiditate sequi dolorum delectus quia quo corrupti labore. Aut mollitia et aut eligendi blanditiis corrupti aut rem voluptatibus veritatis ut. Et ab voluptas delectus repellat eligendi qui eos blanditiis et et eos. Qui ipsum aut ut voluptate nulla officia qui earum repudiandae quidem officia.
Fugit esse beatae placeat nihil libero et sunt voluptas velit maiores voluptatem. Reiciendis quia dolor amet blanditiis labore eligendi fugit reiciendis modi est incidunt. Ut ut rerum odit sit voluptatem ipsam consequatur est incidunt aut quis. Non dolorem voluptatum pariatur esse eos blanditiis rem eos commodi accusamus occaecati. Qui voluptatem eos et tempora et id at voluptas suscipit magni cupiditate.

func LoremIpsumSentence 

func LoremIpsumSentence(wordCount int) string

LoremIpsumSentence will generate a random sentence

Example 
Seed(11)
fmt.Println(LoremIpsumSentence(5))

Output:

Eveniet vero velit velit non.

func LoremIpsumWord 

func LoremIpsumWord() string

LoremIpsumWord will generate a random word

Example 
Seed(11)
fmt.Println(LoremIpsumWord())

Output:

eveniet

func Lunch 

func Lunch() string

Lunch will return a random lunch name

Example 
Seed(11)
fmt.Println(Lunch())

Output:

Quick chile relleno casserole

func MacAddress 

func MacAddress() string

MacAddress will generate a random mac address

Example 
Seed(11)
fmt.Println(MacAddress())

Output:

e4:da:32:33:86:3b

func Map 

func Map() map[string]any

Map will generate a random set of map data

Example 
Seed(11)
fmt.Println(Map())

Output:

map[a:map[that:could] above:[sometimes vast whom us scarcely these huh] am:map[how:9310653] depend:map[hey:5402877] out:381794.78 since:916659.94 these:map[frequently:2314010]]

func Markdown 

func Markdown(co *MarkdownOptions) (string, error)

Markdown will return a single random Markdown template document

Example

TemplateMarkdown examples and tests 

Seed(11)

value, err := Markdown(&MarkdownOptions{})
if err != nil {
	fmt.Println(err)
}

fmt.Println(string(value))

Output:

# TurkeyThinker

*Author: Roxane Webb*

He open safely to stabilize the world. Automate problem recovery gracefully. Choose lovely defaults. Deliberately wake the part. Clear time were better than clever week.

Warm starts beat cold child. Systematically improve the woman yearly. Protect the place under grumpy load.

## Table of Contents
- [Installation](#installation)
- [Usage](#usage)
- [License](#license)

## Installation
'''bash
pip install TurkeyThinker
'''

## Usage
'''python
result = turkeythinker.handle("whimsical story")
print("turkeythinker result:", "terminated")
'''

## License
BSD-3-Clause

func MiddleName 

func MiddleName() string

MiddleName will generate a random middle name

Example 
Seed(11)
fmt.Println(MiddleName())

Output:

Jose

func MinecraftAnimal 

func MinecraftAnimal() string

MinecraftAnimal will generate a random Minecraft animal

Example 
Seed(11)
fmt.Println(MinecraftAnimal())

Output:

wolf

func MinecraftArmorPart 

func MinecraftArmorPart() string

MinecraftArmorPart will generate a random Minecraft armor part

Example 
Seed(11)
fmt.Println(MinecraftArmorPart())

Output:

helmet

func MinecraftArmorTier 

func MinecraftArmorTier() string

MinecraftArmorTier will generate a random Minecraft armor tier

Example 
Seed(11)
fmt.Println(MinecraftArmorTier())

Output:

netherite

func MinecraftBiome 

func MinecraftBiome() string

MinecraftBiome will generate a random Minecraft biome

Example 
Seed(11)
fmt.Println(MinecraftBiome())

Output:

the nether

func MinecraftDye 

func MinecraftDye() string

MinecraftDye will generate a random Minecraft dye

Example 
Seed(11)
fmt.Println(MinecraftDye())

Output:

yellow

func MinecraftFood 

func MinecraftFood() string

MinecraftFood will generate a random Minecraft food

Example 
Seed(11)
fmt.Println(MinecraftFood())

Output:

steak

func MinecraftMobBoss 

func MinecraftMobBoss() string

MinecraftMobBoss will generate a random Minecraft mob boss

Example 
Seed(11)
fmt.Println(MinecraftMobBoss())

Output:

ender dragon

func MinecraftMobHostile 

func MinecraftMobHostile() string

MinecraftMobHostile will generate a random Minecraft mob hostile

Example 
Seed(11)
fmt.Println(MinecraftMobHostile())

Output:

wither skeleton

func MinecraftMobNeutral 

func MinecraftMobNeutral() string

MinecraftMobNeutral will generate a random Minecraft mob neutral

Example 
Seed(11)
fmt.Println(MinecraftMobNeutral())

Output:

wolf

func MinecraftMobPassive 

func MinecraftMobPassive() string

MinecraftMobPassive will generate a random Minecraft mob passive

Example 
Seed(11)
fmt.Println(MinecraftMobPassive())

Output:

turtle

func MinecraftOre 

func MinecraftOre() string

MinecraftOre will generate a random Minecraft ore

Example 
Seed(11)
fmt.Println(MinecraftOre())

Output:

redstone

func MinecraftTool 

func MinecraftTool() string

MinecraftTool will generate a random Minecraft tool

Example 
Seed(11)
fmt.Println(MinecraftTool())

Output:

fishing rod

func MinecraftVillagerJob 

func MinecraftVillagerJob() string

MinecraftVillagerJob will generate a random Minecraft villager job

Example 
Seed(11)
fmt.Println(MinecraftVillagerJob())

Output:

toolsmith

func MinecraftVillagerLevel 

func MinecraftVillagerLevel() string

MinecraftVillagerLevel will generate a random Minecraft villager level

Example 
Seed(11)
fmt.Println(MinecraftVillagerLevel())

Output:

master

func MinecraftVillagerStation 

func MinecraftVillagerStation() string

MinecraftVillagerStation will generate a random Minecraft villager station

Example 
Seed(11)
fmt.Println(MinecraftVillagerStation())

Output:

stonecutter

func MinecraftWeapon 

func MinecraftWeapon() string

MinecraftWeapon will generate a random Minecraft weapon

Example 
Seed(11)
fmt.Println(MinecraftWeapon())

Output:

shield

func MinecraftWeather 

func MinecraftWeather() string

MinecraftWeather will generate a random Minecraft weather

Example 
Seed(11)
fmt.Println(MinecraftWeather())

Output:

thunder

func MinecraftWood 

func MinecraftWood() string

MinecraftWood will generate a random Minecraft wood

Example 
Seed(11)
fmt.Println(MinecraftWood())

Output:

dark oak

func Minute 

func Minute() int

Minute will generate a random minute

Example 
Seed(11)
fmt.Println(Minute())

Output:

53

func Month 

func Month() int

Month will generate a random month int

Example 
Seed(11)
fmt.Println(Month())

Output:

11

func MonthString 

func MonthString() string

MonthString will generate a random month string

Example 
Seed(11)
fmt.Println(MonthString())

Output:

November

func MovieGenre 

func MovieGenre() string
Example 
Seed(11)
fmt.Println(MovieGenre())

Output:

Thriller

func MovieName 

func MovieName() string
Example 
Seed(11)
fmt.Println(MovieName())

Output:

The Terminator

func Name 

func Name() string

Name will generate a random First and Last Name

Example 
Seed(11)
fmt.Println(Name())

Output:

Priscilla Thornton

func NamePrefix 

func NamePrefix() string

NamePrefix will generate a random name prefix

Example 
Seed(11)
fmt.Println(NamePrefix())

Output:

Dr.

func NameSuffix 

func NameSuffix() string

NameSuffix will generate a random name suffix

Example 
Seed(11)
fmt.Println(NameSuffix())

Output:

PhD

func NanoSecond 

func NanoSecond() int

NanoSecond will generate a random nano second

Example 
Seed(11)
fmt.Println(NanoSecond())

Output:

895883936

func NiceColors 

func NiceColors() []string

NiceColor will generate a random safe color string

Example 
Seed(11)
fmt.Println(NiceColors())

Output:

[#fffbb7 #a6f6af #66b6ab #5b7c8d #4f2958]

func Noun 

func Noun() string

Noun will generate a random noun

Example 
Seed(11)
fmt.Println(Noun())

Output:

nest

func NounAbstract 

func NounAbstract() string

NounAbstract will generate a random abstract noun

Example 
Seed(11)
fmt.Println(NounAbstract())

Output:

speed

func NounCollectiveAnimal 

func NounCollectiveAnimal() string

NounCollectiveAnimal will generate a random collective noun animal

Example 
Seed(11)
fmt.Println(NounCollectiveAnimal())

Output:

leap

func NounCollectivePeople 

func NounCollectivePeople() string

NounCollectivePeople will generate a random collective noun person

Example 
Seed(11)
fmt.Println(NounCollectivePeople())

Output:

posse

func NounCollectiveThing 

func NounCollectiveThing() string

NounCollectiveThing will generate a random collective noun thing

Example 
Seed(11)
fmt.Println(NounCollectiveThing())

Output:

hail

func NounCommon 

func NounCommon() string

NounCommon will generate a random common noun

Example 
Seed(11)
fmt.Println(NounCommon())

Output:

group

func NounConcrete 

func NounConcrete() string

NounConcrete will generate a random concrete noun

Example 
Seed(11)
fmt.Println(NounConcrete())

Output:

theater

func NounCountable 

func NounCountable() string

NounCountable will generate a random countable noun

Example 
Seed(11)
fmt.Println(NounCountable())

Output:

smile

func NounDeterminer 

func NounDeterminer() string

NounDeterminer will generate a random noun determiner

Example 
Seed(11)
fmt.Println(NounDeterminer())

Output:

every

func NounProper 

func NounProper() string

NounProper will generate a random proper noun

Example 
Seed(11)
fmt.Println(NounProper())

Output:

Nannie

func NounUncountable 

func NounUncountable() string

NounUncountable will generate a random uncountable noun

Example 
Seed(11)
fmt.Println(NounUncountable())

Output:

usage

func Number 

func Number(min int, max int) int

Number will generate a random number between given min and max

Example 
Seed(11)
fmt.Println(Number(50, 23456))

Output:

21019

func Numerify 

func Numerify(str string) string

Numerify will replace # with random numerical values

Example 
Seed(11)
fmt.Println(Numerify("###-###-####"))

Output:

881-252-7598

func OperaUserAgent 

func OperaUserAgent() string

OperaUserAgent will generate a random opera browser user agent string

Example 
Seed(11)
fmt.Println(OperaUserAgent())

Output:

Opera/10.91 (X11; Linux i686; en-US) Presto/2.12.265 Version/11.00

func Paragraph 

func Paragraph(paragraphCount ...any) string

Paragraph will generate a random paragraph Deprecated: The parameters are ignored and will be removed in the next major release.

Example 
Seed(11)
fmt.Println(Paragraph())

Output:

Publish a changelog entry for the day. Steady jittery progress in Denver should visible.

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 
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:

tcvncypbfolpftvlyplgdxiwibpsautg
ZXVXDVFQGCECFDBRWEKPWATHKRGKWDIZ
78902501101475351179812748788830
!!._-._*--@@.@---@_@.-_!_!-*_!*@
96 rvcB@f0.PNzL!qp 7hP_V 7g!vV 9
6hJDB

func PastDate 

func PastDate() time.Time

PastDate will generate a random past time.Time struct

Example 
Seed(11)
fmt.Println(PastDate())

func PetName 

func PetName() string

PetName will return a random fun pet name

Example 
Seed(11)
fmt.Println(PetName())

Output:

The Notorious D.O.G.

func Phone 

func Phone() string

Phone will generate a random phone number string

Example 
Seed(11)
fmt.Println(Phone())

Output:

8812527598

func PhoneFormatted 

func PhoneFormatted() string

PhoneFormatted will generate a random phone number string

Example 
Seed(11)
fmt.Println(PhoneFormatted())

Output:

812-527-5989

func Phrase 

func Phrase() string

Phrase will return a random phrase

Example 
Seed(11)
fmt.Println(Phrase())

Output:

how many siblings do you have

func PhraseAdverb 

func PhraseAdverb() string

PhraseAdverb will return a random adverb phrase

Example 
Seed(11)
fmt.Println(PhraseAdverb())

Output:

successfully

func PhraseNoun 

func PhraseNoun() string

PhraseNoun will return a random noun phrase

Example 
Seed(11)
fmt.Println(PhraseNoun())

Output:

a fear

func PhrasePreposition 

func PhrasePreposition() string

PhrasePreposition will return a random preposition phrase

Example 
Seed(11)
fmt.Println(PhrasePreposition())

Output:

with an archipelago

func PhraseVerb 

func PhraseVerb() string

PhraseVerb will return a random preposition phrase

Example 
Seed(11)
fmt.Println(PhraseVerb())

Output:

bathe the jittery trip totally brightly under a troubling part scarcely unexpectedly

func Preposition 

func Preposition() string

Preposition will generate a random preposition

Example 
Seed(11)
fmt.Println(Preposition())

Output:

instead of

func PrepositionCompound 

func PrepositionCompound() string

PrepositionCompound will generate a random compound preposition

Example 
Seed(11)
fmt.Println(PrepositionCompound())

Output:

other than

func PrepositionDouble 

func PrepositionDouble() string

PrepositionDouble will generate a random double preposition

Example 
Seed(11)
fmt.Println(PrepositionDouble())

Output:

next to

func PrepositionSimple 

func PrepositionSimple() string

PrepositionSimple will generate a random simple preposition

Example 
Seed(11)
fmt.Println(PrepositionSimple())

Output:

with

func Price 

func Price(min, max float64) float64

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

Example 
Seed(11)
fmt.Printf("%.2f", Price(0.8618, 1000))

Output:

770.49

func ProductAudience added in v7.1.0 

func ProductAudience() []string

ProductAudience will generate a random target audience

Example 
Seed(11)
fmt.Println(ProductAudience())

Output:

[students collectors]

func ProductBenefit added in v7.1.0 

func ProductBenefit() string

ProductBenefit will generate a random product benefit

Example 
Seed(11)
fmt.Println(ProductBenefit())

Output:

time-saving

func ProductCategory 

func ProductCategory() string

ProductCategory will generate a random product category

Example 
Seed(11)
fmt.Println(ProductCategory())

Output:

tableware

func ProductDescription 

func ProductDescription() string

ProductDescription will generate a random product description

Example 
Seed(11)
fmt.Println(ProductDescription())

Output:

This product, ideal for collectors and hobbyists, features puzzled mica and incorporates water-resistant to ensure safety during sports.

func ProductDimension added in v7.1.0 

func ProductDimension() string

ProductDimension will generate a random product dimension

Example 
Seed(11)
fmt.Println(ProductDimension())

Output:

x-small

func ProductFeature 

func ProductFeature() string

ProductFeature will generate a random product feature

Example 
Seed(11)
fmt.Println(ProductFeature())

Output:

ultrasonic

func ProductISBN added in v7.3.0 

func ProductISBN(opts *ISBNOptions) string

ProductISBN13 will generate a random ISBN-13 string for the product

Example 
Seed(11)
fmt.Println(ProductISBN(&ISBNOptions{Version: "13", Separator: "-"}))

Output:

978-8-8125-2759-5
Example (Isbn10) 
Seed(11)
fmt.Println(ProductISBN(&ISBNOptions{Version: "10", Separator: "-"}))

Output:

8-8125-275-7

func ProductMaterial 

func ProductMaterial() string

ProductMaterial will generate a random product material

Example 
Seed(11)
fmt.Println(ProductMaterial())

Output:

textile

func ProductName 

func ProductName() string

ProductName will generate a random product name

Example 
Seed(11)
fmt.Println(ProductName())

Output:

Luxurious Trophy

func ProductSuffix added in v7.1.0 

func ProductSuffix() string

ProductSuffix will generate a random product suffix

Example 
Seed(11)
fmt.Println(ProductSuffix())

Output:

turbo

func ProductUPC 

func ProductUPC() string

ProductUPC will generate a random product UPC

Example 
Seed(11)
fmt.Println(ProductUPC())

Output:

088125275989

func ProductUseCase added in v7.1.0 

func ProductUseCase() string

ProductUseCase will generate a random product use case

Example 
Seed(11)
fmt.Println(ProductUseCase())

Output:

sports

func ProgrammingLanguage 

func ProgrammingLanguage() string

ProgrammingLanguage will return a random programming language

Example 
Seed(11)
fmt.Println(ProgrammingLanguage())

Output:

TELCOMP

func Pronoun 

func Pronoun() string

Pronoun will generate a random pronoun

Example 
Seed(11)
fmt.Println(Pronoun())

Output:

some

func PronounDemonstrative 

func PronounDemonstrative() string

PronounDemonstrative will generate a random demonstrative pronoun

Example 
Seed(11)
fmt.Println(PronounDemonstrative())

Output:

this

func PronounIndefinite 

func PronounIndefinite() string

PronounIndefinite will generate a random indefinite pronoun

Example 
Seed(11)
fmt.Println(PronounIndefinite())

Output:

somebody

func PronounInterrogative 

func PronounInterrogative() string

PronounInterrogative will generate a random interrogative pronoun

Example 
Seed(11)
fmt.Println(PronounInterrogative())

Output:

how

func PronounObject 

func PronounObject() string

PronounObject will generate a random object pronoun

Example 
Seed(11)
fmt.Println(PronounObject())

Output:

them

func PronounPersonal 

func PronounPersonal() string

PronounPersonal will generate a random personal pronoun

Example 
Seed(11)
fmt.Println(PronounPersonal())

Output:

they

func PronounPossessive 

func PronounPossessive() string

PronounPossessive will generate a random possessive pronoun

Example 
Seed(11)
fmt.Println(PronounPossessive())

Output:

theirs

func PronounReflective 

func PronounReflective() string

PronounReflective will generate a random reflective pronoun

Example 
Seed(11)
fmt.Println(PronounReflective())

Output:

itself

func PronounRelative 

func PronounRelative() string

PronounRelative will generate a random relative pronoun

Example 
Seed(11)
fmt.Println(PronounRelative())

Output:

whomever

func Question 

func Question() string

Question will return a random question

Example 
Seed(11)
fmt.Println(Question())

Output:

What is the marginal gain from fear?

func Quote 

func Quote() string

Quote will return a random quote from a random person

Example 
Seed(11)
fmt.Println(Quote())

Output:

"Energy is contagious—so is fear"

func RGBColor 

func RGBColor() []int

RGBColor will generate a random int slice color

Example 
Seed(11)
fmt.Println(RGBColor())

Output:

[180 18 181]

func RandomInt 

func RandomInt(i []int) int

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

Example 
Seed(11)

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

Output:

8413

func RandomMapKey 

func RandomMapKey(mapI any) any

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 
Seed(11)
fmt.Println(RandomString([]string{"hello", "world"}))

Output:

hello

func RandomUint 

func RandomUint(u []uint) uint

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

Example 
Seed(11)

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

Output:

8413

func Regex 

func Regex(regexStr string) string

Regex will generate a string based upon a RE2 syntax

Example 
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:

ffbbd
GSNYV
up
tyyxi@kshtyia.net

func RemoveFuncLookup 

func RemoveFuncLookup(functionName string)

RemoveFuncLookup will remove a function from lookup

func SQL 

func SQL(so *SQLOptions) (string, error)
Example 
Seed(11)

res, _ := SQL(&SQLOptions{
	Table: "people",
	Count: 2,
	Fields: []Field{
		{Name: "id", Function: "autoincrement"},
		{Name: "first_name", Function: "firstname"},
		{Name: "price", Function: "price"},
		{Name: "age", Function: "number", Params: MapParams{"min": {"1"}, "max": {"99"}}},
		{Name: "created_at", Function: "date", Params: MapParams{"format": {"2006-01-02 15:04:05"}}},
	},
})

fmt.Println(string(res))

Output:

INSERT INTO people (id, first_name, price, age, created_at) VALUES (1, 'Priscilla', 985.96, 20, '1925-07-08 17:32:57'),(2, 'Ramon', 639.32, 74, '2017-12-29 07:25:24');

func SSN 

func SSN() string

SSN will generate a random Social Security Number

Example 
Seed(11)
fmt.Println(SSN())

Output:

906295542

func SafariUserAgent 

func SafariUserAgent() string

SafariUserAgent will generate a random safari browser user agent string

Example 
Seed(11)
fmt.Println(SafariUserAgent())

Output:

Mozilla/5.0 (Windows; U; Windows NT 6.0) AppleWebKit/536.44.6 (KHTML, like Gecko) Version/4.1 Safari/536.44.6

func SafeColor 

func SafeColor() string

SafeColor will generate a random safe color string

Example 
Seed(11)
fmt.Println(SafeColor())

Output:

aqua

func School 

func School() string

School will generate a random School type

Example 
Seed(11)
fmt.Println(School())

Output:

Hillside Private Academy

func Second 

func Second() int

Second will generate a random second

Example 
Seed(11)
fmt.Println(Second())

Output:

53

func Seed 

func Seed(args ...any) error

Seed attempts to seed the GlobalFaker with the given seed

func Sentence 

func Sentence(wordCount ...int) string

Sentence will generate a random sentence Deprecated: The wordCount parameter is ignored and will be removed in the next major release.

Example 
Seed(11)
fmt.Println(Sentence())

Output:

Weekends reserve time for Sun Bathing and day.

func ShuffleAnySlice 

func ShuffleAnySlice(v any)

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

Example 
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:

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

func ShuffleInts 

func ShuffleInts(a []int)

ShuffleInts will randomize a slice of ints

Example 
Seed(11)

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

Output:

[941 777 8413 74125 854 89416 841657 52]

func ShuffleStrings 

func ShuffleStrings(a []string)

ShuffleStrings will randomize a slice of strings

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

Output:

[for day happy everyone good times a have]

func Slice 

func Slice(v any)

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

Example 
Seed(11)

var S []string
Slice(&S)

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

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

Output:

[KKbMlbxqu mwwv WVlPmw AeAwVH Khrx DcxFeWk vChMCeKf BwRtnboOE mWluN]
[102 -7 -125]
Example (Struct) 
Seed(11)

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

var B []Basic
Slice(&B)

fmt.Println(B)

Output:

[{Nannie 3680786209731553973 0.27238095} {Gregg 4268594234476337060 0.0051180124} {Hailie 8337306475187377941 0.118576884} {Ramon 1365845625386394310 0.27625358} {Roxane 7952567920265354269 0.648698} {Daija 7933890822314871011 0.37052673} {Lance 5542429450337529393 0.36615264} {Rocky 6292602578870227868 0.9382272} {Jace 229639691709918065 0.5914113}]

func Slogan 

func Slogan() string

Slogan will generate a random company slogan

Example 
Seed(11)
fmt.Println(Slogan())

Output:

local area network maximize Drive, mission-critical.

func Snack 

func Snack() string

Snack will return a random snack name

Example 
Seed(11)
fmt.Println(Snack())

Output:

Fantastic banana bran muffins

func SocialMedia added in v7.8.0 

func SocialMedia() string

SocialMedia will generate a random social media string

Example 
Seed(11)
fmt.Println(SocialMedia())

Output:

https://linkedin.com/in/CuriosCasino7

func SongArtist added in v7.2.0 

func SongArtist() string
Example 
Seed(11)
fmt.Println(SongArtist())

Output:

The Jacksons

func SongGenre added in v7.2.0 

func SongGenre() string
Example 
Seed(11)
fmt.Println(SongGenre())

Output:

Synthwave

func SongName added in v7.2.0 

func SongName() string
Example 
Seed(11)
fmt.Println(SongName())

Output:

What Was I Made For?

func State 

func State() string

State will generate a random state string

Example 
Seed(11)
fmt.Println(State())

Output:

Vermont

func StateAbr 

func StateAbr() string

StateAbr will generate a random abbreviated state string

Example 
Seed(11)
fmt.Println(StateAbr())

Output:

WV

func Street 

func Street() string

Street will generate a random address street string

Example 
Seed(11)
fmt.Println(Street())

Output:

125 East Routemouth

func StreetName 

func StreetName() string

StreetName will generate a random address street name string

Example 
Seed(11)
fmt.Println(StreetName())

Output:

Turnpike

func StreetNumber 

func StreetNumber() string

StreetNumber will generate a random address street number string

Example 
Seed(11)
fmt.Println(StreetNumber())

Output:

812

func StreetPrefix 

func StreetPrefix() string

StreetPrefix will generate a random address street prefix string

Example 
Seed(11)
fmt.Println(StreetPrefix())

Output:

Port

func StreetSuffix 

func StreetSuffix() string

StreetSuffix will generate a random address street suffix string

Example 
Seed(11)
fmt.Println(StreetSuffix())

Output:

side

func Struct 

func Struct(v any) error

Struct fills in exported fields of a struct with random data based on the value of `fake` tag of exported fields or with the result of a call to the Fake() method if the field type implements `Fakeable`. Use `fake:"skip"` to explicitly skip an element. All built-in types are supported, with templating support for string types.

Example 
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"`
	SkipAlt    *string           `fake:"-"`
	Array      []string          `fakesize:"2"`
	ArrayRange []string          `fakesize:"2,6"`
	Map        map[string]string `fakesize:"2"`
	MapRange   map[string]string `fakesize:"2,4"`
	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.SkipAlt)
fmt.Printf("%v\n", f.Array)
fmt.Printf("%v\n", f.ArrayRange)
fmt.Printf("%v\n", f.Map)
fmt.Printf("%v\n", f.MapRange)
fmt.Printf("%+v\n", f.Bar)

Output:

sKKbMlbxqu
1365845625386394310
4415419407664574903
Roxane
10
<nil>
<nil>
[RWVlPmwRAe wVHB]
[rxXDcxFe kfvChMC KfmBwRtn]
map[gyJrZ:tfZAk oOEImWl:NXYnuKiGab]
map[WigEnVzBy:JJXMkG aHqIpyVs:UxvheGVE pYyDuWC:yzjqsX]
{Name:LfLRuhFRHQ Number:5737279083624806933 Float:0.59020466}
Example (Array) 
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"`
	NamesRange []string `fake:"{firstname}" fakesize:"3,6"`
}

var fm FooMany
Struct(&fm)

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

Output:

[{sKKbMlbxqu 1365845625386394310 Lesley 10 <nil>}]
[Roxanne Randy Daija]
[Edna Lance Colton Lila Rocky Danyka]

func Svg 

func Svg(options *SVGOptions) string

Generate a random svg generator

Example 
Seed(11)
fmt.Println(Svg(nil))

Output:

<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 459 443" width="459" height="443"><rect x="0" y="0" width="100%" height="100%" fill="#64908a" /><circle cx="334" cy="238" r="437" fill="#cc2a41" /><circle cx="34" cy="328" r="428" fill="#cc2a41" /><circle cx="151" cy="190" r="191" fill="#e8caa4" /><circle cx="343" cy="410" r="156" fill="#351330" /><circle cx="5" cy="410" r="192" fill="#351330" /><circle cx="94" cy="286" r="384" fill="#cc2a41" /><circle cx="34" cy="239" r="439" fill="#351330" /><circle cx="199" cy="310" r="278" fill="#cc2a41" /><circle cx="293" cy="106" r="20" fill="#64908a" /><circle cx="275" cy="327" r="11" fill="#cc2a41" /><circle cx="406" cy="338" r="239" fill="#e8caa4" /><circle cx="41" cy="71" r="344" fill="#64908a" /><circle cx="411" cy="116" r="208" fill="#64908a" /><circle cx="410" cy="88" r="303" fill="#351330" /><circle cx="241" cy="69" r="285" fill="#cc2a41" /></svg>

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 
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:[Jeff Robert Billy] Team 2:[Connor Fabian Sharon] Team 3:[Justin Steve]]

func Template 

func Template(template string, co *TemplateOptions) (string, error)

Template generates an document based on the the supplied template

Example 
Seed(11)

template := `{{range IntRange 1 4}}{{FirstName}} {{LastName}}\n{{end}}`

value, err := Template(template, &TemplateOptions{Data: 4})
if err != nil {
	fmt.Println(err)
}

fmt.Println(string(value))

Output:

Priscilla Thornton
Brooke Duncan
Gregg Ford
Laurel McClure

func TimeZone 

func TimeZone() string

TimeZone will select a random timezone string

Example 
Seed(11)
fmt.Println(TimeZone())

Output:

West Pacific Standard Time

func TimeZoneAbv 

func TimeZoneAbv() string

TimeZoneAbv will select a random timezone abbreviation string

Example 
Seed(11)
fmt.Println(TimeZoneAbv())

Output:

WPST

func TimeZoneFull 

func TimeZoneFull() string

TimeZoneFull will select a random full timezone string

Example 
Seed(11)
fmt.Println(TimeZoneFull())

Output:

(UTC+10:00) Guam, Port Moresby

func TimeZoneOffset 

func TimeZoneOffset() float32

TimeZoneOffset will select a random timezone offset

Example 
Seed(11)
fmt.Println(TimeZoneOffset())

Output:

10

func TimeZoneRegion 

func TimeZoneRegion() string

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

Example 
Seed(11)
fmt.Println(TimeZoneRegion())

Output:

Indian/Chagos

func URL 

func URL() string

URL will generate a random url string

Example 
Seed(11)
fmt.Println(URL())

Output:

http://www.deputyinnovative.biz/infrastructures

func UUID 

func UUID() string

UUID (version 4) will generate a random unique identifier based upon random numbers

Example 
Seed(11)
fmt.Println(UUID())

Output:

b4ddf623-4ea6-48e5-9292-541f028d1fdb

func Uint 

func Uint() uint

Uint will generate a random uint value

func Uint16 

func Uint16() uint16

Uint16 will generate a random uint16 value

Example 
Seed(11)
fmt.Println(Uint16())

Output:

56756

func Uint32 

func Uint32() uint32

Uint32 will generate a random uint32 value

Example 
Seed(11)
fmt.Println(Uint32())

Output:

3847792206

func Uint64 

func Uint64() uint64

Uint64 will generate a random uint64 value

Example 
Seed(11)
fmt.Println(Uint64())

Output:

16526141687177076148

func Uint8 

func Uint8() uint8

Uint8 will generate a random uint8 value

Example 
Seed(11)
fmt.Println(Uint8())

Output:

180

func UintN 

func UintN(n uint) uint

UintN will generate a random uint value between 0 and n

func UintRange 

func UintRange(min, max uint) uint

UintRange will generate a random uint value between min and max

Example 
Seed(11)
fmt.Println(UintRange(1, 10))

Output:

9

func Unit added in v7.4.0 

func Unit() string

Unit will generate a random unit string

Example 
Seed(11)
fmt.Println(Unit())

Output:

Penthouse 812

func UrlSlug added in v7.8.0 

func UrlSlug(words int) string

UrlSlug will generate a random url slug with the specified number of words

Example 
Seed(11)
fmt.Println(UrlSlug(3))

Output:

bathe-regularly-quiver

func UserAgent 

func UserAgent() string

UserAgent will generate a random broswer user agent

Example 
Seed(11)
fmt.Println(UserAgent())

Output:

Mozilla/5.0 (Windows 98) AppleWebKit/5360 (KHTML, like Gecko) Chrome/37.0.852.0 Mobile Safari/5360

func Username 

func Username() string

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

Example 
Seed(11)
fmt.Println(Username())

Output:

Gregg812

func Vegetable 

func Vegetable() string

Vegetable will return a random vegetable name

Example 
Seed(11)
fmt.Println(Vegetable())

Output:

Sweet Potato

func Verb 

func Verb() string

Verb will generate a random verb

Example 
Seed(11)
fmt.Println(Verb())

Output:

would

func VerbAction 

func VerbAction() string

VerbAction will generate a random action verb

Example 
Seed(11)
fmt.Println(VerbAction())

Output:

paint

func VerbHelping 

func VerbHelping() string

VerbHelping will generate a random helping verb

Example 
Seed(11)
fmt.Println(VerbHelping())

Output:

am

func VerbIntransitive 

func VerbIntransitive() string

VerbIntransitive will generate a random intransitive verb

Example 
Seed(11)
fmt.Println(VerbIntransitive())

Output:

vomit

func VerbLinking 

func VerbLinking() string

VerbLinking will generate a random linking verb

Example 
Seed(11)
fmt.Println(VerbLinking())

Output:

must

func VerbTransitive 

func VerbTransitive() string

VerbTransitive will generate a random transitive verb

Example 
Seed(11)
fmt.Println(VerbTransitive())

Output:

upgrade

func Vowel 

func Vowel() string

Vowel will generate a single random lower case vowel

Example 
Seed(11)
fmt.Println(Vowel())

Output:

a

func WeekDay 

func WeekDay() string

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

Example 
Seed(11)
fmt.Println(WeekDay())

Output:

Saturday

func Weighted 

func Weighted(options []any, weights []float32) (any, error)

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

Example 
Seed(11)

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

fmt.Println(option)

Output:

2

func Word 

func Word() string

Word will generate a random word

Example 
Seed(11)
fmt.Println(Word())

Output:

bathe

func XML 

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

XML generates an object or an array of objects in json format A nil XMLOptions returns a randomly structured XML.

Example (Array) 
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>Priscilla</first_name>
        <last_name>Thornton</last_name>
        <password>3lGftNp9S908</password>
    </record>
    <record>
        <first_name>Shaun</first_name>
        <last_name>Byrd</last_name>
        <password>Lc3G00tpPp7U</password>
    </record>
</xml>
Example (Single) 
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>Priscilla</first_name>
    <last_name>Thornton</last_name>
    <password>3lGftNp9S908</password>
</xml>

func Year 

func Year() int

Year will generate a random year between 1900 - current year

Example 
Seed(11)
fmt.Println(Year())

Output:

2012

func Zip 

func Zip() string

Zip will generate a random Zip code string

Example 
Seed(11)
fmt.Println(Zip())

Output:

81252

Types

type AddressInfo 

type AddressInfo struct {
	Address   string  `json:"address" xml:"address"`
	Street    string  `json:"street" xml:"street"`
	Unit      string  `json:"unit" xml:"unit"`
	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 
Seed(11)
address := Address()
fmt.Println(address.Address)
fmt.Println(address.Street)
fmt.Println(address.Unit)
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:

125 East Routemouth, North Las Vegas, South Dakota 17999
125 East Routemouth

North Las Vegas
South Dakota
17999
Isle of Man
-79.948308
-60.019628

type BookInfo 

type BookInfo struct {
	Title  string `json:"title" xml:"name"`
	Author string `json:"author" xml:"author"`
	Genre  string `json:"genre" xml:"genre"`
}

func Book 

func Book() *BookInfo
Example 
Seed(11)
book := Book()
fmt.Println(book.Title)
fmt.Println(book.Author)
fmt.Println(book.Genre)

Output:

Things Fall Apart
Toni Morrison
Erotic

type CSVOptions 

type CSVOptions struct {
	Delimiter string  `json:"delimiter" xml:"delimiter" fake:"{randomstring:[,,tab]}"`
	RowCount  int     `json:"row_count" xml:"row_count" fake:"{number:1,10}"`
	Fields    []Field `json:"fields" xml:"fields" fake:"{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 
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:

Dacia
CNG
Santafe 4wd
Automatic
Passenger car heavy
1929

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 
Seed(11)
contact := Contact()
fmt.Println(contact.Phone)
fmt.Println(contact.Email)

Output:

8812527598
ramonblack@rutherford.io

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 
Seed(11)
ccInfo := CreditCard()
fmt.Println(ccInfo.Type)
fmt.Println(ccInfo.Number)
fmt.Println(ccInfo.Exp)
fmt.Println(ccInfo.Cvv)

Output:

American Express
6376095989079994
06/30
125

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 
Seed(11)
currency := Currency()
fmt.Println(currency.Short)
fmt.Println(currency.Long)

Output:

UGX
Uganda Shilling

type EmailOptions 

type EmailOptions struct {
}

EmailOptions defines values needed for email document generation

type Fakeable 

type Fakeable interface {
	// Fake returns a fake value for the type.
	Fake(faker *Faker) (any, error)
}

Fakeable is an interface that can be implemented by a type to provide a custom fake value.

Example 
var t1 testStruct1
var t2 testStruct1
var t3 testStruct2
var t4 testStruct2
New(314).Struct(&t1)
New(314).Struct(&t2)
New(314).Struct(&t3)
New(314).Struct(&t4)

fmt.Printf("%#v\n", t1)
fmt.Printf("%#v\n", t2)
fmt.Printf("%#v\n", t3)
fmt.Printf("%#v\n", t4)

Output:

gofakeit.testStruct1{B:"Bryce"}
gofakeit.testStruct1{B:"Bryce"}
gofakeit.testStruct2{B:"Bryce"}
gofakeit.testStruct2{B:"Bryce"}
Example (Employee) 
f1 := New(100)

// Fakes random values from the Gamma distribution
var A1 employee
var A2 employee
var A3 employee
f1.Struct(&A1)
f1.Struct(&A2)
f1.Struct(&A3)

fmt.Printf("%#v\n", A1)
fmt.Printf("%#v\n", A2)
fmt.Printf("%#v\n", A3)

Output:

gofakeit.employee{Name:"Julio Hicks", CallCountPerHour:17}
gofakeit.employee{Name:"Autumn Berge", CallCountPerHour:8}
gofakeit.employee{Name:"Mohammed Rutherford", CallCountPerHour:10}
Example (GammaFloat64) 
f1 := New(100)

// Fakes random values from the Gamma distribution
var A1 gammaFloat64
var A2 gammaFloat64
var A3 gammaFloat64
f1.Struct(&A1)
f1.Struct(&A2)
f1.Struct(&A3)

fmt.Println(A1)
fmt.Println(A2)
fmt.Println(A3)

Output:

1.9058272589164647
1.951453943304136
4.336093466276675

type Faker 

type Faker struct {
	Rand rand.Source

	// Lock to make thread safe
	Locked bool
	// contains filtered or unexported fields
}

Faker struct is the primary struct for using localized 

var GlobalFaker *Faker = New(0)

Create global variable to deal with global function call

func New 

func New(seed uint64) *Faker

New creates and returns a new Faker struct seeded with a given seed using the PCG algorithm in lock mode for thread safety

Example 
// Get new faker with default settings
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: Priscilla Thornton
Email: brookeduncan@maxwell.biz
Phone: 7598907999

func NewFaker 

func NewFaker(src rand.Source, lock bool) *Faker

NewFaker takes in a rand.Source and thread lock state and returns a new Faker struct

Example 
// Create new faker with ChaCha8, cryptographically secure
chacha := rand.NewChaCha8([32]byte{5, 4, 3, 2, 1, 0})
fake := NewFaker(chacha, true)

// or

// Create new faker with PCG, pseudo-random
pcg := rand.NewPCG(0, 0)
fake = NewFaker(pcg, false)

fmt.Println("Name:", fake.Name())

Output:

Name: Carey Ramirez

func (*Faker) APIUserAgent added in v7.11.0 

func (f *Faker) APIUserAgent() string

APIUserAgent will generate a random API user agent string

Example 
f := New(11)
fmt.Println(f.APIUserAgent())

Output:

httpie-go/8.1.2

func (*Faker) AchAccount 

func (f *Faker) AchAccount() string

AchAccount will generate a 12 digit account number

Example 
f := New(11)
fmt.Println(f.AchAccount())

Output:

881252759890

func (*Faker) AchRouting 

func (f *Faker) AchRouting() string

AchRouting will generate a 9 digit routing number

Example 
f := New(11)
fmt.Println(f.AchRouting())

Output:

881252759

func (*Faker) Address 

func (f *Faker) Address() *AddressInfo

Address will generate a struct of address information

Example 
f := New(11)
address := f.Address()
fmt.Println(address.Address)
fmt.Println(address.Street)
fmt.Println(address.Unit)
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:

125 East Routemouth, North Las Vegas, South Dakota 17999
125 East Routemouth

North Las Vegas
South Dakota
17999
Isle of Man
-79.948308
-60.019628

func (*Faker) Adjective 

func (f *Faker) Adjective() string

Adjective will generate a random adjective

Example 
f := New(11)
fmt.Println(f.Adjective())

Output:

none

func (*Faker) AdjectiveDemonstrative 

func (f *Faker) AdjectiveDemonstrative() string

AdjectiveDemonstrative will generate a random demonstrative adjective

Example 
f := New(11)
fmt.Println(f.AdjectiveDemonstrative())

Output:

it

func (*Faker) AdjectiveDescriptive 

func (f *Faker) AdjectiveDescriptive() string

AdjectiveDescriptive will generate a random descriptive adjective

Example 
f := New(11)
fmt.Println(f.AdjectiveDescriptive())

Output:

tired

func (*Faker) AdjectiveIndefinite 

func (f *Faker) AdjectiveIndefinite() string

AdjectiveIndefinite will generate a random indefinite adjective

Example 
f := New(11)
fmt.Println(f.AdjectiveIndefinite())

Output:

several

func (*Faker) AdjectiveInterrogative 

func (f *Faker) AdjectiveInterrogative() string

AdjectiveInterrogative will generate a random interrogative adjective

Example 
f := New(11)
fmt.Println(f.AdjectiveInterrogative())

Output:

which

func (*Faker) AdjectivePossessive 

func (f *Faker) AdjectivePossessive() string

AdjectivePossessive will generate a random possessive adjective

Example 
f := New(11)
fmt.Println(f.AdjectivePossessive())

Output:

their

func (*Faker) AdjectiveProper 

func (f *Faker) AdjectiveProper() string

AdjectiveProper will generate a random proper adjective

Example 
f := New(11)
fmt.Println(f.AdjectiveProper())

Output:

Swiss

func (*Faker) AdjectiveQuantitative 

func (f *Faker) AdjectiveQuantitative() string

AdjectiveQuantitative will generate a random quantitative adjective

Example 
f := New(11)
fmt.Println(f.AdjectiveQuantitative())

Output:

sparse

func (*Faker) Adverb 

func (f *Faker) Adverb() string

Adverb will generate a random adverb

Example 
f := New(11)
fmt.Println(f.Adverb())

Output:

ever

func (*Faker) AdverbDegree 

func (f *Faker) AdverbDegree() string

AdverbDegree will generate a random degree adverb

Example 
f := New(11)
fmt.Println(f.AdverbDegree())

Output:

too

func (*Faker) AdverbFrequencyDefinite 

func (f *Faker) AdverbFrequencyDefinite() string

AdverbFrequencyDefinite will generate a random frequency definite adverb

Example 
f := New(11)
fmt.Println(f.AdverbFrequencyDefinite())

Output:

yearly

func (*Faker) AdverbFrequencyIndefinite 

func (f *Faker) AdverbFrequencyIndefinite() string

AdverbFrequencyIndefinite will generate a random frequency indefinite adverb

Example 
f := New(11)
fmt.Println(f.AdverbFrequencyIndefinite())

Output:

generally

func (*Faker) AdverbManner 

func (f *Faker) AdverbManner() string

AdverbManner will generate a random manner adverb

Example 
f := New(11)
fmt.Println(f.AdverbManner())

Output:

tensely

func (*Faker) AdverbPlace 

func (f *Faker) AdverbPlace() string

AdverbPlace will generate a random place adverb

Example 
f := New(11)
fmt.Println(f.AdverbPlace())

Output:

under

func (*Faker) AdverbTimeDefinite 

func (f *Faker) AdverbTimeDefinite() string

AdverbTimeDefinite will generate a random time definite adverb

Example 
f := New(11)
fmt.Println(f.AdverbTimeDefinite())

Output:

yesterday

func (*Faker) AdverbTimeIndefinite 

func (f *Faker) AdverbTimeIndefinite() string

AdverbTimeIndefinite will generate a random time indefinite adverb

Example 
f := New(11)
fmt.Println(f.AdverbTimeIndefinite())

Output:

soon

func (*Faker) Age added in v7.10.0 

func (f *Faker) Age() int

Age will generate a random age between 0 and 100

Example 
f := New(11)
fmt.Println(f.Age())

Output:

90

func (*Faker) AirlineAircraftType added in v7.8.0 

func (f *Faker) AirlineAircraftType() string

AirlineAircraftType will generate a random aircraft type

Example 
f := New(11)
fmt.Println(f.AirlineAircraftType())

Output:

regional

func (*Faker) AirlineAirplane added in v7.8.0 

func (f *Faker) AirlineAirplane() string

AirlineAirplane will generate a random airplane model

Example 
f := New(11)
fmt.Println(f.AirlineAirplane())

Output:

De Havilland Dash 8

func (*Faker) AirlineAirport added in v7.8.0 

func (f *Faker) AirlineAirport() string

AirlineAirport will generate a random airport name

Example 
f := New(11)
fmt.Println(f.AirlineAirport())

Output:

Cairo International Airport

func (*Faker) AirlineAirportIATA added in v7.8.0 

func (f *Faker) AirlineAirportIATA() string

AirlineAirportIATA will generate a random airport IATA code

Example 
f := New(11)
fmt.Println(f.AirlineAirportIATA())

Output:

CAI

func (*Faker) AirlineFlightNumber added in v7.8.0 

func (f *Faker) AirlineFlightNumber() string

AirlineFlightNumber will generate a random flight number

Example 
f := New(11)
fmt.Println(f.AirlineFlightNumber())

Output:

US1996

func (*Faker) AirlineRecordLocator added in v7.8.0 

func (f *Faker) AirlineRecordLocator() string

AirlineRecordLocator will generate a random record locator (booking reference)

Example 
f := New(11)
fmt.Println(f.AirlineRecordLocator())

Output:

USKKBM

func (*Faker) AirlineSeat added in v7.8.0 

func (f *Faker) AirlineSeat() string

AirlineSeat will generate a random seat assignment

Example 
f := New(11)
fmt.Println(f.AirlineSeat())

Output:

54J

func (*Faker) Animal 

func (f *Faker) Animal() string

Animal will return a random animal

Example 
f := New(11)
fmt.Println(f.Animal())

Output:

turtle

func (*Faker) AnimalType 

func (f *Faker) AnimalType() string

AnimalType will return a random animal type

Example 
f := New(11)
fmt.Println(f.AnimalType())

Output:

reptiles

func (*Faker) AppAuthor 

func (f *Faker) AppAuthor() string

AppAuthor will generate a random company or person name

Example 
f := New(11)
fmt.Println(f.AppAuthor())

Output:

StreetEasy

func (*Faker) AppName 

func (f *Faker) AppName() string

AppName will generate a random app name

Example 
f := New(11)
fmt.Println(f.AppName())

Output:

Swanthink

func (*Faker) AppVersion 

func (f *Faker) AppVersion() string

AppVersion will generate a random app version

Example 
f := New(11)
fmt.Println(f.AppVersion())

Output:

5.18.4

func (*Faker) BS 

func (f *Faker) BS() string

BS will generate a random company bs string

Example 
f := New(11)
fmt.Println(f.BS())

Output:

models

func (*Faker) BankName added in v7.3.0 

func (f *Faker) BankName() string
Example 
f := New(11)
fmt.Println(f.BankName())

Output:

Toronto Dominion Bank

func (*Faker) BankType added in v7.3.0 

func (f *Faker) BankType() string
Example 
f := New(11)
fmt.Println(f.BankType())

Output:

Savings Bank

func (*Faker) BeerAlcohol 

func (f *Faker) BeerAlcohol() string

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

Example 
f := New(11)
fmt.Println(f.BeerAlcohol())

Output:

8.2%

func (*Faker) BeerBlg 

func (f *Faker) BeerBlg() string

BeerBlg will return a random beer blg between 5.0 and 20.0

Example 
f := New(11)
fmt.Println(f.BeerBlg())

Output:

16.6°Blg

func (*Faker) BeerHop 

func (f *Faker) BeerHop() string

BeerHop will return a random beer hop

Example 
f := New(11)
fmt.Println(f.BeerHop())

Output:

TriplePearl

func (*Faker) BeerIbu 

func (f *Faker) BeerIbu() string

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

Example 
f := New(11)
fmt.Println(f.BeerIbu())

Output:

91 IBU

func (*Faker) BeerMalt 

func (f *Faker) BeerMalt() string

BeerMalt will return a random beer malt

Example 
f := New(11)
fmt.Println(f.BeerMalt())

Output:

Munich

func (*Faker) BeerName 

func (f *Faker) BeerName() string

BeerName will return a random beer name

Example 
f := New(11)
fmt.Println(f.BeerName())

Output:

Sierra Nevada Bigfoot Barleywine Style Ale

func (*Faker) BeerStyle 

func (f *Faker) BeerStyle() string

BeerStyle will return a random beer style

Example 
f := New(11)
fmt.Println(f.BeerStyle())

Output:

Vegetable Beer

func (*Faker) BeerYeast 

func (f *Faker) BeerYeast() string

BeerYeast will return a random beer yeast

Example 
f := New(11)
fmt.Println(f.BeerYeast())

Output:

2308 - Munich Lager

func (*Faker) Bio added in v7.8.0 

func (f *Faker) Bio() string

Bio will generate a random biography using mad libs style templates

Example 
f := New(11)
fmt.Println(f.Bio())
fmt.Println(f.Bio())
fmt.Println(f.Bio())

Output:

Brews Fruit Beer while streaming Country, day job in Memphis as Musician
Singer with a soft spot for Diesel builds and hands-on Weaving in Laredo
Known for a hoodie look and a shelf of PaleGreen weasel art

func (*Faker) Bird 

func (f *Faker) Bird() string

Bird will return a random bird species

Example 
f := New(11)
fmt.Println(f.Bird())

Output:

toucan

func (*Faker) BitcoinAddress 

func (f *Faker) BitcoinAddress() string

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

Example 
f := New(11)
fmt.Println(f.BitcoinAddress())

Output:

1Lcy9SN3ffStpUpP0VlGp4oD9G7t083012

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 
f := New(11)
fmt.Println(f.BitcoinPrivateKey())

Output:

5JMZxkQX2PgaasaHc8wnWLNdMu7rxeU7xS64ev7RWNinacicPfm

func (*Faker) Blurb 

func (f *Faker) Blurb() string
Example 
f := New(11)
fmt.Println(f.Blurb())

Output:

Teamwork

func (*Faker) Book 

func (f *Faker) Book() *BookInfo
Example 
f := New(11)
book := f.Book()
fmt.Println(book.Title)
fmt.Println(book.Author)
fmt.Println(book.Genre)

Output:

Things Fall Apart
Toni Morrison
Erotic

func (*Faker) BookAuthor 

func (f *Faker) BookAuthor() string
Example 
f := New(11)
fmt.Println(f.BookAuthor())

Output:

Vladimir Nabokov

func (*Faker) BookGenre 

func (f *Faker) BookGenre() string
Example 
f := New(11)
fmt.Println(f.BookGenre())

Output:

Thriller

func (*Faker) BookTitle 

func (f *Faker) BookTitle() string
Example 
f := New(11)
fmt.Println(f.BookTitle())

Output:

Things Fall Apart

func (*Faker) Bool 

func (f *Faker) Bool() bool

Bool will generate a random boolean value

Example 
f := New(11)
fmt.Println(f.Bool())

Output:

false

func (*Faker) Breakfast 

func (f *Faker) Breakfast() string

Breakfast will return a random breakfast name

Example 
f := New(11)
fmt.Println(f.Breakfast())

Output:

Purple cow

func (*Faker) BuzzWord 

func (f *Faker) BuzzWord() string

BuzzWord will generate a random company buzz word string

Example 
f := New(11)
fmt.Println(f.BuzzWord())

Output:

open system

func (*Faker) CSV 

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

CSV generates an object or an array of objects in json format A nil CSVOptions returns a randomly structured CSV.

Example (Array) 
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,Priscilla,Thornton,3lGftNp9S908
2,Shaun,Byrd,Lc3G00tpPp7U
3,Grady,Craig,LGAvzZ5xUB6Z

func (*Faker) Car 

func (f *Faker) Car() *CarInfo

Car will generate a struct with car information

Example 
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:

Dacia
CNG
Santafe 4wd
Automatic
Passenger car heavy
1929

func (*Faker) CarFuelType 

func (f *Faker) CarFuelType() string

CarFuelType will return a random fuel type

Example 
f := New(11)
fmt.Println(f.CarFuelType())

Output:

Electric

func (*Faker) CarMaker 

func (f *Faker) CarMaker() string

CarMaker will return a random car maker

Example 
f := New(11)
fmt.Println(f.CarMaker())

Output:

Spyker

func (*Faker) CarModel 

func (f *Faker) CarModel() string

CarModel will return a random car model

Example 
f := New(11)
fmt.Println(f.CarModel())

Output:

Prius

func (*Faker) CarTransmissionType 

func (f *Faker) CarTransmissionType() string

CarTransmissionType will return a random transmission type

Example 
f := New(11)
fmt.Println(f.CarTransmissionType())

Output:

Manual

func (*Faker) CarType 

func (f *Faker) CarType() string

CarType will generate a random car type string

Example 
f := New(11)
fmt.Println(f.CarType())

Output:

Passenger car heavy

func (*Faker) Cat 

func (f *Faker) Cat() string

Cat will return a random cat breed

Example 
f := New(11)
fmt.Println(f.Cat())

Output:

Sokoke

func (*Faker) CelebrityActor 

func (f *Faker) CelebrityActor() string

CelebrityActor will generate a random celebrity actor

Example 
f := New(11)
fmt.Println(f.CelebrityActor())

Output:

Shah Rukh Khan

func (*Faker) CelebrityBusiness 

func (f *Faker) CelebrityBusiness() string

CelebrityBusiness will generate a random celebrity business person

Example 
f := New(11)
fmt.Println(f.CelebrityBusiness())

Output:

Prescott Bush

func (*Faker) CelebritySport 

func (f *Faker) CelebritySport() string

CelebritySport will generate a random celebrity sport person

Example 
f := New(11)
fmt.Println(f.CelebritySport())

Output:

Grete Waitz

func (*Faker) ChromeUserAgent 

func (f *Faker) ChromeUserAgent() string

ChromeUserAgent will generate a random chrome browser user agent string

Example 
f := New(11)
fmt.Println(f.ChromeUserAgent())

Output:

Mozilla/5.0 (Windows CE) AppleWebKit/5362 (KHTML, like Gecko) Chrome/36.0.820.0 Mobile Safari/5362

func (*Faker) City 

func (f *Faker) City() string

City will generate a random city string

Example 
f := New(11)
fmt.Println(f.City())

Output:

Reno

func (*Faker) Color 

func (f *Faker) Color() string

Color will generate a random color string

Example 
f := New(11)
fmt.Println(f.Color())

Output:

SlateGray

func (*Faker) Comment 

func (f *Faker) Comment() string

Comment will generate a random statement or remark expressing an opinion, observation, or reaction

Example 
f := New(11)
fmt.Println(f.Comment())

Output:

After seeing this fear, maybe drink the trip and adjust the here class

func (*Faker) Company 

func (f *Faker) Company() string

Company will generate a random company name string

Example 
f := New(11)
fmt.Println(f.Company())

Output:

TransparaGov

func (*Faker) CompanySuffix 

func (f *Faker) CompanySuffix() string

CompanySuffix will generate a random company suffix string

Example 
f := New(11)
fmt.Println(f.CompanySuffix())

Output:

Inc

func (*Faker) Connective 

func (f *Faker) Connective() string

Connective will generate a random connective

Example 
f := New(11)
fmt.Println(f.Connective())

Output:

through

func (*Faker) ConnectiveCasual 

func (f *Faker) ConnectiveCasual() string

ConnectiveCasual will generate a random casual connective

Example 
f := New(11)
fmt.Println(f.ConnectiveCasual())

Output:

though

func (*Faker) ConnectiveComparative 

func (f *Faker) ConnectiveComparative() string

ConnectiveComparative will generate a random comparative connective

Example 
f := New(11)
fmt.Println(f.ConnectiveComparative())

Output:

after all

func (*Faker) ConnectiveComplaint 

func (f *Faker) ConnectiveComplaint() string

ConnectiveComplaint will generate a random complaint connective

Example 
f := New(11)
fmt.Println(f.ConnectiveComplaint())

Output:

i.e.

func (*Faker) ConnectiveExamplify 

func (f *Faker) ConnectiveExamplify() string

ConnectiveExamplify will generate a random examplify connective

Example 
f := New(11)
fmt.Println(f.ConnectiveExamplify())

Output:

unless

func (*Faker) ConnectiveListing 

func (f *Faker) ConnectiveListing() string

ConnectiveListing will generate a random listing connective

Example 
f := New(11)
fmt.Println(f.ConnectiveListing())

Output:

in summation

func (*Faker) ConnectiveTime 

func (f *Faker) ConnectiveTime() string
Example 
f := New(11)
fmt.Println(f.ConnectiveTime())

Output:

when

func (*Faker) Contact 

func (f *Faker) Contact() *ContactInfo

Contact will generate a struct with information randomly populated contact information

Example 
f := New(11)
contact := f.Contact()
fmt.Println(contact.Phone)
fmt.Println(contact.Email)

Output:

8812527598
ramonblack@rutherford.io

func (*Faker) Country 

func (f *Faker) Country() string

Country will generate a random country string

Example 
f := New(11)
fmt.Println(f.Country())

Output:

Tonga

func (*Faker) CountryAbr 

func (f *Faker) CountryAbr() string

CountryAbr will generate a random abbreviated country string

Example 
f := New(11)
fmt.Println(f.CountryAbr())

Output:

TO

func (*Faker) CreditCard 

func (f *Faker) CreditCard() *CreditCardInfo

CreditCard will generate a struct full of credit card information

Example 
f := New(11)
ccInfo := f.CreditCard()
fmt.Println(ccInfo.Type)
fmt.Println(ccInfo.Number)
fmt.Println(ccInfo.Exp)
fmt.Println(ccInfo.Cvv)

Output:

American Express
6376095989079994
06/30
125

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 
f := New(11)
fmt.Println(f.CreditCardCvv())

Output:

881

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 
f := New(11)
fmt.Println(f.CreditCardExp())

Output:

11/34

func (*Faker) CreditCardNumber 

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

CreditCardNumber will generate a random luhn credit card number

Example 
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:

6376121252759896
6449344737930519
4111026894059156
6706 2052 5709 6

func (*Faker) CreditCardType 

func (f *Faker) CreditCardType() string

CreditCardType will generate a random credit card type string

Example 
f := New(11)
fmt.Println(f.CreditCardType())

Output:

Hiper

func (*Faker) Currency 

func (f *Faker) Currency() *CurrencyInfo

Currency will generate a struct with random currency information

Example 
f := New(11)
currency := f.Currency()
fmt.Println(currency.Short)
fmt.Println(currency.Long)

Output:

UGX
Uganda Shilling

func (*Faker) CurrencyLong 

func (f *Faker) CurrencyLong() string

CurrencyLong will generate a random long currency name

Example 
f := New(11)
fmt.Println(f.CurrencyLong())

Output:

Uganda Shilling

func (*Faker) CurrencyShort 

func (f *Faker) CurrencyShort() string

CurrencyShort will generate a random short currency value

Example 
f := New(11)
fmt.Println(f.CurrencyShort())

Output:

UGX

func (*Faker) Cusip 

func (f *Faker) Cusip() string
Example 
f := New(11)
fmt.Println(f.Cusip())

Output:

64HHTI0T8

func (*Faker) Date 

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

Date will generate a random time.Time struct

Example 
f := New(11)
fmt.Println(f.Date())

Output:

2012-11-07 04:31:13.726582492 +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 
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-03-26 09:20:49.250961474 +0000 UTC

func (*Faker) Day 

func (f *Faker) Day() int

Day will generate a random day between 1 - 31

Example 
f := New(11)
fmt.Println(f.Day())

Output:

28

func (*Faker) Dessert 

func (f *Faker) Dessert() string

Dessert will return a random dessert name

Example 
f := New(11)
fmt.Println(f.Dessert())

Output:

Amish cream pie

func (*Faker) Dice 

func (f *Faker) Dice(numDice uint, sides []uint) []uint

Dice will generate a random set of dice

Example 
f := New(11)
fmt.Println(f.Dice(1, []uint{6}))

Output:

[6]

func (*Faker) Digit 

func (f *Faker) Digit() string

Digit will generate a single ASCII digit

Example 
f := New(11)
fmt.Println(f.Digit())

Output:

8

func (*Faker) DigitN 

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

DigitN will generate a random string of length N consists of ASCII digits. Note that the string generated can start with 0 and this function returns a string with a length of 1 when 0 is passed.

Example 
f := New(11)
fmt.Println(f.DigitN(10))

Output:

8812527598

func (*Faker) Dinner 

func (f *Faker) Dinner() string

Dinner will return a random dinner name

Example 
f := New(11)
fmt.Println(f.Dinner())

Output:

German apple cake with cream cheese frosting

func (*Faker) Dog 

func (f *Faker) Dog() string

Dog will return a random dog breed

Example 
f := New(11)
fmt.Println(f.Dog())

Output:

Rat Terrier

func (*Faker) DomainName 

func (f *Faker) DomainName() string

DomainName will generate a random url domain name

Example 
f := New(11)
fmt.Println(f.DomainName())

Output:

strategicinfrastructures.biz

func (*Faker) DomainSuffix 

func (f *Faker) DomainSuffix() string

DomainSuffix will generate a random domain suffix

Example 
f := New(11)
fmt.Println(f.DomainSuffix())

Output:

io

func (*Faker) Drink 

func (f *Faker) Drink() string

Drink will return a random drink name

Example 
f := New(11)
fmt.Println(f.Drink())

Output:

Wine

func (*Faker) EIN added in v7.7.0 

func (f *Faker) EIN() string

EIN will generate a random Employer Identification Number

Example 
f := New(11)
fmt.Println(f.EIN())

Output:

90-8125275

func (*Faker) Email 

func (f *Faker) Email() string

Email will generate a random email string

Example 
f := New(11)
fmt.Println(f.Email())

Output:

priscillathornton@duncan.biz

func (*Faker) EmailText 

func (f *Faker) EmailText(co *EmailOptions) (string, error)

EmailText will return a single random text email template document

Example 
f := New(11)

value, err := f.EmailText(&EmailOptions{})
if err != nil {
	fmt.Println(err)
}

fmt.Println(string(value))

Output:

Subject: Hi from Nannie!

Dear Duncan,

Greetings! I hope your day is going well.

I trust this email finds you well. Sending good vibes your way.

Warm starts beat cold company. Launch the person midweek for clarity. Automate problem recovery victoriously. Launch the life midweek for clarity.

Sometimes the point last never. Retire outdated life each quarter. Choose lovely defaults. Deliberately wake the part. Clear time were better than clever week.

Warm starts beat cold child. Systematically improve the woman yearly. Protect the place under grumpy load.

I'm curious to know what you think about it. If you have a moment, please feel free to check out the project on GitLab

Feel free to share your opinions with me. Looking forward to your feedback!

I appreciate your attention to this matter. Wishing you a wonderful day!

Warm regards
Jamal Elliott
janierussell@bailey.io
1-875-720-1747

func (*Faker) Emoji 

func (f *Faker) Emoji() string

Emoji will return a random fun emoji

Example 
f := New(11)
fmt.Println(f.Emoji())

Output:

🛫

func (*Faker) EmojiAlias 

func (f *Faker) EmojiAlias() string

EmojiAlias will return a random fun emoji alias

Example 
f := New(11)
fmt.Println(f.EmojiAlias())

Output:

key

func (*Faker) EmojiAnimal added in v7.8.0 

func (f *Faker) EmojiAnimal() string

EmojiAnimal will return a random animal emoji

Example 
f := New(11)
fmt.Println(f.EmojiAnimal())

Output:

🐌

func (*Faker) EmojiCategory 

func (f *Faker) EmojiCategory() string

EmojiCategory will return a random fun emoji category

Example 
f := New(11)
fmt.Println(f.EmojiCategory())

Output:

Flags

func (*Faker) EmojiClothing added in v7.8.0 

func (f *Faker) EmojiClothing() string

EmojiClothing will return a random clothing or accessory emoji

func (*Faker) EmojiCostume added in v7.8.0 

func (f *Faker) EmojiCostume() string

EmojiCostume will return a random costume/fantasy emoji

func (*Faker) EmojiElectronics added in v7.8.0 

func (f *Faker) EmojiElectronics() string

EmojiElectronics will return a random electronics/media device emoji

func (*Faker) EmojiFace added in v7.8.0 

func (f *Faker) EmojiFace() string

EmojiFace will return a random face emoji

func (*Faker) EmojiFlag added in v7.8.0 

func (f *Faker) EmojiFlag() string

EmojiFlag will return a random country flag emoji

Example 
f := New(11)
fmt.Println(f.EmojiFlag())

Output:

🇹🇴

func (*Faker) EmojiFood added in v7.8.0 

func (f *Faker) EmojiFood() string

EmojiFood will return a random food emoji

Example 
f := New(11)
fmt.Println(f.EmojiFood())

Output:

🍾

func (*Faker) EmojiGame added in v7.8.0 

func (f *Faker) EmojiGame() string

EmojiGame will return a random game/leisure emoji

func (*Faker) EmojiGesture added in v7.8.0 

func (f *Faker) EmojiGesture() string

EmojiGesture will return a random gesture emoji

func (*Faker) EmojiHand added in v7.8.0 

func (f *Faker) EmojiHand() string

EmojiHand will return a random hand emoji

func (*Faker) EmojiJob added in v7.8.0 

func (f *Faker) EmojiJob() string

EmojiJob will return a random job/occupation emoji

func (*Faker) EmojiLandmark added in v7.8.0 

func (f *Faker) EmojiLandmark() string

EmojiLandmark will return a random landmark or place emoji

func (*Faker) EmojiMusic added in v7.8.0 

func (f *Faker) EmojiMusic() string

EmojiMusic will return a random music-related emoji

Example 
f := New(11)
fmt.Println(f.EmojiMusic())

Output:

🎚️

func (*Faker) EmojiPerson added in v7.8.0 

func (f *Faker) EmojiPerson() string

EmojiPerson will return a random person variant emoji

func (*Faker) EmojiPlant added in v7.8.0 

func (f *Faker) EmojiPlant() string

EmojiPlant will return a random plant emoji

Example 
f := New(11)
fmt.Println(f.EmojiPlant())

Output:

🍁

func (*Faker) EmojiSentence added in v7.8.0 

func (f *Faker) EmojiSentence() string

EmojiSentence will return a random sentence with emojis interspersed

Example 
f := New(11)
fmt.Println(f.EmojiSentence())

Output:

Category: Symbols 📠.

func (*Faker) EmojiSport added in v7.8.0 

func (f *Faker) EmojiSport() string

EmojiSport will return a random sports emoji

func (*Faker) EmojiTag 

func (f *Faker) EmojiTag() string

EmojiTag will return a random fun emoji tag

Example 
f := New(11)
fmt.Println(f.EmojiTag())

Output:

password

func (*Faker) EmojiTools added in v7.8.0 

func (f *Faker) EmojiTools() string

EmojiTools will return a random tools/weapons emoji

func (*Faker) EmojiVehicle added in v7.8.0 

func (f *Faker) EmojiVehicle() string

EmojiVehicle will return a random vehicle/transport emoji

func (*Faker) EmojiWeather added in v7.8.0 

func (f *Faker) EmojiWeather() string

EmojiWeather will return a random weather/celestial emoji

func (*Faker) Error 

func (f *Faker) Error() error

Error will return a random generic error

Example 
f := New(11)
fmt.Println(f.Error())

Output:

variable assigned before declaration

func (*Faker) ErrorDatabase 

func (f *Faker) ErrorDatabase() error

ErrorDatabase will return a random database error

Example 
f := New(11)
fmt.Println(f.ErrorDatabase())

Output:

destination pointer is nil

func (*Faker) ErrorGRPC 

func (f *Faker) ErrorGRPC() error

ErrorGRPC will return a random gRPC error

Example 
f := New(11)
fmt.Println(f.ErrorGRPC())

Output:

connection refused

func (*Faker) ErrorHTTP 

func (f *Faker) ErrorHTTP() error

ErrorHTTP will return a random HTTP error

Example 
f := New(11)
fmt.Println(f.ErrorHTTP())

Output:

wrote more than the declared Content-Length

func (*Faker) ErrorHTTPClient 

func (f *Faker) ErrorHTTPClient() error

ErrorHTTPClient will return a random HTTP client error response (400-418)

Example 
f := New(11)
fmt.Println(f.ErrorHTTPClient())

Output:

expectation failed

func (*Faker) ErrorHTTPServer 

func (f *Faker) ErrorHTTPServer() error

ErrorHTTPServer will return a random HTTP server error response (500-511)

Example 
f := New(11)
fmt.Println(f.ErrorHTTPServer())

Output:

not extended

func (*Faker) ErrorObject 

func (f *Faker) ErrorObject() error

ErrorObject will return a random error object word

Example 
f := New(11)
fmt.Println(f.ErrorObject())

Output:

url

func (*Faker) ErrorRuntime 

func (f *Faker) ErrorRuntime() error

ErrorRuntime will return a random runtime error

Example 
f := New(11)
fmt.Println(f.ErrorRuntime())

Output:

expected 2 arguments, got 3

func (*Faker) ErrorValidation 

func (f *Faker) ErrorValidation() error

ErrorValidation will return a random validation error

Example 
f := New(11)
fmt.Println(f.ErrorValidation())

Output:

payment details cannot be verified

func (*Faker) Ethnicity added in v7.12.1 

func (f *Faker) Ethnicity() string

Ethnicity will generate a random ethnicity string

Example 
f := New(11)
fmt.Println(f.Ethnicity())

Output:

Swiss

func (*Faker) FarmAnimal 

func (f *Faker) FarmAnimal() string

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

Example 
f := New(11)
fmt.Println(f.FarmAnimal())

Output:

Sheep

func (*Faker) FileExtension 

func (f *Faker) FileExtension() string

FileExtension will generate a random file extension

Example 
f := New(11)
fmt.Println(f.FileExtension())

Output:

dtd

func (*Faker) FileMimeType 

func (f *Faker) FileMimeType() string

FileMimeType will generate a random mime file type

Example 
f := New(11)
fmt.Println(f.FileMimeType())

Output:

application/x-wri

func (*Faker) FirefoxUserAgent 

func (f *Faker) FirefoxUserAgent() string

FirefoxUserAgent will generate a random firefox broswer user agent string

Example 
f := New(11)
fmt.Println(f.FirefoxUserAgent())

Output:

Mozilla/5.0 (Windows CE; en-US; rv:1.9.3.20) Gecko/2012-11-07 Firefox/36.0

func (*Faker) FirstName 

func (f *Faker) FirstName() string

FirstName will generate a random first name

Example 
f := New(11)
fmt.Println(f.FirstName())

Output:

Priscilla

func (*Faker) FixedWidth 

func (f *Faker) FixedWidth(co *FixedWidthOptions) (string, error)

FixedWidth generates an table of random data in fixed width format A nil FixedWidthOptions returns a randomly structured FixedWidth.

Example 
f := New(11)

value, err := f.FixedWidth(&FixedWidthOptions{
	RowCount: 3,
	Fields: []Field{
		{Name: "Name", Function: "{firstname} {lastname}"},
		{Name: "Email", Function: "email"},
		{Name: "Password", Function: "password", Params: MapParams{"special": {"false"}}},
		{Name: "Age", Function: "{number:1,100}"},
	},
})
if err != nil {
	fmt.Println(err)
}

fmt.Println(string(value))

Output:

Name                   Email                          Password         Age
Priscilla Thornton     laurelmcclure@wiley.org        L43ypoSV1tDf     62
Brooke Duncan          ramonblack@rutherford.io       rSM78E2ncUt3     9
Gregg Ford             roxannewalsh@hamilton.name     DUB69zQ1WZx8     77

func (*Faker) FlipACoin 

func (f *Faker) FlipACoin() string

FlipACoin will return a random value of Heads or Tails

Example 
f := New(11)
fmt.Println(f.FlipACoin())

Output:

Tails

func (*Faker) Float32 

func (f *Faker) Float32() float32

Float32 will generate a random float32 value

Example 
f := New(11)
fmt.Println(f.Float32())

Output:

0.3462876

func (*Faker) Float32Range 

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

Float32Range will generate a random float32 value between min and max

Example 
f := New(11)
fmt.Println(f.Float32Range(0, 9999999))

Output:

3.4628758e+06

func (*Faker) Float64 

func (f *Faker) Float64() float64

Float64 will generate a random float64 value

Example 
f := New(11)
fmt.Println(f.Float64())

Output:

0.7703009321621068

func (*Faker) Float64Range 

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

Float64Range will generate a random float64 value between min and max

Example 
f := New(11)
fmt.Println(f.Float64Range(0, 9999999))

Output:

7.703008551320136e+06

func (*Faker) Fruit 

func (f *Faker) Fruit() string

Fruit will return a random fruit name

Example 
f := New(11)
fmt.Println(f.Fruit())

Output:

Redcurrant

func (*Faker) FutureDate 

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

FutureDate will generate a random future time.Time struct

Example 
f := New(11)
fmt.Println(f.FutureDate())

func (*Faker) Gamertag 

func (f *Faker) Gamertag() string

Gamertag will generate a random video game username

Example 
f := New(11)
fmt.Println(f.Gamertag())

Output:

TurkeyThinker

func (*Faker) Gender 

func (f *Faker) Gender() string

Gender will generate a random gender string

Example 
f := New(11)
fmt.Println(f.Gender())

Output:

female

func (*Faker) Generate 

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

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 
f := New(11)

genStr, _ := f.Generate("{firstname} {lastname} {email} #?#?#?")
fmt.Println(genStr)
genStr, _ = f.Generate("{sentence}")
fmt.Println(genStr)
genStr, _ = f.Generate("{shuffleints:[1,2,3]}")
fmt.Println(genStr)
genStr, _ = f.Generate("{randomint:[1,2,3,-4]}")
fmt.Println(genStr)
genStr, _ = f.Generate("{randomuint:[1,2,3,4]}")
fmt.Println(genStr)
genStr, _ = f.Generate("{number:1,50}")
fmt.Println(genStr)
genStr, _ = f.Generate("{shufflestrings:[key:value,int:string,1:2,a:b]}")
fmt.Println(genStr)

Output:

Laurel McClure sethsoto@wallace.com 8K8b1M
Automate problem recovery victoriously.
[2 3 1]
2
4
16
[int:string key:value a:b 1:2]

func (*Faker) HTTPMethod 

func (f *Faker) HTTPMethod() string

HTTPMethod will generate a random http method

Example 
f := New(11)
fmt.Println(f.HTTPMethod())

Output:

DELETE

func (*Faker) HTTPStatusCode 

func (f *Faker) HTTPStatusCode() int

HTTPStatusCode will generate a random status code

Example 
f := New(11)
fmt.Println(f.HTTPStatusCode())

Output:

502

func (*Faker) HTTPStatusCodeSimple 

func (f *Faker) HTTPStatusCodeSimple() int

HTTPStatusCodeSimple will generate a random simple status code

Example 
f := New(11)
fmt.Println(f.HTTPStatusCodeSimple())

Output:

500

func (*Faker) HTTPVersion 

func (f *Faker) HTTPVersion() string

HTTPVersion will generate a random http version

Example 
f := New(11)
fmt.Println(f.HTTPVersion())

Output:

HTTP/2.0

func (*Faker) HackerAbbreviation 

func (f *Faker) HackerAbbreviation() string

HackerAbbreviation will return a random hacker abbreviation

Example 
f := New(11)
fmt.Println(f.HackerAbbreviation())

Output:

SCSI

func (*Faker) HackerAdjective 

func (f *Faker) HackerAdjective() string

HackerAdjective will return a random hacker adjective

Example 
f := New(11)
fmt.Println(f.HackerAdjective())

Output:

solid state

func (*Faker) HackerNoun 

func (f *Faker) HackerNoun() string

HackerNoun will return a random hacker noun

Example 
f := New(11)
fmt.Println(f.HackerNoun())

Output:

circuit

func (*Faker) HackerPhrase 

func (f *Faker) HackerPhrase() string

HackerPhrase will return a random hacker sentence

Example 
f := New(11)
fmt.Println(f.HackerPhrase())

Output:

Use the optical CSS microchip, then you can write the open-source monitor!

func (*Faker) HackerVerb 

func (f *Faker) HackerVerb() string

HackerVerb will return a random hacker verb

Example 
f := New(11)
fmt.Println(f.HackerVerb())

Output:

lock

func (*Faker) HackeringVerb 

func (f *Faker) HackeringVerb() string

HackeringVerb will return a random hacker ingverb

Example 
f := New(11)
fmt.Println(f.HackeringVerb())

Output:

compressing

func (*Faker) HexColor 

func (f *Faker) HexColor() string

HexColor will generate a random hexadecimal color string

Example 
f := New(11)
fmt.Println(f.HexColor())

Output:

#ef759a

func (*Faker) HexUint 

func (f *Faker) HexUint(bitSize int) string

HexUint will generate a random uint hex value with "0x" prefix

Example 
f := New(11)
fmt.Println(f.HexUint(16))

Output:

0x425b

func (*Faker) HipsterParagraph 

func (f *Faker) HipsterParagraph() string

HipsterParagraph will generate a random hipster paragraph

Example 
f := New(11)
fmt.Println(f.HipsterParagraph())

Output:

Compared Care meets you probably haven't heard of them ethos. Single-origin austin, double why.

func (*Faker) HipsterSentence 

func (f *Faker) HipsterSentence() string

HipsterSentence will generate a random hipster sentence

Example 
f := New(11)
fmt.Println(f.HipsterSentence())

Output:

Soul loops with you probably haven't heard of them undertones.

func (*Faker) HipsterWord 

func (f *Faker) HipsterWord() string

HipsterWord will return a single hipster word

Example 
f := New(11)
fmt.Println(f.HipsterWord())

Output:

semiotics

func (*Faker) Hobby 

func (f *Faker) Hobby() string

Hobby will generate a random hobby string

Example 
f := New(11)
fmt.Println(f.Hobby())

Output:

Travel

func (*Faker) Hour 

func (f *Faker) Hour() int

Hour will generate a random hour - in military time

Example 
f := New(11)
fmt.Println(f.Hour())

Output:

21

func (*Faker) ID added in v7.9.0 

func (f *Faker) ID() string

ID will return a random unique identifier

Example 
f := New(11)
fmt.Println(f.ID())

Output:

nfrfzjsb87qckh6bpga2

func (*Faker) IPv4Address 

func (f *Faker) IPv4Address() string

IPv4Address will generate a random version 4 ip address

Example 
f := New(11)
fmt.Println(f.IPv4Address())

Output:

180.18.181.251

func (*Faker) IPv6Address 

func (f *Faker) IPv6Address() string

IPv6Address will generate a random version 6 ip address

Example 
f := New(11)
fmt.Println(f.IPv6Address())

Output:

ddb4:9212:aab5:87fb:4e33:17a4:f7b9:bf8e

func (*Faker) Image 

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

Image generates a random rgba image

Example 
f := New(11)
fmt.Println(f.Image(1, 1))

Output:

&{[180 18 181 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 
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 229 40 162 138 251 3 239 15 255 217]

func (*Faker) ImagePng 

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

ImagePng generates a random rgba png image

Example 
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 218 34 180 21 16 0 0 255 255 3 1 1 126 242 54 123 184 0 0 0 0 73 69 78 68 174 66 96 130]

func (*Faker) InputName 

func (f *Faker) InputName() string

InputName will return a random input field name

Example 
f := New(11)
fmt.Println(f.InputName())

Output:

message

func (*Faker) Int 

func (f *Faker) Int() int

Int will generate a random int value

func (*Faker) Int16 

func (f *Faker) Int16() int16

Int16 will generate a random int16 value

Example 
f := New(11)
fmt.Println(f.Int16())

Output:

23988

func (*Faker) Int32 

func (f *Faker) Int32() int32

Int32 will generate a random int32 value

Example 
f := New(11)
fmt.Println(f.Int32())

Output:

1923896103

func (*Faker) Int64 

func (f *Faker) Int64() int64

Int64 will generate a random int64 value

Example 
f := New(11)
fmt.Println(f.Int64())

Output:

7302769650322300340

func (*Faker) Int8 

func (f *Faker) Int8() int8

Int8 will generate a random Int8 value

Example 
f := New(11)
fmt.Println(f.Int8())

Output:

52

func (*Faker) IntN 

func (f *Faker) IntN(n int) int

IntN will generate a random int value between 0 and n

func (*Faker) IntRange 

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

IntRange will generate a random int value between min and max

Example 
f := New(11)
fmt.Println(f.IntRange(1, 10))

Output:

9

func (*Faker) Interjection 

func (f *Faker) Interjection() string

Interjection will generate a random word expressing emotion

Example 
f := New(11)
fmt.Println(f.Interjection())

Output:

alas

func (*Faker) Isin 

func (f *Faker) Isin() string
Example 
f := New(11)
fmt.Println(f.Isin())

Output:

TO4HHTI0T819

func (*Faker) JSON 

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

JSON generates an object or an array of objects in json format. A nil JSONOptions returns a randomly structured JSON.

Example (Array) 
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": "Priscilla",
        "last_name": "Thornton",
        "password": "3lGftNp9S908"
    },
    {
        "id": 2,
        "first_name": "Shaun",
        "last_name": "Byrd",
        "password": "Lc3G00tpPp7U"
    },
    {
        "id": 3,
        "first_name": "Grady",
        "last_name": "Craig",
        "password": "LGAvzZ5xUB6Z"
    }
]
Example (Object) 
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": "Priscilla",
    "last_name": "Thornton",
    "address": {
        "address": "52759 Stationside, San Diego, Oregon 99344",
        "street": "52759 Stationside",
        "unit": "",
        "city": "San Diego",
        "state": "Oregon",
        "zip": "99344",
        "country": "France",
        "latitude": 77.259885,
        "longitude": 101.656736
    },
    "password": "B4qp9aqaXYSA"
}

func (*Faker) Job 

func (f *Faker) Job() *JobInfo

Job will generate a struct with random job information

Example 
f := New(11)
jobInfo := f.Job()
fmt.Println(jobInfo.Company)
fmt.Println(jobInfo.Title)
fmt.Println(jobInfo.Descriptor)
fmt.Println(jobInfo.Level)

Output:

TransparaGov
Teacher
Deputy
Configuration

func (*Faker) JobDescriptor 

func (f *Faker) JobDescriptor() string

JobDescriptor will generate a random job descriptor string

Example 
f := New(11)
fmt.Println(f.JobDescriptor())

Output:

Strategic

func (*Faker) JobLevel 

func (f *Faker) JobLevel() string

JobLevel will generate a random job level string

Example 
f := New(11)
fmt.Println(f.JobLevel())

Output:

Solutions

func (*Faker) JobTitle 

func (f *Faker) JobTitle() string

JobTitle will generate a random job title string

Example 
f := New(11)
fmt.Println(f.JobTitle())

Output:

Traffic Controller

func (*Faker) Language 

func (f *Faker) Language() string

Language will return a random language

Example 
f := New(11)
fmt.Println(f.Language())

Output:

Turkish

func (*Faker) LanguageAbbreviation 

func (f *Faker) LanguageAbbreviation() string

LanguageAbbreviation will return a random language abbreviation

Example 
f := New(11)
fmt.Println(f.LanguageAbbreviation())

Output:

tr

func (*Faker) LanguageBCP 

func (f *Faker) LanguageBCP() string

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

Example 
f := New(11)
fmt.Println(f.LanguageBCP())

Output:

tr-TR

func (*Faker) LastName 

func (f *Faker) LastName() string

LastName will generate a random last name

Example 
f := New(11)
fmt.Println(f.LastName())

Output:

Wagner

func (*Faker) Latitude 

func (f *Faker) Latitude() float64

Latitude will generate a random latitude float64

Example 
f := New(11)
fmt.Println(f.Latitude())

Output:

48.654167

func (*Faker) LatitudeInRange 

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

LatitudeInRange will generate a random latitude within the input range

Example 
f := New(11)
lat, _ := f.LatitudeInRange(21, 42)
fmt.Println(lat)

Output:

37.176319

func (*Faker) Letter 

func (f *Faker) Letter() string

Letter will generate a single random lower case ASCII letter

Example 
f := New(11)
fmt.Println(f.Letter())

Output:

u

func (*Faker) LetterN 

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

LetterN will generate a random ASCII string with length N. Note that this function returns a string with a length of 1 when 0 is passed.

Example 
f := New(11)
fmt.Println(f.LetterN(10))

Output:

usKKbMlbxq

func (*Faker) Lexify 

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

Lexify will replace ? with random generated letters

Example 
f := New(11)
fmt.Println(f.Lexify("?????"))

Output:

usKKb

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 
f := New(11)
fmt.Println(f.LogLevel("")) // This will also use general
fmt.Println(f.LogLevel("syslog"))
fmt.Println(f.LogLevel("apache"))

Output:

debug
crit
alert

func (*Faker) Longitude 

func (f *Faker) Longitude() float64

Longitude will generate a random longitude float64

Example 
f := New(11)
fmt.Println(f.Longitude())

Output:

97.308335

func (*Faker) LongitudeInRange 

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

LongitudeInRange will generate a random longitude within the input range

Example 
f := New(11)
long, _ := f.LongitudeInRange(-10, 10)
fmt.Println(long)

Output:

5.406018

func (*Faker) LoremIpsumParagraph 

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

LoremIpsumParagraph will generate a random paragraphGenerator

Example 
f := New(11)
fmt.Println(f.LoremIpsumParagraph(3, 5, 12, "\n"))

Output:

Eveniet vero velit velit non incidunt est sed tenetur consequatur ut architecto. Quod non non et voluptas et esse quisquam ullam placeat molestiae laboriosam. Consequatur in perferendis molestiae quam voluptatem eaque quia facilis quo hic dignissimos. Architecto ut tenetur aut qui et optio id sint quae rerum labore. Quae deserunt quia mollitia id accusantium itaque nisi aut omnis occaecati repellendus.
Ad sunt neque placeat et qui saepe voluptatem blanditiis voluptatum possimus saepe. Velit distinctio quia quas cupiditate sequi dolorum delectus quia quo corrupti labore. Aut mollitia et aut eligendi blanditiis corrupti aut rem voluptatibus veritatis ut. Et ab voluptas delectus repellat eligendi qui eos blanditiis et et eos. Qui ipsum aut ut voluptate nulla officia qui earum repudiandae quidem officia.
Fugit esse beatae placeat nihil libero et sunt voluptas velit maiores voluptatem. Reiciendis quia dolor amet blanditiis labore eligendi fugit reiciendis modi est incidunt. Ut ut rerum odit sit voluptatem ipsam consequatur est incidunt aut quis. Non dolorem voluptatum pariatur esse eos blanditiis rem eos commodi accusamus occaecati. Qui voluptatem eos et tempora et id at voluptas suscipit magni cupiditate.

func (*Faker) LoremIpsumSentence 

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

LoremIpsumSentence will generate a random sentence

Example 
f := New(11)
fmt.Println(f.LoremIpsumSentence(5))

Output:

Eveniet vero velit velit non.

func (*Faker) LoremIpsumWord 

func (f *Faker) LoremIpsumWord() string

LoremIpsumWord will generate a random word

Example 
f := New(11)
fmt.Println(f.LoremIpsumWord())

Output:

eveniet

func (*Faker) Lunch 

func (f *Faker) Lunch() string

Lunch will return a random lunch name

Example 
f := New(11)
fmt.Println(f.Lunch())

Output:

Quick chile relleno casserole

func (*Faker) MacAddress 

func (f *Faker) MacAddress() string

MacAddress will generate a random mac address

Example 
f := New(11)
fmt.Println(f.MacAddress())

Output:

e4:da:32:33:86:3b

func (*Faker) Map 

func (f *Faker) Map() map[string]any

Map will generate a random set of map data

Example 
f := New(11)
fmt.Println(f.Map())

Output:

map[a:map[that:could] above:[sometimes vast whom us scarcely these huh] am:map[how:9310653] depend:map[hey:5402877] out:381794.78 since:916659.94 these:map[frequently:2314010]]

func (*Faker) Markdown 

func (f *Faker) Markdown(co *MarkdownOptions) (string, error)

Markdown will return a single random Markdown template document

Example 
f := New(11)

value, err := f.Markdown(&MarkdownOptions{})
if err != nil {
	fmt.Println(err)
}

fmt.Println(string(value))

Output:

# TurkeyThinker

*Author: Roxane Webb*

He open safely to stabilize the world. Automate problem recovery gracefully. Choose lovely defaults. Deliberately wake the part. Clear time were better than clever week.

Warm starts beat cold child. Systematically improve the woman yearly. Protect the place under grumpy load.

## Table of Contents
- [Installation](#installation)
- [Usage](#usage)
- [License](#license)

## Installation
'''bash
pip install TurkeyThinker
'''

## Usage
'''python
result = turkeythinker.handle("whimsical story")
print("turkeythinker result:", "terminated")
'''

## License
BSD-3-Clause

func (*Faker) MiddleName 

func (f *Faker) MiddleName() string

MiddleName will generate a random middle name

Example 
f := New(11)
fmt.Println(f.MiddleName())

Output:

Jose

func (*Faker) MinecraftAnimal 

func (f *Faker) MinecraftAnimal() string

MinecraftAnimal will generate a random Minecraft animal

Example 
f := New(11)
fmt.Println(f.MinecraftAnimal())

Output:

wolf

func (*Faker) MinecraftArmorPart 

func (f *Faker) MinecraftArmorPart() string

MinecraftArmorPart will generate a random Minecraft armor part

Example 
f := New(11)
fmt.Println(f.MinecraftArmorPart())

Output:

helmet

func (*Faker) MinecraftArmorTier 

func (f *Faker) MinecraftArmorTier() string

MinecraftArmorTier will generate a random Minecraft armor tier

Example 
f := New(11)
fmt.Println(f.MinecraftArmorTier())

Output:

netherite

func (*Faker) MinecraftBiome 

func (f *Faker) MinecraftBiome() string

MinecraftBiome will generate a random Minecraft biome

Example 
f := New(11)
fmt.Println(f.MinecraftBiome())

Output:

the nether

func (*Faker) MinecraftDye 

func (f *Faker) MinecraftDye() string

MinecraftDye will generate a random Minecraft dye

Example 
f := New(11)
fmt.Println(f.MinecraftDye())

Output:

yellow

func (*Faker) MinecraftFood 

func (f *Faker) MinecraftFood() string

MinecraftFood will generate a random Minecraft food

Example 
f := New(11)
fmt.Println(f.MinecraftFood())

Output:

steak

func (*Faker) MinecraftMobBoss 

func (f *Faker) MinecraftMobBoss() string

MinecraftMobBoss will generate a random Minecraft mob boss

Example 
f := New(11)
fmt.Println(f.MinecraftMobBoss())

Output:

ender dragon

func (*Faker) MinecraftMobHostile 

func (f *Faker) MinecraftMobHostile() string

MinecraftMobHostile will generate a random Minecraft mob hostile

Example 
f := New(11)
fmt.Println(f.MinecraftMobHostile())

Output:

wither skeleton

func (*Faker) MinecraftMobNeutral 

func (f *Faker) MinecraftMobNeutral() string

MinecraftMobNeutral will generate a random Minecraft mob neutral

Example 
f := New(11)
fmt.Println(f.MinecraftMobNeutral())

Output:

wolf

func (*Faker) MinecraftMobPassive 

func (f *Faker) MinecraftMobPassive() string

MinecraftMobPassive will generate a random Minecraft mob passive

Example 
f := New(11)
fmt.Println(f.MinecraftMobPassive())

Output:

turtle

func (*Faker) MinecraftOre 

func (f *Faker) MinecraftOre() string

MinecraftOre will generate a random Minecraft ore

Example 
f := New(11)
fmt.Println(f.MinecraftOre())

Output:

redstone

func (*Faker) MinecraftTool 

func (f *Faker) MinecraftTool() string

MinecraftTool will generate a random Minecraft tool

Example 
f := New(11)
fmt.Println(f.MinecraftTool())

Output:

fishing rod

func (*Faker) MinecraftVillagerJob 

func (f *Faker) MinecraftVillagerJob() string

MinecraftVillagerJob will generate a random Minecraft villager job

Example 
f := New(11)
fmt.Println(f.MinecraftVillagerJob())

Output:

toolsmith

func (*Faker) MinecraftVillagerLevel 

func (f *Faker) MinecraftVillagerLevel() string

MinecraftVillagerLevel will generate a random Minecraft villager level

Example 
f := New(11)
fmt.Println(f.MinecraftVillagerLevel())

Output:

master

func (*Faker) MinecraftVillagerStation 

func (f *Faker) MinecraftVillagerStation() string

MinecraftVillagerStation will generate a random Minecraft villager station

Example 
f := New(11)
fmt.Println(f.MinecraftVillagerStation())

Output:

stonecutter

func (*Faker) MinecraftWeapon 

func (f *Faker) MinecraftWeapon() string

MinecraftWeapon will generate a random Minecraft weapon

Example 
f := New(11)
fmt.Println(f.MinecraftWeapon())

Output:

shield

func (*Faker) MinecraftWeather 

func (f *Faker) MinecraftWeather() string

MinecraftWeather will generate a random Minecraft weather

Example 
f := New(11)
fmt.Println(f.MinecraftWeather())

Output:

thunder

func (*Faker) MinecraftWood 

func (f *Faker) MinecraftWood() string

MinecraftWood will generate a random Minecraft wood

Example 
f := New(11)
fmt.Println(f.MinecraftWood())

Output:

dark oak

func (*Faker) Minute 

func (f *Faker) Minute() int

Minute will generate a random minute

Example 
f := New(11)
fmt.Println(f.Minute())

Output:

53

func (*Faker) Month 

func (f *Faker) Month() int

Month will generate a random month int

Example 
f := New(11)
fmt.Println(f.Month())

Output:

11

func (*Faker) MonthString 

func (f *Faker) MonthString() string

MonthString will generate a random month string

Example 
f := New(11)
fmt.Println(f.MonthString())

Output:

November

func (*Faker) Movie 

func (f *Faker) Movie() *MovieInfo
Example 
f := New(11)
movie := f.Movie()
fmt.Println(movie.Name)
fmt.Println(movie.Genre)

Output:

The Terminator
Sport

func (*Faker) MovieGenre 

func (f *Faker) MovieGenre() string
Example 
f := New(11)
fmt.Println(f.MovieGenre())

Output:

Thriller

func (*Faker) MovieName 

func (f *Faker) MovieName() string
Example 
f := New(11)
fmt.Println(f.MovieName())

Output:

The Terminator

func (*Faker) Name 

func (f *Faker) Name() string

Name will generate a random First and Last Name

Example 
f := New(11)
fmt.Println(f.Name())

Output:

Priscilla Thornton

func (*Faker) NamePrefix 

func (f *Faker) NamePrefix() string

NamePrefix will generate a random name prefix

Example 
f := New(11)
fmt.Println(f.NamePrefix())

Output:

Dr.

func (*Faker) NameSuffix 

func (f *Faker) NameSuffix() string

NameSuffix will generate a random name suffix

Example 
f := New(11)
fmt.Println(f.NameSuffix())

Output:

PhD

func (*Faker) NanoSecond 

func (f *Faker) NanoSecond() int

NanoSecond will generate a random nano second

Example 
f := New(11)
fmt.Println(f.NanoSecond())

Output:

895883936

func (*Faker) NiceColors 

func (f *Faker) NiceColors() []string

NiceColor will generate a random safe color string

Example 
f := New(11)
fmt.Println(f.NiceColors())

Output:

[#fffbb7 #a6f6af #66b6ab #5b7c8d #4f2958]

func (*Faker) Noun 

func (f *Faker) Noun() string

Noun will generate a random noun

Example 
f := New(11)
fmt.Println(f.Noun())

Output:

nest

func (*Faker) NounAbstract 

func (f *Faker) NounAbstract() string

NounAbstract will generate a random abstract noun

Example 
f := New(11)
fmt.Println(f.NounAbstract())

Output:

speed

func (*Faker) NounCollectiveAnimal 

func (f *Faker) NounCollectiveAnimal() string

NounCollectiveAnimal will generate a random collective noun animal

Example 
f := New(11)
fmt.Println(f.NounCollectiveAnimal())

Output:

leap

func (*Faker) NounCollectivePeople 

func (f *Faker) NounCollectivePeople() string

NounCollectivePeople will generate a random collective noun person

Example 
f := New(11)
fmt.Println(f.NounCollectivePeople())

Output:

posse

func (*Faker) NounCollectiveThing 

func (f *Faker) NounCollectiveThing() string

NounCollectiveThing will generate a random collective noun thing

Example 
f := New(11)
fmt.Println(f.NounCollectiveThing())

Output:

hail

func (*Faker) NounCommon 

func (f *Faker) NounCommon() string

NounCommon will generate a random common noun

Example 
f := New(11)
fmt.Println(f.NounCommon())

Output:

group

func (*Faker) NounConcrete 

func (f *Faker) NounConcrete() string

NounConcrete will generate a random concrete noun

Example 
f := New(11)
fmt.Println(f.NounConcrete())

Output:

theater

func (*Faker) NounCountable 

func (f *Faker) NounCountable() string

NounCountable will generate a random countable noun

Example 
f := New(11)
fmt.Println(f.NounCountable())

Output:

smile

func (*Faker) NounDeterminer 

func (f *Faker) NounDeterminer() string

NounDeterminer will generate a random noun determiner

Example 
f := New(11)
fmt.Println(f.NounDeterminer())

Output:

every

func (*Faker) NounProper 

func (f *Faker) NounProper() string

NounProper will generate a random proper noun

Example 
f := New(11)
fmt.Println(f.NounProper())

Output:

Nannie

func (*Faker) NounUncountable 

func (f *Faker) NounUncountable() string

NounUncountable will generate a random uncountable noun

Example 
f := New(11)
fmt.Println(f.NounUncountable())

Output:

usage

func (*Faker) Number 

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

Number will generate a random number between given min and max

Example 
f := New(11)
fmt.Println(f.Number(50, 23456))

Output:

21019

func (*Faker) Numerify 

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

Numerify will replace # with random numerical values

Example 
f := New(11)
fmt.Println(f.Numerify("###-###-####"))

Output:

881-252-7598

func (*Faker) OperaUserAgent 

func (f *Faker) OperaUserAgent() string

OperaUserAgent will generate a random opera browser user agent string

Example 
f := New(11)
fmt.Println(f.OperaUserAgent())

Output:

Opera/10.91 (X11; Linux i686; en-US) Presto/2.12.265 Version/11.00

func (*Faker) Paragraph 

func (f *Faker) Paragraph(paragraphCount ...any) string

Paragraph will generate a random paragraph Deprecated: The parameters are ignored and will be removed in the next major release.

Example 
f := New(11)
fmt.Println(f.Paragraph())

Output:

Publish a changelog entry for the day. Steady jittery progress in Denver should visible.

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 
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:

tcvncypbfolpftvlyplgdxiwibpsautg
ZXVXDVFQGCECFDBRWEKPWATHKRGKWDIZ
78902501101475351179812748788830
!!._-._*--@@.@---@_@.-_!_!-*_!*@
96 rvcB@f0.PNzL!qp 7hP_V 7g!vV 9
6hJDB

func (*Faker) PastDate 

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

PastDate will generate a random past time.Time struct

Example 
f := New(11)
fmt.Println(f.PastDate())

func (*Faker) Person 

func (f *Faker) Person() *PersonInfo

Person will generate a struct with person information

Example 
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.Age)
fmt.Println(person.SSN)
fmt.Println(person.Hobby)

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:

Priscilla
Thornton
male
20
575624882
Cosplaying
Qado Energy, Inc.
Nail Technician
Technical
Quality
79993 Lanebury, Lincoln, Kansas 93050
79993 Lanebury
Lincoln
Kansas
93050
India
-26.936948
-28.374174
2689405915
elsareynolds@nichols.io
American Express
4570938757201747
11/28
205

func (*Faker) PetName 

func (f *Faker) PetName() string

PetName will return a random fun pet name

Example 
f := New(11)
fmt.Println(f.PetName())

Output:

The Notorious D.O.G.

func (*Faker) Phone 

func (f *Faker) Phone() string

Phone will generate a random phone number string

Example 
f := New(11)
fmt.Println(f.Phone())

Output:

8812527598

func (*Faker) PhoneFormatted 

func (f *Faker) PhoneFormatted() string

PhoneFormatted will generate a random phone number string

Example 
f := New(11)
fmt.Println(f.PhoneFormatted())

Output:

812-527-5989

func (*Faker) Phrase 

func (f *Faker) Phrase() string

Phrase will return a random phrase

Example 
f := New(11)
fmt.Println(f.Phrase())

Output:

how many siblings do you have

func (*Faker) PhraseAdverb 

func (f *Faker) PhraseAdverb() string

PhraseAdverb will return a random adverb phrase

Example 
f := New(11)
fmt.Println(f.PhraseAdverb())

Output:

successfully

func (*Faker) PhraseNoun 

func (f *Faker) PhraseNoun() string

PhraseNoun will return a random noun phrase

Example 
f := New(11)
fmt.Println(f.PhraseNoun())

Output:

a fear

func (*Faker) PhrasePreposition 

func (f *Faker) PhrasePreposition() string

PhrasePreposition will return a random preposition phrase

Example 
f := New(11)
fmt.Println(f.PhrasePreposition())

Output:

with an archipelago

func (*Faker) PhraseVerb 

func (f *Faker) PhraseVerb() string

PhraseVerb will return a random preposition phrase

Example 
f := New(11)
fmt.Println(f.PhraseVerb())

Output:

bathe the jittery trip totally brightly under a troubling part scarcely unexpectedly

func (*Faker) Preposition 

func (f *Faker) Preposition() string

Preposition will generate a random preposition

Example 
f := New(11)
fmt.Println(f.Preposition())

Output:

instead of

func (*Faker) PrepositionCompound 

func (f *Faker) PrepositionCompound() string

PrepositionCompound will generate a random compound preposition

Example 
f := New(11)
fmt.Println(f.PrepositionCompound())

Output:

other than

func (*Faker) PrepositionDouble 

func (f *Faker) PrepositionDouble() string

PrepositionDouble will generate a random double preposition

Example 
f := New(11)
fmt.Println(f.PrepositionDouble())

Output:

next to

func (*Faker) PrepositionSimple 

func (f *Faker) PrepositionSimple() string

PrepositionSimple will generate a random simple preposition

Example 
f := New(11)
fmt.Println(f.PrepositionSimple())

Output:

with

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 
f := New(11)
fmt.Printf("%.2f", f.Price(0.8618, 1000))

Output:

770.49

func (*Faker) Product 

func (f *Faker) Product() *ProductInfo

Product will generate a random set of product information

Example 
f := New(11)
product := f.Product()
fmt.Println(product.Name)
fmt.Println(product.Description)
fmt.Println(product.Categories)
fmt.Println(product.Price)
fmt.Println(product.Features)
fmt.Println(product.Color)
fmt.Println(product.Material)
fmt.Println(product.UPC)
fmt.Println(product.Audience)
fmt.Println(product.Dimension)
fmt.Println(product.UseCase)
fmt.Println(product.Benefit)
fmt.Println(product.Suffix)

Output:

Upgradeable Side Table
This upset product is crafted from gel and includes 4k ready, making it perfect for learning and delivering advanced technology for gamers and DIY enthusiasts.
[smart home devices camping gear]
73.93
[multi-functional self-adjusting water-resistant underwater-capable]
maroon
oak wood
041026894059
[photographers travelers]
regular
dining
aesthetic appeal
plus

func (*Faker) ProductAudience added in v7.1.0 

func (f *Faker) ProductAudience() []string

ProductAudience will generate a random target audience

Example 
f := New(11)
fmt.Println(f.ProductAudience())

Output:

[students collectors]

func (*Faker) ProductBenefit added in v7.1.0 

func (f *Faker) ProductBenefit() string

ProductBenefit will generate a random product benefit

Example 
f := New(11)
fmt.Println(f.ProductBenefit())

Output:

time-saving

func (*Faker) ProductCategory 

func (f *Faker) ProductCategory() string

ProductCategory will generate a random product category

Example 
f := New(11)
fmt.Println(f.ProductCategory())

Output:

tableware

func (*Faker) ProductDescription 

func (f *Faker) ProductDescription() string

ProductDescription will generate a random product description

Example 
f := New(11)
fmt.Println(f.ProductDescription())

Output:

This product, ideal for collectors and hobbyists, features puzzled mica and incorporates water-resistant to ensure safety during sports.

func (*Faker) ProductDimension added in v7.1.0 

func (f *Faker) ProductDimension() string

ProductDimension will generate a random product dimension

Example 
f := New(11)
fmt.Println(f.ProductDimension())

Output:

x-small

func (*Faker) ProductFeature 

func (f *Faker) ProductFeature() string

ProductFeature will generate a random product feature

Example 
f := New(11)
fmt.Println(f.ProductFeature())

Output:

ultrasonic

func (*Faker) ProductISBN added in v7.3.0 

func (f *Faker) ProductISBN(opts *ISBNOptions) string

ProductISBN13 will generate a random ISBN-13 string for the product

Example 
f := New(11)
fmt.Println(f.ProductISBN(&ISBNOptions{Version: "13", Separator: "-"}))

Output:

978-8-8125-2759-5
Example (Isbn10) 
f := New(11)
fmt.Println(f.ProductISBN(&ISBNOptions{Version: "10", Separator: "-"}))

Output:

8-8125-275-7

func (*Faker) ProductMaterial 

func (f *Faker) ProductMaterial() string

ProductMaterial will generate a random product material

Example 
f := New(11)
fmt.Println(f.ProductMaterial())

Output:

textile

func (*Faker) ProductName 

func (f *Faker) ProductName() string

ProductName will generate a random product name

Example 
f := New(11)
fmt.Println(f.ProductName())

Output:

Luxurious Trophy

func (*Faker) ProductSuffix added in v7.1.0 

func (f *Faker) ProductSuffix() string

ProductSuffix will generate a random product suffix

Example 
f := New(11)
fmt.Println(f.ProductSuffix())

Output:

turbo

func (*Faker) ProductUPC 

func (f *Faker) ProductUPC() string

ProductUPC will generate a random product UPC

Example 
f := New(11)
fmt.Println(f.ProductUPC())

Output:

088125275989

func (*Faker) ProductUseCase added in v7.1.0 

func (f *Faker) ProductUseCase() string

ProductUseCase will generate a random product use case

Example 
f := New(11)
fmt.Println(f.ProductUseCase())

Output:

sports

func (*Faker) ProgrammingLanguage 

func (f *Faker) ProgrammingLanguage() string

ProgrammingLanguage will return a random programming language

Example 
f := New(11)
fmt.Println(f.ProgrammingLanguage())

Output:

TELCOMP

func (*Faker) Pronoun 

func (f *Faker) Pronoun() string

Pronoun will generate a random pronoun

Example 
f := New(11)
fmt.Println(f.Pronoun())

Output:

some

func (*Faker) PronounDemonstrative 

func (f *Faker) PronounDemonstrative() string

PronounDemonstrative will generate a random demonstrative pronoun

Example 
f := New(11)
fmt.Println(f.PronounDemonstrative())

Output:

this

func (*Faker) PronounIndefinite 

func (f *Faker) PronounIndefinite() string

PronounIndefinite will generate a random indefinite pronoun

Example 
f := New(11)
fmt.Println(f.PronounIndefinite())

Output:

somebody

func (*Faker) PronounInterrogative 

func (f *Faker) PronounInterrogative() string

PronounInterrogative will generate a random interrogative pronoun

Example 
f := New(11)
fmt.Println(f.PronounInterrogative())

Output:

how

func (*Faker) PronounObject 

func (f *Faker) PronounObject() string

PronounObject will generate a random object pronoun

Example 
f := New(11)
fmt.Println(f.PronounObject())

Output:

them

func (*Faker) PronounPersonal 

func (f *Faker) PronounPersonal() string

PronounPersonal will generate a random personal pronoun

Example 
f := New(11)
fmt.Println(f.PronounPersonal())

Output:

they

func (*Faker) PronounPossessive 

func (f *Faker) PronounPossessive() string

PronounPossessive will generate a random possessive pronoun

Example 
f := New(11)
fmt.Println(f.PronounPossessive())

Output:

theirs

func (*Faker) PronounReflective 

func (f *Faker) PronounReflective() string

PronounReflective will generate a random reflective pronoun

Example 
f := New(11)
fmt.Println(f.PronounReflective())

Output:

itself

func (*Faker) PronounRelative 

func (f *Faker) PronounRelative() string

PronounRelative will generate a random relative pronoun

Example 
f := New(11)
fmt.Println(f.PronounRelative())

Output:

whomever

func (*Faker) Question 

func (f *Faker) Question() string

Question will return a random question

Example 
f := New(11)
fmt.Println(f.Question())

Output:

What is the marginal gain from fear?

func (*Faker) Quote 

func (f *Faker) Quote() string

Quote will return a random quote from a random person

Example 
f := New(11)
fmt.Println(f.Quote())

Output:

"Energy is contagious—so is fear"

func (*Faker) RGBColor 

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

RGBColor will generate a random int slice color

Example 
f := New(11)
fmt.Println(f.RGBColor())

Output:

[180 18 181]

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 
f := New(11)

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

Output:

8413

func (*Faker) RandomMapKey 

func (f *Faker) RandomMapKey(mapI any) any

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 
f := New(11)
fmt.Println(f.RandomString([]string{"hello", "world"}))

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 
f := New(11)

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

Output:

8413

func (*Faker) Regex 

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

Regex will generate a string based upon a RE2 syntax

Example 
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:

ffbbd
GSNYV
up
tyyxi@kshtyia.net

func (*Faker) SQL 

func (f *Faker) SQL(so *SQLOptions) (string, error)
Example 
f := New(11)

res, _ := f.SQL(&SQLOptions{
	Table: "people",
	Count: 2,
	Fields: []Field{
		{Name: "id", Function: "autoincrement"},
		{Name: "first_name", Function: "firstname"},
		{Name: "price", Function: "price"},
		{Name: "age", Function: "number", Params: MapParams{"min": {"1"}, "max": {"99"}}},
		{Name: "created_at", Function: "date", Params: MapParams{"format": {"2006-01-02 15:04:05"}}},
	},
})

fmt.Println(string(res))

Output:

INSERT INTO people (id, first_name, price, age, created_at) VALUES (1, 'Priscilla', 985.96, 20, '1925-07-08 17:32:57'),(2, 'Ramon', 639.32, 74, '2017-12-29 07:25:24');

func (*Faker) SSN 

func (f *Faker) SSN() string

SSN will generate a random Social Security Number

Example 
f := New(11)
fmt.Println(f.SSN())

Output:

906295542

func (*Faker) SafariUserAgent 

func (f *Faker) SafariUserAgent() string

SafariUserAgent will generate a random safari browser user agent string

Example 
f := New(11)
fmt.Println(f.SafariUserAgent())

Output:

Mozilla/5.0 (Windows; U; Windows NT 6.0) AppleWebKit/536.44.6 (KHTML, like Gecko) Version/4.1 Safari/536.44.6

func (*Faker) SafeColor 

func (f *Faker) SafeColor() string

SafeColor will generate a random safe color string

Example 
f := New(11)
fmt.Println(f.SafeColor())

Output:

aqua

func (*Faker) School 

func (f *Faker) School() string
Example 
f := New(11)
fmt.Println(f.School())

Output:

Hillside Private Academy

func (*Faker) Second 

func (f *Faker) Second() int

Second will generate a random second

Example 
f := New(11)
fmt.Println(f.Second())

Output:

53

func (*Faker) Seed 

func (f *Faker) Seed(args ...any) error

Seed attempts to seed the Faker with the given seed

func (*Faker) Sentence 

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

Sentence will generate a random sentence Deprecated: The wordCount parameter is ignored and will be removed in the next major release.

Example 
f := New(11)
fmt.Println(f.Sentence())

Output:

Weekends reserve time for Sun Bathing and day.

func (*Faker) ShuffleAnySlice 

func (f *Faker) ShuffleAnySlice(v any)

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

Example 
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:

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

func (*Faker) ShuffleInts 

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

ShuffleInts will randomize a slice of ints

Example 
f := New(11)

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

Output:

[941 777 8413 74125 854 89416 841657 52]

func (*Faker) ShuffleStrings 

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

ShuffleStrings will randomize a slice of strings

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

Output:

[for day happy everyone good times a have]

func (*Faker) Slice 

func (f *Faker) Slice(v any)

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

Example 
f := New(11)

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

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

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

Output:

[KKbMlbxqu mwwv WVlPmw AeAwVH Khrx DcxFeWk vChMCeKf BwRtnboOE mWluN]
[102 -7 -125]
Example (Struct) 
f := New(11)

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

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

fmt.Println(B)

Output:

[{Nannie 3680786209731553973 0.27238095} {Gregg 4268594234476337060 0.0051180124} {Hailie 8337306475187377941 0.118576884} {Ramon 1365845625386394310 0.27625358} {Roxane 7952567920265354269 0.648698} {Daija 7933890822314871011 0.37052673} {Lance 5542429450337529393 0.36615264} {Rocky 6292602578870227868 0.9382272} {Jace 229639691709918065 0.5914113}]

func (*Faker) Slogan 

func (f *Faker) Slogan() string

Slogan will generate a random company slogan

Example 
f := New(11)
fmt.Println(f.Slogan())

Output:

local area network maximize Drive, mission-critical.

func (*Faker) Snack 

func (f *Faker) Snack() string

Snack will return a random snack name

Example 
f := New(11)
fmt.Println(f.Snack())

Output:

Fantastic banana bran muffins

func (*Faker) SocialMedia added in v7.8.0 

func (f *Faker) SocialMedia() string

SocialMedia will generate a random social media string

Example 
f := New(11)
fmt.Println(f.SocialMedia())

Output:

https://linkedin.com/in/CuriosCasino7

func (*Faker) Song added in v7.2.0 

func (f *Faker) Song() *SongInfo
Example 
f := New(11)
song := f.Song()
fmt.Println(song.Name)
fmt.Println(song.Artist)
fmt.Println(song.Genre)

Output:

What Was I Made For?
Taylor Swift
Country

func (*Faker) SongArtist added in v7.2.0 

func (f *Faker) SongArtist() string
Example 
f := New(11)
fmt.Println(f.SongArtist())

Output:

The Jacksons

func (*Faker) SongGenre added in v7.2.0 

func (f *Faker) SongGenre() string
Example 
f := New(11)
fmt.Println(f.SongGenre())

Output:

Synthwave

func (*Faker) SongName added in v7.2.0 

func (f *Faker) SongName() string
Example 
f := New(11)
fmt.Println(f.SongName())

Output:

What Was I Made For?

func (*Faker) State 

func (f *Faker) State() string

State will generate a random state string

Example 
f := New(11)
fmt.Println(f.State())

Output:

Vermont

func (*Faker) StateAbr 

func (f *Faker) StateAbr() string

StateAbr will generate a random abbreviated state string

Example 
f := New(11)
fmt.Println(f.StateAbr())

Output:

WV

func (*Faker) Street 

func (f *Faker) Street() string

Street will generate a random address street string

Example 
f := New(11)
fmt.Println(f.Street())

Output:

125 East Routemouth

func (*Faker) StreetName 

func (f *Faker) StreetName() string

StreetName will generate a random address street name string

Example 
f := New(11)
fmt.Println(f.StreetName())

Output:

Turnpike

func (*Faker) StreetNumber 

func (f *Faker) StreetNumber() string

StreetNumber will generate a random address street number string

Example 
f := New(11)
fmt.Println(f.StreetNumber())

Output:

812

func (*Faker) StreetPrefix 

func (f *Faker) StreetPrefix() string

StreetPrefix will generate a random address street prefix string

Example 
f := New(11)
fmt.Println(f.StreetPrefix())

Output:

Port

func (*Faker) StreetSuffix 

func (f *Faker) StreetSuffix() string

StreetSuffix will generate a random address street suffix string

Example 
f := New(11)
fmt.Println(f.StreetSuffix())

Output:

side

func (*Faker) Struct 

func (f *Faker) Struct(v any) 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 
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"`
	ArrayRange []string          `fakesize:"2,6"`
	Map        map[string]string `fakesize:"2"`
	MapRange   map[string]string `fakesize:"2,4"`
	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.MapRange)
fmt.Printf("%+v\n", f.Bar)

Output:

sKKbMlbxqu
1365845625386394310
4415419407664574903
Roxane
10
<nil>
[RWVlPmwRAe wVHB]
map[gyJrZ:tfZAk oOEImWl:NXYnuKiGab]
map[WigEnVzBy:JJXMkG aHqIpyVs:UxvheGVE pYyDuWC:yzjqsX]
{Name:LfLRuhFRHQ Number:5737279083624806933 Float:0.59020466}
Example (Array) 
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"`
	NamesRange []string `fake:"{firstname}" fakesize:"3,6"`
}

var fm FooMany
f.Struct(&fm)

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

Output:

[{sKKbMlbxqu 1365845625386394310 Lesley 10 <nil>}]
[Roxanne Randy Daija]
[Edna Lance Colton Lila Rocky Danyka]

func (*Faker) Svg 

func (f *Faker) Svg(options *SVGOptions) string

Generate a random svg generator

Example 
f := New(11)
fmt.Println(f.Svg(nil))

Output:

<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 459 443" width="459" height="443"><rect x="0" y="0" width="100%" height="100%" fill="#64908a" /><circle cx="334" cy="238" r="437" fill="#cc2a41" /><circle cx="34" cy="328" r="428" fill="#cc2a41" /><circle cx="151" cy="190" r="191" fill="#e8caa4" /><circle cx="343" cy="410" r="156" fill="#351330" /><circle cx="5" cy="410" r="192" fill="#351330" /><circle cx="94" cy="286" r="384" fill="#cc2a41" /><circle cx="34" cy="239" r="439" fill="#351330" /><circle cx="199" cy="310" r="278" fill="#cc2a41" /><circle cx="293" cy="106" r="20" fill="#64908a" /><circle cx="275" cy="327" r="11" fill="#cc2a41" /><circle cx="406" cy="338" r="239" fill="#e8caa4" /><circle cx="41" cy="71" r="344" fill="#64908a" /><circle cx="411" cy="116" r="208" fill="#64908a" /><circle cx="410" cy="88" r="303" fill="#351330" /><circle cx="241" cy="69" r="285" fill="#cc2a41" /></svg>

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 
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:[Jeff Robert Billy] Team 2:[Connor Fabian Sharon] Team 3:[Justin Steve]]

func (*Faker) Template 

func (f *Faker) Template(template string, co *TemplateOptions) (string, error)

Template generates an document based on the the supplied template

Example 
f := New(11)

template := `{{range IntRange 1 4}}{{FirstName}} {{LastName}}\n{{end}}`

value, err := f.Template(template, &TemplateOptions{Data: 4})
if err != nil {
	fmt.Println(err)
}

fmt.Println(string(value))

Output:

Priscilla Thornton
Brooke Duncan
Gregg Ford
Laurel McClure

func (*Faker) TimeZone 

func (f *Faker) TimeZone() string

TimeZone will select a random timezone string

Example 
f := New(11)
fmt.Println(f.TimeZone())

Output:

West Pacific Standard Time

func (*Faker) TimeZoneAbv 

func (f *Faker) TimeZoneAbv() string

TimeZoneAbv will select a random timezone abbreviation string

Example 
f := New(11)
fmt.Println(f.TimeZoneAbv())

Output:

WPST

func (*Faker) TimeZoneFull 

func (f *Faker) TimeZoneFull() string

TimeZoneFull will select a random full timezone string

Example 
f := New(11)
fmt.Println(f.TimeZoneFull())

Output:

(UTC+10:00) Guam, Port Moresby

func (*Faker) TimeZoneOffset 

func (f *Faker) TimeZoneOffset() float32

TimeZoneOffset will select a random timezone offset

Example 
f := New(11)
fmt.Println(f.TimeZoneOffset())

Output:

10

func (*Faker) TimeZoneRegion 

func (f *Faker) TimeZoneRegion() string

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

Example 
f := New(11)
fmt.Println(f.TimeZoneRegion())

Output:

Indian/Chagos

func (*Faker) URL 

func (f *Faker) URL() string

URL will generate a random url string

Example 
f := New(11)
fmt.Println(f.URL())

Output:

http://www.deputyinnovative.biz/infrastructures

func (*Faker) UUID 

func (f *Faker) UUID() string

UUID (version 4) will generate a random unique identifier based upon random numbers

Example 
f := New(11)
fmt.Println(f.UUID())

Output:

b4ddf623-4ea6-48e5-9292-541f028d1fdb

func (*Faker) Uint 

func (f *Faker) Uint() uint

Uint will generate a random uint value

func (*Faker) Uint16 

func (f *Faker) Uint16() uint16

Uint16 will generate a random uint16 value

Example 
f := New(11)
fmt.Println(f.Uint16())

Output:

56756

func (*Faker) Uint32 

func (f *Faker) Uint32() uint32

Uint32 will generate a random uint32 value

Example 
f := New(11)
fmt.Println(f.Uint32())

Output:

3847792206

func (*Faker) Uint64 

func (f *Faker) Uint64() uint64

Uint64 will generate a random uint64 value This is the primary location in which the random number is generated. This will be the only location in which reading from Rand.Uint64() is lockable

Example 
f := New(11)
fmt.Println(f.Uint64())

Output:

16526141687177076148

func (*Faker) Uint8 

func (f *Faker) Uint8() uint8

Uint8 will generate a random uint8 value

Example 
f := New(11)
fmt.Println(f.Uint8())

Output:

180

func (*Faker) UintN 

func (f *Faker) UintN(n uint) uint

UintN will generate a random uint value between 0 and n

func (*Faker) UintRange 

func (f *Faker) UintRange(min, max uint) uint

UintRange will generate a random uint value between min and max

Example 
f := New(11)
fmt.Println(f.UintRange(1, 10))

Output:

9

func (*Faker) Unit added in v7.4.0 

func (f *Faker) Unit() string

Unit will generate a random unit string

Example 
f := New(11)
fmt.Println(f.Unit())

Output:

Penthouse 812

func (*Faker) UrlSlug added in v7.8.0 

func (f *Faker) UrlSlug(words int) string

UrlSlug will generate a random url slug with the specified number of words

Example 
f := New(11)
fmt.Println(f.UrlSlug(3))

Output:

bathe-regularly-quiver

func (*Faker) UserAgent 

func (f *Faker) UserAgent() string

UserAgent will generate a random broswer user agent

Example 
f := New(11)
fmt.Println(f.UserAgent())

Output:

Mozilla/5.0 (Windows 98) AppleWebKit/5360 (KHTML, like Gecko) Chrome/37.0.852.0 Mobile Safari/5360

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 
f := New(11)
fmt.Println(f.Username())

Output:

Gregg812

func (*Faker) Vegetable 

func (f *Faker) Vegetable() string

Vegetable will return a random vegetable name

Example 
f := New(11)
fmt.Println(f.Vegetable())

Output:

Sweet Potato

func (*Faker) Verb 

func (f *Faker) Verb() string

Verb will generate a random verb

Example 
f := New(11)
fmt.Println(f.Verb())

Output:

would

func (*Faker) VerbAction 

func (f *Faker) VerbAction() string

VerbAction will generate a random action verb

Example 
f := New(11)
fmt.Println(f.VerbAction())

Output:

paint

func (*Faker) VerbHelping 

func (f *Faker) VerbHelping() string

VerbHelping will generate a random helping verb

Example 
f := New(11)
fmt.Println(f.VerbHelping())

Output:

am

func (*Faker) VerbIntransitive 

func (f *Faker) VerbIntransitive() string

VerbIntransitive will generate a random intransitive verb

Example 
f := New(11)
fmt.Println(f.VerbIntransitive())

Output:

vomit

func (*Faker) VerbLinking 

func (f *Faker) VerbLinking() string

VerbLinking will generate a random linking verb

Example 
f := New(11)
fmt.Println(f.VerbLinking())

Output:

must

func (*Faker) VerbTransitive 

func (f *Faker) VerbTransitive() string

VerbTransitive will generate a random transitive verb

Example 
f := New(11)
fmt.Println(f.VerbTransitive())

Output:

upgrade

func (*Faker) Vowel 

func (f *Faker) Vowel() string

Vowel will generate a single random lower case vowel

Example 
f := New(11)
fmt.Println(f.Vowel())

Output:

a

func (*Faker) WeekDay 

func (f *Faker) WeekDay() string

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

Example 
f := New(11)
fmt.Println(f.WeekDay())

Output:

Saturday

func (*Faker) Weighted 

func (f *Faker) Weighted(options []any, weights []float32) (any, 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 
f := New(11)
fmt.Println(f.Word())

Output:

bathe

func (*Faker) XML 

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

XML generates an object or an array of objects in json format A nil XMLOptions returns a randomly structured XML.

Example (Array) 
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>Priscilla</first_name>
        <last_name>Thornton</last_name>
        <password>3lGftNp9S908</password>
    </record>
    <record>
        <first_name>Shaun</first_name>
        <last_name>Byrd</last_name>
        <password>Lc3G00tpPp7U</password>
    </record>
</xml>
Example (Single) 
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>Priscilla</first_name>
    <last_name>Thornton</last_name>
    <password>3lGftNp9S908</password>
</xml>

func (*Faker) Year 

func (f *Faker) Year() int

Year will generate a random year between 1900 - current year

Example 
f := New(11)
fmt.Println(f.Year())

Output:

2012

func (*Faker) Zip 

func (f *Faker) Zip() string

Zip will generate a random Zip code string

Example 
f := New(11)
fmt.Println(f.Zip())

Output:

81252

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 FixedWidthOptions 

type FixedWidthOptions struct {
	RowCount int     `json:"row_count" xml:"row_count" fake:"{number:1,10}"`
	Fields   []Field `json:"fields" xml:"fields" fake:"{fields}"`
}

FixedWidthOptions defines values needed for csv generation

type ISBNOptions added in v7.3.0 

type ISBNOptions struct {
	Version   string // "10" or "13"
	Separator string // e.g. "-", "" (default: "-")
}

type Info 

type Info struct {
	Display     string                                                `json:"display"`      // display name
	Category    string                                                `json:"category"`     // category
	Description string                                                `json:"description"`  // description
	Example     string                                                `json:"example"`      // example
	Output      string                                                `json:"output"`       // output type
	Aliases     []string                                              `json:"aliases"`      // alt names users might type
	Keywords    []string                                              `json:"keywords"`     // free words and domain terms
	ContentType string                                                `json:"content_type"` // content type
	Params      []Param                                               `json:"params"`       // params
	Any         any                                                   `json:"any"`          // any
	Generate    func(f *Faker, m *MapParams, info *Info) (any, error) `json:"-"`            // generate function
}

Info structures fields to better break down what each one generates

func GetFuncLookup 

func GetFuncLookup(functionName string) *Info

GetFuncLookup will lookup

func GetRandomSimpleFunc 

func GetRandomSimpleFunc(f *Faker) (string, Info)

func (*Info) GetAny 

func (i *Info) GetAny(m *MapParams, field string) (any, error)

GetAny will retrieve Any field from Info

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) GetMap 

func (i *Info) GetMap(m *MapParams, field string) (map[string]any, error)

GetMap will retrieve map[string]any 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

func (*Info) GetUintArray 

func (i *Info) GetUintArray(m *MapParams, field string) ([]uint, error)

GetUintArray will retrieve []uint field from data

type JSONOptions 

type JSONOptions struct {
	Type     string  `json:"type" xml:"type" fake:"{randomstring:[array,object]}"` // array or object
	RowCount int     `json:"row_count" xml:"row_count" fake:"{number:1,10}"`
	Indent   bool    `json:"indent" xml:"indent"`
	Fields   []Field `json:"fields" xml:"fields" fake:"{fields}"`
}

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 
Seed(11)
jobInfo := Job()
fmt.Println(jobInfo.Company)
fmt.Println(jobInfo.Title)
fmt.Println(jobInfo.Descriptor)
fmt.Println(jobInfo.Level)

Output:

TransparaGov
Teacher
Deputy
Configuration

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 MarkdownOptions 

type MarkdownOptions struct {
}

MarkdownOptions defines values needed for markdown document generation

type MovieInfo 

type MovieInfo struct {
	Name  string `json:"name" xml:"name"`
	Genre string `json:"genre" xml:"genre"`
}

func Movie 

func Movie() *MovieInfo
Example 
Seed(11)
movie := Movie()
fmt.Println(movie.Name)
fmt.Println(movie.Genre)

Output:

The Terminator
Sport

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"`
	Age        int             `json:"age" xml:"age"`
	SSN        string          `json:"ssn" xml:"ssn"`
	Hobby      string          `json:"hobby" xml:"hobby"`
	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 
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.Age)
fmt.Println(person.SSN)
fmt.Println(person.Hobby)

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:

Priscilla
Thornton
male
20
575624882
Cosplaying
Qado Energy, Inc.
Nail Technician
Technical
Quality
79993 Lanebury, Lincoln, Kansas 93050
79993 Lanebury
Lincoln
Kansas
93050
India
-26.936948
-28.374174
2689405915
elsareynolds@nichols.io
American Express
4570938757201747
11/28
205

type ProductInfo 

type ProductInfo struct {
	Name        string   `json:"name" xml:"name"`
	Description string   `json:"description" xml:"description"`
	Categories  []string `json:"categories" xml:"categories"`
	Price       float64  `json:"price" xml:"price"`
	Features    []string `json:"features" xml:"features"`
	Color       string   `json:"color" xml:"color"`
	Material    string   `json:"material" xml:"material"`
	UPC         string   `json:"upc" xml:"upc"`
	Audience    []string `json:"audience" xml:"audience"`
	Dimension   string   `json:"dimension" xml:"dimension"`
	UseCase     string   `json:"use_case" xml:"use_case"`
	Benefit     string   `json:"benefit" xml:"benefit"`
	Suffix      string   `json:"suffix" xml:"suffix"`
}

func Product 

func Product() *ProductInfo

Product will generate a random set of product information

Example 
Seed(11)
product := Product()
fmt.Println(product.Name)
fmt.Println(product.Description)
fmt.Println(product.Categories)
fmt.Println(product.Price)
fmt.Println(product.Features)
fmt.Println(product.Color)
fmt.Println(product.Material)
fmt.Println(product.UPC)
fmt.Println(product.Audience)
fmt.Println(product.Dimension)
fmt.Println(product.UseCase)
fmt.Println(product.Benefit)
fmt.Println(product.Suffix)

Output:

Upgradeable Side Table
This upset product is crafted from gel and includes 4k ready, making it perfect for learning and delivering advanced technology for gamers and DIY enthusiasts.
[smart home devices camping gear]
73.93
[multi-functional self-adjusting water-resistant underwater-capable]
maroon
oak wood
041026894059
[photographers travelers]
regular
dining
aesthetic appeal
plus

type SQLOptions 

type SQLOptions struct {
	Table  string  `json:"table" xml:"table"`   // Table name we are inserting into
	Count  int     `json:"count" xml:"count"`   // How many entries (tuples) we're generating
	Fields []Field `json:"fields" xml:"fields"` // The fields to be generated
}

type SVGOptions 

type SVGOptions struct {
	Height int
	Width  int
	Type   string
	Colors []string
}

type SongInfo added in v7.2.0 

type SongInfo struct {
	Name   string `json:"name" xml:"name"`
	Artist string `json:"artist" xml:"artist"`
	Genre  string `json:"genre" xml:"genre"`
}

func Song added in v7.2.0 

func Song() *SongInfo
Example 
Seed(11)
song := Song()
fmt.Println(song.Name)
fmt.Println(song.Artist)
fmt.Println(song.Genre)

Output:

What Was I Made For?
Taylor Swift
Country

type TemplateOptions 

type TemplateOptions struct {
	Funcs template.FuncMap `fake:"-"`
	Data  any              `json:"data" xml:"data" fake:"-"`
}

TemplateOptions defines values needed for template document generation

type XMLOptions 

type XMLOptions struct {
	Type          string  `json:"type" xml:"type" fake:"{randomstring:[array,single]}"` // single or array
	RootElement   string  `json:"root_element" xml:"root_element"`
	RecordElement string  `json:"record_element" xml:"record_element"`
	RowCount      int     `json:"row_count" xml:"row_count" fake:"{number:1,10}"`
	Indent        bool    `json:"indent" xml:"indent"`
	Fields        []Field `json:"fields" xml:"fields" fake:"{fields}"`
}

XMLOptions defines values needed for json generation

Source Files

View all Source files

Directories

Path Synopsis
cmd
exampleupdate command
gofakeit command
gofakeitserver command

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.