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

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

Source Files

View all Source files

Directories

Path Synopsis

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.