Merge pull request #39 from barseghyanartur/dev

Dev

.secrets.baseline

@@ -172,7 +172,7 @@
         "filename": "src/faker_file/tests/test_sftp_server.py",
         "hashed_secret": "e8662cfb96bd9c7fe84c31d76819ec3a92c80e63",
         "is_verified": true,
-        "line_number": 83
+        "line_number": 84
       }
     ],
     "src/faker_file/tests/test_sftp_storage.py": [
@@ -194,5 +194,5 @@
       }
     ]
   },
-  "generated_at": "2023-08-23T21:49:15Z"
+  "generated_at": "2023-09-20T19:26:51Z"
 }

CHANGELOG.rst

@@ -8,6 +8,7 @@ Release history and notes
 .. _imgkit: https://pypi.org/project/imgkit/
 .. _pdf2image: https://pypi.org/project/pdf2image/
 .. _pdfkit: https://pypi.org/project/pdfkit/
+.. _Pillow: https://pypi.org/project/pillow/
 .. _reportlab: https://pypi.org/project/reportlab/
 
 `Sequence based identifiers
@@ -25,6 +26,25 @@ are used for versioning (schema follows below):
   0.3.4 to 0.4).
 - All backwards incompatible changes are mentioned in this document.
 
+0.17.8
+------
+2023-09-21
+
+.. note::
+
+    This release is dedicated to the victims of the war in Artsakh
+    (Nagorno-Karabakh), a land now lost to its native inhabitants (Armenians).
+    Following a grueling nine-month blockade, Azerbaijan initiated another
+    military onslaught on September 19, 2023. The already weakened and
+    outnumbered forces of Artsakh could no longer mount an effective
+    resistance.
+
+- Added support for ``DynamicTemplate`` to all non-graphic image providers.
+  That means, that you can produce images with text, tables, various
+  headings and other images. Correspondent snippets are implemented for all
+  supported image generators; namely `reportlab`_, `WeasyPrint`_ and
+  `Pillow`_.
+
 0.17.7
 ------
 2023-09-12

README.rst

@@ -36,6 +36,7 @@ faker-file
 .. _Creating PDF: https://faker-file.readthedocs.io/en/latest/creating_pdf.html
 .. _Creating DOCX: https://faker-file.readthedocs.io/en/latest/creating_docx.html
 .. _Creating ODT: https://faker-file.readthedocs.io/en/latest/creating_odt.html
+.. _Creating images: https://faker-file.readthedocs.io/en/latest/creating_images.html
 .. _CLI: https://faker-file.readthedocs.io/en/latest/cli.html
 .. _Methodology: https://faker-file.readthedocs.io/en/latest/methodology.html
 .. _Contributor guidelines: https://faker-file.readthedocs.io/en/latest/contributor_guidelines.html
@@ -108,15 +109,13 @@ All licenses are mentioned below between the brackets.
   been tested with ``Django`` starting from version 2.2 to 4.2 (although only
   maintained versions of Django are currently being tested against).
 - ``BMP``, ``GIF`` and ``TIFF`` file support requires either just
-  `Pillow`_ (`HPND`) for very basic functionality, or a combination of
-  `WeasyPrint`_ (`BSD`), `pdf2image`_ (`MIT`), `Pillow`_ (`HPND`) and
-  `poppler`_ (`GPLv2`) for advanced functionality.
+  `Pillow`_ (`HPND`), or a combination of `WeasyPrint`_ (`BSD`),
+  `pdf2image`_ (`MIT`), `Pillow`_ (`HPND`) and `poppler`_ (`GPLv2`).
 - ``DOCX`` file support requires `python-docx`_ (`MIT`).
 - ``EPUB`` file support requires `xml2epub`_ (`MIT`) and `Jinja2`_ (`BSD`).
 - ``ICO``, ``JPEG``, ``PNG``, ``SVG`` and ``WEBP`` files support
-  requires either just `Pillow`_ (`HPND`) for very basic functionality, or a
-  combination of `imgkit`_ (`MIT`) and `wkhtmltopdf`_ (`LGPLv3`) for advanced
-  functionality.
+  requires either just `Pillow`_ (`HPND`), or a combination of
+  `imgkit`_ (`MIT`) and `wkhtmltopdf`_ (`LGPLv3`).
 - ``MP3`` file support requires `gTTS`_ (`MIT`) or `edge-tts`_ (`GPLv3`).
 - ``PDF`` file support requires either combination of `pdfkit`_ (`MIT`)
   and `wkhtmltopdf`_ (`LGPLv3`), or `reportlab`_ (`BSD`).
@@ -144,6 +143,7 @@ Documentation
 - For tips on ``PDF`` creation see `Creating PDF`_.
 - For tips on ``DOCX`` creation see `Creating DOCX`_.
 - For tips on ``ODT`` creation see `Creating ODT`_.
+- For tips on images creation see `Creating images`_.
 - For CLI options see the `CLI`_.
 - Read the `Methodology`_.
 - For guidelines on contributing check the `Contributor guidelines`_.
@@ -293,8 +293,8 @@ Supported file types
 - ``ZIP``
 
 For all image formats (``BMP``, ``ICO``, ``GIF``, ``JPEG``, ``PNG``, ``SVG``,
-``TIFF`` and ``WEBP``) and ``PDF``, there are both graphic and text-to-image
-file providers.
+``TIFF`` and ``WEBP``) and ``PDF``, there are both graphic-only and
+mixed-content file providers (that also have text-to-image capabilities).
 
 Additional providers
 --------------------

SECURITY.rst

@@ -19,12 +19,14 @@ of ``faker-file`` 0.17.x, support will be provided for ``faker-file`` 0.16.x.
 Upon the release of ``faker-file`` 0.18.x, security support for ``faker-file``
 0.16.x will end.
 
-+-----------+-----------+
-| Version   | Supported |
-+===========+===========+
-| 0.17.x    | Yes       |
-+-----------+-----------+
-| 0.16.x    | Yes       |
-+-----------+-----------+
-| < 0.16    | No        |
-+-----------+-----------+
+.. code-block:: text
+
+    ┌─────────────────┬────────────────┐
+    │ Version         │ Supported      │
+    ├─────────────────┼────────────────┤
+    │ 0.17.x          │ Yes            │
+    ├─────────────────┼────────────────┤
+    │ 0.16.x          │ Yes            │
+    ├─────────────────┼────────────────┤
+    │ < 0.16          │ No             │
+    └─────────────────┴────────────────┘