robotframework-mimesislibrary

A Robot Framework keyword library that wraps the Mimesis fake data generator, providing over 100 keywords to generate synthetic data directly in your test suites.

Installation

pip install robotframework-mimesislibrary

Quick Start

*** Settings ***
Library    MimesisLibrary

*** Test Cases ***
Generate Person Data
    ${name}=      Fake Full Name
    ${email}=     Fake Email
    ${phone}=     Fake Phone Number
    Log Many      ${name}    ${email}    ${phone}

Use Per-Keyword Locale
    ${arabic_name}=    Fake First Name    locale=AR
    ${french_city}=    Fake City          locale=FR
    ${turkish_name}=   Fake Full Name     locale=TR
    Log Many           ${arabic_name}     ${french_city}    ${turkish_name}

Generate Internet Data
    ${ip}=     Fake IPv4
    ${url}=    Fake URL
    ${mac}=    Fake MAC Address
    Log Many   ${ip}    ${url}    ${mac}

Generate Unique ID
    ${uuid}=    Fake UUID
    ${token}=   Fake Token Hex
    Log Many    ${uuid}    ${token}

Import Options

# Use default locale (English)
Library    MimesisLibrary

# Use a specific default locale
Library    MimesisLibrary    locale=TR

# Use with a fixed seed for reproducible data
Library    MimesisLibrary    locale=EN    seed=42

Keyword Categories

Supported Locales

Mimesis supports 30+ locales. Locale-dependent keywords (Person, Address, Food, Text, Finance, Datetime) accept a locale parameter:

${name}=    Fake First Name    locale=TR    # Turkish
${name}=    Fake First Name    locale=AR    # Arabic
${name}=    Fake First Name    locale=JA    # Japanese
${name}=    Fake First Name    locale=DE    # German
${name}=    Fake First Name    locale=FR    # French
${name}=    Fake First Name    locale=RU    # Russian

Locale-independent keywords (Fake UUID, Fake IPv4, Fake Integer, etc.) ignore the locale parameter.

Reproducible Data with Seeds

Library    MimesisLibrary    seed=42

*** Test Cases ***
Reproducible Test
    ${name}=    Fake First Name    # Always returns the same value

HTML Documentation

Generate the full keyword reference in HTML format:

python -m robot.libdoc MimesisLibrary docs/index.html

Development Setup

git clone https://github.com/your-org/robotframework-mimesislibrary
cd robotframework-mimesislibrary
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -e ".[dev]"

# Run tests
make test

# Generate docs
make docs

License

MIT License — see LICENSE for details.