snaprender 0.1.0__tar.gz

snaprender-0.1.0/.gitignore

@@ -0,0 +1,14 @@
+node_modules/
+dist/
+.env
+.env.local
+.env.production
+*.log
+coverage/
+.vscode/
+.idea/
+*.tsbuildinfo
+.DS_Store
+tmp/
+site/.astro/
+site/dist/

snaprender-0.1.0/LICENSE

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

snaprender-0.1.0/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: snaprender
+Version: 0.1.0
+Summary: Official Python SDK for SnapRender Screenshot API
+Project-URL: Homepage, https://snap-render.com
+Project-URL: Documentation, https://snap-render.com/docs
+Project-URL: Repository, https://github.com/User0856/snaprender
+License-Expression: MIT
+License-File: LICENSE
+Keywords: api,capture,screenshot,snaprender,webpage
+Requires-Python: >=3.8
+Requires-Dist: httpx>=0.24
+Description-Content-Type: text/markdown
+
+# snaprender
+
+Official Python SDK for the [SnapRender](https://snap-render.com) Screenshot API.
+
+## Install
+
+```bash
+pip install snaprender
+```
+
+## Quick Start
+
+```python
+from snaprender import SnapRender
+
+snap = SnapRender(api_key="sk_live_...")
+
+# Capture a screenshot
+image = snap.capture("https://example.com")
+with open("screenshot.png", "wb") as f:
+    f.write(image)
+
+# Capture with options
+jpg = snap.capture(
+    "https://example.com",
+    format="jpeg",
+    width=1920,
+    height=1080,
+    full_page=True,
+    dark_mode=True,
+    quality=95,
+)
+
+# Check cache status
+info = snap.info("https://example.com")
+print(info["cached"])  # True/False
+
+# Get usage
+usage = snap.usage()
+print(f"{usage['used']}/{usage['limit']} screenshots used")
+```
+
+## Context Manager
+
+```python
+with SnapRender(api_key="sk_live_...") as snap:
+    image = snap.capture("https://example.com")
+```
+
+## Error Handling
+
+```python
+from snaprender import SnapRender, SnapRenderError
+
+snap = SnapRender(api_key="sk_live_...")
+
+try:
+    snap.capture("https://example.com")
+except SnapRenderError as e:
+    print(e.code)    # "QUOTA_EXCEEDED"
+    print(e.status)  # 429
+    print(e)         # "Monthly quota exceeded"
+```
+
+## API
+
+### `SnapRender(api_key, base_url="https://app.snap-render.com", timeout=60.0)`
+
+### `snap.capture(url, **options)` -> `bytes`
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `url` | str | — | URL to capture (required) |
+| `format` | str | `"png"` | `"png"`, `"jpeg"`, `"webp"`, or `"pdf"` |
+| `width` | int | `1280` | Viewport width |
+| `height` | int | `800` | Viewport height |
+| `full_page` | bool | `False` | Capture full scrollable page |
+| `quality` | int | `90` | JPEG/WebP quality (1-100) |
+| `delay` | int | `0` | Wait ms after page load |
+| `dark_mode` | bool | `False` | Emulate dark mode |
+| `block_ads` | bool | `True` | Block ad networks |
+| `block_cookie_banners` | bool | `True` | Remove cookie banners |
+| `device` | str | — | Device preset (e.g. `"iPhone 15"`) |
+| `cache` | bool | `True` | Use cache |
+| `cache_ttl` | int | `86400` | Cache TTL in seconds |
+
+### `snap.info(url)` -> `dict`
+### `snap.usage()` -> `dict`
+### `snap.usage_daily(days=30)` -> `dict`

snaprender-0.1.0/README.md

@@ -0,0 +1,89 @@
+# snaprender
+
+Official Python SDK for the [SnapRender](https://snap-render.com) Screenshot API.
+
+## Install
+
+```bash
+pip install snaprender
+```
+
+## Quick Start
+
+```python
+from snaprender import SnapRender
+
+snap = SnapRender(api_key="sk_live_...")
+
+# Capture a screenshot
+image = snap.capture("https://example.com")
+with open("screenshot.png", "wb") as f:
+    f.write(image)
+
+# Capture with options
+jpg = snap.capture(
+    "https://example.com",
+    format="jpeg",
+    width=1920,
+    height=1080,
+    full_page=True,
+    dark_mode=True,
+    quality=95,
+)
+
+# Check cache status
+info = snap.info("https://example.com")
+print(info["cached"])  # True/False
+
+# Get usage
+usage = snap.usage()
+print(f"{usage['used']}/{usage['limit']} screenshots used")
+```
+
+## Context Manager
+
+```python
+with SnapRender(api_key="sk_live_...") as snap:
+    image = snap.capture("https://example.com")
+```
+
+## Error Handling
+
+```python
+from snaprender import SnapRender, SnapRenderError
+
+snap = SnapRender(api_key="sk_live_...")
+
+try:
+    snap.capture("https://example.com")
+except SnapRenderError as e:
+    print(e.code)    # "QUOTA_EXCEEDED"
+    print(e.status)  # 429
+    print(e)         # "Monthly quota exceeded"
+```
+
+## API
+
+### `SnapRender(api_key, base_url="https://app.snap-render.com", timeout=60.0)`
+
+### `snap.capture(url, **options)` -> `bytes`
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `url` | str | — | URL to capture (required) |
+| `format` | str | `"png"` | `"png"`, `"jpeg"`, `"webp"`, or `"pdf"` |
+| `width` | int | `1280` | Viewport width |
+| `height` | int | `800` | Viewport height |
+| `full_page` | bool | `False` | Capture full scrollable page |
+| `quality` | int | `90` | JPEG/WebP quality (1-100) |
+| `delay` | int | `0` | Wait ms after page load |
+| `dark_mode` | bool | `False` | Emulate dark mode |
+| `block_ads` | bool | `True` | Block ad networks |
+| `block_cookie_banners` | bool | `True` | Remove cookie banners |
+| `device` | str | — | Device preset (e.g. `"iPhone 15"`) |
+| `cache` | bool | `True` | Use cache |
+| `cache_ttl` | int | `86400` | Cache TTL in seconds |
+
+### `snap.info(url)` -> `dict`
+### `snap.usage()` -> `dict`
+### `snap.usage_daily(days=30)` -> `dict`

snaprender-0.1.0/pyproject.toml

@@ -0,0 +1,18 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "snaprender"
+version = "0.1.0"
+description = "Official Python SDK for SnapRender Screenshot API"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+dependencies = ["httpx>=0.24"]
+keywords = ["screenshot", "api", "snaprender", "capture", "webpage"]
+
+[project.urls]
+Homepage = "https://snap-render.com"
+Documentation = "https://snap-render.com/docs"
+Repository = "https://github.com/User0856/snaprender"

snaprender-0.1.0/snaprender/__init__.py

@@ -0,0 +1,6 @@
+"""Official Python SDK for SnapRender Screenshot API."""
+
+from .client import SnapRender, SnapRenderError
+
+__all__ = ["SnapRender", "SnapRenderError"]
+__version__ = "0.1.0"

snaprender-0.1.0/snaprender/client.py

@@ -0,0 +1,144 @@
+"""SnapRender API client."""
+
+from __future__ import annotations
+
+from typing import Any, Optional
+
+import httpx
+
+
+class SnapRenderError(Exception):
+    """Error returned by the SnapRender API."""
+
+    def __init__(self, message: str, code: str = "UNKNOWN", status: int = 0):
+        super().__init__(message)
+        self.code = code
+        self.status = status
+
+
+class SnapRender:
+    """SnapRender Screenshot API client.
+
+    Usage::
+
+        snap = SnapRender(api_key="sk_live_...")
+        image = snap.capture("https://example.com")
+        with open("screenshot.png", "wb") as f:
+            f.write(image)
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        base_url: str = "https://app.snap-render.com",
+        timeout: float = 60.0,
+    ):
+        if not api_key:
+            raise ValueError("api_key is required")
+        self._base_url = base_url.rstrip("/")
+        self._client = httpx.Client(
+            base_url=self._base_url,
+            headers={"X-API-Key": api_key},
+            timeout=timeout,
+        )
+
+    def capture(
+        self,
+        url: str,
+        *,
+        format: str = "png",
+        width: Optional[int] = None,
+        height: Optional[int] = None,
+        full_page: Optional[bool] = None,
+        quality: Optional[int] = None,
+        delay: Optional[int] = None,
+        dark_mode: Optional[bool] = None,
+        block_ads: Optional[bool] = None,
+        block_cookie_banners: Optional[bool] = None,
+        hide_selectors: Optional[str] = None,
+        click_selector: Optional[str] = None,
+        device: Optional[str] = None,
+        user_agent: Optional[str] = None,
+        cache: Optional[bool] = None,
+        cache_ttl: Optional[int] = None,
+    ) -> bytes:
+        """Capture a screenshot and return the image bytes."""
+        params: dict[str, Any] = {"url": url, "format": format}
+        if width is not None:
+            params["width"] = width
+        if height is not None:
+            params["height"] = height
+        if full_page is not None:
+            params["full_page"] = str(full_page).lower()
+        if quality is not None:
+            params["quality"] = quality
+        if delay is not None:
+            params["delay"] = delay
+        if dark_mode is not None:
+            params["dark_mode"] = str(dark_mode).lower()
+        if block_ads is not None:
+            params["block_ads"] = str(block_ads).lower()
+        if block_cookie_banners is not None:
+            params["block_cookie_banners"] = str(block_cookie_banners).lower()
+        if hide_selectors is not None:
+            params["hide_selectors"] = hide_selectors
+        if click_selector is not None:
+            params["click_selector"] = click_selector
+        if device is not None:
+            params["device"] = device
+        if user_agent is not None:
+            params["user_agent"] = user_agent
+        if cache is not None:
+            params["cache"] = str(cache).lower()
+        if cache_ttl is not None:
+            params["cache_ttl"] = cache_ttl
+
+        resp = self._client.get("/v1/screenshot", params=params)
+        if resp.status_code != 200:
+            self._raise_error(resp)
+        return resp.content
+
+    def info(self, url: str, **kwargs: Any) -> dict[str, Any]:
+        """Get cache info for a URL without capturing."""
+        params: dict[str, Any] = {"url": url, **kwargs}
+        resp = self._client.get("/v1/screenshot/info", params=params)
+        if resp.status_code != 200:
+            self._raise_error(resp)
+        return resp.json()
+
+    def usage(self) -> dict[str, Any]:
+        """Get current month's usage."""
+        resp = self._client.get("/v1/usage")
+        if resp.status_code != 200:
+            self._raise_error(resp)
+        return resp.json()
+
+    def usage_daily(self, days: int = 30) -> dict[str, Any]:
+        """Get daily usage breakdown."""
+        resp = self._client.get("/v1/usage/daily", params={"days": days})
+        if resp.status_code != 200:
+            self._raise_error(resp)
+        return resp.json()
+
+    def close(self) -> None:
+        """Close the HTTP client."""
+        self._client.close()
+
+    def __enter__(self) -> SnapRender:
+        return self
+
+    def __exit__(self, *args: Any) -> None:
+        self.close()
+
+    @staticmethod
+    def _raise_error(resp: httpx.Response) -> None:
+        try:
+            body = resp.json()
+            err = body.get("error", {})
+            raise SnapRenderError(
+                err.get("message", f"HTTP {resp.status_code}"),
+                err.get("code", "UNKNOWN"),
+                resp.status_code,
+            )
+        except (ValueError, KeyError):
+            raise SnapRenderError(f"HTTP {resp.status_code}", "UNKNOWN", resp.status_code)