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/readme-logo.png :target: https://github.com/lk-geimfari/mimesis
.. image:: https://github.com/lk-geimfari/mimesis/workflows/test/badge.svg?branch=master :target: https://github.com/lk-geimfari/mimesis/actions :alt: Github Actions Test
.. image:: https://readthedocs.org/projects/mimesis/badge/?version=latest :target: https://mimesis.name/ :alt: Documentation Status
.. image:: https://codecov.io/gh/lk-geimfari/mimesis/branch/master/graph/badge.svg :target: https://codecov.io/gh/lk-geimfari/mimesis :alt: Code Coverage
.. image:: https://www.codefactor.io/repository/github/lk-geimfari/mimesis/badge :target: https://www.codefactor.io/repository/github/lk-geimfari/mimesis :alt: CodeFactor
.. 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.6+-brightgreen.svg :target: https://badge.fury.io/py/mimesis :alt: Python version
Mimesis 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.
To install mimesis, simply use pip:
.. code:: text
~ ⟩ pip install mimesis
a lot of languages_.
fastest_ data generator available for Python.
a lot of data providers_ for a variety of purposes.
simplified_ access to all the providers from a single object.
You can find the complete documentation on the
Read the Docs_.
It is divided into several sections:
Tips and Tricks_
You can improve it by sending pull requests to this repository.
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 example below we import provider
Person_, which represents data related to personal information, such as name, surname, email and etc:
.. code:: python
>>> from mimesis import Person >>> person = Person('en')
>>> person.full_name() 'Brande Sears'
>>> person.email(domains=['mimesis.name']) '[email protected]'
>>> person.email(domains=['mimesis.name'], unique=True) '[email protected]'
>>> person.telephone(mask='1-4##-8##-5##3') '1-436-896-5213'
More about the other providers you can read in our
.. documentation: https://mimesis.name/gettingstarted.html#providers
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:
.. code:: python
>>> from mimesis import Person >>> from mimesis.enums import Gender
>>> de = Person('de') >>> en = Person('en')
>>> de.full_name(gender=Gender.FEMALE) 'Sabrina Gutermuth'
>>> en.full_name(gender=Gender.MALE) 'Layne Gallagher'
.. locales: https://mimesis.name/gettingstarted.html#locales
Mimesis support over twenty different data providers available, which can produce data related to people, food, computer hardware, transportation, addresses, internet and more.
API Reference_ for more info.
.. _contributing guidelines: https://github.com/lk-geimfari/mimesis/blob/master/CONTRIBUTING.rst .. _contributors: https://github.com/lk-geimfari/mimesis/blob/master/CONTRIBUTORS.rst
I have a Telegram channel where I daily post news, announces and all the open-source goodies I found, so subscribe:
The authors of
Mimesisdo 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.
Mimesis is licensed under the MIT License. See
LICENSE_ for more information.
.. _LICENSE: https://github.com/lk-geimfari/mimesis/blob/master/LICENSE