Registry / testing / robotframework-whitelibrary

robotframework-whitelibrary

library1.6.0pypypiunverified

Windows GUI testing library for Robot Framework, version 1.6.0. Uses White (a .NET UI automation framework) to interact with Windows applications. Provides Robot Framework keywords for launching, attaching, and controlling windows, controls, and UI elements. Release cadence is irregular, with minor updates every few months.

testing

pip install robotframework-whitelibrary

github ↗package ↗

INSTALL

IMPORT

SIG · ROBOTFRAMEWORK-WHI

robotframework-whitelibrary

testingpythonv1.6.0

Install

2.0s avg

Import

—

Disk

23MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.6.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 24.8MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 2.0s · import 0.000s · 25MB

23MB installed

● package 23MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

WhiteLibrary

✓ import WhiteLibrary

✗ from WhiteLibrary import WhiteLibrary

Launch Notepad, type text, and close the window. Demonstrates basic usage of Launch Application, Attach Window By Title, Type Text, and Close Window keywords.

*** Settings *** Library WhiteLibrary *** Test Cases *** Open Notepad and Type Text Launch Application notepad.exe Attach Window By Title Untitled - Notepad Type Text id:15 Hello, Robot Framework! Sleep 1s Close Window

Debug

Known issues

breakingBackwards incompatible changes in v1.5.0: Error messages for keywords `Window Should Be Maximized`, `Window Should Be Minimized` and `Window Should Be Closed` have changed. Tests that assert on exact error messages may break.

fix

Update any robot test cases that check the error messages of these keywords to match the new format.

affects: >=1.5.0

deprecatedThe locator format 'type:value' introduced in v1.2.0 may be deprecated or changed in future versions. The old plain locators (e.g., `id:15`) still work but check docs for preferred format.

fix

Use the recommended locator format from the official documentation. For most cases, `id:value` is fine.

affects: >=1.2.0

gotchaWhiteLibrary is Windows-only. It uses .NET Framework and White, which only run on Windows. Running tests on Linux or macOS will fail with platform errors.

fix

Ensure tests are executed on Windows with .NET Framework installed. Use conditional execution or skip on non-Windows platforms.

affects: all

gotchaThe library relies on White's UI automation, which is sensitive to timing. It's common to encounter `ItemNotFoundException` or timeout errors if the UI element hasn't appeared yet. Use `Wait Until Item Exists` (v1.5.0+) or increase timeouts.

fix

Use `Wait Until Item Exists` (only in v1.5.0+) or increase the `white_find_window_timeout` and `white_busy_timeout` settings. Alternatively, add explicit `Sleep` statements.

affects: all

Upgrade

Version history

1.6.0latest on PyPI · released Sep 2, 2019

Audit

Dependencies

robotframeworkrequiredWhiteLibrary extends Robot Framework's test library interface

Agent activity

18 hits · last 30 days

node

Resources

githubhttps://github.com/Omenia/robotframework-whitelibrary ↗

packagehttps://pypi.org/project/robotframework-whitelibrary/ ↗