Mimesis (/mɪˈmiːsɪs) 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:
pip install mimesis- Multilingual: Supports multiple languages.
- Extensibility: Supports custom data providers.
- Easy: Offers a simple design and clear documentation for easy data generation.
- Performance: Widely recognized as the fastest data generator among Python solutions.
- Data variety: Includes a variety of data providers designed for different use cases.
- Schema-based generators: Offers schema-based data generators to effortlessly produce data of any complexity.
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
- 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 provider can be imported to access 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()
'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'You can learn more about other providers and locales in our documentation.
- 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.
Mimesis is licensed under the MIT License. See LICENSE for more information.