faker-file

• Moved several interface classes from one location to another. If you haven't
  implemented custom generators, this won't affect you. If you did, make sure
  to update your imports:

  • BaseTextAugmenter has been moved from
    faker_file.providers.augment_file_from_dir.augmenters.base to
    faker_file.providers.base.text_augmenter.
  • BaseTextExtractor has been moved from
    faker_file.providers.augment_file_from_dir.extractors.base to
    faker_file.providers.base.text_extractor.
  • BaseMp3Generator has been moved from
    faker_file.providers.mp3_file.generators.base to
    faker_file.providers.base.mp3_generator.

• Add filename to data of response objects (StringValue, BytesValue).

• Documentation improvements.
• MyPy fixes.

• Allow returning binary contents of the file by providing the raw=True argument (works with all provider classes and inner functions).

• Add TarFileProvider and create_inner_tar_file function.
• Add OdpFileProvider and create_inner_odp_file function.

• Improve EPUB document layout.
• Improve PDF document layout.
• Minor documentation improvements.

• Allow passing model_name and action arguments to the ContextualWordEmbeddingsAugmenter.
• Replace bert-base-cased with bert-base-multilingual-cased as a default model for ContextualWordEmbeddingsAugmenter.
• Improve PPTX document layout.
• Minor fixes in documentation.

• Add an installation directive [common] to install everything except ML libraries.
• Added testing of UTF8 content.

• Switch to PyPI releases of gtts.
• Stop testing against Django 3.0 and 3.1.
• Documentation improvements.
• Tests improvements.

• Add OdtFileProvider and create_inner_odt_file function.
• Documentation improvements.
• Async related deprecation fixes in EdgeTtsMp3Generator.
• Optimize example factories.

• Add AugmentFileFromDirProvider provider for making augmented copies of randomly picked files from given directory.
• Documentation improvements.
• Fixes in setup.

• Add fuzzy_choice_create_inner_file inner function.
• Documentation improvements.
• Add MaryTTS example (another MP3 generator for Mp3FileProvider).

• Add missing mp3_generator_kwargs argument to the create_inner_mp3_file function.
• Clean-up.

Improvements of the mp3_file module:

• Pass active generator to the Mp3FileProvider in the generator argument if BaseMp3Generator (and all implementations).
• Introduce handle_kwargs method in the BaseMp3Generator to handle arbitrary provider specific tuning.
• Add EdgeTtsMp3Generator MP3 generator.
• Add mp3_generator_kwargs argument to the Mp3FileProvider.mp3_file method.

• Add Mp3FileProvider.
• Add create_inner_mp3_file inner function.

• Fixes in ZipFileProvider.

Note, that this release introduces breaking changes!

• Move all create_inner_*_file functions from faker_file.providers.zip_file to faker_file.providers.helpers.inner module. Adjust your imports accordingly.
• Add EmlFileProvider.
• Add create_inner_eml_file inner function.

• Add EpubFileProvider provider.

• Add RrfFileProvider.
• Added SQLAlchemy factory example.

• Fixes in cloud storage.
• Documentation fixes.