Mimesis is a high-performance fake data generator for Python, which provides data for a variety of purposes in a variety of languages.
|
… image:: https://raw.githubusercontent.com/lk-geimfari/mimesis/master/.github/images/logo.png
:target: https://github.com/lk-geimfari/mimesis
|
… image:: https://github.com/lk-geimfari/mimesis/actions/workflows/test.yml/badge.svg?branch=master
:target: https://github.com/lk-geimfari/mimesis/actions/workflows/test.yml?query=branch%3Amaster
:alt: Github Actions Test
… image:: https://readthedocs.org/projects/mimesis/badge/?version=latest
:target: https://mimesis.name/en/latest/
:alt: Documentation Status
… image:: https://img.shields.io/pypi/v/mimesis?color=bright-green
:target: https://pypi.org/project/mimesis/
:alt: PyPi Version
… image:: https://img.shields.io/pypi/dm/mimesis
:target: https://pypi.org/project/mimesis/
:alt: PyPI - Downloads
… image:: https://img.shields.io/badge/python-3.10 | 3.11 | 3.12 | pypy-brightgreen
:target: https://pypi.org/project/mimesis/
:alt: Python version
Mimesis (/mɪˈmiːsɪs <https://mimesis.name/en/master/about.html#what-does-name-mean>
_) is a robust data generator for Python that can produce a wide range of fake data in various languages. This tool is useful for populating testing databases, creating fake API endpoints, filling pandas DataFrames
, generating JSON and XML files with custom structures, and anonymizing production data, among other purposes.
To install mimesis, simply use pip:
… code:: bash
pip install mimesis
To work with Mimesis on Python versions 3.8 and 3.9, the final compatible version is Mimesis 11.1.0.
Install this specific version to ensure compatibility.
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
_Random and Seed
_Integration with Pytest
_Integration with factory_boy
_Tricks and Tips
_API Reference
_Additional Information
_Changelog
_You can improve it by sending pull requests to this repository.
The library is exceptionally user-friendly, and it only requires you to import a Data Provider object that corresponds to the desired data type.
For instance, the Person <https://mimesis.name/en/latest/api.html#person>
_ provider can be imported to access personal information, including name, surname, email, and other related fields:
… code:: python
>>> from mimesis import Person
>>> from mimesis.locales import Locale
>>> person = Person(Locale.EN)
>>> person.full_name()
'Brande Sears'
>>> person.email(domains=['example.com'])
'[email protected]'
>>> person.email(domains=['mimesis.name'], unique=True)
'[email protected]'
>>> person.telephone(mask='1-4##-8##-5##3')
'1-436-896-5213'
You can learn more about other providers and locales in our documentation
_.
contributing guidelines
_.contributors
_.Mimesis is licensed under the MIT License. See LICENSE
_ for more
information.
… _Locales: https://mimesis.name/en/master/locales.html
… _LICENSE: https://github.com/lk-geimfari/mimesis/blob/master/LICENSE
… _API Reference: https://mimesis.name/en/master/api.html
… _Data Providers: https://mimesis.name/en/master/getting_started.html#data-providers
… _Read the Docs: https://mimesis.name/en/master/
… _About Mimesis: https://mimesis.name/en/latest/about.html
… _Quickstart: https://mimesis.name/en/master/quickstart.html
… _Structured Data Generation: https://mimesis.name/en/master/schema.html
… _Random and Seed: https://mimesis.name/en/master/random_and_seed.html
… _Tricks and Tips: https://mimesis.name/en/master/tips.html
… _Additional Information: https://mimesis.name/en/master/index.html#additional-information
… _Changelog: https://mimesis.name/en/master/index.html#changelog
… _documentation: https://mimesis.name/en/latest/getting_started.html#data-providers
… _contributing guidelines: https://github.com/lk-geimfari/mimesis/blob/master/CONTRIBUTING.rst
… _contributors: https://github.com/lk-geimfari/mimesis/blob/master/CONTRIBUTORS.rst
… _Integration with Pytest: https://mimesis.name/en/master/pytest_plugin.html
… _Integration with factory_boy: https://mimesis.name/en/master/factory_plugin.html