{"id":13712169,"url":"https://github.com/Pallinder/go-randomdata","last_synced_at":"2025-05-06T21:33:22.858Z","repository":{"id":9799447,"uuid":"11777768","full_name":"Pallinder/go-randomdata","owner":"Pallinder","description":"A tiny generator of random data for golang, also known as a faker ","archived":false,"fork":false,"pushed_at":"2023-03-09T09:10:29.000Z","size":154,"stargazers_count":939,"open_issues_count":8,"forks_count":96,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-10-20T10:23:41.578Z","etag":null,"topics":["faker","faker-generator","faker-library","go","golang","randomdata"],"latest_commit_sha":null,"homepage":"","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/Pallinder.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-07-30T23:17:29.000Z","updated_at":"2024-10-18T19:31:22.000Z","dependencies_parsed_at":"2024-06-18T11:21:19.862Z","dependency_job_id":"7c8528f0-d6ef-4b4c-a950-ce11ca410543","html_url":"https://github.com/Pallinder/go-randomdata","commit_stats":{"total_commits":80,"total_committers":27,"mean_commits":2.962962962962963,"dds":0.5875,"last_synced_commit":"26f4a641b55b152ed383ba02b30b99763401ade3"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pallinder%2Fgo-randomdata","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pallinder%2Fgo-randomdata/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pallinder%2Fgo-randomdata/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pallinder%2Fgo-randomdata/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Pallinder","download_url":"https://codeload.github.com/Pallinder/go-randomdata/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224535806,"owners_count":17327596,"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","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":["faker","faker-generator","faker-library","go","golang","randomdata"],"created_at":"2024-08-02T23:01:15.588Z","updated_at":"2024-11-13T22:31:20.242Z","avatar_url":"https://github.com/Pallinder.png","language":"Go","funding_links":[],"categories":["Go","Repositories"],"sub_categories":[],"readme":"# go-randomdata\n\n[![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](https://github.com/Pallinder/go-randomdata/issues)\n[![GoDoc](https://godoc.org/github.com/Pallinder/go-randomdata?status.svg)](https://godoc.org/github.com/Pallinder/go-randomdata)\n[![Build Status](https://travis-ci.org/Pallinder/go-randomdata.png)](https://travis-ci.org/Pallinder/go-randomdata)\n[![Go Report Card](https://goreportcard.com/badge/github.com/Pallinder/go-randomdata)](https://goreportcard.com/report/github.com/Pallinder/go-randomdata)\n\nrandomdata is a tiny help suite for generating random data such as\n\n* first names (male or female)\n* last names\n* full names (male or female)\n* country names (full name or iso 3166.1 alpha-2 or alpha-3)\n* locales / language tags (bcp-47)\n* random email address\n* city names\n* American state names (two chars or full)\n* random numbers (in an interval)\n* random paragraphs\n* random bool values\n* postal- or zip-codes formatted for a range of different countries.\n* american sounding addresses / street names\n* silly names - suitable for names of things\n* random days\n* random months\n* random full date\n* random full profile\n* random date inside range\n* random phone number\n\n## Installation\n\n```go get github.com/Pallinder/go-randomdata```\n\n## Usage\n\n```go\n\npackage main\n\nimport (\n    \"fmt\"\n    \"github.com/Pallinder/go-randomdata\"\n)\n\nfunc main() {\n    // Print a random silly name\n    fmt.Println(randomdata.SillyName())\n\n    // Print a male title\n    fmt.Println(randomdata.Title(randomdata.Male))\n\n    // Print a female title\n    fmt.Println(randomdata.Title(randomdata.Female))\n\n    // Print a title with random gender\n    fmt.Println(randomdata.Title(randomdata.RandomGender))\n\n    // Print a male first name\n    fmt.Println(randomdata.FirstName(randomdata.Male))\n\n    // Print a female first name\n    fmt.Println(randomdata.FirstName(randomdata.Female))\n\n    // Print a last name\n    fmt.Println(randomdata.LastName())\n\n    // Print a male name\n    fmt.Println(randomdata.FullName(randomdata.Male))\n\n    // Print a female name\n    fmt.Println(randomdata.FullName(randomdata.Female))\n\n    // Print a name with random gender\n    fmt.Println(randomdata.FullName(randomdata.RandomGender))\n\n    // Print an email\n    fmt.Println(randomdata.Email())\n\n    // Print a country with full text representation\n    fmt.Println(randomdata.Country(randomdata.FullCountry))\n\n    // Print a country using ISO 3166-1 alpha-2\n    fmt.Println(randomdata.Country(randomdata.TwoCharCountry))\n\n    // Print a country using ISO 3166-1 alpha-3\n    fmt.Println(randomdata.Country(randomdata.ThreeCharCountry))\n    \n    // Print BCP 47 language tag\n    fmt.Println(randomdata.Locale())\n\n    // Print a currency using ISO 4217\n    fmt.Println(randomdata.Currency())\n\n    // Print the name of a random city\n    fmt.Println(randomdata.City())\n\n    // Print the name of a random american state\n    fmt.Println(randomdata.State(randomdata.Large))\n\n    // Print the name of a random american state using two chars\n    fmt.Println(randomdata.State(randomdata.Small))\n\n    // Print an american sounding street name\n    fmt.Println(randomdata.Street())\n\n    // Print an american sounding address\n    fmt.Println(randomdata.Address())\n\n    // Print a random number \u003e= 10 and \u003c 20\n    fmt.Println(randomdata.Number(10, 20))\n\n    // Print a number \u003e= 0 and \u003c 20\n    fmt.Println(randomdata.Number(20))\n\n    // Print a random float \u003e= 0 and \u003c 20 with decimal point 3\n    fmt.Println(randomdata.Decimal(0, 20, 3))\n\n    // Print a random float \u003e= 10 and \u003c 20\n    fmt.Println(randomdata.Decimal(10, 20))\n\n    // Print a random float \u003e= 0 and \u003c 20\n    fmt.Println(randomdata.Decimal(20))\n\n    // Print a bool\n    fmt.Println(randomdata.Boolean())\n\n    // Print a paragraph\n    fmt.Println(randomdata.Paragraph())\n\n    // Print a postal code\n    fmt.Println(randomdata.PostalCode(\"SE\"))\n\n    // Print a set of 2 random numbers as a string\n    fmt.Println(randomdata.StringNumber(2, \"-\"))\n\n    // Print a set of 2 random 3-Digits numbers as a string\n    fmt.Println(randomdata.StringNumberExt(2, \"-\", 3))\n\n    // Print a random string sampled from a list of strings\n    fmt.Println(randomdata.StringSample(\"my string 1\", \"my string 2\", \"my string 3\"))\n\n    // Print a valid random IPv4 address\n    fmt.Println(randomdata.IpV4Address())\n\n    // Print a valid random IPv6 address\n    fmt.Println(randomdata.IpV6Address())\n\n    // Print a browser's user agent string\n    fmt.Println(randomdata.UserAgentString())\n\n    // Print a day\n    fmt.Println(randomdata.Day())\n\n    // Print a month\n    fmt.Println(randomdata.Month())\n\n    // Print full date like Monday 22 Aug 2016\n    fmt.Println(randomdata.FullDate())\n\n    // Print full date \u003c= Monday 22 Aug 2016\n    fmt.Println(randomdata.FullDateInRange(\"2016-08-22\"))\n\n    // Print full date \u003e= Monday 01 Aug 2016 and \u003c= Monday 22 Aug 2016\n    fmt.Println(randomdata.FullDateInRange(\"2016-08-01\", \"2016-08-22\"))\n\n    // Print phone number according to e.164\n    fmt.Println(randomdata.PhoneNumber())\n\n    // Get a complete and randomised profile of data generally used for users\n    // There are many fields in the profile to use check the Profile struct definition in fullprofile.go\n    profile := randomdata.GenerateProfile(randomdata.Male | randomdata.Female | randomdata.RandomGender)\n    fmt.Printf(\"The new profile's username is: %s and password (md5): %s\\n\", profile.Login.Username, profile.Login.Md5)\n\n    // Get a random country-localised street name for Great Britain\n    fmt.Println(randomdata.StreetForCountry(\"GB\"))\n    // Get a random country-localised street name for USA\n    fmt.Println(randomdata.StreetForCountry(\"US\"))\n\n    // Get a random country-localised province for Great Britain\n    fmt.Println(randomdata.ProvinceForCountry(\"GB\"))\n    // Get a random country-localised province for USA\n    fmt.Println(randomdata.ProvinceForCountry(\"US\"))\n}\n\n```\n\n## Versioning / Release Strategy\nGo-Randomdata follows [Semver](https://www.semver.org)\n\nYou can find current releases tagged under the [releases section](https://github.com/Pallinder/go-randomdata/releases).\n\nThe [CHANGELOG.md](CHANGELOG.md) file contains the changelog of the project.\n\n## Contributors\n\n* [jteeuwen](https://github.com/jteeuwen)\n* [n1try](https://github.com/n1try)\n\nAll the other contributors are listed [here](https://github.com/Pallinder/go-randomdata/graphs/contributors).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPallinder%2Fgo-randomdata","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FPallinder%2Fgo-randomdata","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPallinder%2Fgo-randomdata/lists"}