Mimesis: High‑Performance Python Fake Data Generator – Overview, Installation, and Usage

Overview

Mimesis is a high‑performance fake data generator for Python that supplies data in many languages for a wide range of purposes, such as populating test databases, creating mock API endpoints, generating JSON/XML/YAML files, and anonymizing production data.

Description

The library includes more than 20 data providers covering people, food, hardware, transportation, addresses, internet, and more. Its key features are:

Performance – the fastest data generator available for Python.

Extensibility – you can create custom data providers for simulation.

Unified provider access – simplified access to all providers from a single object.

Multilingual support – data for many languages.

Data diversity – providers for various use‑cases.

Schema‑based generators – generate data from complex schemas.

Country‑specific providers – locale‑aware data for specific regions.

Installation

<code>pip install mimesis</code>

Basic Usage

Import a provider (e.g., Person ) and generate data such as full name, email, and telephone numbers.

<code>&gt;&gt; from mimesis import Person
&gt;&gt; person = Person('en')
&gt;&gt; person.full_name()
'Brande Sears'
&gt;&gt; person.email(domains=['mimesis.name'])
'[email protected]'
&gt;&gt; person.email(domains=['mimesis.name'], unique=True)
'[email protected]'
&gt;&gt; person.telephone(mask='1-4##-8##-5##3')
'1-436-896-5213'
</code>

Locales

Mimesis supports 34 locales. You can specify a locale when creating a provider to obtain data appropriate for that language or region.

<code>&gt;&gt; from mimesis import Person
&gt;&gt; from mimesis.enums import Gender
&gt;&gt; de = Person('de')
&gt;&gt; en = Person('en')
&gt;&gt; de.full_name(gender=Gender.FEMALE)
'Sabrina Gutermuth'
&gt;&gt; en.full_name(gender=Gender.MALE)
'Layne Gallagher'
</code>

Structured Data Generation

Using the schema API, you can generate dictionaries that can be easily converted to JSON, XML, YAML, etc. The following Flask example demonstrates a mock API endpoint that returns generated data.

<code>from flask import Flask, jsonify, request
from mimesis.schema import Field, Schema
from mimesis.enums import Gender

app = Flask(__name__)

@app.route('/apps', methods=('GET',))
def apps_view():
    locale = request.args.get('locale', default='en', type=str)
    count = request.args.get('count', default=1, type=int)
    _ = Field(locale)
    schema = Schema(schema=lambda: {
        'id': _('uuid'),
        'name': _('text.word'),
        'version': _('version', pre_release=True),
        'timestamp': _('timestamp', posix=False),
        'owner': {
            'email': _('person.email', domains=['test.com'], key=str.lower),
            'token': _('token_hex'),
            'creator': _('full_name', gender=Gender.FEMALE)
        },
    })
    data = schema.create(iterations=count)
    return jsonify(data)
</code>

Documentation

The full documentation is divided into sections such as Foreword, Getting Started, Tips & Tricks, API Reference, Contributing, and Changelog.