labelixa 0.1.0__py3-none-any.whl

labelixa/__init__.py

@@ -0,0 +1,29 @@
+"""Labelixa Python SDK — thin client for the Labelixa REST API.
+
+Render, validate and convert Zebra ZPL label code without a printer:
+
+    from labelixa import Client
+
+    c = Client()                        # anonymous: free, rate-limited
+    c = Client(api_key="lbx_...")       # your quota, your account
+
+    png = c.render_png("^XA^FO50,50^A0N,40^FDHello^FS^XZ")
+    pdf = c.render_pdf(zpl, width_in=4, height_in=6)
+    report = c.validate(zpl)            # structured lint diagnostics
+    epl = c.to_epl(zpl)                 # ZPL -> EPL2 translation
+
+Design notes (deliberate):
+- This is a THIN wrapper. Every method maps 1:1 to a documented REST
+  endpoint; no client-side magic, no hidden retries that would mask
+  quota signals. The API reference at https://labelixa.com/docs/api is
+  the source of truth.
+- Errors carry the server's own message. Quota exhaustion raises
+  ``QuotaExceeded`` with ``retry_after`` seconds and, when the server
+  suggests one, an ``action`` hint ("upgrade" / "addon").
+"""
+from __future__ import annotations
+
+from .client import Client, LabelixaError, QuotaExceeded
+
+__all__ = ["Client", "LabelixaError", "QuotaExceeded"]
+__version__ = "0.1.0"

labelixa/client.py

@@ -0,0 +1,134 @@
+from __future__ import annotations
+
+import json
+from typing import Any
+
+import httpx
+
+VARSAYILAN_TABAN = "https://api.labelixa.com"
+ZAMAN_ASIMI = httpx.Timeout(30.0)
+
+
+class LabelixaError(RuntimeError):
+    """API bir hata döndürdü. `status` HTTP kodu, mesaj sunucunun kendisi.
+
+    Mesajı yeniden yazmıyoruz: sunucu mesajları zaten eyleme dönük
+    ("Istek basina en fazla N etiket...") ve SDK'nın araya girmesi
+    bilgiyi ancak bozar.
+    """
+
+    def __init__(self, status: int, message: str) -> None:
+        super().__init__(f"HTTP {status}: {message}")
+        self.status = status
+        self.message = message
+
+
+class QuotaExceeded(LabelixaError):
+    """Kota/hız sınırı. `retry_after` saniye; `action` sunucu önerisi.
+
+    Ayrı sınıf olması önemli: 429'u genel hatadan ayıramayan istemci ya
+    hiç yeniden denemez ya da hemen dener — ikisi de yanlış.
+    """
+
+    def __init__(self, status: int, message: str,
+                 retry_after: int, action: str | None) -> None:
+        super().__init__(status, message)
+        self.retry_after = retry_after
+        self.action = action
+
+
+def _hata(yanit: httpx.Response) -> LabelixaError:
+    metin = yanit.text[:500]
+    if yanit.status_code in (402, 429):
+        try:
+            bekle = int(yanit.headers.get("Retry-After", "60"))
+        except ValueError:
+            bekle = 60
+        return QuotaExceeded(yanit.status_code, metin, bekle,
+                             yanit.headers.get("X-Quota-Action"))
+    return LabelixaError(yanit.status_code, metin)
+
+
+class Client:
+    """Labelixa API istemcisi.
+
+    `transport` parametresi test içindir (httpx.ASGITransport ile ağ
+    olmadan gerçek uygulamaya karşı test edilir); normal kullanımda
+    verilmez.
+    """
+
+    def __init__(self, api_key: str | None = None,
+                 base_url: str = VARSAYILAN_TABAN, *,
+                 transport: httpx.BaseTransport | None = None) -> None:
+        basliklar = {"User-Agent": "labelixa-python/0.1.0"}
+        if api_key:
+            basliklar["X-API-Key"] = api_key
+        self._http = httpx.Client(base_url=base_url, headers=basliklar,
+                                  timeout=ZAMAN_ASIMI, transport=transport)
+
+    # ------------------------------------------------------------- render --
+    def render_png(self, zpl: str, *, dpmm: int = 8, width_in: float = 4,
+                   height_in: float = 6, index: int = 0,
+                   rotation: int = 0) -> bytes:
+        """Tek etiketi PNG olarak render eder."""
+        basliklar = {"Content-Type": "text/plain"}
+        if rotation:
+            basliklar["X-Rotation"] = str(rotation)
+        y = self._http.post(
+            f"/v1/printers/{dpmm}dpmm/labels/{width_in:g}x{height_in:g}/{index}",
+            content=zpl.encode(), headers=basliklar)
+        if y.status_code != 200:
+            raise _hata(y)
+        return y.content
+
+    def render_pdf(self, zpl: str, *, dpmm: int = 8, width_in: float = 4,
+                   height_in: float = 6, index: int | None = None) -> bytes:
+        """PDF render eder; `index=None` akıştaki TÜM etiketleri içerir.
+
+        Dikkat: tüm-etiket PDF'i kota olarak etiket SAYISI kadar düşer
+        (tek sayfa 1 düşer) — sunucu kuralıdır, SDK yumuşatmaz.
+        """
+        son = "" if index is None else str(index)
+        y = self._http.post(
+            f"/v1/printers/{dpmm}dpmm/labels/{width_in:g}x{height_in:g}/{son}",
+            content=zpl.encode(),
+            headers={"Content-Type": "text/plain",
+                     "Accept": "application/pdf"})
+        if y.status_code != 200:
+            raise _hata(y)
+        return y.content
+
+    # -------------------------------------------------------- diagnostics --
+    def validate(self, zpl: str, *, dpmm: int = 8, width_in: float = 4,
+                 height_in: float = 6) -> dict[str, Any]:
+        """ZPL'i lint'ler; yapısal tanılama raporu döndürür."""
+        y = self._http.post(
+            "/v1/diagnostics",
+            params={"dpmm": dpmm, "width": width_in, "height": height_in},
+            content=zpl.encode(),
+            headers={"Content-Type": "text/plain"})
+        if y.status_code != 200:
+            raise _hata(y)
+        return json.loads(y.text)
+
+    # ------------------------------------------------------------ convert --
+    def to_epl(self, zpl: str, *, dpmm: int = 8, width_in: float = 4,
+               height_in: float = 6) -> str:
+        """ZPL → EPL2 çevirisi. Çevrilemeyen alanlar sunucu uyarısıyla düşer."""
+        y = self._http.post(
+            f"/v1/printers/{dpmm}dpmm/labels/{width_in:g}x{height_in:g}/",
+            content=zpl.encode(),
+            headers={"Content-Type": "text/plain",
+                     "Accept": "application/epl"})
+        if y.status_code != 200:
+            raise _hata(y)
+        return y.text
+
+    def close(self) -> None:
+        self._http.close()
+
+    def __enter__(self) -> "Client":
+        return self
+
+    def __exit__(self, *a: object) -> None:
+        self.close()

labelixa-0.1.0.dist-info/METADATA

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: labelixa
+Version: 0.1.0
+Summary: Render, validate and convert Zebra ZPL label code via the Labelixa API — no printer required.
+Project-URL: Homepage, https://labelixa.com
+Project-URL: Documentation, https://labelixa.com/docs/api
+License-Expression: MIT
+Keywords: barcode,epl,label,printing,thermal-printer,zebra,zpl
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Printing
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.24
+Description-Content-Type: text/markdown
+
+# labelixa
+
+Render, validate and convert **Zebra ZPL** label code from Python — no
+printer required. Thin client for the [Labelixa](https://labelixa.com) API.
+
+```bash
+pip install labelixa
+```
+
+```python
+from labelixa import Client
+
+c = Client()                          # anonymous: free, rate-limited
+# c = Client(api_key="lbx_...")       # your quota — https://labelixa.com/panel
+
+zpl = "^XA^FO50,50^A0N,40^FDHello^FS^BY3^FO50,120^BCN,100,Y^FD12345678^FS^XZ"
+
+# See what the label looks like
+with open("label.png", "wb") as f:
+    f.write(c.render_png(zpl, width_in=4, height_in=6))
+
+# Lint before printing
+report = c.validate(zpl)
+for d in report["diagnostics"]:
+    print(d["severity"], d["message"])
+
+# Multi-label PDF, ZPL -> EPL2 translation
+pdf = c.render_pdf(zpl)
+epl = c.to_epl(zpl)
+```
+
+Quota errors are first-class:
+
+```python
+from labelixa import QuotaExceeded
+
+try:
+    c.render_png(zpl)
+except QuotaExceeded as e:
+    print(f"retry in {e.retry_after}s (hint: {e.action})")
+```
+
+This SDK is a deliberately thin 1:1 wrapper over the documented REST
+API — the [API reference](https://labelixa.com/docs/api) is the source
+of truth. AI assistants can also use Labelixa directly over MCP:
+point your client at `https://api.labelixa.com/mcp`.

labelixa-0.1.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+labelixa/__init__.py,sha256=XRO9vsarVdYU3f-dvnoRV3C50hDlBY415mSr5xPt05s,1185
+labelixa/client.py,sha256=xrPtCV08OSgZA2Yg-aMx2ALXWPPF9fX_YclrkXxDV5E,5040
+labelixa-0.1.0.dist-info/METADATA,sha256=Gg-xMGFpF75nsBwmONV2HCi6D9MdxMY4uhhVFXoysnk,1860
+labelixa-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+labelixa-0.1.0.dist-info/RECORD,,

labelixa-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any