API Reference

Application

Application wraps a running process. Returned by Desktop.launch() and Desktop.connect().

Full signatures for dolphin_desktop._application.Application are generated from the package docstrings — use help() in Python or autocomplete in your IDE.

Usage examples

Get a window

win = app.window(title_re=".*My App.*")
win = app.window(class_name="Notepad")
win = app.window(title="Exact Window Title")

Context manager (automatic teardown)

with desktop.launch("notepad.exe") as app:
    win = app.window(class_name="Notepad")
    win.get_by_role("Document").type_text("hello")
# app.kill() called automatically

Process lifecycle

app.wait_for_idle(timeout=10)  # wait until CPU is idle
pid = app.process_id
app.close()   # request graceful shutdown explicitly
app.kill()    # deterministic teardown used by fixtures/context managers

All windows

for win in app.windows():
    print(win.title())