swarmauri_xmp_jpeg 0.11.0.dev1

JPEG handler for embedding and extracting XMP packets in Swarmauri runtimes.

swarmauri_xmp_jpeg

swarmauri_xmp_jpeg ships the JPEGXMP handler for embedding, reading, and removing XMP packets from JPEGs via APP1 segments that follow Adobe's namespace header.

Features

• Immediate discovery ? derives from EmbedXmpBase so dynamic registry consumers can import it automatically.
• Header accuracy ? produces APP1 payloads prefixed with http://ns.adobe.com/xap/1.0/\x00 as required by the specification.
• Defensive parsing ? iterates markers safely and halts at SOS to avoid corrupting scan data.

Installation

# pip
pip install swarmauri_xmp_jpeg

# uv
uv add swarmauri_xmp_jpeg

Usage

from pathlib import Path

from swarmauri_xmp_jpeg import JPEGXMP

handler = JPEGXMP()
photo_path = Path("example.jpg")
xmp_packet = """<x:xmpmeta xmlns:x='adobe:ns:meta/'><rdf:RDF>...</rdf:RDF></x:xmpmeta>"""

# Insert the packet right after the SOI marker
updated_bytes = handler.write_xmp(photo_path.read_bytes(), xmp_packet)
photo_path.write_bytes(updated_bytes)

# Confirm it can be recovered later
restored_xml = handler.read_xmp(updated_bytes)
print(restored_xml)

# Strip the packet if needed
clean_bytes = handler.remove_xmp(updated_bytes)

Why it works

• APP1 discipline ? the implementation builds a compliant APP1 segment with the canonical XMP namespace string.
• Dynamic registration ? inheriting from EmbedXmpBase means the handler is registered automatically for plugin discovery.
• Robust parsing ? helper iterators validate segment structure, stopping safely at SOS or malformed markers.

Project Resources

• Source: https://github.com/swarmauri/swarmauri-sdk
• License: Apache 2.0