Mimesis: Fake Data Generator

19.1.0 · active · verified Sat Apr 11

Mimesis is a powerful and fast fake data generator for Python. It provides data for a variety of purposes, including populating databases, creating test data, and anonymizing existing datasets. As of version 19.1.0, it supports numerous locales and data types. The library maintains an active development pace, with regular minor and major releases introducing new features, locales, and performance improvements, often on a monthly or bi-monthly cadence.

Warnings

breaking The internal pytest plugin was removed from Mimesis.
Fix: Instead of relying on the internal plugin, users should create project-specific fixtures and utilize the `Field` class for data generation within their tests.
breaking The `mimesis-factory` library was integrated directly into Mimesis, changing import paths and usage patterns for factory-based data generation.
Fix: If you were using `mimesis-factory`, you should now import factory-related functionalities directly from `mimesis` (e.g., `from mimesis.builtins import MimesisBaseFactory`) and adapt your code accordingly.
breaking The methods `Person.age()` and `Person.work_experience()` were removed.
Fix: For generating random integers that previously `age()` or `work_experience()` might have provided, use `person.random.randint(min_value, max_value)` instead.
gotcha The `Cryptographic` provider now uses a seedable random number generator instead of Python's `secrets` module.
Fix: If your previous code relied on the cryptographically secure randomness provided by `secrets` for the `Cryptographic` provider, be aware that this has changed. Ensure your usage aligns with the new seedable random behavior, especially for security-sensitive applications or when reproducible results are needed.

Install

pip install mimesis Install stable version

Imports

Generic
```
from mimesis import Generic
```
Person
```
from mimesis import Person
```
Locale
```
from mimesis.enums import Locale
```
Factory
```
from mimesis.builtins import MimesisBaseFactory
```
Since v15.0.0, mimesis-factory was integrated directly into Mimesis. Use MimesisBaseFactory or similar classes from mimesis.builtins.

Quickstart

This quickstart demonstrates how to initialize a `Generic` data generator with a specific locale and generate various types of fake data. It also shows direct initialization of a specific provider like `Person`.

from mimesis import Generic
from mimesis.enums import Locale

# Initialize with a specific locale
generator = Generic(locale=Locale.EN)

# Generate some fake data
name = generator.person.full_name()
email = generator.person.email()
address = generator.address.full_address()
company = generator.business.company()

print(f"Name: {name}")
print(f"Email: {email}")
print(f"Address: {address}")
print(f"Company: {company}")

# Example with a specific provider
person_provider = Person(Locale.RU)
print(f"Russian Phone: {person_provider.phone_number()}")

view raw JSON →