faker-file

• Add optional encoding argument to CsvFileProvider and PdfFileProvider providers.
• Add root_path argument to cloud storages.
• Moved all image related code (IcoFileProvider, JpegFileProvider, PngFileProvider, SvgFileProvider, WebpFileProvider) to ImageMixin. Moved all tabular data related code (OdsFileProvider, XlsxFileProvider) to TabularDataMixin.
• Documentation improvements.

Note, that this release introduces breaking changes!

• All file system based operations are moved to a separate abstraction layer of file storages. The following storages have been implemented: FileSystemStorage, PathyFileSystemStorage, AWSS3Storage, GoogleCloudStorage and AzureStorage. The root_path and rel_path params of the providers are deprecated in favour of storages. See the docs more usage examples.

• Added RandomFileFromDirProvider which picks a random file from directory given.
• Improved docs.

• Pass optional generator argument to inner functions of the ZipFileProvider.
• Added create_inner_zip_file inner function which allows to create nested ZIPs.
• Reached test coverage of 100%.

Note, that this release introduces breaking changes!

• Added ODS file support.

• Switched to tablib for easy, non-variant support of various formats (XLSX, ODS).

• Silence imgkit logging output.

• ZipFileProvider allows to pass arbitrary arguments to inner functions. Put all your inner function arguments into a dictionary and pass it in create_inner_file_args key inside options argument. See the example below.

  
      zip_file = ZipFileProvider(None).file(
          prefix="zzz_archive_",
          options={
              "count": 5,
              "create_inner_file_func": create_inner_docx_file,
              "create_inner_file_args": {
                  "prefix": "zzz_file_",
                  "max_nb_chars": 1_024,
                  "content": "{{date}}\r\n{{text}}\r\n{{name}}",
              },
              "directory": "zzz",
          }
      )
  

Note, that this release introduces breaking changes!

• Remove the concept of content generators (and the correspondent content_generator arguments in implemented providers). Instead, allow usage of dynamic fixtures in the provided content argument.
• Remove temporary files when creating ZIP archives.
• Various improvements and fixes in docs.

• Add support for BIN, CSV and XLSX files.
• Better visual representation of generated images and PDFs.

• Added support for ICO, JPEG, PNG, SVG and WEBP files.
• Documentation improvements.

• Initial beta release.