{"id":34125498,"url":"https://github.com/rulox/faker","last_synced_at":"2026-05-28T08:31:52.168Z","repository":{"id":57611721,"uuid":"134778638","full_name":"Rulox/faker","owner":"Rulox","description":"A Go library to create Fake Data for your projects","archived":false,"fork":false,"pushed_at":"2018-07-24T20:10:00.000Z","size":171,"stargazers_count":2,"open_issues_count":5,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-06-21T04:31:49.220Z","etag":null,"topics":["data","dummy","dummy-data","fake","fake-data","faker","go","golang"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Rulox.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-05-24T23:24:59.000Z","updated_at":"2023-06-21T16:18:02.000Z","dependencies_parsed_at":"2022-08-27T09:30:34.192Z","dependency_job_id":null,"html_url":"https://github.com/Rulox/faker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Rulox/faker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rulox%2Ffaker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rulox%2Ffaker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rulox%2Ffaker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rulox%2Ffaker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Rulox","download_url":"https://codeload.github.com/Rulox/faker/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Rulox%2Ffaker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":27738656,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-14T02:00:11.348Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data","dummy","dummy-data","fake","fake-data","faker","go","golang"],"created_at":"2025-12-14T23:03:00.918Z","updated_at":"2025-12-14T23:03:06.938Z","avatar_url":"https://github.com/Rulox.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\u003cp align=\"center\"\u003e\u003cimg src=\"doc/faker_logo.png\" width=\"250\"\u003e\u003c/p\u003e\n\n# Faker (WIP, do not use this library in production)\n![quality](https://sonarcloud.io/api/project_badges/measure?project=faker_key\u0026metric=alert_status) \n[![Build Status](https://travis-ci.org/Rulox/faker.svg?branch=master)](https://travis-ci.org/Rulox/faker)\n[![GoDoc](https://godoc.org/github.com/Rulox/faker?status.svg)](https://godoc.org/github.com/Rulox/faker)\n\nFaker is a Golang library that generates all type of fake data. Including localized data.\n\nThis library is inspired by same libs in other languages like Perl's, ruby's and PHP's Faker.\n\nFaker has been built and tested with Go \u003e= 1.10\n\n## Content\n- [Installing](#installing)\n- [Usage](#usage)\n    - [In code](#in-code)\n- [Generators](#generators)\n    - [Misc](doc/misc.md)\n    - [Address](doc/address.md)\n    - [Person](doc/person.md)\n- [Locales](#locales)\n    - [Set Locale](#set-your-locale)\n- [Examples](examples)\n- [FAQ](#faq)\n- [License](#license)\n\n### Installing\nJust use go get\n\n`go get -u github.com/Rulox/faker`\n\nOr add the library to your project and use `dep ensure`\n\n### Usage\nThe main struct `generator/Faker` provides all the usability for you in order to create the fake data. \nIt is necessary to use `faker.NewFaker()` function in order to load default values in some variables.\n\n`Faker` has different type of generators (for Misc data, Addresses, Companies, Phones, etc). \n#### In code\n```go\n    f := faker.NewFaker(\"en_US\") // Use en_US locale\n    f.Misc.RandomInt()  // 54\n    f.Address.Street()  // Bedford \n``` \n### Generators\nA faker instance has multiple generators. Go to the [documentation](doc) to check all of them.\n\n### Locales\nThe locales are organized in YAML files called `faker.yml` inside each language folder.\nThe default locale is `en_US`. A lot of help to create new locales for languages is needed\nand the format is so easy that anyone (even if you're not a developer) can supply data\nfollowing the format.\n\n#### Set your locale\nSetting a locale is really easy. The locale string is passed in the `NewFaker` function.\nThis function will (among other stuff) load the yaml corresponding to the language code\nyou choose. Please be careful, use the name of the folder as the locale name `string`.\n```go\n\tf := faker.NewFaker(\"es_ES\")\n```\n\nYou can also change the locale after having your faker initialized\n```go\n\tf := faker.NewFaker(\"en_GB\")\n\t// do your stuff here with en_GB set\n\tf.SetLocale(\"es_ES\")\n\t// Spanish time!\n```\n## FAQ\n - Is the data real?\n   - The data is randomly chosen so no. You may end up with a wrong province/state/zip code combination\n- What about gender? Does the library take care of the right combination?\n   - Not really. There's a plan to add this capability in the future though.\n- What about a CLI or console tool?\n   - Is in the roadmap! Check the project regularly\n- How can I Help?\n   - There's always a missing language or feature. Feel free to open an `issue` or even better, a `pull request` \n   to help this library growing\n      \n## License\nThis code is free to use under the terms of the MIT license. See LICENSE.md for more information.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frulox%2Ffaker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frulox%2Ffaker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frulox%2Ffaker/lists"}