scrapely-python 0.1.15__tar.gz → 0.1.16__tar.gz

{scrapely_python-0.1.15/src/scrapely_python.egg-info → scrapely_python-0.1.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scrapely-python
-Version: 0.1.15
+Version: 0.1.16
 Summary: Scrapely Python SDK - A toolkit for building Actors on the Scrapely platform
 Author-email: Scrapely <support@scrape.ly>
 License-Expression: MIT AND Apache-2.0

{scrapely_python-0.1.15 → scrapely_python-0.1.16}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "scrapely-python"
-version = "0.1.15"
+version = "0.1.16"
 description = "Scrapely Python SDK - A toolkit for building Actors on the Scrapely platform"
 readme = "README.md"
 license = "MIT AND Apache-2.0"

{scrapely_python-0.1.15 → scrapely_python-0.1.16}/src/scrapely/__init__.py

@@ -132,7 +132,7 @@ from .errors import (
     raise_for_status,
 )
 
-__version__ = '0.1.15'
+__version__ = '0.1.16'
 __all__ = [
     # Core
     'Actor',

{scrapely_python-0.1.15 → scrapely_python-0.1.16}/src/scrapely/actor.py

@@ -1080,6 +1080,34 @@ class Actor(metaclass=_ActorMeta):
             status_message=data.get('statusMessage'),
         )
 
+    @classmethod
+    async def solver_status(cls, vendor: str) -> Dict[str, Any]:
+        """Anti-bot solver status for a vendor (free, cached for 15 s, never raises).
+
+        ``usable`` False means the vendor cannot be solved right now: take your
+        fallback (for example the hosted browser), or fail the items that need
+        a solve at once and call ``set_solver_degraded_status()``. See
+        ``scrapely.solver``.
+        """
+        from .solver import solver_status_async
+
+        return await solver_status_async(vendor)
+
+    @classmethod
+    async def set_solver_degraded_status(cls, skipped: Optional[int] = None, total: Optional[int] = None) -> None:
+        """Set the standard status message for a run whose site protection cannot be solved right now.
+
+        "Site protection temporarily unavailable, results may be incomplete",
+        with "(N of M items skipped)" when both counts are given. Never raises:
+        the run goes on.
+        """
+        from .solver import degraded_status_message
+
+        try:
+            await cls.set_status_message(degraded_status_message(skipped, total))
+        except Exception as exc:  # noqa: BLE001 - a status message must never stop the run
+            logger.warning(f'Could not set the solver status message: {exc}')
+
     @classmethod
     async def _put_run_status_message(
         cls, message: str, *, is_terminal: bool