Mimesis: mock data for developers.
Project description
Mimesis is a fast and easy to use library for Python programming language, which helps generate synthetic data for a variety of purposes in a variety of languages. This 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, etc.
This library offers a number of advantages over other similar libraries:
Performance. Significantly faster than other similar libraries.
Completeness. Strives to provide many detailed providers that offer a variety of data generators.
Simplicity. Does not require any modules other than the Python standard library.
Installation
To install mimesis, simply use pip:
➜ ~ pip install mimesisalso you can install it manually:
(env) ➜ git clone git@github.com:lk-geimfari/mimesis.git
(env) ➜ cd mimesis/
(env) ➜ make installDocumentation
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.
Getting started
That’s library is really easy to use and a simple usage example is given below:
>>> from mimesis import Person
>>> person = Person('en')
>>> person.full_name()
'Antonetta Garrison'
>>> person.occupation()
'Backend Developer'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:
>>> 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'How to Contribute
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.
License
Mimesis is licensed under the MIT License. See LICENSE for more information.
Disclaimer
The authors assume no responsibility for how you use this library data generated by it. This library is designed only for developers with good intentions. Do not use the data generated with Mimesis for illegal purposes.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file mimesis-2.1.0.tar.gz.
File metadata
- Download URL: mimesis-2.1.0.tar.gz
- Upload date:
- Size: 2.4 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 4b856023acdaaefe2e10bbfea9fd4cb6fa9adbbbe9618a8f796aa8887b58e6f2 |
|
| MD5 | 0bd6f65329760b43662af6c6c495be45 |
|
| BLAKE2b-256 | cee8f7a590bfa26d654d139e124dafb178fbd1133e86cc6773f1d5c031250689 |
File details
Details for the file mimesis-2.1.0-py3-none-any.whl.
File metadata
- Download URL: mimesis-2.1.0-py3-none-any.whl
- Upload date:
- Size: 2.4 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 2a17aa98cc8aff2c0b1828312e213a515030ed57a1c7b61fc07a87150cb0f25f |
|
| MD5 | 78062d32b65ba0f007c2b999e6805872 |
|
| BLAKE2b-256 | c17be09e523bce60e6228920ab6a372e3263e73bee6d62dbee74f54585068352 |
