snaprender 0.7.1__tar.gz → 0.7.3__tar.gz

{snaprender-0.7.1 → snaprender-0.7.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: snaprender
-Version: 0.7.1
+Version: 0.7.3
 Summary: Official Python SDK for SnapRender Screenshot API
 Project-URL: Homepage, https://snap-render.com
 Project-URL: Documentation, https://snap-render.com/docs
@@ -20,7 +20,7 @@ Description-Content-Type: text/markdown
 
 Official Python SDK for the [SnapRender](https://snap-render.com) Screenshot API. Capture pixel-perfect screenshots, extract page content, run batch jobs, and manage webhooks with a single library.
 
-**500 free screenshots/month. [Get your API key](https://snap-render.com/auth/signup?ref=pypi)**
+**200 free screenshots/month. [Get your API key](https://snap-render.com/auth/signup?ref=pypi)**
 
 ## Features
 
@@ -62,6 +62,12 @@ image = snap.capture(html="<h1>Hello World</h1>")
 image = snap.capture(markdown="# Hello World\nSome **bold** text.")
 ```
 
+> **Cache is OFF by default.** Every request captures a fresh screenshot. To save credits on repeated requests, pass `cache=True`. Cached hits are free and return in under 200ms:
+>
+> ```python
+> image = snap.capture("https://example.com", cache=True)
+> ```
+
 ## Context Manager
 
 ```python
@@ -138,8 +144,8 @@ print(result["image"])  # data:image/png;base64,...
 | `hide_selectors` | str | `None` | Comma-separated CSS selectors to hide |
 | `click_selector` | str | `None` | CSS selector to click before capture |
 | `user_agent` | str | `None` | Custom user-agent string |
-| `cache` | bool | `True` | Use CDN cache |
-| `cache_ttl` | int | `86400` | Cache TTL in seconds |
+| `cache` | bool | `False` | Return cached result if available. **Off by default:** set `True` to enable caching. Cached hits are free but may be up to 24h old. |
+| `cache_ttl` | int | `86400` | Cache lifetime in seconds (default 24h). Cached screenshots older than this are recaptured. |
 | `response_type` | str | `None` | Set to `"json"` for metadata + base64 data URI |
 
 ---
@@ -229,8 +235,8 @@ result = snap.extract(
 | `block_cookie_banners` | bool | `None` | Remove cookie banners |
 | `delay` | int | `None` | Wait (ms) after page load |
 | `max_length` | int | `None` | Truncate content to this many characters |
-| `cache` | bool | `None` | Use cache |
-| `cache_ttl` | int | `None` | Cache TTL in seconds |
+| `cache` | bool | `None` | Return cached extraction if available. **Off by default:** set `True` to enable caching. Cached hits are free but may be stale. |
+| `cache_ttl` | int | `None` | Cache lifetime in seconds (default 24h). |
 
 **Returns** `{ "url": str, "type": str, "content": ..., "wordCount": int, "processingTimeMs": int }`
 

{snaprender-0.7.1 → snaprender-0.7.3}/README.md

@@ -6,7 +6,7 @@
 
 Official Python SDK for the [SnapRender](https://snap-render.com) Screenshot API. Capture pixel-perfect screenshots, extract page content, run batch jobs, and manage webhooks with a single library.
 
-**500 free screenshots/month. [Get your API key](https://snap-render.com/auth/signup?ref=pypi)**
+**200 free screenshots/month. [Get your API key](https://snap-render.com/auth/signup?ref=pypi)**
 
 ## Features
 
@@ -48,6 +48,12 @@ image = snap.capture(html="<h1>Hello World</h1>")
 image = snap.capture(markdown="# Hello World\nSome **bold** text.")
 ```
 
+> **Cache is OFF by default.** Every request captures a fresh screenshot. To save credits on repeated requests, pass `cache=True`. Cached hits are free and return in under 200ms:
+>
+> ```python
+> image = snap.capture("https://example.com", cache=True)
+> ```
+
 ## Context Manager
 
 ```python
@@ -124,8 +130,8 @@ print(result["image"])  # data:image/png;base64,...
 | `hide_selectors` | str | `None` | Comma-separated CSS selectors to hide |
 | `click_selector` | str | `None` | CSS selector to click before capture |
 | `user_agent` | str | `None` | Custom user-agent string |
-| `cache` | bool | `True` | Use CDN cache |
-| `cache_ttl` | int | `86400` | Cache TTL in seconds |
+| `cache` | bool | `False` | Return cached result if available. **Off by default:** set `True` to enable caching. Cached hits are free but may be up to 24h old. |
+| `cache_ttl` | int | `86400` | Cache lifetime in seconds (default 24h). Cached screenshots older than this are recaptured. |
 | `response_type` | str | `None` | Set to `"json"` for metadata + base64 data URI |
 
 ---
@@ -215,8 +221,8 @@ result = snap.extract(
 | `block_cookie_banners` | bool | `None` | Remove cookie banners |
 | `delay` | int | `None` | Wait (ms) after page load |
 | `max_length` | int | `None` | Truncate content to this many characters |
-| `cache` | bool | `None` | Use cache |
-| `cache_ttl` | int | `None` | Cache TTL in seconds |
+| `cache` | bool | `None` | Return cached extraction if available. **Off by default:** set `True` to enable caching. Cached hits are free but may be stale. |
+| `cache_ttl` | int | `None` | Cache lifetime in seconds (default 24h). |
 
 **Returns** `{ "url": str, "type": str, "content": ..., "wordCount": int, "processingTimeMs": int }`
 

{snaprender-0.7.1 → snaprender-0.7.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "snaprender"
-version = "0.7.1"
+version = "0.7.3"
 description = "Official Python SDK for SnapRender Screenshot API"
 readme = "README.md"
 license = {text = "MIT"}

{snaprender-0.7.1 → snaprender-0.7.3}/snaprender/__init__.py

@@ -3,4 +3,4 @@
 from .client import SnapRender, SnapRenderError
 
 __all__ = ["SnapRender", "SnapRenderError"]
-__version__ = "0.5.0"
+__version__ = "0.7.3"