---
2024-06-09
.. note::
This release contains minor backwards incompatible changes. Namely,
in the ``email`` provider.
- The ``domain`` (type: ``str``, default value: ``example.com``) argument
of the ``email`` provider has been dropped in favour
of ``domain_names`` (type: ``Optional[Tuple[str]``, default value: ``None``).
- Added a dedicated ``PydanticModelFactory`` (yet equal to ``ModelFactory``)
for future improvements.
- Added ``PreInit`` factory class and ``pre_init`` decorator.
- Improved documentation of factories.
- Added ``random_choice`` and ``random_sample`` providers.
- Added ``tld``, ``domain_name``, ``free_email_domain``, ``company_email``
and ``free_email`` providers.