faker

README

Faker for Go

Usage

package main

import (
  "github.com/manveru/faker"
)

func main() {
  fake, err := faker.New("en")
  if err != nil {
    panic(err)
  }
  println(fake.Name())  //> "Adriana Crona"
  println(fake.Email()) //> charity.brown@fritschbotsford.biz
}

Inspired by the ruby faker gem, which is a port of the Perl Data::Faker library.

Documentation

Overview

faker generates fake data in various languages.

Index

• Variables
• type Faker
  • func New(lang string) (*Faker, error)
  • func (f *Faker) CellPhoneNumber() string
  • func (f *Faker) Characters(count int) string
  • func (f *Faker) City() string
  • func (f *Faker) CityPrefix() string
  • func (f *Faker) CitySuffix() string
  • func (f *Faker) CompanyBs() string
  • func (f *Faker) CompanyCatchPhrase() string
  • func (f *Faker) CompanyName() string
  • func (f *Faker) CompanySuffix() string
  • func (f *Faker) Country() string
  • func (f *Faker) DomainName() string
  • func (f *Faker) DomainSuffix() string
  • func (f *Faker) DomainWord() string
  • func (f *Faker) Email() string
  • func (f *Faker) FirstName() string
  • func (f *Faker) FreeEmail() string
  • func (f *Faker) IPv4Address() net.IP
  • func (f *Faker) IPv6Address() net.IP
  • func (f *Faker) JobTitle() string
  • func (f *Faker) LastName() string
  • func (f *Faker) Latitude() float64
  • func (f *Faker) Longitude() float64
  • func (f *Faker) Name() string
  • func (f *Faker) NamePrefix() string
  • func (f *Faker) NameSuffix() string
  • func (f *Faker) Paragraph(sentences int, supplemental bool) string
  • func (f *Faker) Paragraphs(count int, supplemental bool) []string
  • func (f *Faker) PhoneNumber() string
  • func (f *Faker) PostCode() string
  • func (f *Faker) SafeEmail() string
  • func (f *Faker) SecondaryAddress() string
  • func (f *Faker) Sentence(words int, supplemental bool) string
  • func (f *Faker) Sentences(count int, supplemental bool) []string
  • func (f *Faker) State() string
  • func (f *Faker) StateAbbr() string
  • func (f *Faker) StreetAddress() string
  • func (f *Faker) StreetName() string
  • func (f *Faker) StreetSuffix() string
  • func (f *Faker) URL() string
  • func (f *Faker) UserName() string
  • func (f *Faker) Words(count int, supplemental bool) []string
• type Rand

Examples

• Faker.Name

Variables

var Dict = dict

You can add your own translations and words to this dictionary. It's a map[string]map[string][]string. For example:

faker.Dict["en"]["company.suffix"] = []string{
  "Inc",
  "and Sons",
  "LLC",
  "Group",
}

Types

type Faker

type Faker struct {
	Language string
	Dict     map[string][]string
	Rand     Rand
	Buffer   bytes.Buffer
}

func New

func New(lang string) (*Faker, error)

func (*Faker) CellPhoneNumber

func (f *Faker) CellPhoneNumber() string

func (*Faker) Characters

func (f *Faker) Characters(count int) string

func (*Faker) City

func (f *Faker) City() string

func (*Faker) CityPrefix

func (f *Faker) CityPrefix() string

func (*Faker) CitySuffix

func (f *Faker) CitySuffix() string

func (*Faker) CompanyBs

func (f *Faker) CompanyBs() string

func (*Faker) CompanyCatchPhrase

func (f *Faker) CompanyCatchPhrase() string

func (*Faker) CompanyName

func (f *Faker) CompanyName() string

func (*Faker) CompanySuffix

func (f *Faker) CompanySuffix() string

func (*Faker) Country

func (f *Faker) Country() string

func (*Faker) DomainName

func (f *Faker) DomainName() string

func (*Faker) DomainSuffix

func (f *Faker) DomainSuffix() string

func (*Faker) DomainWord

func (f *Faker) DomainWord() string

func (*Faker) Email

func (f *Faker) Email() string

func (*Faker) FirstName

func (f *Faker) FirstName() string

func (*Faker) FreeEmail

func (f *Faker) FreeEmail() string

func (*Faker) IPv4Address

func (f *Faker) IPv4Address() net.IP

func (*Faker) IPv6Address

func (f *Faker) IPv6Address() net.IP

func (*Faker) JobTitle

func (f *Faker) JobTitle() string

func (*Faker) LastName

func (f *Faker) LastName() string

func (*Faker) Latitude

func (f *Faker) Latitude() float64

func (*Faker) Longitude

func (f *Faker) Longitude() float64

func (*Faker) Name

func (f *Faker) Name() string

Name returns a random personal name in various formats.

Example

fake, _ := New("en")
fake.Rand = rand.New(rand.NewSource(42))
fmt.Println(fake.Name())

Output:

Adriana Crona

func (*Faker) NamePrefix

func (f *Faker) NamePrefix() string

func (*Faker) NameSuffix

func (f *Faker) NameSuffix() string

func (*Faker) Paragraph

func (f *Faker) Paragraph(sentences int, supplemental bool) string

func (*Faker) Paragraphs

func (f *Faker) Paragraphs(count int, supplemental bool) []string

func (*Faker) PhoneNumber

func (f *Faker) PhoneNumber() string

func (*Faker) PostCode

func (f *Faker) PostCode() string

func (*Faker) SafeEmail

func (f *Faker) SafeEmail() string

func (*Faker) SecondaryAddress

func (f *Faker) SecondaryAddress() string

func (*Faker) Sentence

func (f *Faker) Sentence(words int, supplemental bool) string

func (*Faker) Sentences

func (f *Faker) Sentences(count int, supplemental bool) []string

func (*Faker) State

func (f *Faker) State() string

func (*Faker) StateAbbr

func (f *Faker) StateAbbr() string

func (*Faker) StreetAddress

func (f *Faker) StreetAddress() string

func (*Faker) StreetName

func (f *Faker) StreetName() string

func (*Faker) StreetSuffix

func (f *Faker) StreetSuffix() string

func (*Faker) URL

func (f *Faker) URL() string

func (*Faker) UserName

func (f *Faker) UserName() string

func (*Faker) Words

func (f *Faker) Words(count int, supplemental bool) []string

type Rand

type Rand interface {
	Float32() float32
	Float64() float64
	Int63n(int64) int64
	Intn(int) int
}