Mimesis

-------------

**Fixed**:

- ``country()`` from the ``Address()`` provider now by default returns the country name of the current locale.
- Separated Europe and Asia continents in Italian locale.


**Removed**:

- Removed duplicated names in the countries of ``et`` locale.

-------------

**Added**:

- Added built-in provider DenmarkSpecProvider
- Added meta classes for providers for internal usage (see `621 <https://github.com/lk-geimfari/mimesis/issues/621>`_.)
- Added support for custom templates in ``Person().username()``
- Added ``ItalianSpecProvider()``

**Fixed**:

- Support of seed for custom providers
- ``currency_iso_code`` from the ``Business()`` provider now by default returns the currency code of the current locale.

**Removed**:

- Removed ``multiple_choice()`` in the ``random`` module because it was unused and it could be replaced with ``random.choices``.
- Removed legacy method ``child_count()`` from provider ``Person()``

-------------

**Fixed**:

- Fixed ``UnsupportedField`` on using field ``choice``, `619 <https://github.com/lk-geimfari/mimesis/issues/619>`_

-------------

.. warning:: This release (3.0.0) contains some breaking changes in API

.. warning:: In this release (3.0.0) we've reject support of Python 3.5


**Added**:

- Added provider ``Choice()``
- Added method ``formatted_time()`` for ``Datetime()`` provider
- Added method ``formatted_date()`` for ``Datetime()`` provider
- Added method ``formatted_datetime()`` for ``Datetime()`` provider
- Added support of timezones (optional) for ``Datetime().datetime()``
- Added method to bulk create datetime objects: ``Datetime().bulk_create_datetimes()``
- Added ``kpp`` for ``RussiaSpecProvider``
- Added ``PolandSpecProvider`` builtin data provider
- Added context manager to temporarily overriding locale - ``BaseDataProvider.override_locale()``
- Added method ``token_urlsafe()`` for ``Cryptographic`` provider
- Added 6k+ username words


**Updated**:

- Updated documentation
- Updated data for ``pl`` and ``fr``
- Updated SNILS algorithm for ``RussiaSpecProvider``
- Updated method ``Datetime().time()`` to return only ``datetime.time`` object
- Updated method ``Datetime().date()`` to return only ``datetime.date`` object
- Completely annotated all functions
- Locale independent providers inherit ``BaseProvider`` instead of ``BaseDataProvider`` (it's mean that locale independent providers does not support parameter ``locale`` anymore)
- Now you can add to Generic only providers which are subclasses of ``BaseProvider`` to ensure a single instance of ``random.Random()`` for all providers


**Renamed**:

- Renamed provider ``ClothingSizes`` to ``Clothing``, so now it can contain any data related to clothing, not sizes only
- Renamed ``Science().dna()`` to ``Science().dna_sequence()``
- Renamed ``Science().rna()`` to ``Science().rna_sequence()``
- Renamed module ``helpers.py`` to ``random.py``
- Renamed module ``config.py`` to ``locales.py``
- Renamed module ``utils.py`` to ``shortcuts.py``
- Renamed ``Cryptographic().bytes()`` to ``Cryptographic.token_bytes()``
- Renamed ``Cryptographic().token()`` to ``Cryptographic.token_hex()``


**Removed**:

- Removed deprecated argument ``fmt`` for ``Datetime().date()``, use ``Datetime().formatted_date()`` instead
- Removed deprecated argument ``fmt`` for ``Datetime().time()``, use ``Datetime().formatted_time()`` instead
- Removed deprecated argument ``humanize`` for ``Datetime().datetime()``, use ``Datetime().formatted_datetime()`` instead
- Removed deprecated method ``Science.scientific_article()``
- Removed deprecated providers ``Games``
- Removed deprecated method ``Structure().json()``, use ``schema.Schema()`` and ``schema.Field`` instead
- Removed deprecated and useless method: ``Development().backend()``
- Removed deprecated and useless method: ``Development().frontend()``
- Removed deprecated and useless method: ``Development().version_control_system()``
- Removed deprecated and useless method: ``Development().container()``
- Removed deprecated and useless method: ``Development().database()``
- Removed deprecated method ``Internet().category_of_website()``
- Removed duplicated method ``Internet().image_by_keyword()``, use ``Internet().stock_image()`` with ``keywords`` instead
- Removed deprecated JapanSpecProvider (it didn't fit the definition of the data provider)
- Removed deprecated method ``Internet().subreddit()``
- Removed ``Cryptographic().salt()`` use ``Cryptographic().token_hex()`` or ``Cryptographic().token_bytes()`` instead
- Removed methods ``Person.favorite_movie()``, ``Person.favorite_music_genre()``, ``Person.level_of_english()`` because they did not related to ``Person`` provider

**Fixed**:

- Fixed bug with seed
- Fixed issue with names on downloading images
- Fixed issue with ``None`` in username for ``Person().username()``
- Other minor improvements and fix

-------------

**Added**:

- Added a list of all supported locales as ``mimesis/locales.py``

**Updated**:

- Changed how ``Internet`` provider works with ``stock_image``
- Changed how ``random`` module works, now exposing global ``Random`` instance
- Updated dependencies
- Updated ``choice`` to make it a provider with more output types

**Fixed**:

- Prevents ``ROMANIZED_DICT`` from mutating
- Fixed ``appveyour`` builds
- Fixed ``flake8-builtins`` checks
- Fixed some ``mypy`` issues with strict mode
- Fixed number of elements returned by ``choice`` with ``unique=True``

-------------

**Removed**:

- Removed internal function ``utils.locale_info`` which duplicate ``utils.setup_locale``