main.py

# main.py
import random
from fastapi import FastAPI, Request
from fastapi.templating import Jinja2Templates
from fastapi.responses import HTMLResponse
from faker import Faker

# Initialize FastAPI
app = FastAPI()

# Initialize Faker
fake = Faker()

# Jinja2 templates directory
templates = Jinja2Templates(directory="templates")


def generate_profile():
    """
  Generate a random user profile with consistent gender using Faker
  and a random avatar from RandomUser.me.

  Note: Faker generates gender-specific names, but emails are not guaranteed 
  to match the gender. In this implementation, emails are still random. 
  Hopefully, Faker will add gender-consistent emails in the future! 

  Returns a dictionary containing:
  - name: gender-consistent full name
  - email: (currently random) email
  - phone: random phone number
  - address: random address (newlines replaced with commas)
  - job: random job title
  - avatar: URL of a random gender-consistent avatar (0-99)
  - gender: 'male' or 'female'
  """

    gender = random.choice(["male", "female"])

    # Use Faker's profile to get gender-consistent name and email
    if gender == "male":
        profile = fake.profile(sex='M')
        avatar_gender = "men"
    else:
        profile = fake.profile(sex='F')
        avatar_gender = "women"

    # Random avatar from randomuser.me (0-99)
    avatar_id = random.randint(0, 99)
    avatar_url = f"https://randomuser.me/api/portraits/{avatar_gender}/{avatar_id}.jpg"

    return {
        "name": profile['name'],              # gender-consistent name
        "email": profile['mail'],              # currently random email
        "phone": fake.phone_number(),
        "address": fake.address().replace("\n", ", "),
        "job": fake.job(),
        "avatar": avatar_url,
        "gender": gender,
    }


@app.get("/", response_class=HTMLResponse)
async def home(request: Request):
    """
    Render the main page with an initial random profile.
    """
    profile = generate_profile()
    return templates.TemplateResponse("index.html", {"request": request, "profile": profile})


@app.get("/profile", response_class=HTMLResponse)
async def get_profile(request: Request):
    """
    Return only the profile card HTML (HTMX partial).
    Used when refreshing profile without reloading the page.
    """
    profile = generate_profile()
    return templates.TemplateResponse("profile_partial.html", {"request": request, "profile": profile})