file.attachments

Attributes

IMAGE_MAX_SIZE
IMAGE_QUALITY
CHECKSUM_FUNCTION

Classes

_ImageSaveOptionalParams	dict() -> new empty dictionary
ProcessedUploadedFile	Simple depot.fields.interfaces.DepotFileInfo implementation that stores files.

Functions

get_svg_size_or_default(→ tuple[str, str])
strip_exif_and_limit_and_store_image_size(...)
store_checksum(→ None)
sanitize_svg_images(→ IO[bytes])
store_extract_and_pages(→ None)

Module Contents

class file.attachments._ImageSaveOptionalParams

Bases: TypedDict

dict() -> new empty dictionary dict(mapping) -> new dictionary initialized from a mapping object’s

(key, value) pairs

dict(iterable) -> new dictionary initialized as if via:

d = {} for k, v in iterable:

d[k] = v

dict(**kwargs) -> new dictionary initialized with the name=value pairs

in the keyword argument list. For example: dict(one=1, two=2)

exif: NotRequired[PIL.Image.Exif]

file.attachments.IMAGE_MAX_SIZE = 2048

file.attachments.IMAGE_QUALITY = 85

file.attachments.CHECKSUM_FUNCTION = 'md5'

file.attachments.get_svg_size_or_default(content: IO[bytes]) → tuple[str, str]

file.attachments.strip_exif_and_limit_and_store_image_size(file: ProcessedUploadedFile, content: IO[bytes], content_type: str | None) → IO[bytes] | None

file.attachments.store_checksum(file: ProcessedUploadedFile, content: IO[bytes], content_type: str | None) → None

file.attachments.sanitize_svg_images(file: ProcessedUploadedFile, content: IO[bytes], content_type: str | None) → IO[bytes]

file.attachments.store_extract_and_pages(file: ProcessedUploadedFile, content: IO[bytes], content_type: str | None) → None

class file.attachments.ProcessedUploadedFile(content, depot_name=None)

Bases: depot.fields.upload.UploadedFile

Simple depot.fields.interfaces.DepotFileInfo implementation that stores files.

Takes a file as content and uploads it to the depot while saving around most file information. Pay attention that if the file gets replaced through depot manually the UploadedFile will continue to have the old data.

Also provides support for encoding/decoding using JSON for storage inside databases as a plain string.

Default attributes provided for all UploadedFile include:

• filename - This is the name of the uploaded file

• file_id - This is the ID of the uploaded file

• path - This is a depot_name/file_id path which can

  be used with DepotManager.get_file() to retrieve the file

• content_type - This is the content type of the uploaded file

• uploaded_at - This is the upload date in YYYY-MM-DD HH:MM:SS format

• url - Public url of the uploaded file

• file - The depot.io.interfaces.StoredFile instance of the stored file

processors

process_content(content: depot.io.interfaces._FileContent, filename: str | None = None, content_type: str | None = None) → None

Standard implementation of DepotFileInfo.process_content()

This is the standard depot implementation of files upload, it will store the file on the default depot and will provide the standard attributes.

Subclasses will need to call this method to ensure the standard set of attributes is provided.