snaprender 0.2.4__tar.gz → 0.3.0__tar.gz

{snaprender-0.2.4 → snaprender-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: snaprender
-Version: 0.2.4
+Version: 0.3.0
 Summary: Official Python SDK for SnapRender Screenshot API
 Project-URL: Homepage, https://snap-render.com
 Project-URL: Documentation, https://snap-render.com/docs

{snaprender-0.2.4 → snaprender-0.3.0}/pyproject.toml

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

{snaprender-0.2.4 → snaprender-0.3.0}/snaprender/__init__.py

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

{snaprender-0.2.4 → snaprender-0.3.0}/snaprender/client.py

@@ -44,8 +44,10 @@ class SnapRender:
 
     def capture(
         self,
-        url: str,
+        url: Optional[str] = None,
         *,
+        html: Optional[str] = None,
+        markdown: Optional[str] = None,
         format: str = "png",
         width: Optional[int] = None,
         height: Optional[int] = None,
@@ -63,40 +65,91 @@ class SnapRender:
         cache_ttl: Optional[int] = None,
         response_type: Optional[str] = None,
     ) -> "bytes | dict[str, Any]":
-        """Capture a screenshot. Returns bytes by default, or a dict when response_type='json'."""
-        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
-        if response_type is not None:
-            params["response_type"] = response_type
-
-        resp = self._client.get("/v1/screenshot", params=params)
+        """Capture a screenshot. Provide exactly one of: url, html, or markdown.
+
+        When html or markdown is provided, uses POST with JSON body.
+        When url is provided, uses GET with query parameters (backward compatible).
+        Returns bytes by default, or a dict when response_type='json'.
+        """
+        use_post = bool(html or markdown)
+
+        if use_post:
+            body: dict[str, Any] = {"format": format}
+            if url is not None:
+                body["url"] = url
+            if html is not None:
+                body["html"] = html
+            if markdown is not None:
+                body["markdown"] = markdown
+            if width is not None:
+                body["width"] = width
+            if height is not None:
+                body["height"] = height
+            if full_page is not None:
+                body["full_page"] = full_page
+            if quality is not None:
+                body["quality"] = quality
+            if delay is not None:
+                body["delay"] = delay
+            if dark_mode is not None:
+                body["dark_mode"] = dark_mode
+            if block_ads is not None:
+                body["block_ads"] = block_ads
+            if block_cookie_banners is not None:
+                body["block_cookie_banners"] = block_cookie_banners
+            if hide_selectors is not None:
+                body["hide_selectors"] = hide_selectors
+            if click_selector is not None:
+                body["click_selector"] = click_selector
+            if device is not None:
+                body["device"] = device
+            if user_agent is not None:
+                body["user_agent"] = user_agent
+            if cache is not None:
+                body["cache"] = cache
+            if cache_ttl is not None:
+                body["cache_ttl"] = cache_ttl
+            if response_type is not None:
+                body["response_type"] = response_type
+
+            resp = self._client.post("/v1/screenshot", json=body)
+        else:
+            if not url:
+                raise ValueError("One of url, html, or markdown is required")
+            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
+            if response_type is not None:
+                params["response_type"] = response_type
+
+            resp = self._client.get("/v1/screenshot", params=params)
+
         if resp.status_code != 200:
             self._raise_error(resp)
         if response_type == "json":