optivor 1.2.0__py3-none-any.whl

optivor/__init__.py

@@ -0,0 +1,41 @@
+from urllib.parse import urlencode, rstrip
+
+class OptivorClient:
+    def __init__(self, base_url: str = "http://localhost:8080", default_bucket: str = ""):
+        self.base_url = base_url.rstrip("/")
+        self.default_bucket = default_bucket
+
+    def build_url(self, key: str, **params) -> str:
+        clean_key = key.lstrip("/")
+        if self.default_bucket and "/" not in clean_key:
+            full_path = f"{self.default_bucket}/{clean_key}"
+        else:
+            full_path = clean_key
+
+        query = {}
+        if "width" in params or "w" in params:
+            query["w"] = params.get("width") or params.get("w")
+        if "height" in params or "h" in params:
+            query["h"] = params.get("height") or params.get("h")
+        if "fit" in params:
+            query["fit"] = params["fit"]
+        if "format" in params:
+            query["format"] = params["format"]
+        if "focal" in params:
+            focal = params["focal"]
+            query["focal"] = ",".join(map(str, focal)) if isinstance(focal, (list, tuple)) else str(focal)
+        if "overlay" in params:
+            query["overlay"] = params["overlay"]
+        if "gravity" in params:
+            query["gravity"] = params["gravity"]
+        if "opacity" in params:
+            query["opacity"] = params["opacity"]
+        if "blur" in params:
+            query["blur"] = params["blur"]
+        if params.get("grayscale"):
+            query["grayscale"] = "true"
+        if "pixelate" in params:
+            query["pixelate"] = params["pixelate"]
+
+        q_str = urlencode(query)
+        return f"{self.base_url}/image/{full_path}{'?' + q_str if q_str else ''}"

optivor-1.2.0.dist-info/METADATA

@@ -0,0 +1,96 @@
+Metadata-Version: 2.4
+Name: optivor
+Version: 1.2.0
+Summary: Official Python SDK for Optivor image optimization engine (Django / FastAPI support)
+Author: Optivor Team
+License: Apache-2.0
+Description-Content-Type: text/markdown
+
+# `optivor` (Python SDK)
+
+> Official Python SDK for [Optivor](https://github.com/optivor/optivor) image optimization engine (Django, FastAPI, Flask).
+
+[![PyPI version](https://img.shields.io/pypi/v/optivor.svg)](https://pypi.org/project/optivor/)
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
+
+The `optivor` Python package provides helper methods for building signed and dynamic image transformation URLs.
+
+---
+
+## Installation
+
+```bash
+pip install optivor
+```
+
+---
+
+## Basic Usage
+
+```python
+from optivor import OptivorClient
+
+optivor = OptivorClient(
+    base_url="https://optivor.example.com",
+    default_bucket="my-bucket"
+)
+
+# Generate WebP image URL
+url = optivor.build_url(
+    "photos/landscape.jpg",
+    width=800,
+    height=600,
+    fit="cover",
+    format="webp"
+)
+# => https://optivor.example.com/image/my-bucket/photos/landscape.jpg?w=800&h=600&fit=cover&format=webp
+```
+
+---
+
+## Advanced Options
+
+```python
+url = optivor.build_url(
+    "users/avatar.jpg",
+    width=400,
+    height=400,
+    fit="focal",
+    focal=(0.3, 0.7),
+    format="avif",
+    overlay="logo.png",
+    gravity="bottom_right",
+    opacity=60,
+    blur=5.0,
+    grayscale=True,
+    pixelate=4
+)
+```
+
+---
+
+## Django Integration Example
+
+```python
+# settings.py
+OPTIVOR_URL = "https://optivor.example.com"
+OPTIVOR_BUCKET = "prod-images"
+
+# templatetags/optivor_tags.py
+from django import template
+from optivor import OptivorClient
+from django.conf import settings
+
+register = template.Library()
+optivor = OptivorClient(settings.OPTIVOR_URL, settings.OPTIVOR_BUCKET)
+
+@register.simple_tag
+def optivor_url(key, **kwargs):
+    return optivor.build_url(key, **kwargs)
+```
+
+---
+
+## License
+
+Apache-2.0 © Optivor Team

optivor-1.2.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+optivor/__init__.py,sha256=0aZwnDtGGK3crjezvUmI668bBR9WPs9R5Y7YVyn_7dc,1656
+optivor-1.2.0.dist-info/METADATA,sha256=wAH1eDCEomoJAoaaLT99ZuODJeihLLdkjB09nFnYPcU,1959
+optivor-1.2.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+optivor-1.2.0.dist-info/top_level.txt,sha256=g8rcjnkO73rYRKZpUw8fJ8gMkP3QvEens3O1i1vA9Og,8
+optivor-1.2.0.dist-info/RECORD,,

optivor-1.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

optivor-1.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+optivor