kathy-ythz5w/helpers/name_helpers.py
2025-03-27 05:31:33 -05:00

72 lines
2.0 KiB
Python

import random
from typing import List
# List of common girl names
GIRL_NAMES = [
"Sophia", "Emma", "Olivia", "Isabella", "Ava", "Mia", "Abigail", "Emily", "Charlotte", "Harper",
"Madison", "Amelia", "Elizabeth", "Sofia", "Avery", "Ella", "Scarlett", "Grace", "Chloe", "Victoria",
"Riley", "Aria", "Lily", "Aubrey", "Zoey", "Penelope", "Lillian", "Addison", "Layla", "Natalie",
"Camila", "Hannah", "Brooklyn", "Zoe", "Nora", "Leah", "Audrey", "Savannah", "Allison", "Samantha",
"Maya", "Eliza", "Brooke", "Isabelle", "Aaliyah", "Mila", "Evelyn", "Valentina", "Ariana", "Madelyn"
]
def get_random_girl_name() -> str:
"""
Get a random girl name from the predefined list.
Returns:
str: A random girl name
"""
return random.choice(GIRL_NAMES)
def generate_girl_names(count: int) -> List[str]:
"""
Generate a list of random girl names.
Args:
count (int): The number of names to generate.
Returns:
List[str]: A list of random girl names.
"""
return random.sample(GIRL_NAMES, count)
def is_valid_girl_name(name: str) -> bool:
"""
Check if a given name is a valid girl name.
Args:
name (str): The name to validate.
Returns:
bool: True if the name is a valid girl name, False otherwise.
"""
return name in GIRL_NAMES
def add_girl_name(name: str) -> None:
"""
Add a new girl name to the list of names.
Args:
name (str): The name to add.
Raises:
ValueError: If the name is already in the list.
"""
if name in GIRL_NAMES:
raise ValueError(f"Name '{name}' already exists in the list.")
GIRL_NAMES.append(name)
def remove_girl_name(name: str) -> None:
"""
Remove a girl name from the list of names.
Args:
name (str): The name to remove.
Raises:
ValueError: If the name is not found in the list.
"""
if name not in GIRL_NAMES:
raise ValueError(f"Name '{name}' not found in the list.")
GIRL_NAMES.remove(name)