iterationlayer 1.1.0__tar.gz

iterationlayer-1.1.0/.github/workflows/ci.yml

@@ -0,0 +1,24 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e ".[dev]"
+      - run: ruff check .
+      - run: ruff format --check .
+      - run: mypy iterationlayer
+      - run: pytest

iterationlayer-1.1.0/.github/workflows/publish.yml

@@ -0,0 +1,21 @@
+name: Publish
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: pip install build twine
+      - run: python -m build
+      - run: twine upload dist/*
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_TOKEN }}

iterationlayer-1.1.0/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.pyc
+*.egg-info/
+dist/
+build/
+.venv/
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/

iterationlayer-1.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Iteration Layer
+
+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.

iterationlayer-1.1.0/PKG-INFO

@@ -0,0 +1,214 @@
+Metadata-Version: 2.4
+Name: iterationlayer
+Version: 1.1.0
+Summary: Official Python SDK for the Iteration Layer API
+Project-URL: Homepage, https://iterationlayer.com
+Project-URL: Documentation, https://iterationlayer.com/docs
+Project-URL: Repository, https://github.com/iterationlayer/sdk-python
+Project-URL: Issues, https://github.com/iterationlayer/issues
+Author: Iteration Layer
+License-Expression: MIT
+License-File: LICENSE
+Keywords: api,document-extraction,document-generation,image-generation,image-transformation,iteration-layer,sdk
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.9
+Requires-Dist: httpx<1,>=0.27
+Provides-Extra: dev
+Requires-Dist: mypy>=1.15; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: respx>=0.22; extra == 'dev'
+Requires-Dist: ruff>=0.11; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Iteration Layer Python SDK
+
+Official Python SDK for the [Iteration Layer API](https://iterationlayer.com).
+
+## Installation
+
+```sh
+pip install iterationlayer
+```
+
+## Usage
+
+```python
+from iterationlayer import IterationLayer
+
+client = IterationLayer(api_key="il_your_api_key")
+```
+
+### Document Extraction
+
+Extract structured data from documents using AI.
+
+```python
+result = client.extract(
+    files=[{"type": "url", "name": "invoice.pdf", "url": "https://example.com/invoice.pdf"}],
+    schema={
+        "fields": [
+            {"type": "TEXT", "name": "company_name", "description": "The company name"},
+            {"type": "CURRENCY_AMOUNT", "name": "total", "description": "The invoice total"},
+        ]
+    },
+)
+
+print(result["company_name"]["value"])       # "Acme Corp"
+print(result["company_name"]["confidence"])  # 0.95
+```
+
+### Image Transformation
+
+Resize, crop, convert, and apply effects to images.
+
+```python
+result = client.transform(
+    file={"type": "url", "name": "photo.jpg", "url": "https://example.com/photo.jpg"},
+    operations=[
+        {"type": "resize", "width_in_px": 800, "height_in_px": 600, "fit": "cover"},
+        {"type": "convert", "format": "webp", "quality": 85},
+    ],
+)
+
+import base64
+image_bytes = base64.b64decode(result["buffer"])
+```
+
+### Image Generation
+
+Compose images from layer definitions.
+
+```python
+result = client.generate_image(
+    dimensions={"width_in_px": 1200, "height_in_px": 630},
+    layers=[
+        {"type": "solid-color", "index": 0, "hex_color": "#1a1a2e"},
+        {
+            "type": "text",
+            "index": 1,
+            "text": "Hello World",
+            "font_name": "Inter",
+            "font_size_in_px": 48,
+            "text_color": "#ffffff",
+            "position": {"x_in_px": 50, "y_in_px": 50},
+            "dimensions": {"width_in_px": 1100, "height_in_px": 530},
+        },
+    ],
+    output_format="png",
+)
+
+import base64
+image_bytes = base64.b64decode(result["buffer"])
+```
+
+### Document Generation
+
+Generate PDF, DOCX, EPUB, or PPTX from structured data.
+
+```python
+result = client.generate_document(
+    format="pdf",
+    document={
+        "metadata": {"title": "Invoice #123"},
+        "page": {
+            "size": {"preset": "A4"},
+            "margins": {"top_in_pt": 36, "bottom_in_pt": 36, "left_in_pt": 36, "right_in_pt": 36},
+        },
+        "styles": {
+            "text": {"font_family": "Helvetica", "font_size_in_pt": 12, "line_height": 1.5, "color": "#000000"},
+            "headline": {"font_family": "Helvetica", "font_size_in_pt": 24, "color": "#000000", "spacing_before_in_pt": 12, "spacing_after_in_pt": 6},
+            "link": {"color": "#0066cc"},
+            "list": {"indent_in_pt": 18, "spacing_between_items_in_pt": 4},
+            "table": {
+                "header": {"background_color": "#f0f0f0", "font_family": "Helvetica", "font_size_in_pt": 12, "color": "#000000", "padding_in_pt": 6},
+                "body": {"font_family": "Helvetica", "font_size_in_pt": 12, "color": "#000000", "padding_in_pt": 6},
+            },
+            "grid": {"gap_in_pt": 12},
+            "separator": {"color": "#cccccc", "thickness_in_pt": 1, "margin_top_in_pt": 12, "margin_bottom_in_pt": 12},
+            "image": {"alignment": "center", "margin_top_in_pt": 8, "margin_bottom_in_pt": 8},
+        },
+        "content": [
+            {"type": "headline", "level": "h1", "text": "Invoice #123"},
+            {"type": "paragraph", "markdown": "Thank you for your business."},
+        ],
+    },
+)
+
+import base64
+pdf_bytes = base64.b64decode(result["buffer"])
+```
+
+### Sheet Generation
+
+Generate CSV, Markdown, or XLSX spreadsheets from structured data.
+
+```python
+result = client.generate_sheet(
+    format="xlsx",
+    sheets=[
+        {
+            "name": "Invoices",
+            "columns": [
+                {"name": "Company", "width": 20},
+                {"name": "Total", "width": 15},
+            ],
+            "rows": [
+                [
+                    {"value": "Acme Corp"},
+                    {"value": 1500.50, "format": "currency", "currency_code": "EUR"},
+                ],
+            ],
+        },
+    ],
+)
+
+import base64
+sheet_bytes = base64.b64decode(result["buffer"])
+```
+
+### Webhooks (Async)
+
+Use the `*_async` methods to receive results via webhook instead of waiting for the response.
+
+```python
+result = client.extract_async(
+    files=[{"type": "url", "name": "invoice.pdf", "url": "https://example.com/invoice.pdf"}],
+    schema={
+        "fields": [
+            {"type": "CURRENCY_AMOUNT", "name": "total", "description": "The invoice total"},
+        ]
+    },
+    webhook_url="https://your-app.com/webhooks/extraction",
+)
+```
+
+### Context Manager
+
+The client can be used as a context manager to ensure the underlying HTTP connection is closed.
+
+```python
+with IterationLayer(api_key="il_your_api_key") as client:
+    result = client.extract(...)
+```
+
+### Error Handling
+
+```python
+from iterationlayer import IterationLayerError
+
+try:
+    result = client.extract(...)
+except IterationLayerError as e:
+    print(e.status_code)     # 422
+    print(e.error_message)   # "Validation error: ..."
+```
+
+## Documentation
+
+Full documentation is available at [https://iterationlayer.com/docs](https://iterationlayer.com/docs).
+
+## Issues & Feedback
+
+Please report bugs and request features in the [issues repository](https://github.com/iterationlayer/issues).

iterationlayer-1.1.0/README.md

@@ -0,0 +1,190 @@
+# Iteration Layer Python SDK
+
+Official Python SDK for the [Iteration Layer API](https://iterationlayer.com).
+
+## Installation
+
+```sh
+pip install iterationlayer
+```
+
+## Usage
+
+```python
+from iterationlayer import IterationLayer
+
+client = IterationLayer(api_key="il_your_api_key")
+```
+
+### Document Extraction
+
+Extract structured data from documents using AI.
+
+```python
+result = client.extract(
+    files=[{"type": "url", "name": "invoice.pdf", "url": "https://example.com/invoice.pdf"}],
+    schema={
+        "fields": [
+            {"type": "TEXT", "name": "company_name", "description": "The company name"},
+            {"type": "CURRENCY_AMOUNT", "name": "total", "description": "The invoice total"},
+        ]
+    },
+)
+
+print(result["company_name"]["value"])       # "Acme Corp"
+print(result["company_name"]["confidence"])  # 0.95
+```
+
+### Image Transformation
+
+Resize, crop, convert, and apply effects to images.
+
+```python
+result = client.transform(
+    file={"type": "url", "name": "photo.jpg", "url": "https://example.com/photo.jpg"},
+    operations=[
+        {"type": "resize", "width_in_px": 800, "height_in_px": 600, "fit": "cover"},
+        {"type": "convert", "format": "webp", "quality": 85},
+    ],
+)
+
+import base64
+image_bytes = base64.b64decode(result["buffer"])
+```
+
+### Image Generation
+
+Compose images from layer definitions.
+
+```python
+result = client.generate_image(
+    dimensions={"width_in_px": 1200, "height_in_px": 630},
+    layers=[
+        {"type": "solid-color", "index": 0, "hex_color": "#1a1a2e"},
+        {
+            "type": "text",
+            "index": 1,
+            "text": "Hello World",
+            "font_name": "Inter",
+            "font_size_in_px": 48,
+            "text_color": "#ffffff",
+            "position": {"x_in_px": 50, "y_in_px": 50},
+            "dimensions": {"width_in_px": 1100, "height_in_px": 530},
+        },
+    ],
+    output_format="png",
+)
+
+import base64
+image_bytes = base64.b64decode(result["buffer"])
+```
+
+### Document Generation
+
+Generate PDF, DOCX, EPUB, or PPTX from structured data.
+
+```python
+result = client.generate_document(
+    format="pdf",
+    document={
+        "metadata": {"title": "Invoice #123"},
+        "page": {
+            "size": {"preset": "A4"},
+            "margins": {"top_in_pt": 36, "bottom_in_pt": 36, "left_in_pt": 36, "right_in_pt": 36},
+        },
+        "styles": {
+            "text": {"font_family": "Helvetica", "font_size_in_pt": 12, "line_height": 1.5, "color": "#000000"},
+            "headline": {"font_family": "Helvetica", "font_size_in_pt": 24, "color": "#000000", "spacing_before_in_pt": 12, "spacing_after_in_pt": 6},
+            "link": {"color": "#0066cc"},
+            "list": {"indent_in_pt": 18, "spacing_between_items_in_pt": 4},
+            "table": {
+                "header": {"background_color": "#f0f0f0", "font_family": "Helvetica", "font_size_in_pt": 12, "color": "#000000", "padding_in_pt": 6},
+                "body": {"font_family": "Helvetica", "font_size_in_pt": 12, "color": "#000000", "padding_in_pt": 6},
+            },
+            "grid": {"gap_in_pt": 12},
+            "separator": {"color": "#cccccc", "thickness_in_pt": 1, "margin_top_in_pt": 12, "margin_bottom_in_pt": 12},
+            "image": {"alignment": "center", "margin_top_in_pt": 8, "margin_bottom_in_pt": 8},
+        },
+        "content": [
+            {"type": "headline", "level": "h1", "text": "Invoice #123"},
+            {"type": "paragraph", "markdown": "Thank you for your business."},
+        ],
+    },
+)
+
+import base64
+pdf_bytes = base64.b64decode(result["buffer"])
+```
+
+### Sheet Generation
+
+Generate CSV, Markdown, or XLSX spreadsheets from structured data.
+
+```python
+result = client.generate_sheet(
+    format="xlsx",
+    sheets=[
+        {
+            "name": "Invoices",
+            "columns": [
+                {"name": "Company", "width": 20},
+                {"name": "Total", "width": 15},
+            ],
+            "rows": [
+                [
+                    {"value": "Acme Corp"},
+                    {"value": 1500.50, "format": "currency", "currency_code": "EUR"},
+                ],
+            ],
+        },
+    ],
+)
+
+import base64
+sheet_bytes = base64.b64decode(result["buffer"])
+```
+
+### Webhooks (Async)
+
+Use the `*_async` methods to receive results via webhook instead of waiting for the response.
+
+```python
+result = client.extract_async(
+    files=[{"type": "url", "name": "invoice.pdf", "url": "https://example.com/invoice.pdf"}],
+    schema={
+        "fields": [
+            {"type": "CURRENCY_AMOUNT", "name": "total", "description": "The invoice total"},
+        ]
+    },
+    webhook_url="https://your-app.com/webhooks/extraction",
+)
+```
+
+### Context Manager
+
+The client can be used as a context manager to ensure the underlying HTTP connection is closed.
+
+```python
+with IterationLayer(api_key="il_your_api_key") as client:
+    result = client.extract(...)
+```
+
+### Error Handling
+
+```python
+from iterationlayer import IterationLayerError
+
+try:
+    result = client.extract(...)
+except IterationLayerError as e:
+    print(e.status_code)     # 422
+    print(e.error_message)   # "Validation error: ..."
+```
+
+## Documentation
+
+Full documentation is available at [https://iterationlayer.com/docs](https://iterationlayer.com/docs).
+
+## Issues & Feedback
+
+Please report bugs and request features in the [issues repository](https://github.com/iterationlayer/issues).

iterationlayer-1.1.0/iterationlayer/__init__.py

@@ -0,0 +1,10 @@
+from iterationlayer.client import (
+    IterationLayer,
+    IterationLayerError,
+)
+from iterationlayer.types import *  # noqa: F401, F403
+
+__all__ = [
+    "IterationLayer",
+    "IterationLayerError",
+]