Movatterモバイル変換

jaswdr/fakerPublic

NotificationsYou must be signed in to change notification settings
Fork70
Star639

🚀 Ultimate fake data generator for Go with zero dependencies

pkg.go.dev/github.com/jaswdr/faker

License

MIT license

639 stars 70 forks Branches Tags Activity

Star

Notifications

You must be signed in to change notification settings

Branches Tags

Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 264 Commits
.claude		.claude
.github		.github
.deepsource.toml		.deepsource.toml
.gitignore		.gitignore
.gitpod.yml		.gitpod.yml
.licrc		.licrc
CLAUDE.md		CLAUDE.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
address.go		address.go
address_test.go		address_test.go
app.go		app.go
app_test.go		app_test.go
beer.go		beer.go
beer_test.go		beer_test.go
benchmarks_test.go		benchmarks_test.go
binarystring.go		binarystring.go
binarystring_test.go		binarystring_test.go
blood.go		blood.go
blood_test.go		blood_test.go
boolean.go		boolean.go
boolean_test.go		boolean_test.go
car.go		car.go
car_test.go		car_test.go
codecov.yml		codecov.yml
color.go		color.go
color_test.go		color_test.go
company.go		company.go
company_test.go		company_test.go
cover.png		cover.png
crypto.go		crypto.go
crypto_test.go		crypto_test.go
currency.go		currency.go
currency_test.go		currency_test.go
directory.go		directory.go
directory_test.go		directory_test.go
emoji.go		emoji.go
emoji_test.go		emoji_test.go
english_words.go		english_words.go
faker.go		faker.go
faker_benchmark_test.go		faker_benchmark_test.go
faker_test.go		faker_test.go
file.go		file.go
file_test.go		file_test.go
food.go		food.go
food_test.go		food_test.go
gamer.go		gamer.go
gamer_test.go		gamer_test.go
gender.go		gender.go
gender_test.go		gender_test.go
genre.go		genre.go
genre_test.go		genre_test.go
go.mod		go.mod
hash.go		hash.go
hash_test.go		hash_test.go
iban.go		iban.go
iban_test.go		iban_test.go
image.go		image.go
image_test.go		image_test.go
internet.go		internet.go
internet_test.go		internet_test.go
json.go		json.go
json_test.go		json_test.go
language.go		language.go
language_test.go		language_test.go
lorem.go		lorem.go
lorem_flickr.go		lorem_flickr.go
lorem_flickr_test.go		lorem_flickr_test.go
lorem_test.go		lorem_test.go
mimetype.go		mimetype.go
mimetype_test.go		mimetype_test.go
music.go		music.go
music_test.go		music_test.go
payment.go		payment.go
payment_test.go		payment_test.go
person.go		person.go
person_test.go		person_test.go
pet.go		pet.go
pet_test.go		pet_test.go
phone.go		phone.go
phone_test.go		phone_test.go
pokemon.go		pokemon.go
pokemon_test.go		pokemon_test.go
profile_image.go		profile_image.go
profile_image_test.go		profile_image_test.go
programming_language.go		programming_language.go
programming_language_test.go		programming_language_test.go
pull_request_template.md		pull_request_template.md
random_element.go		random_element.go
random_element_test.go		random_element_test.go
struct.go		struct.go
struct_test.go		struct_test.go
time.go		time.go
time_test.go		time_test.go
user_agent.go		user_agent.go
user_agent_test.go		user_agent_test.go
utils.go		utils.go

Repository files navigation

Faker is a Go library that generates fake data for you. Whether you need to bootstrap your database, create good-looking XML documents, fill-in your persistence to stress test it, or anonymize data taken from a production service, Faker is for you.

Faker is heavily inspired by PHP"sFaker

Faker requires Go >= 1.22 for 2.X

Test it directly from your browser

Start athttps://play.golang.org/p/JpTagDGBaHK

Installation

Add this to your Go file

import"github.com/jaswdr/faker/v2"

And rungo get ordep ensure to get the package.

Basic Usage

Usefaker.New() to create and initialize a faker generator, which can generate data by accessing properties named after the type of data you want.

import"github.com/jaswdr/faker/v2"funcmain() {fake:=faker.New()fake.Person().Name()// Lucy Cechtelarfake.Address().Address()// 426 Jordy Lodgefake.Lorem().Text(100)// Dolores sit sint laboriosam dolorem culpa et autem. Beatae nam sunt fugit// et sit et mollitia sed.// Fuga deserunt tempora facere magni omnis. Omnis quia temporibus laudantium// sit minima sint.}

Even if this example shows a method access, each call tofake.Name() yields a different (random) result.

p:=fake.Person()fori:=0;i<10;i++ {fmt.Println(p.Name())}// Adaline Reichel// Dr. Santa Prosacco DVM// Noemy Vandervort V// Lexi O"Conner// Gracie Weber// Roscoe Johns// Emmett Lebsack// Keegan Thiel// Wellington Koelpin II// Ms. Karley Kiehn V

You can also generate a profile image.

image:=p.Image()fmt.Println(image.Name())// /tmp/profil-picture-img-1064677774.jfiffmt.Printf("%+v",image)// &{file:0xc0002e4300}

Generate fake data using Structs

typeExampleStructstruct {SimpleStringFieldstringSimpleNumberintSimpleBoolboolSomeFormatedStringstring`fake:"??? ###"`SomeStringArray [5]string`fake:"????"`}example:=ExampleStruct{}f.Struct().Fill(&example)fmt.Printf("%+v",example)//{SimpleStringField:87576a01c2a547b2bbf9b7c736d1db40 SimpleNumber:9223372036854775807 SimpleBool:false SomeFormatedString:cxo 321 SomeStringArray:[effr swxp ldnj obcs nvlg]}

Generate random placeholder images usingLoremFlickr

// get a *os.File pointing to a file that is a random imageimage:=f.LoremFlickr().Image(100,100, []string{},"",false)fmt.Println(image.Name())// /tmp/loremflickr-img-4101493944.jpg

Generate profile images usingThisPersonDoesNotExist

profileImage:=f.ProfileImage().Image()fmt.Println(profileImage.Name())// /tmp/profil-picture-img-4022222298.jfif

See more formatters indocs

Development

Create a fork and get the code.

$ go get github.com/jaswdr/faker/v2

Do your changes, add tests, run the tests.

$ gotestPASSok      github.com/jaswdr/faker/v2 2.966s

Push to your fork and send a new pull request from your fork to this repository.

Versioning

Faker is maintained under theSemantic Versioning guidelines. Starting at2.X, we only support maintained versions of Go. Which according toGo's Release Policy means that we only support the two newer major versions.