Skip to main content

Mimesis: fake data generator.

Project description

Mimesis - Fake Data Generator


https://raw.githubusercontent.com/lk-geimfari/mimesis/master/media/readme-logo.png

Description

Travi CI AppVeyor CI Documentation Status Code Coverage Package version Python version

Mimesis is fast and extremely easy to use Python package, which helps generate big volumes of fake data for a variety of purposes in a variety of languages. The fake data can be particularly useful during software development and testing. For example, it could be used to populate a testing database, create beautiful JSON and XML files, anonymize data taken from a production service and etc.

Installation

To install mimesis, simply use pip:

[env] ~ ⟩ pip install mimesis

Getting started

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 Provider).

In example below we import provider Person, which represents data related to personal information, such as name, surname, email and etc:

>>> from mimesis import Person
>>> person = Person('en')

>>> person.full_name()
'Antonetta Garrison'

>>> person.occupation()
'Backend Developer'

>>> person.telephone()
'1-408-855-5063'

>>> person.identifier(mask='####/##-#')
'2714/48-4'

More about the other providers you can read in our documentation.

Locales

Mimesis currently includes support for 33 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.enums import Gender

>>> de = Person('de')
>>> pl = Person('pl')

>>> de.full_name(gender=Gender.FEMALE)
'Sabrina Gutermuth'

>>> pl.full_name(gender=Gender.MALE)
'Światosław Tomankiewicz'

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.

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-3.1.0.tar.gz (2.2 MB view details)

Uploaded Source

Built Distribution

mimesis-3.1.0-py3-none-any.whl (2.3 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mimesis-3.1.0.tar.gz
  • Upload date:
  • Size: 2.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.7.2 requests-toolbelt/0.9.1 tqdm/4.30.0 CPython/3.6.3

File hashes

Hashes for mimesis-3.1.0.tar.gz
Algorithm Hash digest
SHA256 2647493a72e9a97fb35aab4c6c16b2bcc4c1430931c996dc991b433a8c1a662c
MD5 73992e6d657a0e50398e9e14c965b7e0
BLAKE2b-256 fe4f2c636410653f79ceb41ee56e937adb1ff8c41d0cf649fc1df8796c1442d5

See more details on using hashes here.

File details

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

File metadata

  • Download URL: mimesis-3.1.0-py3-none-any.whl
  • Upload date:
  • Size: 2.3 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.7.2 requests-toolbelt/0.9.1 tqdm/4.30.0 CPython/3.6.3

File hashes

Hashes for mimesis-3.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d56676e877e0987004f5b03df25f90d72b735f54e3f0257541fcd256557b9370
MD5 7c195453dbe2d2a7fe5d840e8a741977
BLAKE2b-256 5dbaf77db197cb419de0dae0c53593f15a84d531b4433adaac6c4b98952a76c7

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