swarmauri_xmp_webp 0.1.1.dev32__tar.gz

swarmauri_xmp_webp-0.1.1.dev32/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_webp-0.1.1.dev32/PKG-INFO

@@ -0,0 +1,88 @@
+Metadata-Version: 2.4
+Name: swarmauri_xmp_webp
+Version: 0.1.1.dev32
+Summary: WebP handler scaffold for embedding and extracting XMP packets in Swarmauri runtimes.
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: swarmauri,sdk,standards,xmp,webp
+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 :: 2 - Pre-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_webp/">
+        <img src="https://img.shields.io/pypi/dm/swarmauri_xmp_webp" alt="PyPI - Downloads"/></a>
+    <a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/swarmauri_xmp_webp/">
+        <img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/swarmauri_xmp_webp.svg"/></a>
+    <a href="https://pypi.org/project/swarmauri_xmp_webp/">
+        <img src="https://img.shields.io/pypi/pyversions/swarmauri_xmp_webp" alt="PyPI - Python Version"/></a>
+    <a href="https://pypi.org/project/swarmauri_xmp_webp/">
+        <img src="https://img.shields.io/pypi/l/swarmauri_xmp_webp" alt="PyPI - License"/></a>
+    <a href="https://pypi.org/project/swarmauri_xmp_webp/">
+        <img src="https://img.shields.io/pypi/v/swarmauri_xmp_webp?label=swarmauri_xmp_webp&color=green" alt="PyPI - swarmauri_xmp_webp"/></a>
+</p>
+
+---
+
+# swarmauri_xmp_webp
+
+`swarmauri_xmp_webp` declares the `WebPXMP` handler scaffold for RIFF/WEBP containers and prepares the dynamic registry for a full implementation.
+
+## Features
+
+- **Forward compatible** – establishes class signatures today so future implementations slot straight into existing workflows.
+- **Registry aligned** – inherits from `EmbedXmpBase`, enabling automatic discovery through Swarmauri's dynamic registry.
+- **Clear contracts** – raises `NotImplementedError` for read/write/remove until the RIFF logic is complete.
+
+## Installation
+
+```bash
+# pip
+pip install swarmauri_xmp_webp
+
+# uv
+uv add swarmauri_xmp_webp
+```
+
+## Usage
+
+```python
+from swarmauri_xmp_webp import WebPXMP
+
+handler = WebPXMP()
+
+# Raises NotImplementedError until read/write/remove are implemented
+try:
+    handler.read_xmp(b"RIFF....WEBP")
+except NotImplementedError:
+    print("WebP XMP support is forthcoming.")
+```
+
+### Why it works
+
+- **Forward compatible** – declaring the handler today reserves the RIFF chunk namespace for future work.
+- **Registry alignment** – subclassing `EmbedXmpBase` means discovery logic will work without code changes once implemented.
+- **Clear contracts** – explicit `NotImplementedError` exceptions communicate the remaining work to contributors.
+
+## Project Resources
+
+- Source: <https://github.com/swarmauri/swarmauri-sdk>
+- License: Apache 2.0
+

swarmauri_xmp_webp-0.1.1.dev32/README.md

@@ -0,0 +1,62 @@
+![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_webp/">
+        <img src="https://img.shields.io/pypi/dm/swarmauri_xmp_webp" alt="PyPI - Downloads"/></a>
+    <a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/swarmauri_xmp_webp/">
+        <img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/swarmauri_xmp_webp.svg"/></a>
+    <a href="https://pypi.org/project/swarmauri_xmp_webp/">
+        <img src="https://img.shields.io/pypi/pyversions/swarmauri_xmp_webp" alt="PyPI - Python Version"/></a>
+    <a href="https://pypi.org/project/swarmauri_xmp_webp/">
+        <img src="https://img.shields.io/pypi/l/swarmauri_xmp_webp" alt="PyPI - License"/></a>
+    <a href="https://pypi.org/project/swarmauri_xmp_webp/">
+        <img src="https://img.shields.io/pypi/v/swarmauri_xmp_webp?label=swarmauri_xmp_webp&color=green" alt="PyPI - swarmauri_xmp_webp"/></a>
+</p>
+
+---
+
+# swarmauri_xmp_webp
+
+`swarmauri_xmp_webp` declares the `WebPXMP` handler scaffold for RIFF/WEBP containers and prepares the dynamic registry for a full implementation.
+
+## Features
+
+- **Forward compatible** – establishes class signatures today so future implementations slot straight into existing workflows.
+- **Registry aligned** – inherits from `EmbedXmpBase`, enabling automatic discovery through Swarmauri's dynamic registry.
+- **Clear contracts** – raises `NotImplementedError` for read/write/remove until the RIFF logic is complete.
+
+## Installation
+
+```bash
+# pip
+pip install swarmauri_xmp_webp
+
+# uv
+uv add swarmauri_xmp_webp
+```
+
+## Usage
+
+```python
+from swarmauri_xmp_webp import WebPXMP
+
+handler = WebPXMP()
+
+# Raises NotImplementedError until read/write/remove are implemented
+try:
+    handler.read_xmp(b"RIFF....WEBP")
+except NotImplementedError:
+    print("WebP XMP support is forthcoming.")
+```
+
+### Why it works
+
+- **Forward compatible** – declaring the handler today reserves the RIFF chunk namespace for future work.
+- **Registry alignment** – subclassing `EmbedXmpBase` means discovery logic will work without code changes once implemented.
+- **Clear contracts** – explicit `NotImplementedError` exceptions communicate the remaining work to contributors.
+
+## Project Resources
+
+- Source: <https://github.com/swarmauri/swarmauri-sdk>
+- License: Apache 2.0

swarmauri_xmp_webp-0.1.1.dev32/pyproject.toml

@@ -0,0 +1,51 @@
+[project]
+name = "swarmauri_xmp_webp"
+version = "0.1.1.dev32"
+description = "WebP handler scaffold 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 :: 2 - Pre-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',
+    'webp',
+]
+
+[project.urls]
+Homepage = "https://github.com/swarmauri/swarmauri-sdk"
+
+[project.entry-points.'swarmauri.xmp_handlers']
+WebPXMP = "swarmauri_xmp_webp:WebPXMP"
+
+[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_webp-0.1.1.dev32/swarmauri_xmp_webp/__init__.py

@@ -0,0 +1,92 @@
+"""WebP XMP handler implementation."""
+
+from __future__ import annotations
+
+from typing import ClassVar, Iterator, Tuple
+
+from swarmauri_base import register_type
+from swarmauri_base.xmp import EmbedXmpBase
+
+
+@register_type(resource_type=EmbedXmpBase)
+class WebPXMP(EmbedXmpBase):
+    """Embed and extract XMP packets using WebP ``XMP `` chunks."""
+
+    SIGNATURE: ClassVar[bytes] = b"RIFF"
+    FORMAT: ClassVar[bytes] = b"WEBP"
+    XMP_CHUNK: ClassVar[bytes] = b"XMP "
+
+    def _validate(self, data: bytes) -> None:
+        if len(data) < 12 or not data.startswith(self.SIGNATURE):
+            raise ValueError("Not a WebP payload")
+        if data[8:12] != self.FORMAT:
+            raise ValueError("RIFF container is not WebP formatted")
+
+    def _iter_chunks(self, data: bytes) -> Iterator[Tuple[int, bytes, int, int]]:
+        self._validate(data)
+        pos = 12
+        end = len(data)
+        while pos + 8 <= end:
+            ctype = data[pos : pos + 4]
+            size = int.from_bytes(data[pos + 4 : pos + 8], "little")
+            data_start = pos + 8
+            data_end = data_start + size
+            if data_end > end:
+                raise ValueError("Truncated WebP chunk")
+            yield pos, ctype, data_start, size
+            pos = data_end + (size & 1)
+        if pos != end:
+            # Allow a single padding byte
+            if not (pos == end - 1 and data[-1] == 0):
+                raise ValueError("Unexpected trailer in WebP payload")
+
+    def supports(self, header: bytes, path: str) -> bool:
+        return path.lower().endswith(".webp") or (
+            header.startswith(self.SIGNATURE) and header[8:12] == self.FORMAT
+        )
+
+    def read_xmp(self, data: bytes) -> str | None:
+        for _offset, ctype, data_off, data_len in self._iter_chunks(data):
+            if ctype != self.XMP_CHUNK:
+                continue
+            payload = data[data_off : data_off + data_len]
+            return payload.decode("utf-8", errors="ignore")
+        return None
+
+    def _chunk_bytes(self, ctype: bytes, payload: bytes) -> bytes:
+        chunk = bytearray()
+        chunk.extend(ctype)
+        chunk.extend(len(payload).to_bytes(4, "little"))
+        chunk.extend(payload)
+        if len(payload) & 1:
+            chunk.append(0)
+        return bytes(chunk)
+
+    def write_xmp(self, data: bytes, xmp_xml: str) -> bytes:
+        xmp_bytes = self._ensure_xml(xmp_xml)
+        self._validate(data)
+        chunks = []
+        for _offset, ctype, data_off, data_len in self._iter_chunks(data):
+            if ctype == self.XMP_CHUNK:
+                continue
+            payload = data[data_off : data_off + data_len]
+            chunks.append(self._chunk_bytes(ctype, payload))
+        chunks.append(self._chunk_bytes(self.XMP_CHUNK, xmp_bytes))
+        body = b"".join(chunks)
+        size = len(body) + len(self.FORMAT)
+        return self.SIGNATURE + size.to_bytes(4, "little") + self.FORMAT + body
+
+    def remove_xmp(self, data: bytes) -> bytes:
+        self._validate(data)
+        chunks = []
+        for _offset, ctype, data_off, data_len in self._iter_chunks(data):
+            if ctype == self.XMP_CHUNK:
+                continue
+            payload = data[data_off : data_off + data_len]
+            chunks.append(self._chunk_bytes(ctype, payload))
+        body = b"".join(chunks)
+        size = len(body) + len(self.FORMAT)
+        return self.SIGNATURE + size.to_bytes(4, "little") + self.FORMAT + body
+
+
+__all__ = ["WebPXMP"]