Faker-file

------
2023-08-22

.. note::

This release might introduces minor backwards incompatible changes only
if you have written own- or customized existing- image providers and used
them in combination with `WeasyPrint`_-based image generator. A new
property named ``image_format`` has been added to all image-based
providers and the ``WeasyPrintImageGenerator`` is using that instead
of formerly used ``extension`` property.

- Added ``PilImageGenerator`` (for text-to-image).
- Added ``PilPdfGenerator`` (for text-to-image).

------
2023-08-18

.. note::

Release is dedicated to the victims and de-facto hostages of
the `Blockade of the Republic of Artsakh`_. Have you ever heard
of `Armenian genocide`_? It's happening again. For more than 8 months,
Azerbaijan has launched an illegal blockade of the Republic of Artsakh,
including critical civilian infrastructure such as gas, electricity and
roads connecting Armenia and Artaskh. Shortages of essential goods –
including electricity, fuel, and water reserves – are widespread and
emergency reserves are being rationed. The blockade has resulted in
significant medical and food shortages in Artsakh, leading to increased
health complications, as reported by Artsakh Healthcare ministry.

- Deaths due to cardiovascular diseases doubled in the first seven
months of the year, with a particular surge in July-August.
- Deaths from malignant tumors rose by 15.9% over the same period due
to lack of medications and medical aid.
- New cases of stroke and heart attacks increased by 26% and 9.7%
respectively.
- Newly diagnosed cases of malignant tumors rose by 24.3%.
- Around 90% of monitored pregnant women developed anemia from poor
nutrition and medication shortages.
- While overall abortion numbers remained stable, medically indicated
abortions quadrupled in July due to factors like stress and
inadequate nutrition.
- Reports of fainting surged by 91% in July-August.
- Emergency calls for high blood pressure saw a 5.6-fold increase in
July-August.

The dire health outcomes are attributed to the blockade's impact,
including medication shortages, stress, disrupted medical procedures,
and restricted healthcare access. The Artsakh Health Ministry warns of
further deterioration if the blockade continues, emphasizing the systemic
challenges in healthcare delivery due to the blockade.

- Added ``AugmentRandomImageFromDirProvider``
and ``AugmentImageFromPathProvider`` providers for basic image augmentation.
- Added ``storage`` to metadata for all providers for easy clean-up of files.
- Added ``unlink`` method to all storages for easy clean-up of files.
- Added ``FileRegistry`` to keep track of all files created and introduce
functionality for cleaning up the files.
- Stop testing against Python 3.7.

------
2023-08-02

.. note::

In memory of Sinead O'Connor.

- Allow to pass ``image`` argument (``bytes``) to the contrib ``add_picture``
functions.
- Documentation improvements.

------
2023-07-25

- Added ``JSON`` file provider.

------
2023-07-21

- Added ``WeasyPrintImageGenerator`` image generator class based
on `WeasyPrint`_ and `pdf2image`_ packages.
- Added ``BMP``, ``TIFF`` and ``GIF`` file providers (both text-to-image
and graphic ones). Note, that above mentioned text-to-image providers
are using ``WeasyPrintImageGenerator`` as a default image generator class,
since ``ImagekitImageGenerator`` class isn't capable of supporting the
above mentioned file formats.
- Added more helper functions for ``DynamicTemplate`` use for ODT, PDF and
DOCX file providers to support h1, h2, h3, h4, h5 and h6 headings.

----
2023-07-12

.. note::

Release is dedicated to the victims and de-facto hostages of
the `Blockade of the Republic of Artsakh`_. Have you ever heard
of `Armenian genocide`_? It's happening again and the world
silently watches.

- Introducing graphic image providers. Prior to this release, images have
been created using text-to-image solutions. Sometimes it's just handy to
have a graphic image. Therefore, a number of graphic image file providers
have been created (including inner functions support). The following graphic
file providers have been added: ``GraphicIcoFileProvider``,
``GraphicJpegFileProvider``, ``GraphicPdfFileProvider``,
``GraphicPngFileProvider`` and ``GraphicWebpFileProvider`` to support
creation of graphic ``ICO``, ``JPEG``, ``PDF``, ``PNG`` and ``WEBP`` files.
- The previously mentioned text-to-image rendering has been delegated to
image generators. Default generator is still based on the `imgkit`_, but
the change makes it possible to use custom generators.