Debian Codegraph @

NEWS

raw
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.