swarmauri_xmp_jpeg 0.1.1.dev31__tar.gz

swarmauri_xmp_jpeg-0.1.1.dev31/LICENSE

@@ -0,0 +1,2 @@
+This project is licensed under the Apache License 2.0.
+See the root LICENSE file of the swarmauri-sdk repository.

swarmauri_xmp_jpeg-0.1.1.dev31/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: swarmauri_xmp_jpeg
+Version: 0.1.1.dev31
+Summary: JPEG handler for embedding and extracting XMP packets in Swarmauri runtimes.
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: swarmauri,sdk,standards,xmp,jpeg
+Author: Jacob Stewart
+Author-email: jacob@swarmauri.com
+Requires-Python: >=3.10,<3.13
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Dist: swarmauri_base
+Requires-Dist: swarmauri_core
+Project-URL: Homepage, https://github.com/swarmauri/swarmauri-sdk
+Description-Content-Type: text/markdown
+
+![Swarmauri Logo](https://github.com/swarmauri/swarmauri-sdk/blob/3d4d1cfa949399d7019ae9d8f296afba773dfb7f/assets/swarmauri.brand.theme.svg)
+
+
+<p align="center">
+    <a href="https://pypi.org/project/swarmauri_xmp_jpeg/">
+        <img src="https://img.shields.io/pypi/dm/swarmauri_xmp_jpeg" alt="PyPI - Downloads"/></a>
+    <a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/swarmauri_xmp_jpeg/">
+        <img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/swarmauri_xmp_jpeg.svg"/></a>
+    <a href="https://pypi.org/project/swarmauri_xmp_jpeg/">
+        <img src="https://img.shields.io/pypi/pyversions/swarmauri_xmp_jpeg" alt="PyPI - Python Version"/></a>
+    <a href="https://pypi.org/project/swarmauri_xmp_jpeg/">
+        <img src="https://img.shields.io/pypi/l/swarmauri_xmp_jpeg" alt="PyPI - License"/></a>
+    <a href="https://pypi.org/project/swarmauri_xmp_jpeg/">
+        <img src="https://img.shields.io/pypi/v/swarmauri_xmp_jpeg?label=swarmauri_xmp_jpeg&color=green" alt="PyPI - swarmauri_xmp_jpeg"/></a>
+</p>
+
+---
+
+# 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
+
+```bash
+# pip
+pip install swarmauri_xmp_jpeg
+
+# uv
+uv add swarmauri_xmp_jpeg
+```
+
+## Usage
+
+```python
+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
+

swarmauri_xmp_jpeg-0.1.1.dev31/README.md

@@ -0,0 +1,71 @@
+![Swarmauri Logo](https://github.com/swarmauri/swarmauri-sdk/blob/3d4d1cfa949399d7019ae9d8f296afba773dfb7f/assets/swarmauri.brand.theme.svg)
+
+
+<p align="center">
+    <a href="https://pypi.org/project/swarmauri_xmp_jpeg/">
+        <img src="https://img.shields.io/pypi/dm/swarmauri_xmp_jpeg" alt="PyPI - Downloads"/></a>
+    <a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/swarmauri_xmp_jpeg/">
+        <img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/swarmauri_xmp_jpeg.svg"/></a>
+    <a href="https://pypi.org/project/swarmauri_xmp_jpeg/">
+        <img src="https://img.shields.io/pypi/pyversions/swarmauri_xmp_jpeg" alt="PyPI - Python Version"/></a>
+    <a href="https://pypi.org/project/swarmauri_xmp_jpeg/">
+        <img src="https://img.shields.io/pypi/l/swarmauri_xmp_jpeg" alt="PyPI - License"/></a>
+    <a href="https://pypi.org/project/swarmauri_xmp_jpeg/">
+        <img src="https://img.shields.io/pypi/v/swarmauri_xmp_jpeg?label=swarmauri_xmp_jpeg&color=green" alt="PyPI - swarmauri_xmp_jpeg"/></a>
+</p>
+
+---
+
+# 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
+
+```bash
+# pip
+pip install swarmauri_xmp_jpeg
+
+# uv
+uv add swarmauri_xmp_jpeg
+```
+
+## Usage
+
+```python
+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

swarmauri_xmp_jpeg-0.1.1.dev31/pyproject.toml

@@ -0,0 +1,51 @@
+[project]
+name = "swarmauri_xmp_jpeg"
+version = "0.1.1.dev31"
+description = "JPEG handler for embedding and extracting XMP packets in Swarmauri runtimes."
+license = "Apache-2.0"
+readme = "README.md"
+requires-python = ">=3.10,<3.13"
+classifiers = [
+    "License :: OSI Approved :: Apache Software License",
+    "Natural Language :: English",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Development Status :: 3 - Alpha",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+]
+authors = [{ name = "Jacob Stewart", email = "jacob@swarmauri.com" }]
+dependencies = [
+    "swarmauri_core",
+    "swarmauri_base",
+]
+keywords = [
+    'swarmauri',
+    'sdk',
+    'standards',
+    'xmp',
+    'jpeg',
+]
+
+[project.urls]
+Homepage = "https://github.com/swarmauri/swarmauri-sdk"
+
+[project.entry-points.'swarmauri.xmp_handlers']
+JPEGXMP = "swarmauri_xmp_jpeg:JPEGXMP"
+
+[tool.uv.sources]
+swarmauri_core = { workspace = true }
+swarmauri_base = { workspace = true }
+
+[build-system]
+requires = ["poetry-core>=1.0.0"]
+build-backend = "poetry.core.masonry.api"
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0",
+    "ruff>=0.9",
+]

swarmauri_xmp_jpeg-0.1.1.dev31/swarmauri_xmp_jpeg/__init__.py

@@ -0,0 +1,108 @@
+"""JPEG APP1 XMP handler."""
+
+from __future__ import annotations
+
+import io
+from typing import ClassVar, Iterator, Tuple
+
+from swarmauri_base import register_type
+from swarmauri_base.xmp import EmbedXmpBase
+
+
+@register_type(resource_type=EmbedXmpBase)
+class JPEGXMP(EmbedXmpBase):
+    """Embed XMP packets inside JPEG APP1 segments."""
+
+    SOI: ClassVar[bytes] = b"\xff\xd8"
+    EOI: ClassVar[bytes] = b"\xff\xd9"
+    SOS: ClassVar[int] = 0xDA
+    APP1: ClassVar[int] = 0xE1
+    XMP_HDR: ClassVar[bytes] = b"http://ns.adobe.com/xap/1.0/\x00"
+
+    def supports(self, header: bytes, path: str) -> bool:
+        return header.startswith(self.SOI) or path.lower().endswith((".jpg", ".jpeg"))
+
+    def _iter_segments(self, data: bytes) -> Iterator[Tuple[int, int, int, int]]:
+        if not data.startswith(self.SOI):
+            raise ValueError("Not a JPEG payload")
+        n = len(data)
+        i = 2
+        yield 0, 0xD8, 0, 0
+        while i < n:
+            if data[i] != 0xFF:
+                return
+            j = i
+            while j < n and data[j] == 0xFF:
+                j += 1
+            if j >= n:
+                return
+            marker = data[j]
+            i = j + 1
+            if marker == self.SOS:
+                if i + 2 > n:
+                    raise ValueError("Truncated SOS segment")
+                seglen = int.from_bytes(data[i : i + 2], "big")
+                yield j - 1, marker, i, seglen - 2
+                return
+            if i + 2 > n:
+                return
+            seglen = int.from_bytes(data[i : i + 2], "big")
+            if seglen < 2 or i + seglen > n:
+                raise ValueError("Invalid JPEG segment length")
+            yield j - 1, marker, i, seglen - 2
+            i += seglen
+
+    def read_xmp(self, data: bytes) -> str | None:
+        for _m_off, marker, p_off, p_len in self._iter_segments(data):
+            if marker != self.APP1:
+                continue
+            payload = data[p_off + 2 : p_off + 2 + p_len]
+            if payload.startswith(self.XMP_HDR):
+                return payload[len(self.XMP_HDR) :].decode("utf-8", errors="ignore")
+        return None
+
+    def _build_app1(self, xmp_utf8: bytes) -> bytes:
+        payload = self.XMP_HDR + xmp_utf8
+        seglen = 2 + len(payload)
+        return b"\xff" + bytes([self.APP1]) + seglen.to_bytes(2, "big") + payload
+
+    def write_xmp(self, data: bytes, xmp_xml: str) -> bytes:
+        xmp_bytes = self._ensure_xml(xmp_xml)
+        if not data.startswith(self.SOI):
+            raise ValueError("Not a JPEG payload")
+        out = io.BytesIO()
+        out.write(self.SOI)
+        inserted = False
+        for _m_off, marker, p_off, p_len in self._iter_segments(data):
+            if marker == 0xD8:
+                continue
+            if not inserted:
+                out.write(self._build_app1(xmp_bytes))
+                inserted = True
+            if marker == self.APP1:
+                payload = data[p_off + 2 : p_off + 2 + p_len]
+                if payload.startswith(self.XMP_HDR):
+                    continue
+            out.write(b"\xff" + bytes([marker]) + data[p_off : p_off + 2 + p_len])
+        if not inserted:
+            out.write(self._build_app1(xmp_bytes))
+            out.write(data[2:])
+        return out.getvalue()
+
+    def remove_xmp(self, data: bytes) -> bytes:
+        if not data.startswith(self.SOI):
+            raise ValueError("Not a JPEG payload")
+        out = io.BytesIO()
+        out.write(self.SOI)
+        for _m_off, marker, p_off, p_len in self._iter_segments(data):
+            if marker == 0xD8:
+                continue
+            if marker == self.APP1:
+                payload = data[p_off + 2 : p_off + 2 + p_len]
+                if payload.startswith(self.XMP_HDR):
+                    continue
+            out.write(b"\xff" + bytes([marker]) + data[p_off : p_off + 2 + p_len])
+        return out.getvalue()
+
+
+__all__ = ["JPEGXMP"]