| 1 |
|
| 2 |
# dogtail 1.0.1 |
| 3 |
|
| 4 |
Rebased with a number of contributions that were done to the master branch while we were working on Wayland and we have accidentaly not included them in 1.0. |
| 5 |
See https://gitlab.com/dogtail/dogtail/-/issues/31 |
| 6 |
Also returned couple of modules we thought were of no use (tc, wrapped) but were proved otherwise to keep 1.0 fully compatible with 0.x. |
| 7 |
|
| 8 |
# dogtail 1.0 |
| 9 |
|
| 10 |
After more than five years of continuous experimentation and development, we are excited to finally release Dogtail 1.0—a Wayland-enabled version of Dogtail! How did we achieve this? It was made possible by the `gnome-ponytail-daemon`, originally crafted by Olivier Fourdan: https://gitlab.gnome.org/ofourdan/gnome-ponytail-daemon. This tool allows us to perform actions in a Wayland GNOME session in a similar way to how we have been doing so with X functions. |
| 11 |
|
| 12 |
## How does it work in brief? |
| 13 |
|
| 14 |
The core functionality relies on the Screen Cast and Remote Desktop API, enabling us to "connect" to either a specific window or the entire screen to simulate user input actions like key presses, typing, and—most importantly—mouse actions on specific coordinates. Ponytail uses the window list from `org.gnome.Shell.Introspect` to identify windows. Dogtail then ensures the correct window is connected via the Remote Desktop API, allowing input actions to be accurately executed within it. |
| 15 |
|
| 16 |
On the AT-SPI tree and accessibility's "introspection" side, not much has changed—input has primarily been the challenge on Wayland. The main difference is that only "local" window coordinates are known for UI items. To address this, we always connect to the specific window we're working with, and Ponytail's `connectWindow` ensures these local coordinates are translated to global ones internally. |
| 17 |
|
| 18 |
## What does this mean for users? |
| 19 |
|
| 20 |
Dogtail handles all of this logic seamlessly, so in practical use, the user doesn't need to worry about coordinate types or window connections. In fact, the vast majority of our tests work identically in both X and Wayland sessions using the Dogtail API. When running on an X session, Dogtail will use the traditional X functions to handle input and operate as it always has. |
| 21 |
|
| 22 |
## A long journey to 1.0 |
| 23 |
|
| 24 |
We began working on the Wayland-enabled version over five years ago (originally available in the `devel/wayland` branch). It has taken all this time to ensure the solution is robust and reliable enough to warrant a 1.0 release. This version includes all the Wayland-related developments and other changes (like the GTK4 support tweaks mentioned below) and has been extensively tested. Importantly, it is backward compatible with the entire Dogtail API that has been available so far. This release includes all modules from the 0.9.x series, most notably the "procedural" module, which we plan to deprecate in favor of a completely "tree-based" approach in Dogtail 2.0. |
| 25 |
|
| 26 |
That release will also involve significant cleanup, major code refactoring, and a transition from `pyatspi` to directly introspected `atspi`. It will also contain up date code examples and dogtail's unittests should pass with gitlab pipelines re-enabled. |
| 27 |
|
| 28 |
For more details on these upcoming changes, see issue #29. |
| 29 |
|
| 30 |
## Important: Handling GTK4 Application Windows in Dogtail |
| 31 |
|
| 32 |
For GTK4 applications, disabling window shadows is essential to ensure accurate positioning by Dogtail. With shadows disabled, we encounters a consistent coordinate offset, which we've preconfigured as `dogtail.config.gtk4Offset`. In case of working with fullscreen windows, the offset is 0, and we manage to detect that |
| 33 |
on-the-fly both in x11 and wayland sessions. However this process requires `python-xlib`, even for Wayland sessions, leveraging Xwayland to ascertain resolution information, as no more direct method we've found currently available for Wayland. |
| 34 |
|
| 35 |
When window shadows are active, the perceived offset can vary significantly, influenced by factors such as the specific application, window size, and scaling settings. To ensure consistent behavior across applications, disabling shadows is recommended. |
| 36 |
|
| 37 |
Disabling Shadows in GTK4: |
| 38 |
|
| 39 |
To disable window shadows, add the following CSS to your GTK4 configuration (`~/.config/gtk-4.0/gtk.css`): |
| 40 |
|
| 41 |
window, .popover, .tooltip { |
| 42 |
box-shadow: none; |
| 43 |
} |
| 44 |
|
| 45 |
|
| 46 |
dogtail 0.9.10 |
| 47 |
============== |
| 48 |
|
| 49 |
There has been a good deal of fixes and improvements since last year's release. We're not really ready for 1.0 |
| 50 |
yet, which is why we release this important cumulative release as 0.9.10. We have also moved our homesite to |
| 51 |
gitlab (fedoraproject has been discontinued). For the list of changes, simply go to: |
| 52 |
https://gitlab.com/dogtail/dogtail/commits/master |
| 53 |
|
| 54 |
dogtail 0.9.9 |
| 55 |
============= |
| 56 |
A 1.0 pre-release. Contains a big number of fixes and changes done |
| 57 |
since 0.9.0. Most important of these is framework's compatibility with |
| 58 |
Python3. We've modified the code everywhere to run with both Python 2.7 |
| 59 |
and 3.3+. This means that from now on we maintain the same codebase and |
| 60 |
are releasing the same tarball, which can be used to package both py2 and |
| 61 |
py3 installations downstream. A complete list of fixes and changes will |
| 62 |
be present here, when we release 1.0 after 0.9.9 has been thouroughly tested. |
| 63 |
|
| 64 |
Though considered a pre-release, don'worry! 0.9.9 is considered stable and |
| 65 |
have gone through some rigorious testing already. Thanks to newly extended |
| 66 |
unit-test-set, it is actually the most self-tested release so far. |
| 67 |
|
| 68 |
dogtail 0.9.0 |
| 69 |
============= |
| 70 |
Over the last year we've made a good number of fixes, added some new features |
| 71 |
and got overall stability to the point where we can make a new 'major minor' |
| 72 |
release. With 0.9 we're finally getting only a step away from what we'd like |
| 73 |
to get done with 1.0. |
| 74 |
|
| 75 |
|
| 76 |
* Added a fix for situations when a previously crashed application |
| 77 |
still registered with at-spi blocks search ('Broken' session problem) |
| 78 |
Fixed for root.application(), root.applications() and for whenever |
| 79 |
GeneralPredicate is used (.child()). Also done for Sniff. RHBZ 972257 |
| 80 |
|
| 81 |
* Added a support for gnome-continuous build-api (#36) |
| 82 |
|
| 83 |
* Added a direct lambda support in the findChildren method, that allows |
| 84 |
using non-predicate lambdas to create search properties. These can be |
| 85 |
all pure dogtail Node properties (i.e. showing), not limiting to just |
| 86 |
pyatspi ones as is when using Predicate. |
| 87 |
|
| 88 |
* Added a GnomeShell 'helper' class into utils module allowing to work |
| 89 |
with the new top-panel application menu. |
| 90 |
|
| 91 |
* With GTK3.10+ Gdk changes, needed to tune the keyNameToKeyCode function |
| 92 |
so that it provides valid keySym in as many cases possible - with both |
| 93 |
pre-GTK3.10 as well as GTK3.11+ having the same behavior in typeText and |
| 94 |
pressKey |
| 95 |
|
| 96 |
* Sniff ui update: the info pane now stays down on resizing |
| 97 |
|
| 98 |
* Got rid of some deprecated GObject calls |
| 99 |
|
| 100 |
* Several updates to the dogtail-run-headless-next |
| 101 |
- Any kind of session can now be used in any combination with both gdm/kdm |
| 102 |
--session can be used to specify any xsession desktop file, 'kde' defaults |
| 103 |
to 'kde-plasma' too keep pre-updated compatibility; default is now the previous user session |
| 104 |
--dm - new param to pick either gdm (default) or kdm |
| 105 |
--session-binary - new param to specify any in-session binary to grab script env from |
| 106 |
- to be used with non gnome/kde session (lxde, ubuntu) |
| 107 |
- do not confuse with session execs like gnome-session and starkde, that may |
| 108 |
actually exit after session loadup; it should be everpresent (kwin, shell...) |
| 109 |
- Added a --restart switch to force restart the previously running (often left-over) session before proceeding |
| 110 |
- More logging of script execution (start/stop/PID), and some cleanups |
| 111 |
|
| 112 |
* Trap GErrors in findAllDescendants and retry if it occurs: This fixes crashes in findChildren if elements are being added/removed quickly |
| 113 |
|
| 114 |
* Unicode handling updates: |
| 115 |
- Make sure safeDecode is not skipping any strings |
| 116 |
- Don't crash when logging message contains unicode |
| 117 |
|
| 118 |
* Error Handling for Attribute Error |
| 119 |
|
| 120 |
* Fixed utils.run issue when having whitespace containing binary by |
| 121 |
using shlex shell-like parsing split. |
| 122 |
|
| 123 |
* Removed an always true if condition in i18n |
| 124 |
|
| 125 |
* Log child description when clicking. The log will now print the element description when it will be clicked |
| 126 |
|
| 127 |
* Trap TypeError in findAllDescendants: Sometimes pytaspi returns None as a Node if children are being removed too fast. |
| 128 |
We should retry search in this case |
| 129 |
|
| 130 |
* Extended the default TypingDelay from 0.075 to 0.1 seconds (helps working with certain high unicode charactes) |
| 131 |
|
| 132 |
* Fixed an bug in sniff discovered by jmolet that made sniff crash when |
| 133 |
run from /bin/sniff not /usr/bin/sniff |
| 134 |
|
| 135 |
* Generate a better script method call for labels |
| 136 |
|
| 137 |
* Fix for failing 'focus.application.node' seting |
| 138 |
|
| 139 |
* Derive all classes from object explicitely |
| 140 |
|
| 141 |
* Changed icons used in sniff that got moved to the gnome-icon-theme-legacy |
| 142 |
recently for the ones from non-legacy package. |
| 143 |
|
| 144 |
* Unified the 'isSth' vs. 'sth' properties for only 'sth' - added 'selected', but also introduced |
| 145 |
'isChecked' property for 0.7.x compatibility |
| 146 |
|
| 147 |
* Added instructions on how to enable accessibility into utils.bailBecauseA11yIsDisabled() |
| 148 |
|
| 149 |
* Added a 'retry' option to the tree.root.application() |
| 150 |
|
| 151 |
* Fixed the concurrent creation of sniff_refresh lock from both tree and procedural |
| 152 |
|
| 153 |
* Switched to use environ value to get user in config. os.getlogin breaks when run scheduled from a testing system with no terminal. |
| 154 |
|
| 155 |
* Patched the mouse related rawinput methods to prevent using negative coordinates |
| 156 |
|
| 157 |
* Updated and added more unittests |
| 158 |
|
| 159 |
dogtail 0.8.2 |
| 160 |
============= |
| 161 |
Second update to the 0.8 series containing several fixes and improvements |
| 162 |
|
| 163 |
* Added the dogtail-run-headless-next to replace the dogtail-run-headless in future. |
| 164 |
-next, uses a diplay manager (kdm or gdm) for session management, should be used instead of older |
| 165 |
headless on systemd systems already |
| 166 |
|
| 167 |
* Unittests vastly improved and updated |
| 168 |
|
| 169 |
* Fixed a missing reset of FocusWindow to None on application refocus |
| 170 |
|
| 171 |
* Fixed the dogtail-logout to use gnome-shell instead of old gnome-panel |
| 172 |
|
| 173 |
dogtail 0.8.1 |
| 174 |
============= |
| 175 |
A first update to the new GNOME3 / KDE4 compatible release containing several fixes: |
| 176 |
|
| 177 |
* Sniff's autorefresh made togglable, to help avoid collisions with potential |
| 178 |
running dogtail scripts. Sniff checks at startup whether some script is running |
| 179 |
and sets up the autorefresh off if it is. |
| 180 |
|
| 181 |
* Added a locking mechanism into utils that can be used to solve situations when |
| 182 |
multiple dogtail processes/thread are running (applied in tree/procedural and sniff |
| 183 |
already) |
| 184 |
|
| 185 |
* Removed the deprecated dependency on CORBA |
| 186 |
|
| 187 |
* Icons no longer use absolute pathing in sniff (thx roignac) |
| 188 |
|
| 189 |
* Deprecated .has_key() operator replaced with 'in'. |
| 190 |
|
| 191 |
* Removed .svg inside sniff's .desktop file |
| 192 |
|
| 193 |
dogtail 0.8.0 |
| 194 |
============= |
| 195 |
Finally a big release updating dogtail after more than 2 years ! Dogtail |
| 196 |
is developed and maintained now again. |
| 197 |
|
| 198 |
Simply put, ported to be compatible with the new GNOME 3 and to work well in major |
| 199 |
GNOME 3 (GTK3) distributions. |
| 200 |
|
| 201 |
We'd like to make the 0.8.x version onward the GNOME 3 compatible branch usable |
| 202 |
for Fedora, RHEL7 and others, while keeping 0.7.x releases for fixes in older GNOME2 |
| 203 |
systems. |
| 204 |
|
| 205 |
--- What was done --- |
| 206 |
|
| 207 |
Notably, Sniff's UI needed to ported completely to GTK3, yet there are |
| 208 |
also several places in dogtail 'itself' that needed to be rewritten to go ahead |
| 209 |
with the new technologies. Those were all the modules where the old pygtk was |
| 210 |
used for various reasons (rawinput, utils, tree...). Incompatibilites were also |
| 211 |
present due to the new version of pyatspi (notably with the doAction method). |
| 212 |
|
| 213 |
Release highlights: |
| 214 |
|
| 215 |
* A great number of fixes everywhere related to GTK/GNOME/At-Spi updates |
| 216 |
|
| 217 |
* The dogtail-recorder was dropped for now, but might return in RC or 0.8.1 |
| 218 |
|
| 219 |
* Thanks to the qt-at-spi project, dogtail now works out-of-the-box for QT! |
| 220 |
|
| 221 |
* Headless supports KDE sessions |
| 222 |
|
| 223 |
* Headless working with full 3D-Accelerated GNOME session (no fallback anymore) |
| 224 |
|
| 225 |
* Highlight used in sniff completely re-written and made toggleable (of by default) |
| 226 |
|
| 227 |
* Makefile updated, 'make run' builds packages in homedir/rpmbuld now |
| 228 |
|
| 229 |
* Several examples fixed for updated gedit |
| 230 |
|
| 231 |
* Added tree.isChild() convenience method |
| 232 |
|
| 233 |
* Renamed doAction to doActionNamed due to conflict with doAction inside |
| 234 |
pyatspi namespace |
| 235 |
|
| 236 |
* Delay made configurable in absoluteMotion and relativeMotion functions |
| 237 |
|
| 238 |
* Changed at-spi activation to use DConf instead of GConf |
| 239 |
|
| 240 |
* A bit of code clean-up and modernization (using @property now etc.) |
| 241 |
|
| 242 |
* More error checking added |
| 243 |
|
| 244 |
* A couple of unit tests for Node added |
| 245 |
|
| 246 |
* Node.findChildren() updated to be faster |
| 247 |
|
| 248 |
|
| 249 |
dogtail 0.7.0 |
| 250 |
============= |
| 251 |
|
| 252 |
This release has too many changes to list. Here are some of the major ones: |
| 253 |
|
| 254 |
* Dogtail has been ported to pyatspi. This means: |
| 255 |
- Faster performance. |
| 256 |
- Errors will be more clear. |
| 257 |
- No more segfaulting or myserious crashes. |
| 258 |
|
| 259 |
* There is now useful generated API documentation: |
| 260 |
http://fedorapeople.org/~zmc/dogtail/epydoc/ |
| 261 |
|
| 262 |
* Inline documentation has been greatly improved. |
| 263 |
|
| 264 |
* Headless execution support was completely rewritten. |
| 265 |
|
| 266 |
* Sniff was completely rewritten. It is now: |
| 267 |
- Faster. |
| 268 |
- More reliable. |
| 269 |
- Self-updating via AT-SPI events. |
| 270 |
- Slightly prettier. |
| 271 |
- Able to tell you about certain states and relations. |
| 272 |
|
| 273 |
* Image Comparison (TCImage) was rewritten. No more ImageMagick! |
| 274 |
|
| 275 |
Note: tests/Node.py's TestNodeAttributes is failing due to GNOME bugs #498557 |
| 276 |
and #498563 |
| 277 |
|
| 278 |
|
| 279 |
dogtail 0.6.1 |
| 280 |
============= |
| 281 |
|
| 282 |
Features: |
| 283 |
|
| 284 |
* dogtail-recorder has a Play button now. |
| 285 |
|
| 286 |
* dogtail-recorder now records right-clicks. That it didn't previously was an |
| 287 |
oversight. Note that there is some inconsistency when dealing with context |
| 288 |
menus, as the events often get fired in the wrong order. |
| 289 |
|
| 290 |
* New logging mechanism: |
| 291 |
|
| 292 |
- Debug output is now written to a file. To disable this, set |
| 293 |
dogtail.config.config.logDebugToFile to False. |
| 294 |
|
| 295 |
- The procedural API defaults to not raising FocusErrors, and instead |
| 296 |
issuing warnings via the debug logging mechanism (which prints to |
| 297 |
standard out along with writing to a file). To re-enable FocusErrors, set |
| 298 |
dogtail.config.config.fatalErrors to True. |
| 299 |
|
| 300 |
* Brian Cameron submitted a patch to make dogtail.distro correctly detect that |
| 301 |
it is running on Solaris. |
| 302 |
|
| 303 |
Bugfixes: |
| 304 |
|
| 305 |
* dogtail-recorder no longer offers the broken Object-Oriented backend as a |
| 306 |
choice. If it gets fixed, it will be offered again. |
| 307 |
|
| 308 |
* dogtail-recorder can be properly exited by clicking on the window manager |
| 309 |
close button. In fact, the Quit button was removed also. |
| 310 |
|
| 311 |
* dogtail-recorder's syntax hilighting works again, thanks to a patch from |
| 312 |
Dave Malcolm. |
| 313 |
|
| 314 |
* Searching for nodes with parentheses in their names will no longer fail. |
| 315 |
|
| 316 |
* The various pressKey() functions were blowing up on punctuation and |
| 317 |
newlines. Fixed. |
| 318 |
|
| 319 |
* Predicate subclasses in dogtail.predicate which were missing debugNames have |
| 320 |
gotten them back. |
| 321 |
|
| 322 |
* Warnings are no longer issued when dogtail encounters invalid Unicode. |
| 323 |
|
| 324 |
* Where several of our example scripts were broken, Michal Babej noticed and |
| 325 |
submitted patches fixing them. |
| 326 |
|
| 327 |
* dogtail's tarball is 90% smaller! Some overly large test images were |
| 328 |
replaced with very, very small ones that still do the job. |
| 329 |
|
| 330 |
|
| 331 |
dogtail 0.6.0 |
| 332 |
============= |
| 333 |
|
| 334 |
Features: |
| 335 |
|
| 336 |
* Keystroke recording support in dogtail-recorder: |
| 337 |
|
| 338 |
- Normal keypresses (e.g. typing 'foo bar baz') will be recorded as |
| 339 |
"type('foo bar baz')" in the procedural API. dogtail.tree.Node has a new |
| 340 |
method, typeText(), which is called by dogtail.procedural.type(). |
| 341 |
|
| 342 |
- Nonprintable keypresses (e.g. typing Control-Shift-c) will be recorded as |
| 343 |
"keyCombo('<Control><Shift>c')" in the procedural API. dogtail.tree.Node |
| 344 |
has a new method, keyCombo(), which is called by |
| 345 |
dogtail.procedural.keyCombo(). |
| 346 |
|
| 347 |
- The now-unnecessary 'Input Text' button has been removed. |
| 348 |
|
| 349 |
* dogtail.tree.Node has new attributes and a new method: |
| 350 |
|
| 351 |
- grabFocus(): Attempts to cause the node to grab the keyboard focus. |
| 352 |
|
| 353 |
- focusable: Whether the node is able to have keyboard focus. |
| 354 |
|
| 355 |
- focused: Whether the node currently has keyboard focus. |
| 356 |
|
| 357 |
- checked: Whether the node is a checkbox that is currently checked. |
| 358 |
|
| 359 |
* Dogtail now checks if accessibility is enabled before it does anything. |
| 360 |
sniff and dogtail-recorder will prompt to enable it via a dialog, and |
| 361 |
scripts themselves will just refuse to run. |
| 362 |
|
| 363 |
* Dogtail no longer uses the IconLogger (in the notification area) by default. |
| 364 |
Set dogtail.config.config.useIconLogger to True to reenable it. |
| 365 |
|
| 366 |
* dogtail.utils.screenshot() was rewritten to use GDK instead of ImageMagick. |
| 367 |
|
| 368 |
Bugfixes: |
| 369 |
|
| 370 |
* Dogtail is now much more robust in dealing with possibly-invalid Unicode |
| 371 |
strings passed to it via AT-SPI. (GNOME bug #354515) |
| 372 |
|
| 373 |
* Dogtail will not crash when it receives an SpiException caused by a CORBA |
| 374 |
COMM_FAILURE, unless the source of that error is the application under test. |
| 375 |
|
| 376 |
* While exceptions occuring inside callbacks used in dogtail-recorder will |
| 377 |
still not properly be raised, they are now printed to standard out. |
| 378 |
|
| 379 |
* SuSe support in dogtail.distro is fixed. (GNOME bug #353601) |
| 380 |
|
| 381 |
* sniff and dogtail-recorder will now find their glade files, even if they're |
| 382 |
installed into a nonstandard prefix. (GNOME bug #353719, #353731) |
| 383 |
|
| 384 |
* dogtail-run-headless had a few bugs fixed. |
| 385 |
|
| 386 |
|
| 387 |
dogtail 0.5.2 |
| 388 |
============= |
| 389 |
|
| 390 |
Features: |
| 391 |
|
| 392 |
* A much-improved recorder: |
| 393 |
|
| 394 |
- A procedural script writer, which is now default. |
| 395 |
|
| 396 |
- An 'Input Text' feature, which allows you to set the text attribute |
| 397 |
of any visible Node via the recorder. Coming soon is proper keystroke |
| 398 |
recording. |
| 399 |
|
| 400 |
- The script view now uses syntax hilighting where available. (GNOME bug |
| 401 |
#345374) |
| 402 |
|
| 403 |
* A completely-rewritten dogtail-run-headless, which now offers two session |
| 404 |
types: minimal GNOME and metacity. The syntax has changed, so use |
| 405 |
'dogtail-run-headless --help' to get started. (GNOME bug #320548) |
| 406 |
|
| 407 |
* All 'name' arguments in dogtail.tree and dogtail.procedural now accept |
| 408 |
regular expressions. |
| 409 |
|
| 410 |
* Support for AccessibleSelections, providing a clean way to select page |
| 411 |
tabs and combo box items. (GNOME bug #336562) |
| 412 |
|
| 413 |
* Support for building in a jhbuild environment. (GNOME bug #318535) |
| 414 |
|
| 415 |
* Far more extensive unit tests for dogtail.tree.Node. |
| 416 |
|
| 417 |
Bugfixes: |
| 418 |
|
| 419 |
* The source is now indented with spaces and not tabs! :) (GNOME bug #318833) |
| 420 |
|
| 421 |
* Pyspi and dogtail no longer mysteriously stop working. (GNOME bug #321273) |
| 422 |
|
| 423 |
* Sniff no longer crashes when an application being poked disappears. (GNOME |
| 424 |
bug #318135) |
| 425 |
|
| 426 |
|
| 427 |
dogtail 0.5.1 |
| 428 |
============= |
| 429 |
|
| 430 |
Features: |
| 431 |
|
| 432 |
* An improved build system for RPMs. |
| 433 |
|
| 434 |
* dogtail.procedural's FocusErrors are now more informative. |
| 435 |
|
| 436 |
Bugfixes: |
| 437 |
|
| 438 |
* examples/recorder.py was broken; a bug in dogtail.predicate.makeCamel() |
| 439 |
was breaking the predicates' makeScriptVariableName() calls. It's fixed. |
| 440 |
|
| 441 |
|
| 442 |
dogtail 0.5.0 |
| 443 |
============= |
| 444 |
|
| 445 |
Features: |
| 446 |
|
| 447 |
* Automatic runtime translation into the current locale using the application |
| 448 |
under test's own translations. See |
| 449 |
examples/gedit-test-utf8-procedural-api.py for an example. |
| 450 |
|
| 451 |
* dogtail.distro.packageDb gained new methods: getFiles(), getMoFiles(), and |
| 452 |
getDependencies(). |
| 453 |
|
| 454 |
* dogtail.distro.packageDb now has support for JHBuild environments. |
| 455 |
|
| 456 |
* dogtail.distro has gained exceptions: |
| 457 |
|
| 458 |
- PackageNotFoundError: raised when the specified package is not found. |
| 459 |
|
| 460 |
- DistributionNotSupportedError: raised when support for the current |
| 461 |
distribution is not currently implemented in dogtail.distro. This does |
| 462 |
not mean that dogtail will not work at all; only that |
| 463 |
distribution-specific functionality, like automatic runtime translation, |
| 464 |
will not. |
| 465 |
|
| 466 |
* dogtail.errors is a new module for very general exceptions, such as |
| 467 |
DependencyNotFoundError, which is raised when the use of a feature that |
| 468 |
depends on some missing piece of software is attempted. |
| 469 |
|
| 470 |
* sniff will now cause the selected node to blink onscreen. |
| 471 |
|
| 472 |
* dogtail.tree has a new Node subclass, Link. Link nodes have a roleName of |
| 473 |
'hyper link' and an action called 'jump'. Their main purpose is to allow |
| 474 |
us to follow links in web pages. |
| 475 |
|
| 476 |
* dogtail.tree.Node has new properties and methods: |
| 477 |
|
| 478 |
- position: the onscreen position of the node, if it wraps an |
| 479 |
atspi.Component. |
| 480 |
|
| 481 |
- size: the onscreen size of the node, if it wraps an atspi.Component. |
| 482 |
|
| 483 |
- blink(): causes the node to blink onscreen. |
| 484 |
|
| 485 |
- grabFocus(): causes the node to grab the keyboard focus, if it wraps an |
| 486 |
atspi.Component. |
| 487 |
|
| 488 |
- rawClick(): synthesizes a raw mouse click on the node, if it wraps an |
| 489 |
atspi.Component. |
| 490 |
|
| 491 |
- rawType(): synthesizes raw keyboard events to type text into the node, if |
| 492 |
it wraps an atspi.Component. |
| 493 |
|
| 494 |
* dogtail.procedural has new helper methods: |
| 495 |
|
| 496 |
- menu(): executes the 'menu' action on the focused widget. |
| 497 |
|
| 498 |
- focus.frame(): a shortcut to focus.widget(roleName='frame' ...) |
| 499 |
|
| 500 |
- focus.window(): a shortcut to focus.widget(roleName='window' ...) |
| 501 |
|
| 502 |
* dogtail.procedural.click() can now synthesize raw mouse events to perform |
| 503 |
"raw" clicks. |
| 504 |
|
| 505 |
* dogtail.rawinput has gained new methods: |
| 506 |
|
| 507 |
- pressKey(): synthesizes a raw keyboard event, pressing the key whose |
| 508 |
name is specified. |
| 509 |
|
| 510 |
- typeText(): types a specified string, one key at a time, using raw |
| 511 |
keyboard events. |
| 512 |
|
| 513 |
* dogtail.config was rewritten. |
| 514 |
|
| 515 |
* dogtail.config.config has new parameters: |
| 516 |
|
| 517 |
- ensureSensitivity: controls whether a NotSensitiveError is raised when |
| 518 |
an attempt is made to execute an action belonging to a Node instance |
| 519 |
that is not sensitive, or if a warning is simply printed instead (the |
| 520 |
default). |
| 521 |
|
| 522 |
- debugTranslation: Controls whether details of the autotranslation |
| 523 |
process will be outputted to the debug logger. |
| 524 |
|
| 525 |
* dogtail.config now creates its scratchDir, dataDir, and logDir as soon as |
| 526 |
the values are set. |
| 527 |
|
| 528 |
* dogtail.utils.screenshot(), by default, whether using a custom filename or |
| 529 |
not, now appends a timestamp to the filename. That may be disabled by |
| 530 |
passing 'timeStamp = False' to the method. For this reason, it also prints |
| 531 |
the full path to the screenshot. |
| 532 |
|
| 533 |
* dogtail.logging.TimeStamp.fileStamp()'s format has changed, to |
| 534 |
filename_YYYYMMDD-hhmmss or just filename_YYYYMMDD, controlled by the new |
| 535 |
optional argument 'addTime'. |
| 536 |
|
| 537 |
* dogtail prints the full path to any logfiles it creates. |
| 538 |
|
| 539 |
* dogtail-run-headless will now turn accessibility on before executing the |
| 540 |
script under test, and also restore the old value after the the script has |
| 541 |
finished executing (GNOME bug #320548). |
| 542 |
|
| 543 |
Bugfixes: |
| 544 |
|
| 545 |
* sniff will correctly show the text of a non-editable text node again |
| 546 |
(GNOME bug #321564). |
| 547 |
|
| 548 |
* dogtail.tree.screenshot() was mostly rewritten, and no longer breaks when |
| 549 |
given a custom filename. |
| 550 |
|
| 551 |
* dogtail.procedural no longer causes PyDoc to fail miserably (or at all). |
| 552 |
|
| 553 |
* dogtail will no longer warn about missing wnck bindings, because they're |
| 554 |
not actually used anyway. |
| 555 |
|
| 556 |
* dogtail.procedural.focus.dialog() no longer searches recursively (GNOME |
| 557 |
bug #321624). |
| 558 |
|
| 559 |
* dogtail.procedural.focus.widget() and its shortcut functions now properly |
| 560 |
raise a FocusError if their search fails. |
| 561 |
|
| 562 |
* dogtail.tc.TCString.compare() will now fail properly again, thanks to |
| 563 |
Muktha Narayan (GNOME bug #321151). |
| 564 |
|
| 565 |
* dogtail.tc.TCImage.compare() now works with the newest version of |
| 566 |
ImageMagick. That version had changed its behavior, breaking the function. |
| 567 |
(GNOME bug #321431). |
| 568 |
|
| 569 |
* Attempting to instantiate a dogtail.tc.TCImage object while ImageMagick is |
| 570 |
not installed will now give a comprehensible error message, thanks to the |
| 571 |
new dogtail.errors.DependencyNotFoundError exception. |
| 572 |
|
| 573 |
* Calling dogtail.utils.screenshot() while ImageMagick is not installed will |
| 574 |
also raise a dogtail.errors.DependencyNotFoundError. |
| 575 |
|
| 576 |
* Attempting to execute an action belonging to a Node instance that isn't |
| 577 |
sensitive no longer fails by default, but prints a warning. This behavior |
| 578 |
is controlled by the ensureSensitivity configuration parameter. |
| 579 |
|
| 580 |
* dogtail-run-headless now correctly returns the exit code of the script |
| 581 |
being executed (GNOME bug #320535). |
| 582 |
|
| 583 |
* dogtail.distro's APT support implementation now only calls |
| 584 |
apt_pkg.GetCache() once, improving performance significantly when multiple |
| 585 |
calls to packageDb.get{Version,Dependencies}() are needed. |
| 586 |
|
| 587 |
* Building RPM packages from the supplied dogtail.spec works again on distros |
| 588 |
that are as old or older than RHEL4. |
| 589 |
|
| 590 |
* Building RPM packages with 'make rpm' works again without root privileges. |
| 591 |
|
| 592 |
API breaks: |
| 593 |
|
| 594 |
* Action execution via dogtail.tree.Node instances was forced to change |
| 595 |
interfaces from the "node.open()" model to a "node.doAction('open')" |
| 596 |
model. To retain backward compatibility with the application wrappers, the |
| 597 |
"click" action is still available as "node.click()". The |
| 598 |
dogtail.procedural interface was able to remain unchanged. |
| 599 |
|
| 600 |
* dogtail.config was rewritten to be more robust, and its interface was |
| 601 |
changed slightly. To port, First, remove any instantiations of the old |
| 602 |
Config class, and then make the following parameter replacements: |
| 603 |
|
| 604 |
- Config => config |
| 605 |
- logdir => logDir |
| 606 |
- scratch => scratchDir |
| 607 |
- data => dataDir |
| 608 |
|
| 609 |
|
| 610 |
dogtail 0.4.3 |
| 611 |
============= |
| 612 |
|
| 613 |
Features: |
| 614 |
* Headless support has been added. Use dogtail-run-headless to spawn an X |
| 615 |
server, a minimal "Nat/Jeff" GNOME session, and execute a given dogtail |
| 616 |
script before exiting. The dogtail-detect-session script detects a running |
| 617 |
GNOME session, but KDE support can be dropped in once KDE has accessibility |
| 618 |
support. |
| 619 |
|
| 620 |
* dogtail now uses a notification icon while it is running. Its tooltip is |
| 621 |
equal to the last message relayed by the debug logger. Most of the code |
| 622 |
was taken from jhbuild. |
| 623 |
|
| 624 |
* Sniff, the AT-SPI browser that uses the dogtail libraries, has gained icons |
| 625 |
for both applications and specific widgets (based on the role name, taken |
| 626 |
from at-poke) to make browsing easier. |
| 627 |
|
| 628 |
* Sniff also gained a proper dogtail icon. |
| 629 |
|
| 630 |
* The procedural API has been given more convenience functions for 'focusing' |
| 631 |
different types of widgets. |
| 632 |
|
| 633 |
* The procedural API has also been given an openItem() method, which works |
| 634 |
just like click(), for opening icons on nautilus' desktop. |
| 635 |
|
| 636 |
* dogtail can now detect Gentoo and Conary distributions, thanks to Brent |
| 637 |
Smith and Tim Gerla, respectively. |
| 638 |
|
| 639 |
* The Node class in dogtail.tree now exports the 'role' attribute in addition |
| 640 |
to the 'role name'. |
| 641 |
|
| 642 |
* Wrappers for gcalctool and yelp were added, thanks to Dave Malcolm. |
| 643 |
|
| 644 |
* A wrapper for gedit was added, thanks to Paolo Borelli. |
| 645 |
|
| 646 |
* New examples for Evolution, gcalctool and the GTK file chooser were added, |
| 647 |
thanks to Dave Malcolm. |
| 648 |
|
| 649 |
* Dave Malcolm also enhanced the Evolution wrapper, adding support for |
| 650 |
creating new meetings. |
| 651 |
|
| 652 |
* A new example that generates fake documentation for a given application has |
| 653 |
been added, thanks to Dave Malcolm. |
| 654 |
|
| 655 |
* dogtail.spec has been added, thanks to Jeremy Katz, to improve the quality |
| 656 |
of the RPM packages. |
| 657 |
|
| 658 |
Bugfixes: |
| 659 |
* several examples had not been updated to reflect API changes before the |
| 660 |
last release. This has been corrected. |
| 661 |
|
| 662 |
* The epiphany wrapper now uses the package name 'epiphany-browser' on |
| 663 |
Debian-based distributions to detect the package version, thanks to Andrew |
| 664 |
Beresford. |