Skip to main content

oculix (Python)

Python wrapper for OculiX — visual automation for the real world.

Install

pip install oculix

Requirements: Python 3.8+, Java 11+ on PATH (Eclipse Temurin or Azul Zulu).

The OculiX engine (~160 MB fat JAR) is downloaded on first use into ~/.oculix/lib/.

Quickstart

from oculix import Screen, App, VNCScreen

screen = Screen()
screen.click("login.png")
screen.type("admin")
screen.click("submit.png")
screen.wait("dashboard.png", 10)

# Open a desktop app
calc = App.open("calc")
screen.click("button_7.png")

# Drive a remote VNC display
vnc = VNCScreen.start("10.0.0.42", 5900, "", 1920, 1080)
vnc.click("logo.png")
vnc.stop()

With pytest

import pytest
from oculix import Screen, App

@pytest.fixture
def calc():
    a = App.open("calculator")
    yield a
    a.close()

def test_addition(calc):
    s = Screen()
    s.click("button_7.png")
    s.click("button_plus.png")
    s.click("button_3.png")
    s.click("button_equals.png")
    assert s.exists("result_10.png")

License

MIT

Metadata

Release files for oculix 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for oculix 1.0.0
File Size Uploaded Provenance Actions
oculix-1.0.0.tar.gz 9.9 kB Without provenance Details for oculix-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for oculix 1.0.0
File Interpreter ABI Platform Actions
oculix-1.0.0-py3-none-any.whl Python 3 none any Details for oculix-1.0.0-py3-none-any.whl

Total release size: 18.7 kB

Release files / oculix-1.0.0.tar.gz

Download URL oculix-1.0.0.tar.gz
Size 9.9 kB
Tags Source
SHA-256 checksum
How to use checksums
3a8e908f3664dd17b885b9bdd0ed700f026d24671a4d228070ad33177dc374a9
BLAKE2b-256 checksum
How to use checksums
85c0ed5c7799e46eb8d5262ad7aa26e33e7d60fc0a66dbc90f41870d3f128789
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / oculix-1.0.0-py3-none-any.whl

Download URL oculix-1.0.0-py3-none-any.whl
Size 8.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
76753d6e3d622809a6ecc4d351d118d3b1b5132295d661a7e96238a1daad8d86
BLAKE2b-256 checksum
How to use checksums
0d970203f22589871c0d8d1d3d70608feb5fe9d0ab7f2961122c11b657d73a32
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Security for oculix 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page