https://github.com/plimble/rand

Random Data
https://github.com/plimble/rand

Last synced: 7 months ago
JSON representation

Random Data

• Host: GitHub
• URL: https://github.com/plimble/rand
• Owner: plimble
• License: mit
• Created: 2015-03-16T03:40:15.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2015-04-30T16:46:45.000Z (over 11 years ago)
• Last Synced: 2024-06-21T13:14:31.774Z (about 2 years ago)
• Language: Go
• Size: 164 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
go-randomdata

==============

[![Build Status](https://travis-ci.org/Pallinder/go-randomdata.png)](https://travis-ci.org/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)

* 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

### Installation

```go get github.com/Pallinder/go-randomdata```

### Documentation

http://godoc.org/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 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 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(Decimal(0, 20, 3))

	// Print a random float >= 10 and <= 20

	fmt.Println(Decimal(10, 20))

	// Print a random float >= 0 and <= 20

	fmt.Println(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 random numbers as a string

	fmt.Println(randomdata.StringNumber(2,"-"))

	

	// Print a valid random IPv4 address

	fmt.Println(randomdata.IpV4Address())	

}

```

### Contributors

* https://github.com/jteeuwen