mimesis


Namemimesis JSON
Version 5.5.0 PyPI version JSON
download
home_pagehttps://github.com/lk-geimfari/mimesis
SummaryMimesis: Fake Data Generator.
upload_time2022-06-22 12:07:15
maintainer
docs_urlNone
authorIsaak Uchakaev
requires_python>=3.8,<4.0
licenseMIT
keywords data database dummy fake faker fixtures generate mimesis mock populate testing
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            Mimesis: The Fake Data Generator
--------------------------------

|

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

|

Description
-----------

.. image:: https://github.com/lk-geimfari/mimesis/actions/workflows/test.yml/badge.svg?branch=master
     :target: https://github.com/lk-geimfari/mimesis/actions/workflows/test.yml?query=branch%3Amaster
     :alt: Github Actions Test

.. image:: https://readthedocs.org/projects/mimesis/badge/?version=latest
     :target: https://mimesis.name/en/latest/
     :alt: Documentation Status

.. image:: https://codecov.io/gh/lk-geimfari/mimesis/branch/master/graph/badge.svg
     :target: https://codecov.io/gh/lk-geimfari/mimesis
     :alt: Code Coverage

.. image:: https://www.codefactor.io/repository/github/lk-geimfari/mimesis/badge
   :target: https://www.codefactor.io/repository/github/lk-geimfari/mimesis
   :alt: CodeFactor

.. image:: https://img.shields.io/pypi/v/mimesis?color=bright-green
     :target: https://pypi.org/project/mimesis/
     :alt: PyPi Version

.. image:: https://img.shields.io/pypi/dm/mimesis
     :target: https://pypi.org/project/mimesis/
     :alt: PyPI - Downloads

.. image:: https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10%20%7C%20pypy-brightgreen
     :target: https://pypi.org/project/mimesis/
     :alt: Python version

Mimesis (/mɪˈmiːsɪs, Ancient Greek: μίμησις, mīmēsis) is a high-performance fake data generator for Python,
which provides data for a variety of purposes in a variety of languages. The fake data could be used to populate
a testing database, create fake API endpoints, create JSON and XML files of arbitrary structure, anonymize data taken
from production and etc.

Installation
------------


To install mimesis, simply use pip:

.. code:: bash

    pip install mimesis


Python compatibility
---------------------

Mimesis supports Python 3.8 (also PyPy 3.8), 3.9, and 3.10.

The Mimesis 4.1.3 is the last to support Python 3.6 and 3.7.

Supported Features
------------------

- **Easy**: Designed to be easy to use and learn.
- **Multilingual**: Supports data for `a lot of languages <https://mimesis.name/en/latest/getting_started.html#supported-locales>`_.
- **Performance**: The `fastest <https://mimesis.name/en/latest/about.html#performance>`_ data generator available for Python.
- **Data variety**: Supports `a lot of data providers <https://mimesis.name/en/latest/api.html>`_ for a variety of purposes.
- **Country-specific data providers**: Provides data specific only for `some countries <https://mimesis.name/en/latest/api.html#builtin-data-providers>`_.
- **Extensibility**: You can create your own data providers and use them with Mimesis.
- **Generic data provider**: The `simplified <https://mimesis.name/en/latest/getting_started.html#generic-provider>`_ access to all the providers from a single object.
- **Zero hard dependencies**: Does not require any modules other than the Python standard library.
- **Schema-based generators**: Provides an easy mechanism to generate data by the schema of any complexity.


Documentation
-------------

You can find the complete documentation on the `Read the Docs <https://mimesis.name/en/latest/>`_.

It is divided into several sections:

-  `About Mimesis <https://mimesis.name/en/latest/about.html>`_
-  `Getting Started <https://mimesis.name/en/latest/getting_started.html>`_
-  `Tips and Tricks <https://mimesis.name/en/latest/tips.html>`_
-  `API Reference <https://mimesis.name/en/latest/api.html>`_
-  `Contributing <https://mimesis.name/en/latest/contributing.html>`_
-  `Changelog <https://mimesis.name/en/latest/changelog.html>`_

You can improve it by sending pull requests to this repository.

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

In the example below we import provider `Person <https://mimesis.name/en/latest/api.html#person>`_,
which represents data related to personal information, such as name, surname, email and etc:

.. code:: python

    >>> 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'


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

.. _documentation: https://mimesis.name/en/latest/getting_started.html#data-providers


Locales
-------

Mimesis currently includes support for 34 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:

.. code:: python

    >>> from mimesis import Person
    >>> from mimesis.locales import Locale
    >>> from mimesis.enums import Gender

    >>> de = Person(locale=Locale.DE)
    >>> en = Person(locale=Locale.EN)

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

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


.. _locales: https://mimesis.name/en/latest/getting_started.html#supported-locales

Providers
---------

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


You can generate a lot of extremely detailed data:

.. code:: python

    >>> from mimesis import Internet
    >>> from mimesis.enums import URLScheme
    >>> internet = Internet()
    >>> internet.url(scheme=URLScheme.WSS, subdomains=["chat"])
    'wss://chat.system.io/'


See `API Reference <https://mimesis.name/en/latest/api.html>`_ and `Data Providers <https://mimesis.name/en/latest/getting_started.html#data-providers>`_ for more info.

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.

.. _contributing guidelines: https://github.com/lk-geimfari/mimesis/blob/master/CONTRIBUTING.rst
.. _contributors: https://github.com/lk-geimfari/mimesis/blob/master/CONTRIBUTORS.rst


Useful links
------------

I have a Telegram channel where I daily post news, announces and all the open-source
goodies I found, so subscribe: `@software_dev_channel <https://t.me/software_dev_channel>`_.

Disclaimer
----------

The authors of `Mimesis` do not assume any responsibility for how you use it or how you use data generated with it.
This library was designed with good intentions to make testing easier. Do not use the data generated with Mimesis for illegal purposes.

License
-------

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

.. _LICENSE: https://github.com/lk-geimfari/mimesis/blob/master/LICENSE

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/lk-geimfari/mimesis",
    "name": "mimesis",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.8,<4.0",
    "maintainer_email": "",
    "keywords": "data,database,dummy,fake,faker,fixtures,generate,mimesis,mock,populate,testing",
    "author": "Isaak Uchakaev",
    "author_email": "likid.geimfari@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/8d/a4/0437b23755327e3e76685dc076974bdaa1b847db070be8db7f9b0e8b323e/mimesis-5.5.0.tar.gz",
    "platform": null,
    "description": "Mimesis: The Fake Data Generator\n--------------------------------\n\n|\n\n.. image:: https://raw.githubusercontent.com/lk-geimfari/mimesis/master/.github/images/logo-white-bg.png\n     :target: https://github.com/lk-geimfari/mimesis\n\n|\n\nDescription\n-----------\n\n.. image:: https://github.com/lk-geimfari/mimesis/actions/workflows/test.yml/badge.svg?branch=master\n     :target: https://github.com/lk-geimfari/mimesis/actions/workflows/test.yml?query=branch%3Amaster\n     :alt: Github Actions Test\n\n.. image:: https://readthedocs.org/projects/mimesis/badge/?version=latest\n     :target: https://mimesis.name/en/latest/\n     :alt: Documentation Status\n\n.. image:: https://codecov.io/gh/lk-geimfari/mimesis/branch/master/graph/badge.svg\n     :target: https://codecov.io/gh/lk-geimfari/mimesis\n     :alt: Code Coverage\n\n.. image:: https://www.codefactor.io/repository/github/lk-geimfari/mimesis/badge\n   :target: https://www.codefactor.io/repository/github/lk-geimfari/mimesis\n   :alt: CodeFactor\n\n.. image:: https://img.shields.io/pypi/v/mimesis?color=bright-green\n     :target: https://pypi.org/project/mimesis/\n     :alt: PyPi Version\n\n.. image:: https://img.shields.io/pypi/dm/mimesis\n     :target: https://pypi.org/project/mimesis/\n     :alt: PyPI - Downloads\n\n.. image:: https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10%20%7C%20pypy-brightgreen\n     :target: https://pypi.org/project/mimesis/\n     :alt: Python version\n\nMimesis (/m\u026a\u02c8mi\u02d0s\u026as, Ancient Greek: \u03bc\u03af\u03bc\u03b7\u03c3\u03b9\u03c2, m\u012bm\u0113sis) is a high-performance fake data generator for Python,\nwhich provides data for a variety of purposes in a variety of languages. The fake data could be used to populate\na testing database, create fake API endpoints, create JSON and XML files of arbitrary structure, anonymize data taken\nfrom production and etc.\n\nInstallation\n------------\n\n\nTo install mimesis, simply use pip:\n\n.. code:: bash\n\n    pip install mimesis\n\n\nPython compatibility\n---------------------\n\nMimesis supports Python 3.8 (also PyPy 3.8), 3.9, and 3.10.\n\nThe Mimesis 4.1.3 is the last to support Python 3.6 and 3.7.\n\nSupported Features\n------------------\n\n- **Easy**: Designed to be easy to use and learn.\n- **Multilingual**: Supports data for `a lot of languages <https://mimesis.name/en/latest/getting_started.html#supported-locales>`_.\n- **Performance**: The `fastest <https://mimesis.name/en/latest/about.html#performance>`_ data generator available for Python.\n- **Data variety**: Supports `a lot of data providers <https://mimesis.name/en/latest/api.html>`_ for a variety of purposes.\n- **Country-specific data providers**: Provides data specific only for `some countries <https://mimesis.name/en/latest/api.html#builtin-data-providers>`_.\n- **Extensibility**: You can create your own data providers and use them with Mimesis.\n- **Generic data provider**: The `simplified <https://mimesis.name/en/latest/getting_started.html#generic-provider>`_ access to all the providers from a single object.\n- **Zero hard dependencies**: Does not require any modules other than the Python standard library.\n- **Schema-based generators**: Provides an easy mechanism to generate data by the schema of any complexity.\n\n\nDocumentation\n-------------\n\nYou can find the complete documentation on the `Read the Docs <https://mimesis.name/en/latest/>`_.\n\nIt is divided into several sections:\n\n-  `About Mimesis <https://mimesis.name/en/latest/about.html>`_\n-  `Getting Started <https://mimesis.name/en/latest/getting_started.html>`_\n-  `Tips and Tricks <https://mimesis.name/en/latest/tips.html>`_\n-  `API Reference <https://mimesis.name/en/latest/api.html>`_\n-  `Contributing <https://mimesis.name/en/latest/contributing.html>`_\n-  `Changelog <https://mimesis.name/en/latest/changelog.html>`_\n\nYou can improve it by sending pull requests to this repository.\n\nUsage\n-----\n\nThis library is really easy to use and everything you need is just import an object which\nrepresents a type of data you need (we call such object a *Provider*).\n\nIn the example below we import provider `Person <https://mimesis.name/en/latest/api.html#person>`_,\nwhich represents data related to personal information, such as name, surname, email and etc:\n\n.. code:: python\n\n    >>> from mimesis import Person\n    >>> from mimesis.locales import Locale\n    >>> person = Person(Locale.EN)\n\n    >>> person.full_name()\n    'Brande Sears'\n\n    >>> person.email(domains=['example.com'])\n    'roccelline1878@example.com'\n\n    >>> person.email(domains=['mimesis.name'], unique=True)\n    'f272a05d39ec46fdac5be4ac7be45f3f@mimesis.name'\n\n    >>> person.telephone(mask='1-4##-8##-5##3')\n    '1-436-896-5213'\n\n\nMore about the other providers you can read in our `documentation`_.\n\n.. _documentation: https://mimesis.name/en/latest/getting_started.html#data-providers\n\n\nLocales\n-------\n\nMimesis currently includes support for 34 different `locales`_. You can\nspecify a locale when creating providers and they will return data that\nis appropriate for the language or country associated with that locale.\n\nLet's take a look how it works:\n\n.. code:: python\n\n    >>> from mimesis import Person\n    >>> from mimesis.locales import Locale\n    >>> from mimesis.enums import Gender\n\n    >>> de = Person(locale=Locale.DE)\n    >>> en = Person(locale=Locale.EN)\n\n    >>> de.full_name(gender=Gender.FEMALE)\n    'Sabrina Gutermuth'\n\n    >>> en.full_name(gender=Gender.MALE)\n    'Layne Gallagher'\n\n\n.. _locales: https://mimesis.name/en/latest/getting_started.html#supported-locales\n\nProviders\n---------\n\nMimesis support over twenty different data providers available,\nwhich can produce data related to people, food, computer hardware,\ntransportation, addresses, internet and more.\n\n\nYou can generate a lot of extremely detailed data:\n\n.. code:: python\n\n    >>> from mimesis import Internet\n    >>> from mimesis.enums import URLScheme\n    >>> internet = Internet()\n    >>> internet.url(scheme=URLScheme.WSS, subdomains=[\"chat\"])\n    'wss://chat.system.io/'\n\n\nSee `API Reference <https://mimesis.name/en/latest/api.html>`_ and `Data Providers <https://mimesis.name/en/latest/getting_started.html#data-providers>`_ for more info.\n\nHow to Contribute\n-----------------\n\n1. Take a look at `contributing guidelines`_.\n2. Check for open issues or open a fresh issue to start a discussion\n   around a feature idea or a bug.\n3. Fork the repository on GitHub to start making your changes to the\n   *your_branch* branch.\n4. Add yourself to the list of `contributors`_.\n5. Send a pull request and bug the maintainer until it gets merged and\n   published.\n\n.. _contributing guidelines: https://github.com/lk-geimfari/mimesis/blob/master/CONTRIBUTING.rst\n.. _contributors: https://github.com/lk-geimfari/mimesis/blob/master/CONTRIBUTORS.rst\n\n\nUseful links\n------------\n\nI have a Telegram channel where I daily post news, announces and all the open-source\ngoodies I found, so subscribe: `@software_dev_channel <https://t.me/software_dev_channel>`_.\n\nDisclaimer\n----------\n\nThe authors of `Mimesis` do not assume any responsibility for how you use it or how you use data generated with it.\nThis library was designed with good intentions to make testing easier. Do not use the data generated with Mimesis for illegal purposes.\n\nLicense\n-------\n\nMimesis is licensed under the MIT License. See `LICENSE`_ for more\ninformation.\n\n.. _LICENSE: https://github.com/lk-geimfari/mimesis/blob/master/LICENSE\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Mimesis: Fake Data Generator.",
    "version": "5.5.0",
    "split_keywords": [
        "data",
        "database",
        "dummy",
        "fake",
        "faker",
        "fixtures",
        "generate",
        "mimesis",
        "mock",
        "populate",
        "testing"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "26d1dea1119c2484346f7e63f121adfc",
                "sha256": "a717bf6ae712a8e1cec59237a975d87f9c04321322e7d7ca3c6cfe99060b1914"
            },
            "downloads": -1,
            "filename": "mimesis-5.5.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "26d1dea1119c2484346f7e63f121adfc",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8,<4.0",
            "size": 4361464,
            "upload_time": "2022-06-22T12:07:12",
            "upload_time_iso_8601": "2022-06-22T12:07:12.270266Z",
            "url": "https://files.pythonhosted.org/packages/12/1b/a26229f60eaa1f3f2e9b00295cdedd17f9ffe701ab45f6ce2b0467d1ce0f/mimesis-5.5.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "ef8666df0f03b2cd4aea0574a071339e",
                "sha256": "0fa83814359be0465f0fdbf0595b87225fa533167330121a2831a3e928a73ac5"
            },
            "downloads": -1,
            "filename": "mimesis-5.5.0.tar.gz",
            "has_sig": false,
            "md5_digest": "ef8666df0f03b2cd4aea0574a071339e",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8,<4.0",
            "size": 4325150,
            "upload_time": "2022-06-22T12:07:15",
            "upload_time_iso_8601": "2022-06-22T12:07:15.164049Z",
            "url": "https://files.pythonhosted.org/packages/8d/a4/0437b23755327e3e76685dc076974bdaa1b847db070be8db7f9b0e8b323e/mimesis-5.5.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2022-06-22 12:07:15",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "github_user": "lk-geimfari",
    "github_project": "mimesis",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "mimesis"
}
        
Elapsed time: 0.49669s