Skip to content
Mimesis is a package for Python, which helps generate big volumes of fake data for a variety of purposes in a variety of languages.
Python Makefile
Branch: master
Clone or download

Latest commit

dependabot-preview Bump pytest-randomly from 3.3.1 to 3.4.0 (#860)
Bumps [pytest-randomly](https://github.com/pytest-dev/pytest-randomly) from 3.3.1 to 3.4.0.
- [Release notes](https://github.com/pytest-dev/pytest-randomly/releases)
- [Changelog](https://github.com/pytest-dev/pytest-randomly/blob/master/HISTORY.rst)
- [Commits](pytest-dev/pytest-randomly@3.3.1...3.4.0)

Signed-off-by: dependabot-preview[bot] <support@dependabot.com>

Co-authored-by: dependabot-preview[bot] <27856297+dependabot-preview[bot]@users.noreply.github.com>
Latest commit a8cc53c May 28, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update daysUntilStale for Stale Bot Dec 14, 2019
docs Bump sphinx from 3.0.3 to 3.0.4 (#859) May 27, 2020
media Updated filename Jan 31, 2019
mimesis Updated de-ch person dataset (#836) Apr 13, 2020
tests Disallow to use same placeholder for digit and char Mar 1, 2020
.editorconfig Refactoring (#586) Nov 27, 2018
.gitignore Refactor tests for username Mar 27, 2019
.readthedocs.yml Added .readthedocs.yml Nov 21, 2018
.travis.yml Migrate to poetry (Fix #781) (#820) Feb 27, 2020
CHANGELOG.rst Update changelog Feb 9, 2020
CODE_OF_CONDUCT.md Removed extra from shhhh Jan 21, 2019
CONTRIBUTING.rst Add pytest-randomly seedsetting functionto Makefile (#849) May 14, 2020
CONTRIBUTORS.rst Add pytest-randomly seedsetting functionto Makefile (#849) May 14, 2020
LICENSE Update LICENSE May 2, 2020
MANIFEST.in Included py.typed to package Mar 1, 2019
Makefile Add pytest-randomly seedsetting functionto Makefile (#849) May 14, 2020
README.rst Fix description and badges Feb 29, 2020
codecov.yml Added locales.py to ignore. Oct 23, 2018
poetry.lock Bump pytest-randomly from 3.3.1 to 3.4.0 (#860) May 28, 2020
pyproject.toml Bump pytest-randomly from 3.3.1 to 3.4.0 (#860) May 28, 2020
setup.cfg Updated isort rules Dec 15, 2018
setup.py Add Python 3.8 to classifiers in setup.py Dec 13, 2019

README.rst

Mimesis - Fake Data Generator


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

Description

Travis CI Documentation Status Code Coverage PyPi Version Python version Mimesis on PyPi

Mimesis is a package for Python, which helps generate big volumes of fake data for a variety of purposes in a variety of languages. The fake data could be used to populate a testing database, create JSON and XML files of arbitrary structure, anonymize data taken from production and etc.

Installation

To install mimesis, simply use pip:

[venv] ~ ⟩ pip install mimesis

Usage

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()
'Brande Sears'

>>> person.email(domains=['mimesis.name'])
'roccelline1878@mimesis.name'

>>> person.telephone(mask='1-4##-8##-5##3')
'1-436-896-5213'

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')
>>> en = Person('en')

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

>>> en.full_name(gender=Gender.MALE)
'Layne Gallagher'

Providers

Mimesis support over twenty different data providers available, which can produce data related to people, food, computer hardware, transportation, addresses, internet and more.

See API Reference for more info.

Generating structured data

You can generate dictionaries which can be easily converted to any format you want (JSON/XML/YAML etc.) with any structure you want.

See Schema and Fields for more info.

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.

You can’t perform that action at this time.