Mimesis: fake data generator.
Project description
Mimesis - Fake Data Generator
Description
Mimesis (/mɪˈmiːsɪs, Ancient Greek: μίμησις, mīmēsis) is a high-performance fake data generator for Python, which provides data for a variety of purposes in a variety of languages. The fake data could be used to populate a testing database, create fake API endpoints, create JSON and XML files of arbitrary structure, anonymize data taken from production and etc.
Installation
To install mimesis, simply use pip:
~ ⟩ pip install mimesisPython compatibility
Mimesis 5.0 supports Python 3.8, 3.9, and 3.10.
The Mimesis 4.1.3 is the last to support Python 3.6 and 3.7.
Supported Features
Easy: Designed to be easy to use and learn.
Multilingual: Supports data for a lot of languages.
Performance: The fastest data generator available for Python.
Data variety: Supports a lot of data providers for a variety of purposes.
Country-specific data providers: Provides data specific only for some countries.
Extensibility: You can create your own data providers and use them with Mimesis.
Generic data provider: The simplified access to all the providers from a single object.
Zero hard dependencies: Does not require any modules other than the Python standard library.
Schema-based generators: Provides an easy mechanism to generate data by the schema of any complexity.
Documentation
You can find the complete documentation on the Read the Docs.
It is divided into several sections:
You can improve it by sending pull requests to this repository.
Usage
This readme file contains information for Mimesis 5.0.0 which is not released yet, so If you’re looking for actual docs for 4.1.3 then see: https://mimesis.name/
This library is really easy to use and everything you need is just import an object which represents a type of data you need (we call such object a Provider).
In the example below we import provider Person, which represents data related to personal information, such as name, surname, email and etc:
>>> from mimesis import Person
>>> from mimesis.locales import Locale
>>> person = Person(Locale.EN)
>>> person.full_name()
'Brande Sears'
>>> person.email(domains=['example.com'])
'roccelline1878@example.com'
>>> person.email(domains=['mimesis.name'], unique=True)
'f272a05d39ec46fdac5be4ac7be45f3f@mimesis.name'
>>> person.telephone(mask='1-4##-8##-5##3')
'1-436-896-5213'More about the other providers you can read in our documentation.
Locales
Mimesis currently includes support for 34 different locales. You can specify a locale when creating providers and they will return data that is appropriate for the language or country associated with that locale.
Let’s take a look how it works:
>>> from mimesis import Person
>>> from mimesis.locales import Locale
>>> from mimesis.enums import Gender
>>> de = Person(locale=Locale.DE)
>>> en = Person(locale=Locale.EN)
>>> de.full_name(gender=Gender.FEMALE)
'Sabrina Gutermuth'
>>> en.full_name(gender=Gender.MALE)
'Layne Gallagher'Providers
Mimesis support over twenty different data providers available, which can produce data related to people, food, computer hardware, transportation, addresses, internet and more.
See Data Providers for more info.
How to Contribute
Take a look at contributing guidelines.
Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug.
Fork the repository on GitHub to start making your changes to the your_branch branch.
Add yourself to the list of contributors.
Send a pull request and bug the maintainer until it gets merged and published.
Useful links
I have a Telegram channel where I daily post news, announces and all the open-source goodies I found, so subscribe: @software_dev_channel.
Disclaimer
The authors of Mimesis do not assume any responsibility for how you use it or how you use data generated with it. This library was designed with good intentions to make testing easier. Do not use the data generated with Mimesis for illegal purposes.
License
Mimesis is licensed under the MIT License. See LICENSE for more information.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file mimesis-5.0.0.tar.gz.
File metadata
- Download URL: mimesis-5.0.0.tar.gz
- Upload date:
- Size: 4.3 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.2 importlib_metadata/4.0.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 29b9e93ae8f44f17619b77e0a3922498c20cbe3ef3b294062833d69b809700dc |
|
| MD5 | e935c3efb5cc2afe6f7febf2f9a4c813 |
|
| BLAKE2b-256 | 0d23a24e92b73b4a4fca50f1121e6a86cd604a42cd6074f963aff70cd9c3cfbd |
File details
Details for the file mimesis-5.0.0-py3-none-any.whl.
File metadata
- Download URL: mimesis-5.0.0-py3-none-any.whl
- Upload date:
- Size: 4.4 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.2 importlib_metadata/4.0.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | d5114e7743128ec234e6acac2fa160b90e58c0d65ab64c8f1881182f0016a100 |
|
| MD5 | 0473ae0dd410ea4ca6610231de01ffb3 |
|
| BLAKE2b-256 | 32deed049afc9a530d0e9460e429b1a69b0d773b5f87df3d8f55da26244819a6 |
