media-optimization-engine 1.4.1__tar.gz → 1.4.2__tar.gz

{media_optimization_engine-1.4.1/media_optimization_engine.egg-info → media_optimization_engine-1.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: media-optimization-engine
-Version: 1.4.1
+Version: 1.4.2
 Summary: Media Optimization Engineer for Django/Python: automatic model-field optimization, responsive picture/srcset rendering, AVIF/WebP derivatives, 360 media, autonomous nodes, and CDN-ready storage.
 Author-email: Achille Kabasele <pepexykabasele@gmail.com>
 Maintainer-email: Achille Kabasele <pepexykabasele@gmail.com>
@@ -233,6 +233,16 @@ JavaScript is not required for normal responsive images.
 
 Runtime measurement is appropriate only for highly dynamic components whose rendered width cannot be described reliably with sizes, such as resizable editors, canvas-like builders, or asynchronously mounted panels.
 
+## Docker image
+
+The standalone service is also published as a multi-architecture GHCR image:
+
+~~~bash
+docker pull ghcr.io/kabasele754/media-optimization-engine:1.4.1
+~~~
+
+For Compose deployment, see `docs/DOCKER.md` and `docker-compose.ghcr.yml`.
+
 ## Flutter / native clients
 
 MOE also ships reference Dart adapters for native applications.

{media_optimization_engine-1.4.1 → media_optimization_engine-1.4.2}/README.md

@@ -177,6 +177,16 @@ JavaScript is not required for normal responsive images.
 
 Runtime measurement is appropriate only for highly dynamic components whose rendered width cannot be described reliably with sizes, such as resizable editors, canvas-like builders, or asynchronously mounted panels.
 
+## Docker image
+
+The standalone service is also published as a multi-architecture GHCR image:
+
+~~~bash
+docker pull ghcr.io/kabasele754/media-optimization-engine:1.4.1
+~~~
+
+For Compose deployment, see `docs/DOCKER.md` and `docker-compose.ghcr.yml`.
+
 ## Flutter / native clients
 
 MOE also ships reference Dart adapters for native applications.

media_optimization_engine-1.4.2/media_engine/management/commands/backfill_registered_media.py

@@ -0,0 +1,72 @@
+from django.core.exceptions import ValidationError
+from django.core.management.base import BaseCommand
+from media_engine.integration import ingest_model_field
+from media_engine.registry import entries
+
+
+class Command(BaseCommand):
+    help = 'Ingest image fields declared through register_model_image().'
+
+    def add_arguments(self, parser):
+        parser.add_argument('--limit', type=int)
+        parser.add_argument(
+            '--fail-fast',
+            action='store_true',
+            help='Stop immediately on the first invalid/unreadable image.',
+        )
+
+    def handle(self, *args, **options):
+        processed = 0
+        skipped = 0
+        failed = 0
+        failures = []
+
+        for entry in entries():
+            qs = entry.model._default_manager.all()
+            if options['limit']:
+                qs = qs[:options['limit']]
+
+            for obj in qs.iterator():
+                try:
+                    asset = ingest_model_field(
+                        obj,
+                        field_name=entry.field_name,
+                        profile=entry.profile,
+                        role=entry.role,
+                    )
+                    if asset is None:
+                        skipped += 1
+                    else:
+                        processed += 1
+                except ValidationError as exc:
+                    failed += 1
+                    message = (
+                        f'{entry.model._meta.label}.{entry.field_name} '
+                        f'pk={obj.pk}: {exc}'
+                    )
+                    failures.append(message)
+                    self.stderr.write(self.style.WARNING(f'SKIP {message}'))
+                    if options['fail_fast']:
+                        raise
+                except (FileNotFoundError, OSError, ValueError) as exc:
+                    failed += 1
+                    message = (
+                        f'{entry.model._meta.label}.{entry.field_name} '
+                        f'pk={obj.pk}: {exc}'
+                    )
+                    failures.append(message)
+                    self.stderr.write(self.style.WARNING(f'SKIP {message}'))
+                    if options['fail_fast']:
+                        raise
+
+        summary = (
+            f'Processed {processed} registered model images; '
+            f'skipped {skipped}; failures {failed}.'
+        )
+        if failed:
+            self.stdout.write(self.style.WARNING(summary))
+            self.stdout.write('Last failures:')
+            for message in failures[-20:]:
+                self.stdout.write(f'  - {message}')
+        else:
+            self.stdout.write(self.style.SUCCESS(summary))

{media_optimization_engine-1.4.1 → media_optimization_engine-1.4.2}/media_engine/storage_paths.py

@@ -2,7 +2,7 @@ from pathlib import Path
 
 
 def safe_extension(fmt):
-    return {'JPEG': 'jpg', 'JPG': 'jpg', 'PNG': 'png', 'WEBP': 'webp', 'AVIF': 'avif'}.get(fmt.upper(), fmt.lower())
+    return {'JPEG': 'jpg', 'JPG': 'jpg', 'MPO': 'jpg', 'PNG': 'png', 'WEBP': 'webp', 'AVIF': 'avif'}.get(fmt.upper(), fmt.lower())
 
 
 def original_storage_name(sha256_hex, extension):

media_optimization_engine-1.4.2/media_engine/tests/test_backfill_registered_media.py

@@ -0,0 +1,51 @@
+from types import SimpleNamespace
+from unittest.mock import patch
+
+from django.core.exceptions import ValidationError
+from django.core.management import call_command
+from django.test import SimpleTestCase
+
+
+class _Manager:
+    def __init__(self, objects):
+        self._objects = list(objects)
+
+    def all(self):
+        return self
+
+    def __iter__(self):
+        return iter(self._objects)
+
+    def __getitem__(self, item):
+        if isinstance(item, slice):
+            return _Manager(self._objects[item])
+        return self._objects[item]
+
+    def iterator(self):
+        return iter(self._objects)
+
+
+class BackfillRegisteredMediaTests(SimpleTestCase):
+    @patch("media_engine.management.commands.backfill_registered_media.entries")
+    @patch("media_engine.management.commands.backfill_registered_media.ingest_model_field")
+    def test_invalid_image_does_not_abort_backfill(self, ingest, entries):
+        model = SimpleNamespace(
+            _default_manager=_Manager([
+                SimpleNamespace(pk=1),
+                SimpleNamespace(pk=2),
+            ]),
+            _meta=SimpleNamespace(label="demo.Photo"),
+        )
+        entries.return_value = [
+            SimpleNamespace(
+                model=model,
+                field_name="image",
+                profile="default",
+                role="content",
+            )
+        ]
+        ingest.side_effect = [ValidationError("Unsupported image format"), object()]
+
+        call_command("backfill_registered_media")
+
+        self.assertEqual(ingest.call_count, 2)

media_optimization_engine-1.4.2/media_engine/tests/test_validators.py

@@ -0,0 +1,30 @@
+from io import BytesIO
+from unittest.mock import MagicMock, patch
+
+from django.core.files.uploadedfile import SimpleUploadedFile
+from django.test import SimpleTestCase
+
+from media_engine.validators import inspect_upload
+
+
+class MpoValidationTests(SimpleTestCase):
+    @patch("media_engine.validators.Image.open")
+    def test_mpo_is_normalized_as_jpeg(self, image_open):
+        image = MagicMock()
+        image.format = "MPO"
+        image.size = (1200, 800)
+        image.verify.return_value = None
+        image_open.return_value = image
+
+        upload = SimpleUploadedFile(
+            "portrait.jpg",
+            b"fake-mpo-container",
+            content_type="image/jpeg",
+        )
+
+        raw, fmt, mime, width, height = inspect_upload(upload)
+
+        self.assertEqual(raw, b"fake-mpo-container")
+        self.assertEqual(fmt, "JPEG")
+        self.assertEqual(mime, "image/jpeg")
+        self.assertEqual((width, height), (1200, 800))

{media_optimization_engine-1.4.1 → media_optimization_engine-1.4.2}/media_engine/validators.py

@@ -7,9 +7,10 @@ try:
 except Exception:
     pillow_avif = None
 
-ALLOWED_FORMATS = {'JPEG', 'PNG', 'WEBP', 'AVIF'}
+ALLOWED_FORMATS = {'JPEG', 'PNG', 'WEBP', 'AVIF', 'MPO'}
 MIME_BY_FORMAT = {
     'JPEG': 'image/jpeg',
+    'MPO': 'image/jpeg',
     'PNG': 'image/png',
     'WEBP': 'image/webp',
     'AVIF': 'image/avif',
@@ -31,6 +32,11 @@ def inspect_upload(uploaded_file):
         fmt = (image.format or '').upper()
         if fmt not in ALLOWED_FORMATS:
             raise ValidationError(f'Unsupported image format: {fmt or "unknown"}')
+        # Pillow reports some JPEG containers as MPO. For optimization purposes,
+        # the primary frame is a normal JPEG-compatible raster and can safely
+        # enter the standard image pipeline.
+        if fmt == 'MPO':
+            fmt = 'JPEG'
         width, height = image.size
         max_pixels = getattr(settings, 'MEDIA_ENGINE_MAX_PIXELS', 50_000_000)
         if width * height > max_pixels:

{media_optimization_engine-1.4.1 → media_optimization_engine-1.4.2/media_optimization_engine.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: media-optimization-engine
-Version: 1.4.1
+Version: 1.4.2
 Summary: Media Optimization Engineer for Django/Python: automatic model-field optimization, responsive picture/srcset rendering, AVIF/WebP derivatives, 360 media, autonomous nodes, and CDN-ready storage.
 Author-email: Achille Kabasele <pepexykabasele@gmail.com>
 Maintainer-email: Achille Kabasele <pepexykabasele@gmail.com>
@@ -233,6 +233,16 @@ JavaScript is not required for normal responsive images.
 
 Runtime measurement is appropriate only for highly dynamic components whose rendered width cannot be described reliably with sizes, such as resizable editors, canvas-like builders, or asynchronously mounted panels.
 
+## Docker image
+
+The standalone service is also published as a multi-architecture GHCR image:
+
+~~~bash
+docker pull ghcr.io/kabasele754/media-optimization-engine:1.4.1
+~~~
+
+For Compose deployment, see `docs/DOCKER.md` and `docker-compose.ghcr.yml`.
+
 ## Flutter / native clients
 
 MOE also ships reference Dart adapters for native applications.

{media_optimization_engine-1.4.1 → media_optimization_engine-1.4.2}/media_optimization_engine.egg-info/SOURCES.txt

@@ -75,12 +75,14 @@ media_engine/static/media_engine/media-cache-sw.js
 media_engine/templatetags/__init__.py
 media_engine/templatetags/responsive_media.py
 media_engine/tests/__init__.py
+media_engine/tests/test_backfill_registered_media.py
 media_engine/tests/test_distributed_node.py
 media_engine/tests/test_image_ops.py
 media_engine/tests/test_panorama.py
 media_engine/tests/test_paths.py
 media_engine/tests/test_profiles.py
 media_engine/tests/test_responsive_media.py
+media_engine/tests/test_validators.py
 media_optimization_engine.egg-info/PKG-INFO
 media_optimization_engine.egg-info/SOURCES.txt
 media_optimization_engine.egg-info/dependency_links.txt

{media_optimization_engine-1.4.1 → media_optimization_engine-1.4.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "media-optimization-engine"
-version = "1.4.1"
+version = "1.4.2"
 description = "Media Optimization Engineer for Django/Python: automatic model-field optimization, responsive picture/srcset rendering, AVIF/WebP derivatives, 360 media, autonomous nodes, and CDN-ready storage."
 requires-python = ">=3.11"
 authors = [{ name = "Achille Kabasele", email = "pepexykabasele@gmail.com" }]

media_optimization_engine-1.4.1/media_engine/management/commands/backfill_registered_media.py

@@ -1,21 +0,0 @@
-from django.core.management.base import BaseCommand
-from media_engine.integration import ingest_model_field
-from media_engine.registry import entries
-
-
-class Command(BaseCommand):
-    help = 'Ingest image fields declared through register_model_image().' 
-
-    def add_arguments(self, parser):
-        parser.add_argument('--limit', type=int)
-
-    def handle(self, *args, **options):
-        processed = 0
-        for entry in entries():
-            qs = entry.model._default_manager.all()
-            if options['limit']:
-                qs = qs[:options['limit']]
-            for obj in qs.iterator():
-                ingest_model_field(obj, field_name=entry.field_name, profile=entry.profile, role=entry.role)
-                processed += 1
-        self.stdout.write(self.style.SUCCESS(f'Processed {processed} registered model images.'))