tzafon 0.1.4__py3-none-any.whl → 1.4.0__py3-none-any.whl

tzafon-1.4.0.dist-info/RECORD

@@ -0,0 +1,46 @@
+tzafon/__init__.py,sha256=V5qEHakTu5iq2ShF_TOZHw4io0UXcTp3_AQBqRpMO48,3251
+tzafon/_base_client.py,sha256=5AX9s8UF-0wXUI15A1uiRcWhTNk_I4UBpt0Q-2r0aLU,67047
+tzafon/_client.py,sha256=EbENZoqN6ERd3PSISUi0jGCdmxC_5-P8sONVbZaqR9w,15066
+tzafon/_compat.py,sha256=DQBVORjFb33zch24jzkhM14msvnzY7mmSmgDLaVFUM8,6562
+tzafon/_constants.py,sha256=S14PFzyN9-I31wiV7SmIlL5Ga0MLHxdvegInGdXH7tM,462
+tzafon/_exceptions.py,sha256=qi7R0qNzTGtKBt4fWynaQkMnUk3YGrIp01jis82aEdo,3224
+tzafon/_files.py,sha256=KnEzGi_O756MvKyJ4fOCW_u3JhOeWPQ4RsmDvqihDQU,3545
+tzafon/_models.py,sha256=lKnskYPONAWDvWo8tmbbVk7HmG7UOsI0Nve0vSMmkRc,30452
+tzafon/_qs.py,sha256=craIKyvPktJ94cvf9zn8j8ekG9dWJzhWv0ob34lIOv4,4828
+tzafon/_resource.py,sha256=EseuwN0R4kKBVcQnyF4NgCeRtc6-OrR8yWVI5fOYGHM,1112
+tzafon/_response.py,sha256=Gaq-HHLZ76rKv515pCAMkfW4rbz_ManOH-7R640hrDE,28792
+tzafon/_streaming.py,sha256=SavIdu5Tnaelw60s19mwFijhkdhdxh1fDqZ1AoIwC0g,10108
+tzafon/_types.py,sha256=1kStHPi-XwmomGBE0xKVtz0mdRF4Svxb8NWZR4FaSiY,7236
+tzafon/_version.py,sha256=iQiubfCSrqbBxAeb4F9zNHDDpkgEuVobKfZWVuACOrs,158
+tzafon/batch_wrapper.py,sha256=ESJGxScFZzdPwDTiCjCz6-QRsoB-_nxoZuHbN9HKbUE,3509
+tzafon/client_extensions.py,sha256=Tn3SkDYNl0B8M3U8eE39KNLsazKpbztAQSmBVVmzgCQ,1964
+tzafon/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tzafon/wrapper.py,sha256=gfihF7G0y-Q77h_N6IKoslB8XXDK1eq3dZAIq1BLedc,3517
+tzafon/_utils/__init__.py,sha256=7fch0GT9zpNnErbciSpUNa-SjTxxjY6kxHxKMOM4AGs,2305
+tzafon/_utils/_compat.py,sha256=D8gtAvjJQrDWt9upS0XaG9Rr5l1QhiAx_I_1utT_tt0,1195
+tzafon/_utils/_datetime_parse.py,sha256=bABTs0Bc6rabdFvnIwXjEhWL15TcRgWZ_6XGTqN8xUk,4204
+tzafon/_utils/_logs.py,sha256=PEF_Amx1dH7ka0Jvayh7slfAfeVkgcGsLInHQ0Y1SzI,776
+tzafon/_utils/_proxy.py,sha256=aglnj2yBTDyGX9Akk2crZHrl10oqRmceUy2Zp008XEs,1975
+tzafon/_utils/_reflection.py,sha256=ZmGkIgT_PuwedyNBrrKGbxoWtkpytJNU1uU4QHnmEMU,1364
+tzafon/_utils/_resources_proxy.py,sha256=lysaDfd1mc_JASfb2pnOzeAGyWwNF8zCLebbfeuKa6I,589
+tzafon/_utils/_streams.py,sha256=SMC90diFFecpEg_zgDRVbdR3hSEIgVVij4taD-noMLM,289
+tzafon/_utils/_sync.py,sha256=TpGLrrhRNWTJtODNE6Fup3_k7zrWm1j2RlirzBwre-0,2862
+tzafon/_utils/_transform.py,sha256=NjCzmnfqYrsAikUHQig6N9QfuTVbKipuP3ur9mcNF-E,15951
+tzafon/_utils/_typing.py,sha256=N_5PPuFNsaygbtA_npZd98SVN1LQQvFTKL6bkWPBZGU,4786
+tzafon/_utils/_utils.py,sha256=0dDqauUbVZEXV0NVl7Bwu904Wwo5eyFCZpQThhFNhyA,12253
+tzafon/resources/__init__.py,sha256=2tbxQpPYxwl6BYAmWlSblYFfmeBEasXs9oxh3vXRG2M,591
+tzafon/resources/computers.py,sha256=6qqhsaqPfnlC0Swy7CwnIdtT60GRWeVnKUm2BBHDHdc,31592
+tzafon/types/__init__.py,sha256=kb0H5ErFRI_4U_KF2ElDt45ZTid6K1dyDjq5_VL_FKs,902
+tzafon/types/action_result.py,sha256=RE4iCBcGaUWXirCBNsjf00jLl_s173NN8-gCMtKVs0g,374
+tzafon/types/computer_create_params.py,sha256=G9rhhm8ckcLbG5tM-vHrgG19-jmfUVN0KMcHodjNs4g,553
+tzafon/types/computer_execute_action_params.py,sha256=-s1B9iUBavL2R2MvQXDxixdYbzr-l24wqjPP9LDo-xQ,304
+tzafon/types/computer_execute_batch_params.py,sha256=hg5xchXjFmXv-I04hfygZYq5_TrkjmfhpmdWWsE3Axw,302
+tzafon/types/computer_execute_batch_response.py,sha256=zIUo0GDOCk6wUeSTa4_RPPHRp1gasRdi_o8EpI6zCek,256
+tzafon/types/computer_keep_alive_response.py,sha256=H75ugeXG2CetcGgwwKE_cYmr_ujDH0qpMWg9TMZ4tkI,250
+tzafon/types/computer_list_response.py,sha256=ABykSdzQgm_bNISk_F7GQaXWRB3WidA9tXuMjmNWZps,294
+tzafon/types/computer_navigate_params.py,sha256=mK4JWt0fqafLuoXHdOh_I6j-hJY0Ub0nAUkadA20v38,294
+tzafon/types/computer_response.py,sha256=agc6iysQzQR22edcoz84CuUpzQ7WLwsxEuo8ccwIbYc,404
+tzafon-1.4.0.dist-info/METADATA,sha256=OWyl374RBvhlhT84mf7NBgAXotNqBd3fYv-wSVL4wlc,13983
+tzafon-1.4.0.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+tzafon-1.4.0.dist-info/licenses/LICENSE,sha256=ciLXi9zfEehb4Tnhy-M9I2WSRUpZjx-FK1TEChVqlDo,1048
+tzafon-1.4.0.dist-info/RECORD,,

{tzafon-0.1.4.dist-info → tzafon-1.4.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.27.0
+Generator: hatchling 1.26.3
 Root-Is-Purelib: true
 Tag: py3-none-any

tzafon-1.4.0.dist-info/licenses/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2025 computer
+
+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.

tzafon/_connection.py

@@ -1,49 +0,0 @@
-from __future__ import annotations
-import asyncio
-import traceback
-import websockets
-from websockets.protocol import State
-from .models import Command, Result
-
-
-class _WsConnection:
-    def __init__(self, url: str, *, ping_interval: int = 20):
-        if not url.startswith(("ws://", "wss://")):
-            raise ValueError(f"Invalid websocket URL '{url}'")
-        self._url = url
-        self._conn: websockets.WebSocketClientProtocol | None = None
-        self._ping = ping_interval
-
-    async def connect(self) -> None:
-        if self.is_open:
-            return
-        self._conn = await websockets.connect(
-            self._url,
-            max_size=2**24,  # 16 MiB
-            ping_interval=self._ping,
-            ping_timeout=self._ping,
-        )
-
-    async def close(self) -> None:
-        if self._conn and self._conn.state is State.OPEN:
-            try:
-                await self._conn.close(code=1000, reason="Client shutting down")
-                await asyncio.wait_for(self._conn.wait_closed(), timeout=5)
-            except Exception:
-                traceback.print_exc()
-        self._conn = None
-
-    async def send(self, cmd: Command) -> Result:
-        if not self.is_open:
-            raise RuntimeError("Websocket not connected")
-        await self._conn.send(cmd.dump())
-        raw = await self._conn.recv()
-        if isinstance(raw, str):
-            raw = raw.encode()
-        return Result.load(raw)
-
-    @property
-    def is_open(self) -> bool:
-        return (
-            self._conn is not None and getattr(self._conn, "state", None) is State.OPEN
-        )

tzafon/client.py

@@ -1,116 +0,0 @@
-from __future__ import annotations
-import asyncio
-import logging
-import os
-from typing import Optional
-
-from .models import Command, Result, ActionType
-from ._connection import _WsConnection
-from .exceptions import ScreenshotFailed
-
-
-log = logging.getLogger("waypoint")
-_DEFAULT_VIEWPORT = {"width": 1280, "height": 720}
-
-
-class Waypoint:
-    def __init__(
-        self,
-        token: str,
-        *,
-        url_template: str = "wss://api.tzafon.ai/ephemeral-tzafonwright?token={token}",
-        connect_timeout: float = 10.0,
-    ):
-        if not token or not token.startswith("wpk_"):
-            raise ValueError("token must look like 'wpk_…'")
-        self._ws_url = url_template.format(token=token)
-        self._timeout = connect_timeout
-        self._ws: Optional[_WsConnection] = None
-
-    async def __aenter__(self) -> "Waypoint":
-        self._ws = _WsConnection(self._ws_url)
-        await asyncio.wait_for(self._ws.connect(), timeout=self._timeout)
-        # one-time only
-        await self.set_viewport(**_DEFAULT_VIEWPORT)
-        return self
-
-    async def __aexit__(self, exc_t, exc, tb) -> None:
-        if self._ws:
-            await self._ws.close()
-            self._ws = None
-
-    async def goto(self, url: str, *, timeout: int = 5_000) -> Result:
-        return await self._send(Command(ActionType.GOTO, url=url, timeout=timeout))
-
-    async def click(self, x: float, y: float) -> Result:
-        return await self._send(Command(ActionType.CLICK, x=x, y=y))
-
-    async def type(self, text: str) -> Result:
-        return await self._send(Command(ActionType.TYPE, text=text))
-
-    async def scroll(self, dx: int = 0, dy: int = 100) -> Result:
-        return await self._send(Command(ActionType.SCROLL, delta_x=dx, delta_y=dy))
-
-    async def screenshot(
-        self,
-        path: str | os.PathLike | None = None,
-        *,
-        mkdir: bool = True,
-        return_url: bool = False,
-    ) -> bytes | str:
-        """
-        Grab a **JPEG** screenshot.
-
-        Parameters
-        path:
-            Optional file destination. If provided the image is written to disk
-            *and* the raw bytes are still returned.
-        mkdir:
-            Automatically create parent folders if they do not exist.
-        return_url:
-            If True, return the remote URL instead of the image bytes.
-        """
-        res = await self._send(Command(ActionType.SCREENSHOT))
-
-        if return_url:
-            if res.image_url:
-                return res.image_url
-            if path is not None:
-                from pathlib import Path
-
-                p = Path(path)
-                if mkdir:
-                    p.parent.mkdir(parents=True, exist_ok=True)
-                p.write_bytes(res.image)
-                return str(p.resolve())
-            raise ScreenshotFailed(
-                "Server did not provide image_url; set return_url=False to get bytes"
-            )
-
-        if res.success and res.image is None and res.image_url is not None:
-            await res.download_image()
-
-        if not (res.success and res.image):
-            raise ScreenshotFailed(res.error_message or "unknown error")
-
-        if path is not None:
-            from pathlib import Path
-
-            p = Path(path)
-            if mkdir:
-                p.parent.mkdir(parents=True, exist_ok=True)
-            p.write_bytes(res.image)
-        return res.image
-
-    async def set_viewport(self, *, width: int, height: int) -> Result:
-        return await self._send(
-            Command(ActionType.SET_VIEWPORT_SIZE, width=width, height=height)
-        )
-
-    async def _send(self, cmd: Command) -> Result:
-        if self._ws is None:
-            raise RuntimeError("Waypoint must be used inside 'async with'")
-        res = await self._ws.send(cmd)
-        if not res.success:
-            log.warning("Command %s failed: %s", cmd.action_type, res.error_message)
-        return res

tzafon/exceptions.py

@@ -1,6 +0,0 @@
-class WaypointError(Exception):
-    """Base for all SDK exceptions."""
-
-
-class ScreenshotFailed(WaypointError):
-    """Raised when screenshot returns success=False."""

tzafon/models.py

@@ -1,99 +0,0 @@
-from __future__ import annotations
-import json
-import base64
-from dataclasses import dataclass, asdict
-from enum import Enum
-from typing import Optional, Dict, Any, Self
-
-
-class ActionType(str, Enum):
-    CLICK = "click"
-    TYPE = "type"
-    SCROLL = "scroll"
-    GOTO = "goto"
-    SCREENSHOT = "screenshot"
-    SET_VIEWPORT_SIZE = "set_viewport_size"
-
-
-@dataclass(slots=True)
-class Command:
-    action_type: ActionType
-    # optional payload
-    x: Optional[float] = None
-    y: Optional[float] = None
-    text: Optional[str] = None
-    delta_x: Optional[int] = None
-    delta_y: Optional[int] = None
-    url: Optional[str] = None
-    width: Optional[int] = None
-    height: Optional[int] = None
-    timeout: int = 5000  # ms
-
-    @classmethod
-    def load(cls, body: bytes) -> Self:
-        data = json.loads(body.decode("utf-8"))
-        action_str = data.pop("action_type", None)
-        if action_str is None:
-            raise ValueError("Command missing 'action_type'")
-        try:
-            action_enum = ActionType(action_str)
-        except ValueError as e:
-            raise ValueError(f"Unknown action_type '{action_str}'") from e
-        return cls(action_type=action_enum, **data)
-
-    def dump(self) -> bytes:
-        d = asdict(self)
-        d["action_type"] = self.action_type.value
-        d = {k: v for k, v in d.items() if v is not None}
-        return json.dumps(d).encode("utf-8")
-
-
-@dataclass(slots=True)
-class Result:
-    success: bool
-    image: Optional[bytes] = None  # jpeg bytes
-    image_url: Optional[str] = None  # remote location if bytes omitted
-    error_message: Optional[str] = None
-
-    async def download_image(self) -> None:
-        """If `image` is None but `image_url` present, fetch the bytes (async)."""
-        if self.image is None and self.image_url is not None:
-            try:
-                import httpx
-
-                async with httpx.AsyncClient(timeout=20.0, follow_redirects=True) as c:
-                    resp = await c.get(self.image_url)
-                    resp.raise_for_status()
-                    self.image = resp.content
-            except Exception:
-                # keep silent – caller will treat as missing image later
-                pass
-
-    @classmethod
-    def load(cls, body: bytes) -> Self:
-        data = json.loads(body.decode("utf-8"))
-        img_b64 = data.get("image")
-        img = base64.b64decode(img_b64) if img_b64 else None
-        return cls(
-            success=data.get("success", False),
-            image=img,
-            image_url=data.get("image_url"),
-            error_message=data.get("error_message"),
-        )
-
-    def dump(self) -> bytes:
-        d: Dict[str, Any] = {
-            "success": self.success,
-            "error_message": self.error_message,
-        }
-
-        if self.image is not None:
-            d["image"] = base64.b64encode(self.image).decode()
-        if self.image_url is not None:
-            d["image_url"] = self.image_url
-        return json.dumps({k: v for k, v in d.items() if v is not None}).encode()
-
-    def __str__(self) -> str:
-        ok = "✅" if self.success else "❌"
-        img = "🖼️" if self.image else "—"
-        return f"<Result {ok} image:{img} msg:{self.error_message!r}>"

tzafon-0.1.4.dist-info/METADATA

@@ -1,62 +0,0 @@
-Metadata-Version: 2.4
-Name: tzafon
-Version: 0.1.4
-Summary: Tzafon Waypoint – browser automation
-License: MIT
-Requires-Python: >=3.10
-Requires-Dist: httpx>=0.26.0
-Requires-Dist: pytest-asyncio>=0.24.0
-Requires-Dist: pytest>=8.3.4
-Requires-Dist: python-dotenv>=1.1.0
-Requires-Dist: twine>=6.1.0
-Requires-Dist: websockets>=15.0.1
-Description-Content-Type: text/markdown
-
-# Tzafon Waypoint
-
-A Python client for interacting with the tzafon API for web automation (waypoint.tzafon.ai).
-
-## Installation
-
-```bash
-pip install tzafon
-```
-
-## Usage
-
-```python
-import asyncio
-from tzafon import Waypoint
-
-async def main():
-    async with Waypoint(token="wpk_your_token_here") as wp:
-        # Navigate to a website
-        await wp.goto("https://example.com")
-
-        # Take a screenshot
-        image_bytes = await wp.screenshot("screenshot.jpg")
-
-        # Click at a specific position
-        await wp.click(100, 200)
-
-        # Type some text
-        await wp.type("Hello world")
-
-        # Scroll down
-        await wp.scroll(dy=200)
-
-if __name__ == "__main__":
-    asyncio.run(main())
-```
-
-## Features
-
-- Web navigation
-- Screenshots
-- Clicking and typing
-- Scrolling
-- Viewport control
-
-## License
-
-MIT

tzafon-0.1.4.dist-info/RECORD

@@ -1,8 +0,0 @@
-tzafon/__init__.py,sha256=QpZABzfciDC1uUdoRHp5tW0694ZJGtHNF9ieGilnt94,53
-tzafon/_connection.py,sha256=6kqekASLSAGrjx5bWJNVTQ3mifw2MbemB8b8xJm8_Qg,1599
-tzafon/client.py,sha256=uzh8ZLntw9cOIK5jAcfSokrpfBWxIksm-AuH3xfHM3s,3901
-tzafon/exceptions.py,sha256=SeeZRBAsyeogXXcfF3b3IaKUsehWNeNZAgxbmrzjI48,168
-tzafon/models.py,sha256=HTpU4YwjbggV85l5-_VxVvjHGOX_jupSNtMEUZ4f1oM,3239
-tzafon-0.1.4.dist-info/METADATA,sha256=vAVOPCaUmOQfAM3xPmH2b4lME7xPop2xMGToW7cebNs,1202
-tzafon-0.1.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-tzafon-0.1.4.dist-info/RECORD,,