stapel-cdn 0.4.1__tar.gz

stapel_cdn-0.4.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 usestapel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

stapel_cdn-0.4.1/PKG-INFO

@@ -0,0 +1,58 @@
+Metadata-Version: 2.4
+Name: stapel-cdn
+Version: 0.4.1
+Summary: Media/CDN management Django app for the Stapel framework
+License: MIT
+Keywords: django,stapel,cdn,media,storage
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 5.2
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: stapel-core<0.4,>=0.3.0
+Requires-Dist: Pillow>=9.0
+Requires-Dist: celery>=5
+Provides-Extra: s3
+Requires-Dist: boto3>=1.34; extra == "s3"
+Provides-Extra: images
+Requires-Dist: pyvips>=2.2; extra == "images"
+Provides-Extra: all
+Requires-Dist: stapel-cdn[images,s3]; extra == "all"
+Dynamic: license-file
+
+# stapel-cdn
+
+[![CI](https://github.com/usestapel/stapel-cdn/actions/workflows/ci.yml/badge.svg)](https://github.com/usestapel/stapel-cdn/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/usestapel/stapel-cdn/graph/badge.svg)](https://codecov.io/gh/usestapel/stapel-cdn)
+
+> Media management — image/video/file upload, processing, CDN ref tracking
+
+Part of the [Stapel framework](https://github.com/usestapel) — composable Django apps for building production-grade platforms.
+
+## Installation
+
+```bash
+pip install stapel-cdn
+```
+
+## Quick start
+
+```python
+# settings.py
+INSTALLED_APPS = [
+    ...
+    'stapel_cdn',
+]
+```
+
+## Bus events
+
+### Consumes
+| `user.deleted` | [schema](schemas/consumes/user.deleted.json) |
+| `user.deletion_initiated` | [schema](schemas/consumes/user.deletion_initiated.json) |
+
+## License
+
+MIT — see [LICENSE](LICENSE)

stapel_cdn-0.4.1/README.md

@@ -0,0 +1,34 @@
+# stapel-cdn
+
+[![CI](https://github.com/usestapel/stapel-cdn/actions/workflows/ci.yml/badge.svg)](https://github.com/usestapel/stapel-cdn/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/usestapel/stapel-cdn/graph/badge.svg)](https://codecov.io/gh/usestapel/stapel-cdn)
+
+> Media management — image/video/file upload, processing, CDN ref tracking
+
+Part of the [Stapel framework](https://github.com/usestapel) — composable Django apps for building production-grade platforms.
+
+## Installation
+
+```bash
+pip install stapel-cdn
+```
+
+## Quick start
+
+```python
+# settings.py
+INSTALLED_APPS = [
+    ...
+    'stapel_cdn',
+]
+```
+
+## Bus events
+
+### Consumes
+| `user.deleted` | [schema](schemas/consumes/user.deleted.json) |
+| `user.deletion_initiated` | [schema](schemas/consumes/user.deletion_initiated.json) |
+
+## License
+
+MIT — see [LICENSE](LICENSE)

stapel_cdn-0.4.1/__init__.py

@@ -0,0 +1,47 @@
+"""CDN app for stapel-cdn service.
+
+Public API (lazily exported, PEP 562 — importing this package never pulls
+in Django or requires configured settings):
+
+- ``cdn_settings`` — resolved app settings (``stapel_cdn.conf``).
+- ``media_exists`` — comm function: check whether a media ref resolves to a
+  stored CDN asset (``stapel_cdn.functions``).
+- ``refs_sync`` — comm function: sync entity → media reference tracking
+  (``stapel_cdn.functions``).
+- ``validate_image_file`` — upload validator: extension allowlist, Pillow
+  decode check, decompression-bomb cap (``stapel_cdn.validators``).
+- ``text_watermark`` — built-in reference watermark engine for the
+  ``STAPEL_CDN["WATERMARK"]`` seam (``stapel_cdn.watermarks``).
+"""
+
+__all__ = [
+    "cdn_settings",
+    "media_exists",
+    "refs_sync",
+    "text_watermark",
+    "validate_image_file",
+]
+
+# name → submodule that defines it. Resolution is deferred until first
+# attribute access so that `import stapel_cdn` stays Django-free.
+_LAZY_EXPORTS = {
+    "cdn_settings": ".conf",
+    "media_exists": ".functions",
+    "refs_sync": ".functions",
+    "text_watermark": ".watermarks",
+    "validate_image_file": ".validators",
+}
+
+
+def __getattr__(name):
+    if name in _LAZY_EXPORTS:
+        from importlib import import_module
+
+        value = getattr(import_module(_LAZY_EXPORTS[name], __name__), name)
+        globals()[name] = value  # cache for subsequent lookups
+        return value
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+def __dir__():
+    return sorted(set(globals()) | set(__all__))

stapel_cdn-0.4.1/actions.py

@@ -0,0 +1,23 @@
+"""Action subscriptions of the cdn module.
+
+Handlers must be idempotent: delivery is at-least-once (outbox retries,
+broker redelivery).
+"""
+import logging
+
+from stapel_core.comm import on_action
+
+logger = logging.getLogger(__name__)
+
+
+@on_action("user.deleted")
+def handle_user_deleted(event):
+    """Erase this module's PII when an account deletion is executed."""
+    from .gdpr import CDNGDPRProvider
+
+    user_id = event.payload.get("user_id")
+    if not user_id:
+        logger.error("user.deleted event without user_id: %s", event.event_id)
+        return
+    CDNGDPRProvider().delete(user_id)
+    logger.info("cdn data erased for deleted user %s", user_id)