madam.vector module

class madam.vector.SVGMetadataProcessor(config: Mapping[str, Any] | None = None)[source]

Bases: MetadataProcessor

Represents a metadata processor that handles Scalable Vector Graphics (SVG) data.

It is assumed that the SVG XML uses UTF-8 encoding.

__init__(config: Mapping[str, Any] | None = None) → None[source]

Initializes a new SVGMetadataProcessor.

Parameters:

config – Mapping with settings.

combine(file: IO, metadata: Mapping[str, Mapping]) → IO[source]

Returns a byte stream whose contents represent the specified file where the specified metadata was added.

Parameters:

  • metadata (Mapping) – Mapping of the metadata format to the metadata dict

  • file (IO) – Container file

Returns:

file-like object with combined content

Return type:

IO

property formats: Iterable[str]

The metadata formats which are supported.

Returns:

supported metadata formats

Return type:

set[str]

read(file: IO) → Mapping[str, Mapping][source]

Reads the file and returns the metadata.

The metadata that is returned is grouped by type. The keys are specified by format.

Parameters:

file (IO) – File-like object to be read

Returns:

Metadata contained in the file

Return type:

Mapping

Raises:

UnsupportedFormatError – if the data is corrupt or its format is not supported

strip(file: IO) → IO[source]

Removes all metadata of the supported type from the specified file.

Parameters:

file (IO) – file-like that should get stripped of the metadata

Returns:

file-like object without metadata

Return type:

IO

class madam.vector.SVGProcessor(config: Mapping[str, Any] | None = None)[source]

Bases: Processor

Represents a processor that handles Scalable Vector Graphics (SVG) data.

__init__(config: Mapping[str, Any] | None = None) → None[source]

Initializes a new SVGProcessor.

Parameters:

config – Mapping with settings.

can_read(file: IO) → bool[source]

Returns whether the specified MIME type is supported by this processor.

Parameters:

file (IO) – file-like object to be tested

Returns:

whether the data format of the specified file is supported or not

Return type:

bool

read(file: IO) → Asset[source]

Returns an Asset object whose essence is identical to the contents of the specified file.

Parameters:

file (IO) – file-like object to be read

Returns:

Asset with essence

Return type:

Asset

Raises:

UnsupportedFormatError – if the specified data format is not supported

shrink(asset: Asset) → Asset[source]

Shrinks the size of an SVG asset.

Parameters:

asset (Asset) – Media asset to be shrunk

Returns:

Shrunk vector asset

Return type:

Asset

property supported_mime_types: frozenset

MIME types this processor can handle (used to build the Madam index).