tzafon 0.1.3__tar.gz → 1.3.2__tar.gz

tzafon-1.3.2/.gitignore

@@ -0,0 +1,16 @@
+.prism.log
+_dev
+
+__pycache__
+.mypy_cache
+
+dist
+
+.venv
+.idea
+
+.env
+.envrc
+codegen.log
+Brewfile.lock.json
+.env

tzafon-1.3.2/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.3.2"
+}

tzafon-1.3.2/BATCH_API.md

@@ -0,0 +1,124 @@
+# Batch Execution API
+
+Perfect for queuing multiple actions and executing them together.
+
+## Usage
+
+```python
+from tzafon import asyncComputer
+
+client = asyncComputer()
+
+computer = client.create(kind="browser")
+computer.navigate("https://google.com")
+computer.type("Hello World")
+computer.click(100, 200)
+
+# Execute all queued actions in batch
+result = computer.execute()
+
+computer.terminate()
+```
+
+## How It Works
+
+1. **Queue Actions** - Each method call queues an action (doesn't execute immediately)
+2. **Batch Execute** - `computer.execute()` sends all queued actions to backend
+3. **Backend processes** - Actions run sequentially, stops on first error
+4. **Results returned** - Get results for all executed actions
+
+## All Actions
+
+```python
+computer = client.create(kind="browser")
+
+# Queue actions (chainable)
+computer.navigate("https://github.com")
+computer.wait(2.0)
+computer.scroll("down", amount=500)
+computer.hotkey("ctrl", "f")
+computer.type("search term")
+computer.click(100, 200)
+computer.double_click(300, 400)
+computer.right_click(500, 600)
+computer.drag(100, 100, 200, 200)
+computer.screenshot()
+
+# Execute all at once
+result = computer.execute()
+```
+
+## Response Format
+
+```python
+result = computer.execute()
+
+# ComputerExecuteBatchResponse
+result.results  # List of ActionResult for each action
+result.success  # Overall success status
+
+for i, action_result in enumerate(result.results):
+    print(f"Action {i+1}: {action_result.status}")
+```
+
+## Context Manager
+
+```python
+with client.create(kind="browser") as computer:
+    computer.navigate("https://google.com")
+    computer.type("Hello World")
+    computer.click(100, 200)
+    
+    result = computer.execute()
+    # Automatically terminates on exit
+```
+
+## Why Batch Execution?
+
+- **Performance**: Single API call instead of multiple
+- **Atomic**: All actions or none (stops on first error)  
+- **Simpler**: Queue actions then execute
+- **Efficient**: Network optimized
+
+## Comparison
+
+### asyncComputer (Batch)
+```python
+from tzafon import asyncComputer
+
+client = asyncComputer()
+computer = client.create(kind="browser")
+computer.navigate("https://google.com")  # Queued
+computer.type("Hello")                    # Queued
+computer.click(100, 200)                  # Queued
+result = computer.execute()               # Execute all
+```
+
+### Computer (Immediate)
+```python
+from tzafon import Computer
+
+client = Computer()
+with client.create(kind="browser") as computer:
+    computer.navigate("https://google.com")  # Executes immediately
+    computer.type("Hello")                    # Executes immediately
+    computer.click(100, 200)                  # Executes immediately
+```
+
+### AsyncComputer (Async Immediate)
+```python
+from tzafon import AsyncComputer
+
+client = AsyncComputer()
+async with client.create(kind="browser") as computer:
+    await computer.navigate("https://google.com")  # Async execute
+    await computer.type("Hello")                    # Async execute
+    await computer.click(100, 200)                  # Async execute
+```
+
+## Choose Your Style
+
+- **`asyncComputer`** - Queue and batch execute
+- **`Computer`** - Immediate sync execution
+- **`AsyncComputer`** - Immediate async execution
+

tzafon-1.3.2/CHANGELOG.md

@@ -0,0 +1,92 @@
+# Changelog
+
+## 1.3.2 (2025-10-08)
+
+Full Changelog: [v1.3.1...v1.3.2](https://github.com/atulgavandetzafon/computer-python/compare/v1.3.1...v1.3.2)
+
+### Chores
+
+* update SDK settings ([05f237e](https://github.com/atulgavandetzafon/computer-python/commit/05f237ee8b8b72f28301dda597201e051f1b7ef4))
+* update SDK settings ([89b4df6](https://github.com/atulgavandetzafon/computer-python/commit/89b4df64ee207a368dfa80e9ae47a9255da4d545))
+
+## 1.3.1 (2025-10-08)
+
+Full Changelog: [v1.3.0...v1.3.1](https://github.com/atulgavandetzafon/computer-python/compare/v1.3.0...v1.3.1)
+
+## 1.3.0 (2025-10-08)
+
+Full Changelog: [v1.2.0...v1.3.0](https://github.com/atulgavandetzafon/computer-python/compare/v1.2.0...v1.3.0)
+
+### Features
+
+* **api:** manual updates ([92a3ec3](https://github.com/atulgavandetzafon/computer-python/commit/92a3ec3c358004e432973fedd6844add8bcb1c7d))
+
+## 1.2.0 (2025-10-08)
+
+Full Changelog: [v1.1.4...v1.2.0](https://github.com/atulgavandetzafon/computer-python/compare/v1.1.4...v1.2.0)
+
+### Features
+
+* **api:** manual updates ([8ce5b6b](https://github.com/atulgavandetzafon/computer-python/commit/8ce5b6bc92fffc1baf956972489ceefbf987be3b))
+* **api:** manual updates ([8fa5045](https://github.com/atulgavandetzafon/computer-python/commit/8fa5045b6bfbf00a3d44833100d36b58d27a83e3))
+* **api:** manual updates ([3dc796f](https://github.com/atulgavandetzafon/computer-python/commit/3dc796fb27186307f81f6e3ad93e6715a707604d))
+* **api:** manual updates ([ff7ae66](https://github.com/atulgavandetzafon/computer-python/commit/ff7ae66be8c4d9c69b52f803b23a0456aebe3c1e))
+* **api:** manual updates ([3492063](https://github.com/atulgavandetzafon/computer-python/commit/3492063eeb600e5c42585ebc8805b50cc0ffe9c0))
+* **api:** manual updates ([a68cfdb](https://github.com/atulgavandetzafon/computer-python/commit/a68cfdb2689829e82063eb672e1736e9f66bd81e))
+* **api:** manual updates ([0e7ee2c](https://github.com/atulgavandetzafon/computer-python/commit/0e7ee2ca2568511b495a154a6b802dd5c4b42908))
+
+## 1.1.4 (2025-10-08)
+
+Full Changelog: [v1.1.3...v1.1.4](https://github.com/atulgavandetzafon/computer-python/compare/v1.1.3...v1.1.4)
+
+## 1.1.3 (2025-10-08)
+
+Full Changelog: [v1.1.2...v1.1.3](https://github.com/atulgavandetzafon/computer-python/compare/v1.1.2...v1.1.3)
+
+## 1.1.2 (2025-10-08)
+
+Full Changelog: [v1.1.1...v1.1.2](https://github.com/atulgavandetzafon/computer-python/compare/v1.1.1...v1.1.2)
+
+## 1.1.1 (2025-10-08)
+
+Full Changelog: [v1.1.0...v1.1.1](https://github.com/atulgavandetzafon/computer-python/compare/v1.1.0...v1.1.1)
+
+## 1.1.0 (2025-10-07)
+
+Full Changelog: [v1.0.1...v1.1.0](https://github.com/atulgavandetzafon/computer-python/compare/v1.0.1...v1.1.0)
+
+### Features
+
+* **api:** manual updates ([aaf8e53](https://github.com/atulgavandetzafon/computer-python/commit/aaf8e534415ea6bc8420f2ed8e3b854011a7bf71))
+* **api:** manual updates ([833115e](https://github.com/atulgavandetzafon/computer-python/commit/833115e5e6814f6347de3e0521faceb4bf9e15e8))
+
+
+### Chores
+
+* update SDK settings ([0b62c4b](https://github.com/atulgavandetzafon/computer-python/commit/0b62c4b04323dabf192fe31e11f45ea94f366411))
+
+## 1.0.1 (2025-10-07)
+
+Full Changelog: [v0.0.1...v1.0.1](https://github.com/atulgavandetzafon/computer-python/compare/v0.0.1...v1.0.1)
+
+### Features
+
+* **api:** added python ([7bc6a73](https://github.com/atulgavandetzafon/computer-python/commit/7bc6a73f549bb57bb176de454d395fd692159a0e))
+* **api:** manual updates ([57e4841](https://github.com/atulgavandetzafon/computer-python/commit/57e4841180a11f953e1d8db5e3c1ea7eebbb1d3e))
+* **api:** manual updates ([a23814e](https://github.com/atulgavandetzafon/computer-python/commit/a23814e85afaa64e2a429b2bcb6507b0accb46bc))
+* **api:** Updated to bearer auth ([c95903e](https://github.com/atulgavandetzafon/computer-python/commit/c95903e3795de2823b6266f914647dd55dc4eeba))
+* **api:** v2 api ([db7fdb5](https://github.com/atulgavandetzafon/computer-python/commit/db7fdb5cbcb3ed5f38c2fcebe824573172c223d1))
+* async ([38d796c](https://github.com/atulgavandetzafon/computer-python/commit/38d796c6538fad278abf122887a57a379c5a532b))
+* lets test functionality ([3d5f515](https://github.com/atulgavandetzafon/computer-python/commit/3d5f515098e71964a431849a37c88a7a017424d2))
+* wrapper test1 ([e329ec1](https://github.com/atulgavandetzafon/computer-python/commit/e329ec12ae711d64cad28e04a74bd7c1283669ce))
+
+
+### Bug Fixes
+
+* removed old async ([1b5c5cd](https://github.com/atulgavandetzafon/computer-python/commit/1b5c5cdf4a7c80089e8ca67e13540bdae898ac98))
+
+
+### Chores
+
+* update SDK settings ([a5da45a](https://github.com/atulgavandetzafon/computer-python/commit/a5da45a676c091d3d02fde9352d98d458e4dfe7f))
+* update SDK settings ([3e68f6d](https://github.com/atulgavandetzafon/computer-python/commit/3e68f6db27fae3f75f411d76e15a6df07d22fa2b))

tzafon-1.3.2/CONTRIBUTING.md

@@ -0,0 +1,128 @@
+## Setting up the environment
+
+### With Rye
+
+We use [Rye](https://rye.astral.sh/) to manage dependencies because it will automatically provision a Python environment with the expected Python version. To set it up, run:
+
+```sh
+$ ./scripts/bootstrap
+```
+
+Or [install Rye manually](https://rye.astral.sh/guide/installation/) and run:
+
+```sh
+$ rye sync --all-features
+```
+
+You can then run scripts using `rye run python script.py` or by activating the virtual environment:
+
+```sh
+# Activate the virtual environment - https://docs.python.org/3/library/venv.html#how-venvs-work
+$ source .venv/bin/activate
+
+# now you can omit the `rye run` prefix
+$ python script.py
+```
+
+### Without Rye
+
+Alternatively if you don't want to install `Rye`, you can stick with the standard `pip` setup by ensuring you have the Python version specified in `.python-version`, create a virtual environment however you desire and then install dependencies using this command:
+
+```sh
+$ pip install -r requirements-dev.lock
+```
+
+## Modifying/Adding code
+
+Most of the SDK is generated code. Modifications to code will be persisted between generations, but may
+result in merge conflicts between manual patches and changes from the generator. The generator will never
+modify the contents of the `src/tzafon/lib/` and `examples/` directories.
+
+## Adding and running examples
+
+All files in the `examples/` directory are not modified by the generator and can be freely edited or added to.
+
+```py
+# add an example to examples/<your-example>.py
+
+#!/usr/bin/env -S rye run python
+…
+```
+
+```sh
+$ chmod +x examples/<your-example>.py
+# run the example against your api
+$ ./examples/<your-example>.py
+```
+
+## Using the repository from source
+
+If you’d like to use the repository from source, you can either install from git or link to a cloned repository:
+
+To install via git:
+
+```sh
+$ pip install git+ssh://git@github.com/atulgavandetzafon/computer-python.git
+```
+
+Alternatively, you can build from source and install the wheel file:
+
+Building this package will create two files in the `dist/` directory, a `.tar.gz` containing the source files and a `.whl` that can be used to install the package efficiently.
+
+To create a distributable version of the library, all you have to do is run this command:
+
+```sh
+$ rye build
+# or
+$ python -m build
+```
+
+Then to install:
+
+```sh
+$ pip install ./path-to-wheel-file.whl
+```
+
+## Running tests
+
+Most tests require you to [set up a mock server](https://github.com/stoplightio/prism) against the OpenAPI spec to run the tests.
+
+```sh
+# you will need npm installed
+$ npx prism mock path/to/your/openapi.yml
+```
+
+```sh
+$ ./scripts/test
+```
+
+## Linting and formatting
+
+This repository uses [ruff](https://github.com/astral-sh/ruff) and
+[black](https://github.com/psf/black) to format the code in the repository.
+
+To lint:
+
+```sh
+$ ./scripts/lint
+```
+
+To format and fix all ruff issues automatically:
+
+```sh
+$ ./scripts/format
+```
+
+## Publishing and releases
+
+Changes made to this repository via the automated release PR pipeline should publish to PyPI automatically. If
+the changes aren't made through the automated pipeline, you may want to make releases manually.
+
+### Publish with a GitHub workflow
+
+You can release to package managers by using [the `Publish PyPI` GitHub action](https://www.github.com/atulgavandetzafon/computer-python/actions/workflows/publish-pypi.yml). This requires a setup organization or repository secret to be set up.
+
+### Publish manually
+
+If you need to manually release a package, you can run the `bin/publish-pypi` script with a `PYPI_TOKEN` set on
+the environment.

tzafon-1.3.2/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.