swarmauri_xmp_png 0.1.2.dev3

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

swarmauri_xmp_png

swarmauri_xmp_png packages the production-grade PNGXMP handler. It reads, writes, and removes XMP packets stored in uncompressed iTXt chunks that follow Adobe's keyword guidance, making it immediately compatible with downstream asset pipelines.

Features

• Registry-ready – inherits from EmbedXmpBase so Swarmauri's dynamic registry can auto-discover the handler.
• Spec compliant – emits iTXt chunks with the XML:com.adobe.xmp keyword and UTF-8 payloads.
• Safety guards – _ensure_xml performs a minimal RDF/XML check before embedding metadata.

Installation

Choose the tool that matches your workflow:

# pip
pip install swarmauri_xmp_png

# uv
uv add swarmauri_xmp_png

Usage

from pathlib import Path

from swarmauri_xmp_png import PNGXMP

handler = PNGXMP()
image_path = Path("example.png")
xmp_packet = """<x:xmpmeta xmlns:x='adobe:ns:meta/'><rdf:RDF>...</rdf:RDF></x:xmpmeta>"""

# Embed an XMP packet
updated_bytes = handler.write_xmp(image_path.read_bytes(), xmp_packet)
image_path.write_bytes(updated_bytes)

# Verify the packet can be recovered
restored_xml = handler.read_xmp(updated_bytes)
print(restored_xml)

# Remove XMP if necessary
clean_bytes = handler.remove_xmp(updated_bytes)

Why it works

• Dynamic discovery – the handler is automatically registered with DynamicBase consumers via inheritance.
• Standards alignment – PNG metadata lives in an iTXt chunk per ISO 16684 guidance.
• Predictable behavior – read/write/remove flows mirror each other so pipelines remain idempotent.

Project Resources

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