person - added age

Author: brianvoe

README.md

@@ -427,6 +427,7 @@ FirstName() string
 MiddleName() string
 LastName() string
 Gender() string
+Age() int
 SSN() string
 EIN() string
 Hobby() string

person.go

@@ -11,6 +11,7 @@ type PersonInfo struct {
 	FirstName  string          `json:"first_name" xml:"first_name"`
 	LastName   string          `json:"last_name" xml:"last_name"`
 	Gender     string          `json:"gender" xml:"gender"`
+	Age        int             `json:"age" xml:"age"`
 	SSN        string          `json:"ssn" xml:"ssn"`
 	Hobby      string          `json:"hobby" xml:"hobby"`
 	Job        *JobInfo        `json:"job" xml:"job"`
@@ -30,6 +31,7 @@ func person(f *Faker) *PersonInfo {
 		FirstName:  firstName(f),
 		LastName:   lastName(f),
 		Gender:     gender(f),
+		Age:        age(f),
 		SSN:        ssn(f),
 		Hobby:      hobby(f),
 		Job:        job(f),
@@ -89,6 +91,14 @@ func (f *Faker) NameSuffix() string { return nameSuffix(f) }
 
 func nameSuffix(f *Faker) string { return getRandValue(f, []string{"person", "suffix"}) }
 
+// Age will generate a random age between 0 and 100
+func Age() int { return age(GlobalFaker) }
+
+// Age will generate a random age between 0 and 100
+func (f *Faker) Age() int { return age(f) }
+
+func age(f *Faker) int { return randIntRange(f, 0, 100) }
+
 // SSN will generate a random Social Security Number
 func SSN() string { return ssn(GlobalFaker) }
 
@@ -270,6 +280,7 @@ func addPersonLookup() {
 	"first_name": "Markus",
 	"last_name": "Moen",
 	"gender": "male",
+	"age": 30,
 	"ssn": "275413589",
 	"image": "https://picsum.photos/208/500",
 	"hobby": "Lacrosse",
@@ -450,7 +461,7 @@ func addPersonLookup() {
 		Generate: func(f *Faker, m *MapParams, info *Info) (any, error) { return lastName(f), nil },
 	})
 
-	// gender (keep terms neutral and search-friendly)
+	// gender
 	AddFuncLookup("gender", Info{
 		Display:     "Gender",
 		Category:    "person",
@@ -471,7 +482,25 @@ func addPersonLookup() {
 		Generate: func(f *Faker, m *MapParams, info *Info) (any, error) { return gender(f), nil },
 	})
 
-	// ssn (us)
+	// age
+	AddFuncLookup("age", Info{
+		Display:     "Age",
+		Category:    "person",
+		Description: "The number of years a person has lived",
+		Example:     "40",
+		Output:      "int",
+		Aliases: []string{
+			"age of person", "person age", "age of individual", "years old", "years of age",
+		},
+		Keywords: []string{
+			"years", "old", "birthday", "birthdate", "birth-date",
+			"lifespan", "maturity", "elderly", "young", "adult", "teenager", "child",
+			"senior", "juvenile", "minor", "majority", "minority", "generation",
+		},
+		Generate: func(f *Faker, m *MapParams, info *Info) (any, error) { return age(f), nil },
+	})
+
+	// ssn
 	AddFuncLookup("ssn", Info{
 		Display:     "SSN",
 		Category:    "person",

person_test.go

@@ -209,6 +209,26 @@ func BenchmarkGender(b *testing.B) {
 	}
 }
 
+func ExampleAge() {
+	Seed(11)
+	fmt.Println(Age())
+
+	// Output: 90
+}
+
+func ExampleFaker_Age() {
+	f := New(11)
+	fmt.Println(f.Age())
+
+	// Output: 90
+}
+
+func BenchmarkAge(b *testing.B) {
+	for i := 0; i < b.N; i++ {
+		Age()
+	}
+}
+
 func ExampleHobby() {
 	Seed(11)
 	fmt.Println(Hobby())
@@ -322,6 +342,7 @@ func ExamplePerson() {
 	fmt.Println(person.FirstName)
 	fmt.Println(person.LastName)
 	fmt.Println(person.Gender)
+	fmt.Println(person.Age)
 	fmt.Println(person.SSN)
 	fmt.Println(person.Hobby)
 
@@ -350,26 +371,27 @@ func ExamplePerson() {
 	// Output: Sonny
 	// Stiedemann
 	// male
-	// 280254464
-	// Sailing
-	// DataLogix
-	// Planner
-	// Human
-	// Usability
-	// 679 Underpassborough, Omaha, Massachusetts 37930
-	// 679 Underpassborough
-	// Omaha
-	// Massachusetts
-	// 37930
-	// Antigua and Barbuda
-	// 41.632289
-	// -1.458116
-	// 1026894059
-	// beaulahmayert@kautzer.net
-	// UnionPay
-	// 627700709387573
-	// 02/27
-	// 162
+	// 20
+	// 575624882
+	// Photography
+	// Qado Energy, Inc.
+	// Facilitator
+	// Regional
+	// Quality
+	// 79993 Lanebury, Lincoln, Kansas 93050
+	// 79993 Lanebury
+	// Lincoln
+	// Kansas
+	// 93050
+	// India
+	// -26.936948
+	// -28.374174
+	// 2689405915
+	// hopeprohaska@metz.io
+	// American Express
+	// 4570938757201747
+	// 11/28
+	// 205
 }
 
 func ExampleFaker_Person() {
@@ -383,6 +405,7 @@ func ExampleFaker_Person() {
 	fmt.Println(person.FirstName)
 	fmt.Println(person.LastName)
 	fmt.Println(person.Gender)
+	fmt.Println(person.Age)
 	fmt.Println(person.SSN)
 	fmt.Println(person.Hobby)
 
@@ -411,26 +434,27 @@ func ExampleFaker_Person() {
 	// Output: Sonny
 	// Stiedemann
 	// male
-	// 280254464
-	// Sailing
-	// DataLogix
-	// Planner
-	// Human
-	// Usability
-	// 679 Underpassborough, Omaha, Massachusetts 37930
-	// 679 Underpassborough
-	// Omaha
-	// Massachusetts
-	// 37930
-	// Antigua and Barbuda
-	// 41.632289
-	// -1.458116
-	// 1026894059
-	// beaulahmayert@kautzer.net
-	// UnionPay
-	// 627700709387573
-	// 02/27
-	// 162
+	// 20
+	// 575624882
+	// Photography
+	// Qado Energy, Inc.
+	// Facilitator
+	// Regional
+	// Quality
+	// 79993 Lanebury, Lincoln, Kansas 93050
+	// 79993 Lanebury
+	// Lincoln
+	// Kansas
+	// 93050
+	// India
+	// -26.936948
+	// -28.374174
+	// 2689405915
+	// hopeprohaska@metz.io
+	// American Express
+	// 4570938757201747
+	// 11/28
+	// 205
 }
 
 func BenchmarkPerson(b *testing.B) {