Skip to main content

Mimesis: Fake Data Generator.

Project description

Mimesis: The Fake Data Generator


https://raw.githubusercontent.com/lk-geimfari/mimesis/master/.github/images/logo.png

Description

Github Actions Test Documentation Status Code Coverage PyPi Version PyPI - Downloads Python version

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.

Installation

To install mimesis, simply use pip:

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.

Features

  • Multilingual: Supports 35 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.

  • Intuitive: Great editor support. Fully-typed, thus autocompletion almost everywhere.

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

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.

How to Contribute

  1. Take a look at contributing guidelines.

  2. Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug.

  3. Fork the repository on GitHub to start making your changes to the your_branch branch.

  4. Add yourself to the list of contributors.

  5. Send a pull request and bug the maintainer until it gets merged and published.

License

Mimesis is licensed under the MIT License. See LICENSE for more information.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mimesis-15.1.0.tar.gz (4.4 MB view details)

Uploaded Source

Built Distribution

mimesis-15.1.0-py3-none-any.whl (4.5 MB view details)

Uploaded Python 3

File details

Details for the file mimesis-15.1.0.tar.gz.

File metadata

  • Download URL: mimesis-15.1.0.tar.gz
  • Upload date:
  • Size: 4.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.1 CPython/3.10.13 Linux/6.5.0-1015-azure

File hashes

Hashes for mimesis-15.1.0.tar.gz
Algorithm Hash digest
SHA256 e1013d2d6bb8156a1449eb1317f31bd40264acf2b41c505bd9f6d7bcbc535406
MD5 1836a5ca4a3887dc5727c71ab3651323
BLAKE2b-256 31f9e765414f90c1a89c94caba254448286a8aa57f334d2b53a0d46db5844b66

See more details on using hashes here.

File details

Details for the file mimesis-15.1.0-py3-none-any.whl.

File metadata

  • Download URL: mimesis-15.1.0-py3-none-any.whl
  • Upload date:
  • Size: 4.5 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.1 CPython/3.10.13 Linux/6.5.0-1015-azure

File hashes

Hashes for mimesis-15.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 911e6d1ee3e9e8b73fe7ca3c539c4fc2ff6645b6b3848f1c77b4db95f9d96cca
MD5 a389c974e54b8e56470f8c09faa9c311
BLAKE2b-256 7e84dda8613360ef90a832d3e984ce566faea75d2b98a8c02d0bf7e8e343eb90

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page