gofakeit

package module
v3.18.0+incompatible Latest Latest
Warning

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

Go to latest
Published: Jun 19, 2019 License: MIT Imports: 12 Imported by: 214

README

alt text

gofakeit Go Report Card Build Status codecov.io GoDoc license

Random data generator written in go

Buy Me A Coffee

Features
  • Every function has an example and a benchmark, see benchmarks
  • Zero dependencies
  • Randomizes user defined structs
  • Numerous functions for regular use
120+ Functions!!!

If there is something that is generic enough missing from this package add an issue and let me know what you need. Most of the time i'll add it!

Seed

If you would like to ensure randomization on initial use be sure to seed it first

gofakeit.Seed(time.Now().UnixNano()) // or gofakeit.Seed(0)

Person

Person() *PersonInfo
Name() string
NamePrefix() string
NameSuffix() string
FirstName() string
LastName() string
Gender() string
SSN() string
Contact() *ContactInfo
Email() string
Phone() string
PhoneFormatted() string
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
StatusCode() string
Street() string
StreetName() string
StreetNumber() string
StreetPrefix() string
StreetSuffix() string
Zip() string
Latitude() float64
LatitudeInRange() (float64, error)
Longitude() float64
LongitudeInRange() (float64, error)

Beer

BeerAlcohol() string
BeerBlg() string
BeerHop() string
BeerIbu() string
BeerMalt() string
BeerName() string
BeerStyle() string
BeerYeast() string

Cars

Vehicle() *VehicleInfo
CarMaker() string
CarModel() string
VehicleType() string
FuelType() string
TransmissionGearType() string

Words

Word() string
Sentence(wordCount int) string
Paragraph(paragraphCount int, sentenceCount int, wordCount int, separator string) string
Question() string
Quote() string

Misc

Struct(v interface{})
Generate() string
Bool() bool
UUID() string

Colors

Color() string
HexColor() string
RGBColor() string
SafeColor() string

Internet

URL() string
ImageURL(width int, height int) string
DomainName() string
DomainSuffix() string
IPv4Address() string
IPv6Address() string
SimpleStatusCode() int
LogLevel(logType string) string
HTTPMethod() string
UserAgent() string
ChromeUserAgent() string
FirefoxUserAgent() string
OperaUserAgent() string
SafariUserAgent() string

Date/Time

Date() time.Time
DateRange(start, end time.Time) time.Time
NanoSecond() int
Second() int
Minute() int
Hour() int
Month() string
Day() int
WeekDay() string
Year() int
TimeZone() string
TimeZoneAbv() string
TimeZoneFull() string
TimeZoneOffset() float32

Payment

Price(min, max float64) float64
CreditCard() *CreditCardInfo
CreditCardCvv() string
CreditCardExp() string
CreditCardNumber() int
CreditCardNumberLuhn() int
CreditCardType() string
Currency() *CurrencyInfo
CurrencyLong() string
CurrencyShort() string

Company

BS() string
BuzzWord() string
Company() string
CompanySuffix() string
Job() *JobInfo
JobDescriptor() string
JobLevel() string
JobTitle() string

Hacker

HackerAbbreviation() string
HackerAdjective() string
HackerIngverb() string
HackerNoun() string
HackerPhrase() string
HackerVerb() string

Hipster

HipsterWord() string
HipsterSentence(wordCount int) string
HipsterParagraph(paragraphCount int, sentenceCount int, wordCount int, separator string) string

File

Extension() string
MimeType() string

Numbers

Number(min int, max int) int
Numerify(str string) string
Int8() int8
Int16() int16
Int32() int32
Int64() int64
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)

String

Digit() string
Letter() string
Lexify(str string) string
RandString(a []string) string
ShuffleStrings(a []string)

Documentation

GoDoc

Example

import "github.com/brianvoe/gofakeit"

gofakeit.Seed(0)
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() // 4287271570245748
gofakeit.HackerPhrase() // Connecting the array won't do anything, we need to generate the haptic COM driver!
gofakeit.JobTitle() // Director
gofakeit.Password(true, true, true, true, true, 32) // WV10MzLxq2DX79w1omH97_0ga59j8!kj
gofakeit.CurrencyShort() // USD
// 120+ more!!!

// Create structs with random injected data
type Foo struct {
	Bar     string
	Baz     string
	Int     int
	Pointer *int
	Skip    *string `fake:"skip"` // Set to "skip" to not generate data for
}
var f Foo
gofakeit.Struct(&f)
fmt.Printf("f.Bar:%s\n", f.Bar) // f.Bar:hrukpttuezptneuvunh
fmt.Printf("f.Baz:%s\n", f.Baz) // f.Baz:uksqvgzadxlgghejkmv
fmt.Printf("f.Int:%d\n", f.Int) // f.Int:-7825289004089916589
fmt.Printf("f.Pointer:%d\n", *f.Pointer) // f.Pointer:-343806609094473732
fmt.Printf("f.Skip:%v\n", f.Skip) // f.Skip:<nil>

Documentation

Overview

Package gofakeit is a random data generator written in go

Every function has an example and a benchmark

See the full list here https://godoc.org/github.com/brianvoe/gofakeit

80+ Functions!!!

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())
fmt.Println("Hacker Phrase:", HackerPhrase())
fmt.Println("Job Title:", JobTitle())
fmt.Println("Password:", Password(true, true, true, true, true, 32))
currency := Currency()
fmt.Printf("Currency: %s - %s", currency.Short, currency.Long)
Output:

Name: Markus Moen
Email: alaynawuckert@kozey.biz
Phone: 9948995369
Address: 35300 South Roadshaven, Hilllville, Montana 30232
BS: e-enable
Beer Name: Weihenstephaner Hefeweissbier
Color: MidnightBlue
Company: Heaney-Tromp
Credit Card: 2720997148008899
Hacker Phrase: Use the wireless SQL sensor, then you can compress the open-source array!
Job Title: Producer
Password: Hozsav7LgAa -Q$qSu  L*2 ?Jivzjn2
Currency: DJF - Djibouti Franc

Index

Examples

Constants

This section is empty.

Variables

This section is empty.

Functions

func BS

func BS() string

BS will generate a random company bs string

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

front-end

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:

2.7%

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:

6.4°Blg

func BeerHop

func BeerHop() string

BeerHop will return a random beer hop

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

Glacier

func BeerIbu

func BeerIbu() string

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

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

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

Duvel

func BeerStyle

func BeerStyle() string

BeerStyle will return a random beer style

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

European Amber Lager

func BeerYeast

func BeerYeast() string

BeerYeast will return a random beer yeast

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

1388 - Belgian Strong Ale

func Bool

func Bool() bool

Bool will generate a random boolean value

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

false

func BuzzWord

func BuzzWord() string

BuzzWord will generate a random company buzz word string

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

disintermediate

func CarMaker

func CarMaker() string

CarMaker will return a random car maker

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

Nissan

func CarModel

func CarModel() string

CarModel will return a random car model

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

Aveo

func Categories

func Categories() map[string][]string

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

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 (X11; Linux i686) AppleWebKit/5312 (KHTML, like Gecko) Chrome/39.0.836.0 Mobile Safari/5312

func City

func City() (city string)

City will generate a random city string

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

Marcelside

func Color

func Color() string

Color will generate a random color string

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

MediumOrchid

func Company

func Company() (company string)

Company will generate a random company name string

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

Moen, Pagac and Wuckert

func CompanySuffix

func CompanySuffix() string

CompanySuffix will generate a random company suffix string

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

Inc

func Country

func Country() string

Country will generate a random country string

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

Tajikistan

func CountryAbr

func CountryAbr() string

CountryAbr will generate a random abbreviated country string

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

FI

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:

513

func CreditCardExp

func CreditCardExp() string

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

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

01/21

func CreditCardNumber

func CreditCardNumber() int

CreditCardNumber will generate a random credit card number int

Example
Seed(11)
fmt.Println(CreditCardNumber())
Output:

4136459948995369

func CreditCardNumberLuhn

func CreditCardNumberLuhn() int

CreditCardNumberLuhn will generate a random credit card number int that passes luhn test

Example
Seed(11)
fmt.Println(CreditCardNumberLuhn())
Output:

2720996615546177

func CreditCardType

func CreditCardType() string

CreditCardType will generate a random credit card type string

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

Visa

func CurrencyLong

func CurrencyLong() string

CurrencyLong will generate a random long currency name

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

Iraq Dinar

func CurrencyShort

func CurrencyShort() string

CurrencyShort will generate a random short currency value

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

IQD

func Date

func Date() time.Time

Date will generate a random time.Time struct

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

1900-01-07 04:14:25.685339029 +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-02-04 14:10:37.166933216 +0000 UTC

func Day

func Day() int

Day will generate a random day between 1 - 31

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

12

func Digit

func Digit() string

Digit will generate a single ASCII digit

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

0

func DomainName

func DomainName() string

DomainName will generate a random url domain name

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

centraltarget.biz

func DomainSuffix

func DomainSuffix() string

DomainSuffix will generate a random domain suffix

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

org

func Email

func Email() string

Email will generate a random email string

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

markusmoen@pagac.net

func Extension

func Extension() string

Extension will generate a random file extension

Example
Seed(11)
fmt.Println(Extension())
Output:

nes

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 (Macintosh; U; PPC Mac OS X 10_8_3 rv:7.0) Gecko/1900-07-01 Firefox/37.0

func FirstName

func FirstName() string

FirstName will generate a random first name

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

Markus

func Float32

func Float32() float32

Float32 will generate a random float32 value

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

3.1128167e+37

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:

914774.6

func Float64

func Float64() float64

Float64 will generate a random float64 value

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

1.644484108270445e+307

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:

914774.5585333086

func FuelType

func FuelType() string

FuelType will return a random fuel type

Example
Seed(11)
fmt.Println(FuelType())
Output:

CNG

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

Generate fake information from given string. String should contain {category.subcategory}

Ex: {person.first} - random firstname

Ex: {person.first}###{person.last}@{person.last}.{internet.domain_suffix} - billy834smith@smith.com

Ex: ### - 481 - random numbers

Ex: ??? - fda - random letters

For a complete list possible categories use the Categories() function.

Example
Seed(11)
fmt.Println(Generate("{person.first} {person.last} lives at {address.number} {address.street_name} {address.street_suffix}"))
Output:

Markus Moen lives at 599 Garden mouth

func HTTPMethod

func HTTPMethod() string

HTTPMethod will generate a random http method

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

HEAD

func HackerAbbreviation

func HackerAbbreviation() string

HackerAbbreviation will return a random hacker abbreviation

Example
Seed(20)
fmt.Println(HackerAbbreviation())
Output:

AGP

func HackerAdjective

func HackerAdjective() string

HackerAdjective will return a random hacker adjective

Example
Seed(20)
fmt.Println(HackerAdjective())
Output:

online

func HackerIngverb

func HackerIngverb() string

HackerIngverb will return a random hacker ingverb

Example
Seed(20)
fmt.Println(HackerIngverb())
Output:

navigating

func HackerNoun

func HackerNoun() string

HackerNoun will return a random hacker noun

Example
Seed(20)
fmt.Println(HackerNoun())
Output:

pixel

func HackerPhrase

func HackerPhrase() string

HackerPhrase will return a random hacker sentence

Example
Seed(20)
fmt.Println(HackerPhrase())
Output:

Connecting the array won't do anything, we need to generate the haptic COM driver!

func HackerVerb

func HackerVerb() string

HackerVerb will return a random hacker verb

Example
Seed(20)
fmt.Println(HackerVerb())
Output:

connect

func HexColor

func HexColor() string

HexColor will generate a random hexadecimal color string

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

#i99jb4

func HipsterParagraph

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

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

Example
Seed(11)
fmt.Println(HipsterParagraph(3, 5, 12, "\n"))
Output:

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

func HipsterSentence

func HipsterSentence(wordCount int) string

HipsterSentence will generate a random sentence

Example
Seed(11)
fmt.Println(HipsterSentence(5))
Output:

Microdosing roof chia echo pickled.

func HipsterWord

func HipsterWord() string

HipsterWord will return a single hipster word

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

microdosing

func Hour

func Hour() int

Hour will generate a random hour - in military time

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

0

func IPv4Address

func IPv4Address() string

IPv4Address will generate a random version 4 ip address

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

222.83.191.222

func IPv6Address

func IPv6Address() string

IPv6Address will generate a random version 6 ip address

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

2001:cafe:8898:ee17:bc35:9064:5866:d019

func ImageURL

func ImageURL(width int, height int) string

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

Example
Seed(11)
fmt.Println(ImageURL(640, 480))
Output:

https://picsum.photos/640/480

func Int16

func Int16() int16

Int16 will generate a random int16 value

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

2200

func Int32

func Int32() int32

Int32 will generate a random int32 value

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

-1072427943

func Int64

func Int64() int64

Int64 will generate a random int64 value

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

-8379641344161477543

func Int8

func Int8() int8

Int8 will generate a random Int8 value

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

24

func JobDescriptor

func JobDescriptor() string

JobDescriptor will generate a random job descriptor string

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

Central

func JobLevel

func JobLevel() string

JobLevel will generate a random job level string

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

Assurance

func JobTitle

func JobTitle() string

JobTitle will generate a random job title string

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

Director

func LastName

func LastName() string

LastName will generate a random last name

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

Daniel

func Latitude

func Latitude() float64

Latitude will generate a random latitude float64

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

-73.53405629980608

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:

22.921026765022624

func Letter

func Letter() string

Letter will generate a single random lower case ASCII letter

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

g

func Lexify

func Lexify(str string) string

Lexify will replace ? will random generated letters

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

gbrma

func LogLevel

func LogLevel(logType string) string

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

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

error
debug
trace1-8

func Longitude

func Longitude() float64

Longitude will generate a random longitude float64

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

-147.06811259961216

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:

-8.170450699978453

func MacAddress

func MacAddress() string

MacAddress will generate a random mac address

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

e1:74:cb:01:77:91

func MimeType

func MimeType() string

MimeType will generate a random mime file type

Example
Seed(11)
fmt.Println(MimeType())
Output:

application/dsptype

func Minute

func Minute() int

Minute will generate a random minute

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

0

func Month

func Month() string

Month will generate a random month string

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

January

func Name

func Name() string

Name will generate a random First and Last Name

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

Markus Moen

func NamePrefix

func NamePrefix() string

NamePrefix will generate a random name prefix

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

Mr.

func NameSuffix

func NameSuffix() string

NameSuffix will generate a random name suffix

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

Jr.

func NanoSecond

func NanoSecond() int

NanoSecond will generate a random nano second

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

196446360

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:

14866

func Numerify

func Numerify(str string) string

Numerify will replace # with random numerical values

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

613-645-9948

func OperaUserAgent

func OperaUserAgent() string

OperaUserAgent will generate a random opera browser user agent string

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

Opera/8.39 (Macintosh; U; PPC Mac OS X 10_8_7; en-US) Presto/2.9.335 Version/10.00

func Paragraph

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

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

Example
Seed(11)
fmt.Println(Paragraph(3, 5, 12, "\n"))
Output:

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

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:

vodnqxzsuptgehrzylximvylxzoywexw
ZSRQWJFJWCSTVGXKYKWMLIAFGFELFJRG
61718615932495608398906260648432
@=-%%#$=-%+++&-#?*&?%&=%?+#@@-&?
EEP+wwpk 4lU-eHNXlJZ4n K9%v&TZ9e
j ?9X

func Phone

func Phone() string

Phone will generate a random phone number string

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

6136459948

func PhoneFormatted

func PhoneFormatted() string

PhoneFormatted will generate a random phone number string

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

136-459-9489

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:

92.26

func Question

func Question() string

Question will return a random question

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

Roof chia echo?

func Quote

func Quote() string

Quote will return a random quote from a random person

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

"Roof chia echo." - Lura Lockman

func RGBColor

func RGBColor() []int

RGBColor will generate a random int slice color

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

[152 23 53]

func RandString added in v1.2.0

func RandString(a []string) string

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

func SSN

func SSN() string

SSN will generate a random Social Security Number

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

296446360

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 (iPad; CPU OS 8_3_2 like Mac OS X; en-US) AppleWebKit/531.15.6 (KHTML, like Gecko) Version/4.0.5 Mobile/8B120 Safari/6531.15.6

func SafeColor

func SafeColor() string

SafeColor will generate a random safe color string

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

black

func Second

func Second() int

Second will generate a random second

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

0

func Seed

func Seed(seed int64)

Seed random. Setting seed to 0 will use time.Now().UnixNano()

func Sentence

func Sentence(wordCount int) string

Sentence will generate a random sentence

Example
Seed(11)
fmt.Println(Sentence(5))
Output:

Quia quae repellat consequatur quidem.

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:

[74125 777 941 89416 8413 854 52 841657]

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:

[good everyone have for times a day happy]

func SimpleStatusCode

func SimpleStatusCode() int

SimpleStatusCode will generate a random simple status code

Example
Seed(11)
fmt.Println(SimpleStatusCode())
Output:

200

func State

func State() string

State will generate a random state string

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

Hawaii

func StateAbr

func StateAbr() string

StateAbr will generate a random abbreviated state string

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

OR

func StatusCode

func StatusCode() int

StatusCode will generate a random status code

Example
Seed(11)
fmt.Println(StatusCode())
Output:

404

func Street

func Street() (street string)

Street will generate a random address street string

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

364 East Rapidsborough

func StreetName

func StreetName() string

StreetName will generate a random address street name string

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

View

func StreetNumber

func StreetNumber() string

StreetNumber will generate a random address street number string

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

13645

func StreetPrefix

func StreetPrefix() string

StreetPrefix will generate a random address street prefix string

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

Lake

func StreetSuffix

func StreetSuffix() string

StreetSuffix will generate a random address street suffix string

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

land

func Struct

func Struct(v interface{})

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

Example
Seed(11)
type Foo struct {
	Bar     string
	Baz     string
	Int     int
	Pointer *int
	Skip    *string `fake:"skip"`
}
var f Foo
Struct(&f)
fmt.Printf("%s\n", f.Bar)
fmt.Printf("%s\n", f.Baz)
fmt.Printf("%d\n", f.Int)
fmt.Printf("%d\n", *f.Pointer)
fmt.Printf("%v\n", f.Skip)
Output:

gbrmarxhkijbptapwyj
dnsmkgtlxwnqhqclayk
-5858358572185296359
-8038678955577270446
<nil>

func TimeZone

func TimeZone() string

TimeZone will select a random timezone string

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

Kaliningrad Standard Time

func TimeZoneAbv

func TimeZoneAbv() string

TimeZoneAbv will select a random timezone abbreviation string

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

KST

func TimeZoneFull

func TimeZoneFull() string

TimeZoneFull will select a random full timezone string

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

(UTC+03:00) Kaliningrad, Minsk

func TimeZoneOffset

func TimeZoneOffset() float32

TimeZoneOffset will select a random timezone offset

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

3

func TransmissionGearType

func TransmissionGearType() string

TransmissionGearType will return a random transmission gear type

Example
Seed(11)
fmt.Println(TransmissionGearType())
Output:

Manual

func URL

func URL() string

URL will generate a random url string

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

https://www.nationalseamless.net/iterate/streamline/systems

func UUID

func UUID() string

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

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

590c1440-9888-45b0-bd51-a817ee07c3f2

func Uint16

func Uint16() uint16

Uint16 will generate a random uint16 value

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

34968

func Uint32

func Uint32() uint32

Uint32 will generate a random uint32 value

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

1075055705

func Uint64

func Uint64() uint64

Uint64 will generate a random uint64 value

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

843730692693298265

func Uint8

func Uint8() uint8

Uint8 will generate a random uint8 value

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

152

func UserAgent

func UserAgent() string

UserAgent will generate a random broswer user agent

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

Mozilla/5.0 (Windows NT 5.0) AppleWebKit/5362 (KHTML, like Gecko) Chrome/37.0.834.0 Mobile Safari/5362

func Username

func Username() string

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

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

Daniel1364

func VehicleType

func VehicleType() string

VehicleType will generate a random vehicle type string

Example
Seed(11)
fmt.Println(VehicleType())
Output:

Passenger car mini

func WeekDay

func WeekDay() string

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

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

Friday

func Word

func Word() string

Word will generate a random word

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

quia

func Year

func Year() int

Year will generate a random year between 1900 - current year

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

1900

func Zip

func Zip() string

Zip will generate a random Zip code string

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

13645

Types

type AddressInfo

type AddressInfo struct {
	Address   string
	Street    string
	City      string
	State     string
	Zip       string
	Country   string
	Latitude  float64
	Longitude float64
}

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.City)
fmt.Println(address.State)
fmt.Println(address.Zip)
fmt.Println(address.Country)
fmt.Println(address.Latitude)
fmt.Println(address.Longitude)
// 872 East Rapidsborough, Rutherfordstad, New Jersey 74853
// 872 East Rapidsborough
// Rutherfordstad
// New Jersey
// 74853
// South Africa
// 23.05875828427908
// 89.02259415693374
Output:

type ContactInfo

type ContactInfo struct {
	Phone string
	Email string
}

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:

6136459948
carolecarroll@bosco.com

type CreditCardInfo

type CreditCardInfo struct {
	Type   string
	Number int
	Exp    string
	Cvv    string
}

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:

Visa
6536459948995369
03/26
353

type CurrencyInfo

type CurrencyInfo struct {
	Short string
	Long  string
}

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.Printf("%s - %s", currency.Short, currency.Long)
Output:

IQD - Iraq Dinar

type JobInfo

type JobInfo struct {
	Company    string
	Title      string
	Descriptor string
	Level      string
}

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:

Moen, Pagac and Wuckert
Developer
National
Integration

type PersonInfo

type PersonInfo struct {
	FirstName  string
	LastName   string
	Gender     string
	SSN        string
	Image      string
	Job        *JobInfo
	Address    *AddressInfo
	Contact    *ContactInfo
	CreditCard *CreditCardInfo
}

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.SSN)
fmt.Println(person.Image)

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

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

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

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

Markus
Moen
male
420776036
https://picsum.photos/300/300/people
Lockman and Sons
Developer
Global
Brand
5369 Streamville, Rossieview, Hawaii 42591
5369 Streamville
Rossieview
Hawaii
42591
Burkina Faso
-6.662594491850811
23.921575244414612
3023202027
lamarkoelpin@heaney.biz
Discover
4148008899822720
09/29
932

type VehicleInfo

type VehicleInfo struct {
	// Vehicle type
	VehicleType string
	// Fuel type
	Fuel string
	// Transmission type
	TransmissionGear string
	// Brand name
	Brand string
	// Vehicle model
	Model string
	// Vehicle model year
	Year int
}

VehicleInfo is a struct dataset of all vehicle information

func Vehicle

func Vehicle() *VehicleInfo

Vehicle will generate a struct with vehicle information

Example
Seed(11)
vehicle := Vehicle()
fmt.Println(vehicle.Brand)
fmt.Println(vehicle.Fuel)
fmt.Println(vehicle.Model)
fmt.Println(vehicle.TransmissionGear)
fmt.Println(vehicle.VehicleType)
fmt.Println(vehicle.Year)
Output:

Fiat
Gasoline
Freestyle Fwd
Automatic
Passenger car mini
1925

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL