Mimesis: The Fake Data Generator
Documentation: https://mimesis.name/
Mimesis (/mɪˈmiːsɪs) is a Python library for generating fake but realistic data in multiple languages and locales. It can generate names, addresses, dates, phone numbers, emails, financial data, and many other types of values.
It is commonly used to populate test databases, mock API responses, generate JSON or XML fixtures, create sample datasets, and anonymize production data. Mimesis provides a simple, consistent API that makes it easy to generate realistic data for development and testing.
The key features are:
- Multilingual: Supports 47 different locales.
- Extensibility: Supports custom data providers and custom field handlers.
- Ease of use: Features a simple design and clear documentation for straightforward data generation.
- Performance: Widely recognized as the fastest data generator among Python solutions.
- Data variety: Includes various data providers designed for different use cases.
- Schema-based generators: Offers schema-based data generators to effortlessly produce data of any complexity.
- Relational data: Supports generating related datasets with foreign keys and nested schemas.
- Intuitive: Great editor support. Fully typed, so you get autocompletion almost everywhere.
Installation
To install Mimesis, use pip:
~ pip install mimesis
Documentation
You can find the complete documentation on the Read the Docs.
It is divided into several sections:
- About Mimesis
- Quickstart
- Locales
- Data Providers
- Structured Data Generation
- Relational Data Generation
- Random and Seed
- Integration with factory_boy
- API Reference
- Changelog
You can improve it by sending pull requests to this repository.
Usage
Import a data provider that corresponds to the data type you need.
For example, the Person provider gives access to personal information, including name, surname, email, and other related fields:
from mimesis import Person
from mimesis.locales import Locale
person = Person(Locale.EN)
person.full_name()
# Output: 'Brande Sears'
person.email(domains=['example.com'])
# Output: 'roccelline1878@example.com'
person.email(domains=['mimesis.name'], unique=True)
# Output: 'f272a05d39ec46fdac5be4ac7be45f3f@mimesis.name'
person.telephone(mask='1-4##-8##-5##3')
# Output: '1-436-896-5213'
License
Mimesis is licensed under the MIT License. See LICENSE for more information.
2 maintainers
Metadata
2 maintainers
Release files for mimesis 22.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| mimesis-22.2.0.tar.gz | 18.3 MB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mimesis-22.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 22.8 MB
Release files / mimesis-22.2.0.tar.gz
| Download URL | mimesis-22.2.0.tar.gz |
|---|---|
| Size | 18.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7cd7d9dadd226129fd8bc6039fb0ff9b58efb2b4001022357f69381208e1df68
|
|
BLAKE2b-256 checksum How to use checksums |
e02b629274dd6e23df1ab470e2c039c77033f674f73f0d48cca3d0c7777fce67
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.18 {"installer":{"name":"uv","version":"0.12.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mimesis-22.2.0-py3-none-any.whl
| Download URL | mimesis-22.2.0-py3-none-any.whl |
|---|---|
| Size | 4.5 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
037011eb3d5edf0b0b5d9eafd74d9881f6dce25b4f01032da0e13fb2a56f37e9
|
|
BLAKE2b-256 checksum How to use checksums |
89a61031fb1c0f453abd96589e2126707a42bcc4d19ec1d705886df6188182df
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.18 {"installer":{"name":"uv","version":"0.12.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for mimesis 22.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
