Introduction

Python wrapper around the Java Access Bridge / Windows Access Bridge.

Prerequisites

64-bit Windows
Java >= 8 (https://docs.aws.amazon.com/corretto/latest/corretto-8-ug/downloads-list.html)
- If you are doing development install JDK, otherwise JRE is enough
Python >= 3.7 (https://www.python.org/downloads/release/python-375/)

Enable the Java Access Bridge in windows

C:\path\to\java\bin\jabswitch -enable

Install

pip install java-access-bridge-wrapper

How to use

Import the Java Access Bridge (JAB) wrapper and optionally the context tree

from JABWrapper.jab_wrapper import JavaAccessBridgeWrapper
from JABWrapper.context_tree import ContextNode, ContextTree, SearchElement

The JAB creates an virtual GUI window when it is opened. For the JAB to operate and receive events from the GUI, the calling code needs to implement the windows message pump and call it in a loop. The JABWrapper object needs to be in the same thread.

This can be achieved for example by starting the message pump in a separate thread, where the JAB object is also initialized.

GetMessage = ctypes.windll.user32.GetMessageW
TranslateMessage = ctypes.windll.user32.TranslateMessage
DispatchMessage = ctypes.windll.user32.DispatchMessageW

def pump_background(pipe: queue.Queue):
    try:
        jab_wrapper = JavaAccessBridgeWrapper()
        pipe.put(jab_wrapper)
        message = byref(wintypes.MSG())
        while GetMessage(message, 0, 0, 0) > 0:
            TranslateMessage(message)
            logging.debug("Dispatching msg={}".format(repr(message)))
            DispatchMessage(message)
    except Exception as err:
        pipe.put(None)

def main():
    pipe = queue.Queue()
        thread = threading.Thread(target=pump_background, daemon=True, args=[pipe])
        thread.start()
        jab_wrapper = pipe.get()
        if not jab_wrapper:
            raise Exception("Failed to initialize Java Access Bridge Wrapper")
        time.sleep(0.1) # Wait until the initial messages are parsed, before accessing frames

if __name__ == "__main__":
    main()

Once the JABWrapper object is initialized, attach to some frame and optionally create the context tree to get the element tree of the application.

jab_wrapper.switch_window_by_title("Frame title")
context_tree = ContextTree(jab_wrapper)

Development

Development prerequisites

Install poetry: https://python-poetry.org/docs/

Test

Run test script against simple Swing application

Set environment variable

set RC_JAVA_ACCESS_BRIDGE_DLL="C:\path\to\Java\bin\WindowsAccessBridge-64.dll"

Initialize poetry

poetry intall

Run test with poetry

poetry run python tests\test.py

Packaging

poetry build
poetry publish

TODO:

Support for 32-bit Java Access Bridge version
Implement rest of the utility functions to the JABWrapper

Release files for java-access-bridge-wrapper 0.14.1

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

Source distribution (sdist)

Source distribution for java-access-bridge-wrapper 0.14.1
File	Size	Uploaded
java_access_bridge_wrapper-0.14.1.tar.gz	27.8 kB	Jun 28, 2023	Details

Built distribution (wheel)

Table of built distributions (wheels) for java-access-bridge-wrapper 0.14.1
File	Interpreter	ABI	Platform	Reset
java_access_bridge_wrapper-0.14.1-py3-none-any.whl 31.9 kB Jun 28, 2023	Python 3	none	any	Details

Total release size: 59.7 kB

Release files / java_access_bridge_wrapper-0.14.1.tar.gz

Download URL	java_access_bridge_wrapper-0.14.1.tar.gz
Size	27.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`8ee085b6257b23037e84c0572821e636402b14450ec7d396b0b04ab85ce40476`
BLAKE2b-256 checksum How to use checksums	`c5d8ef958309b153f4ebc1996d4777d128c9fd346bfd532262955c7add5d08ea`
Upload date	Jun 28, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.4.1 CPython/3.8.10 Windows/10`

Release files / java_access_bridge_wrapper-0.14.1-py3-none-any.whl

Download URL	java_access_bridge_wrapper-0.14.1-py3-none-any.whl
Size	31.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`5e3a5afbb5a42a50d33b355ad74b7fe1e1109c4f7a90c363ec49542fcd605806`
BLAKE2b-256 checksum How to use checksums	`ac398ae188c521273523010f6b298dab4746ff1ba692325e2543e0fa658129f9`
Upload date	Jun 28, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.4.1 CPython/3.8.10 Windows/10`