201 lines
6.3 KiB
Markdown
201 lines
6.3 KiB
Markdown
# go-randomdata
|
|
|
|
[![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](https://github.com/Pallinder/go-randomdata/issues)
|
|
[![GoDoc](https://godoc.org/github.com/Pallinder/go-randomdata?status.svg)](https://godoc.org/github.com/Pallinder/go-randomdata)
|
|
[![Build Status](https://travis-ci.org/Pallinder/go-randomdata.png)](https://travis-ci.org/Pallinder/go-randomdata)
|
|
[![Go Report Card](https://goreportcard.com/badge/github.com/Pallinder/go-randomdata)](https://goreportcard.com/report/github.com/Pallinder/go-randomdata)
|
|
|
|
randomdata is a tiny help suite for generating random data such as
|
|
|
|
* first names (male or female)
|
|
* last names
|
|
* full names (male or female)
|
|
* country names (full name or iso 3166.1 alpha-2 or alpha-3)
|
|
* locales / language tags (bcp-47)
|
|
* random email address
|
|
* city names
|
|
* American state names (two chars or full)
|
|
* random numbers (in an interval)
|
|
* random paragraphs
|
|
* random bool values
|
|
* postal- or zip-codes formatted for a range of different countries.
|
|
* american sounding addresses / street names
|
|
* silly names - suitable for names of things
|
|
* random days
|
|
* random months
|
|
* random full date
|
|
* random full profile
|
|
* random date inside range
|
|
* random phone number
|
|
|
|
## Installation
|
|
|
|
```go get github.com/Pallinder/go-randomdata```
|
|
|
|
## Usage
|
|
|
|
```go
|
|
|
|
package main
|
|
|
|
import (
|
|
"fmt"
|
|
"github.com/Pallinder/go-randomdata"
|
|
)
|
|
|
|
func main() {
|
|
// Print a random silly name
|
|
fmt.Println(randomdata.SillyName())
|
|
|
|
// Print a male title
|
|
fmt.Println(randomdata.Title(randomdata.Male))
|
|
|
|
// Print a female title
|
|
fmt.Println(randomdata.Title(randomdata.Female))
|
|
|
|
// Print a title with random gender
|
|
fmt.Println(randomdata.Title(randomdata.RandomGender))
|
|
|
|
// Print a male first name
|
|
fmt.Println(randomdata.FirstName(randomdata.Male))
|
|
|
|
// Print a female first name
|
|
fmt.Println(randomdata.FirstName(randomdata.Female))
|
|
|
|
// Print a last name
|
|
fmt.Println(randomdata.LastName())
|
|
|
|
// Print a male name
|
|
fmt.Println(randomdata.FullName(randomdata.Male))
|
|
|
|
// Print a female name
|
|
fmt.Println(randomdata.FullName(randomdata.Female))
|
|
|
|
// Print a name with random gender
|
|
fmt.Println(randomdata.FullName(randomdata.RandomGender))
|
|
|
|
// Print an email
|
|
fmt.Println(randomdata.Email())
|
|
|
|
// Print a country with full text representation
|
|
fmt.Println(randomdata.Country(randomdata.FullCountry))
|
|
|
|
// Print a country using ISO 3166-1 alpha-2
|
|
fmt.Println(randomdata.Country(randomdata.TwoCharCountry))
|
|
|
|
// Print a country using ISO 3166-1 alpha-3
|
|
fmt.Println(randomdata.Country(randomdata.ThreeCharCountry))
|
|
|
|
// Print BCP 47 language tag
|
|
fmt.Println(randomdata.Locale())
|
|
|
|
// Print a currency using ISO 4217
|
|
fmt.Println(randomdata.Currency())
|
|
|
|
// Print the name of a random city
|
|
fmt.Println(randomdata.City())
|
|
|
|
// Print the name of a random american state
|
|
fmt.Println(randomdata.State(randomdata.Large))
|
|
|
|
// Print the name of a random american state using two chars
|
|
fmt.Println(randomdata.State(randomdata.Small))
|
|
|
|
// Print an american sounding street name
|
|
fmt.Println(randomdata.Street())
|
|
|
|
// Print an american sounding address
|
|
fmt.Println(randomdata.Address())
|
|
|
|
// Print a random number >= 10 and < 20
|
|
fmt.Println(randomdata.Number(10, 20))
|
|
|
|
// Print a number >= 0 and < 20
|
|
fmt.Println(randomdata.Number(20))
|
|
|
|
// Print a random float >= 0 and < 20 with decimal point 3
|
|
fmt.Println(randomdata.Decimal(0, 20, 3))
|
|
|
|
// Print a random float >= 10 and < 20
|
|
fmt.Println(randomdata.Decimal(10, 20))
|
|
|
|
// Print a random float >= 0 and < 20
|
|
fmt.Println(randomdata.Decimal(20))
|
|
|
|
// Print a bool
|
|
fmt.Println(randomdata.Boolean())
|
|
|
|
// Print a paragraph
|
|
fmt.Println(randomdata.Paragraph())
|
|
|
|
// Print a postal code
|
|
fmt.Println(randomdata.PostalCode("SE"))
|
|
|
|
// Print a set of 2 random numbers as a string
|
|
fmt.Println(randomdata.StringNumber(2, "-"))
|
|
|
|
// Print a set of 2 random 3-Digits numbers as a string
|
|
fmt.Println(randomdata.StringNumberExt(2, "-", 3))
|
|
|
|
// Print a random string sampled from a list of strings
|
|
fmt.Println(randomdata.StringSample("my string 1", "my string 2", "my string 3"))
|
|
|
|
// Print a valid random IPv4 address
|
|
fmt.Println(randomdata.IpV4Address())
|
|
|
|
// Print a valid random IPv6 address
|
|
fmt.Println(randomdata.IpV6Address())
|
|
|
|
// Print a browser's user agent string
|
|
fmt.Println(randomdata.UserAgentString())
|
|
|
|
// Print a day
|
|
fmt.Println(randomdata.Day())
|
|
|
|
// Print a month
|
|
fmt.Println(randomdata.Month())
|
|
|
|
// Print full date like Monday 22 Aug 2016
|
|
fmt.Println(randomdata.FullDate())
|
|
|
|
// Print full date <= Monday 22 Aug 2016
|
|
fmt.Println(randomdata.FullDateInRange("2016-08-22"))
|
|
|
|
// Print full date >= Monday 01 Aug 2016 and <= Monday 22 Aug 2016
|
|
fmt.Println(randomdata.FullDateInRange("2016-08-01", "2016-08-22"))
|
|
|
|
// Print phone number according to e.164
|
|
fmt.Println(randomdata.PhoneNumber())
|
|
|
|
// Get a complete and randomised profile of data generally used for users
|
|
// There are many fields in the profile to use check the Profile struct definition in fullprofile.go
|
|
profile := randomdata.GenerateProfile(randomdata.Male | randomdata.Female | randomdata.RandomGender)
|
|
fmt.Printf("The new profile's username is: %s and password (md5): %s\n", profile.Login.Username, profile.Login.Md5)
|
|
|
|
// Get a random country-localised street name for Great Britain
|
|
fmt.Println(randomdata.StreetForCountry("GB"))
|
|
// Get a random country-localised street name for USA
|
|
fmt.Println(randomdata.StreetForCountry("US"))
|
|
|
|
// Get a random country-localised province for Great Britain
|
|
fmt.Println(randomdata.ProvinceForCountry("GB"))
|
|
// Get a random country-localised province for USA
|
|
fmt.Println(randomdata.ProvinceForCountry("US"))
|
|
}
|
|
|
|
```
|
|
|
|
## Versioning / Release Strategy
|
|
Go-Randomdata follows [Semver](https://www.semver.org)
|
|
|
|
You can find current releases tagged under the [releases section](https://github.com/Pallinder/go-randomdata/releases).
|
|
|
|
The [CHANGELOG.md](CHANGELOG.md) file contains the changelog of the project.
|
|
|
|
## Contributors
|
|
|
|
* [jteeuwen](https://github.com/jteeuwen)
|
|
* [n1try](https://github.com/n1try)
|
|
|
|
All the other contributors are listed [here](https://github.com/Pallinder/go-randomdata/graphs/contributors).
|