🌐 Phoney - Realistic Fake Data Generator

Generate locale-aware fake personal data for testing, development, and anonymization. Perfect for populating databases and creating test users.

🆕 What’s new in 0.3.1

• Resume/CV generator massively expanded: address, postal code, tools and soft skills, measurable project outcomes, volunteer work, publications, awards, references, languages with proficiency, education GPA/coursework, and richer text output.

🆕 What’s new in 0.3.0

• New identifiers: IMEI, VIN, EAN-13, UPC-A, ISBN-13
• Resume/CV generator: assemble person + career + skills + employment history into a structured CV dict or formatted text
• All identifier generators are importable directly:
  • from phoney import generate_imei, generate_vin, generate_ean13, generate_upca, generate_isbn13
• The Phoney class exposes both explicit and generate_* convenience methods:
  • p.imei(), p.vin(), p.ean13(), p.upca(), p.isbn13()
  • p.generate_imei(), p.generate_vin(), p.generate_ean13(), ...
• Internet module hardened:
  • Locale/country-aware IPv4/IPv6 with regional fallbacks; canonical IPv6 formatting
  • TLD preferences per-country; robust domain/hostname/url builders
• Career module: job titles, salary ranges (by locale), skills, employment history
• CLI: phoney-build-prefixes to generate per-country IPv4/IPv6 prefix files from RIR datasets
• Packaging cleanup and Python >= 3.10

Quick test after install:

from phoney import generate_imei, Phoney
print(generate_imei())
p = Phoney()
print(p.imei())
print(p.generate_imei())
print(p.resume(format='text')[:120])

✨ Features

• 50+ locales including en_US, fr_FR, ja_JP, de_DE, and more
• Complete profiles with names, emails, phones, birthdates, and online presence
• Gender-specific name generation
• Usernames, passwords, UUIDs, user agents, and social handles
• Financial data (credit card, IBAN, BIC, etc.)
• Zero dependencies — lightweight and fast

📦 Installation

pip install phoney

🚀 Basic Usage

from phoney import Phoney

phoney = Phoney()

# Individual data
print(phoney.first_name(locale="it_IT"))  # → "Marco"
print(phoney.phone(locale="ja_JP"))       # → "+81 90-1234-5678"
print(phoney.email(first_name="Anna", last_name="Rossi", locale="it_IT"))

# Complete profile
profile = phoney.profile(locale="es_ES")
print(profile)

# Online presence
print(phoney.username("John", "Smith"))
print(phoney.password())
print(phoney.social_handle("John", "Smith", "twitter"))
print(phoney.online_presence("John", "Smith"))

# User agent and UUID
print(phoney.user_agent())
print(phoney.uuid())

📚 High-Level API: Phoney Class

🧩 Profile Structure

{
  'first_name': 'Sophie',
  'last_name': 'Martin',
  'gender': 'female',
  'age': 34,
  'birthdate': datetime.date(1990, 5, 12),
  'email': 'sophie.martin@example.fr',
  'phone': '+33 6 12 34 56 78',
  'locale': 'fr_FR'
}

🛠️ Low-Level API: Direct Functions

You can also import and use the following functions directly:

• generate_person(locale, gender=None) — dict with first/last name and gender
• generate_phone(locale) — phone number for locale
• generate_email(first_name, last_name, locale, age=None, birth_year=None)
• generate_age(min_age=18, max_age=80) — tuple of (age, birthdate)
• generate_profile(locale, gender=None, domain=None, uuid_version=4) — full profile
• generate_user_agent(device_type="desktop") — browser user agent string
• generate_uuid(version=4, domain="example.com", name=None) — UUID string
• generate_username(first_name, last_name, locale='en_US')
• generate_password(min_length=12, max_length=18)
• generate_social_handles(first_name, last_name, platform)
• generate_online_presence(first_name, last_name)
• generate_resume(locale=None, family=None, years=8, format='dict|text') — structured CV dict or a formatted plain-text resume

📦 Modules Overview

phoney/age.py — Age and birthdate generation

• generate_age(min_age=18, max_age=80)

phoney/agent.py — User agent string generation

• generate_user_agent(device_type="desktop")

phoney/create_profile.py — Complete profile generation

• generate_profile(locale, gender=None, domain=None, uuid_version=4)

phoney/data_loader.py — Loads locale data, names, phone formats, email domains

• load_countries(), load_streets(), load_cities(), load_states()
• get_available_locales(), load_names(locale), load_phone_formats(), load_email_domains()

phoney/emailgen.py — Email address generation

• generate_email(first_name, last_name, locale, age=None, birth_year=None, domain=None)

phoney/financial.py — Financial data generator

• FinancialDataGenerator(locale='en_US') class: .generate() for credit card, IBAN, BIC, etc.

phoney/person.py — Person name and gender generation

• generate_person(locale, gender=None)

phoney/phone.py — Phone number generation

• generate_phone(locale=None, max_attempts=500)

phoney/username.py — Username, password, and online presence generation

• generate_username(), generate_password(), generate_social_handles(), generate_online_presence()

phoney/uuidgen.py — UUID generation

• generate_uuid(version=4, domain="example.com", name=None)

🌍 Supported Locales

Phoney supports 50+ locales across Asia, Europe, the Middle East, and the Americas. To list all available locales:

from phoney.data_loader import get_available_locales
print(get_available_locales())

📜 License

MIT — Free for commercial and personal use. Developed by rarfile • Report Issue

🧑‍💼 Career Module

Generate job titles, salary ranges, skills, and employment histories. Data loads from phoney/data/career when present.

Examples:

from phoney import phoney
phoney.job_title()
phoney.salary(locale="en_US", family="software_engineer", level="Senior")
phoney.skills("software_engineer", level="Senior", count=10)
phoney.employment_history(years=8, locale="en_US", family="software_engineer")
phoney.experience_level(7)

Data files:

• phoney/data/career/job_families.json
• phoney/data/career/skills.json
• phoney/data/career/salary_ranges.<locale>.json
• phoney/data/career/companies.<locale>.txt

🌐 Internet Module

Generate domains, URLs, hostnames, IP addresses, and MAC addresses. Data loads from phoney/data/internet when present.

Examples:

phoney.tld(locale="en_GB")            # → 'co.uk'
phoney.domain(locale="en_GB")         # → 'nova-1abc.co.uk'
phoney.hostname(locale="en_GB")       # → 'api-xyz.nova-1abc.co.uk'
phoney.url(locale="ja_JP")            # → 'https://alpha-zz9.jp/api/q8h2?page=3'
phoney.ipv4(locale="en_GB")           # country-aware IPv4 when data present; RIPE fallback otherwise
phoney.ipv6(locale="ja_JP")           # country/region-aware IPv6; always valid global-unicast
phoney.mac()

Data files:

• phoney/data/internet/tlds.txt
• phoney/data/internet/words.txt
• phoney/data/internet/ipv4_prefixes.<CC>.txt (optional, one IPv4 CIDR per line)
• phoney/data/internet/ipv6_prefixes.<CC>.txt (optional, one IPv6 CIDR per line)

Behavior notes:

• Locale parsing accepts en_GB, en-GB, or bare GB.
• IPv4: If ipv4_prefixes.<CC>.txt exists, IPs are drawn from those ranges; otherwise a regional fallback is used (e.g., RIPE for Europe, APNIC for Asia/Pacific) and private/reserved ranges are avoided.
• IPv6: If ipv6_prefixes.<CC>.txt exists, IPs are drawn from those ranges; otherwise a regional fallback /12 is used:
  • RIPE (Europe): 2a00::/12
  • APNIC (Asia/Pacific): 2400::/12
  • ARIN (North America): 2600::/12
  • LACNIC (LatAm): 2800::/12
  • AFRINIC (Africa): 2c00::/12 If no locale is provided, a valid global-unicast from 2000::/3 is generated. All IPv6 addresses are returned in canonical compressed form.

🆔 Other Identifiers

Generate common test identifiers.

Examples:

phoney.imei()                # 15-digit IMEI (Luhn-valid)
phoney.vin()                 # 17-char VIN with check digit
phoney.ean13()               # EAN-13 barcode
phoney.upca()                # UPC-A barcode
phoney.isbn13()              # ISBN-13 (default group '978')

Populate per-country prefixes automatically (offline):

1. Download the latest delegated-*-extended-latest files from each RIR to a folder (e.g., C:/rir-data):

• delegated-apnic-extended-latest
• delegated-arin-extended-latest
• delegated-ripencc-extended-latest
• delegated-lacnic-extended-latest
• delegated-afrinic-extended-latest

2. Run the builder CLI to generate ipv4_prefixes.<CC>.txt and ipv6_prefixes.<CC>.txt files:

phoney-build-prefixes --input-dir C:/rir-data

You can also specify a custom output directory:

phoney-build-prefixes --input-dir C:/rir-data --output-dir C:/my-prefixes

📝 Resume/CV Generator

Create an in-depth resume by combining person, career, skills, and job history. Returns a structured dict or a readable text resume.

Examples:

from phoney import generate_resume, Phoney

# Structured CV
cv = generate_resume(locale='en_GB', family='software_engineer', years=7, format='dict')
print(cv['headline'])
print(cv['skills']['core'])
print(len(cv['experience']))

# Text resume via Phoney
p = Phoney()
print(p.resume(locale='en_GB', years=5, format='text'))

Notes:

• family biases titles, skills, salary ranges, and responsibilities.
• years controls the history window and affects education year.
• Text output is a compact, single-file resume suitable for quick copying.