cthulhu/test/keystrokes/gnome-terminal/man_page_flat_review.py
2024-12-18 10:05:44 -05:00

340 lines
15 KiB
Python

#!/usr/bin/env python3
#
# Copyright (c) 2024 Stormux
# Copyright (c) 2010-2012 The Orca Team
# Copyright (c) 2012 Igalia, S.L.
# Copyright (c) 2005-2010 Sun Microsystems Inc.
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the
# Free Software Foundation, Inc., Franklin Street, Fifth Floor,
# Boston MA 02110-1301 USA.
#
# Fork of Orca Screen Reader (GNOME)
# Original source: https://gitlab.gnome.org/GNOME/orca
from macaroon.playback import *
import utils
sequence = MacroSequence()
sequence.append(PauseAction(3000))
sequence.append(TypeAction("man cthulhu"))
sequence.append(KeyComboAction("Return"))
sequence.append(PauseAction(3000))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyComboAction("KP_8"))
sequence.append(utils.AssertPresentationAction(
"1. Review current line",
["BRAILLE LINE: ' Manual page cthulhu(1) line 1 (press h for help or q to quit) $l'",
" VISIBLE: ' (press h for help or q to quit)', cursor=32",
"SPEECH OUTPUT: ' Manual page cthulhu(1) line 1 (press h for help or q to quit)",
"'"]))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyComboAction("KP_7"))
sequence.append(utils.AssertPresentationAction(
"2. Review previous line",
["BRAILLE LINE: ' When starting cthulhu, initiate the GUI-based configuration. $l'",
" VISIBLE: ' When starting cthulhu', cursor=1",
"SPEECH OUTPUT: ' When starting cthulhu, initiate the GUI-based configuration.",
"'"]))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyComboAction("KP_7"))
sequence.append(utils.AssertPresentationAction(
"3. Review previous line",
["BRAILLE LINE: ' -s, --setup $l'",
" VISIBLE: ' -s, --setup $l', cursor=1",
"SPEECH OUTPUT: ' -s, --setup",
"'"]))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyComboAction("KP_9"))
sequence.append(utils.AssertPresentationAction(
"4. Review next line",
["BRAILLE LINE: ' When starting cthulhu, initiate the GUI-based configuration. $l'",
" VISIBLE: ' When starting cthulhu', cursor=1",
"SPEECH OUTPUT: ' When starting cthulhu, initiate the GUI-based configuration.",
"'"]))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyPressAction(0, None, "KP_Insert"))
sequence.append(KeyComboAction("KP_7"))
sequence.append(KeyReleaseAction(0, None, "KP_Insert"))
sequence.append(utils.AssertPresentationAction(
"5. Review first line",
["BRAILLE LINE: 'File Edit View Search Terminal Help $l'",
" VISIBLE: 'File Edit View Search Terminal H', cursor=1",
"SPEECH OUTPUT: 'File Edit View Search Terminal Help'"]))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyComboAction("KP_9"))
sequence.append(utils.AssertPresentationAction(
"6. Review next line",
["BRAILLE LINE: 'cthulhu(1) General Commands Manual cthulhu(1) $l'",
" VISIBLE: 'cthulhu(1) Gene', cursor=1",
"SPEECH OUTPUT: 'cthulhu(1) General Commands Manual cthulhu(1)",
"'"]))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyComboAction("KP_9"))
sequence.append(utils.AssertPresentationAction(
"7. Review next line",
["BRAILLE LINE: 'vertical scroll bar 3% $l'",
" VISIBLE: 'vertical scroll bar 3% $l', cursor=1",
"SPEECH OUTPUT: 'vertical scroll bar 3 percent.'"]))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyComboAction("KP_9"))
sequence.append(utils.AssertPresentationAction(
"8. Review next line",
["BRAILLE LINE: ' $l'",
" VISIBLE: ' $l', cursor=1",
"SPEECH OUTPUT: 'blank'"]))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyComboAction("KP_9"))
sequence.append(utils.AssertPresentationAction(
"9. Review next line",
["BRAILLE LINE: 'NAME $l'",
" VISIBLE: 'NAME $l', cursor=1",
"SPEECH OUTPUT: 'NAME",
"'"]))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyComboAction("KP_9"))
sequence.append(utils.AssertPresentationAction(
"10. Review next line",
["BRAILLE LINE: ' cthulhu - a scriptable screen reader $l'",
" VISIBLE: ' cthulhu - a scriptable scree', cursor=1",
"SPEECH OUTPUT: ' cthulhu - a scriptable screen reader",
"'"]))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyComboAction("<Control>f"))
sequence.append(utils.AssertPresentationAction(
"11. Forward one page",
["BRAILLE LINE: ' Manual page cthulhu(1) line 24 (press h for help or q to quit)'",
" VISIBLE: '(press h for help or q to quit)', cursor=32",
"BRAILLE LINE: ' Manual page cthulhu(1) line 24 (press h for help or q to quit)'",
" VISIBLE: '(press h for help or q to quit)', cursor=32",
"BRAILLE LINE: ' Manual page cthulhu(1) line 24 (press h for help or q to quit)'",
" VISIBLE: '(press h for help or q to quit)', cursor=32",
"BRAILLE LINE: ' Manual page cthulhu(1) line 24 (press h for help or q to quit)'",
" VISIBLE: '(press h for help or q to quit)', cursor=32",
"SPEECH OUTPUT: ' When starting cthulhu, use dirname as an alternate directory for",
" the user preferences.",
"",
" -e, --enable=speech|braille|braille-monitor",
" When starting cthulhu, force the enabling of the supplied options.",
"",
" -d, --disable=speech|braille|braille-monitor",
" When starting cthulhu, force the disabling of the supplied options.",
"",
" -l, --list-apps",
" Prints the names of all the currently running applications.",
" This is used primarily for debugging purposes to see if cthulhu can",
" talk to the accessibility infrastructure. Note that if cthulhu is",
" already running, this will not kill the other cthulhu process. It",
" will just list the currently running applications, and you will",
" see cthulhu listed twice: once for the existing cthulhu and once for",
" this instance.",
"",
" --debug",
" Enables debug output for cthulhu and sends all debug output to a",
" file with a name of the form 'debug-YYYY-MM-DD-HH:MM:SS.out' in",
" Manual page cthulhu(1) line 24 (press h for help or q to quit)'"]))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyComboAction("KP_8"))
sequence.append(utils.AssertPresentationAction(
"12. Review current line",
["KNOWN ISSUE: We currently deliberately exit flat review and return to the bottom of the window",
"BRAILLE LINE: ' Manual page cthulhu(1) line 24 (press h for help or q to quit) $l'",
" VISIBLE: ' (press h for help or q to quit)', cursor=32",
"SPEECH OUTPUT: ' Manual page cthulhu(1) line 24 (press h for help or q to quit)",
"'"]))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyComboAction("KP_7"))
sequence.append(utils.AssertPresentationAction(
"13. Review previous line",
["BRAILLE LINE: ' file with a name of the form 'debug-YYYY-MM-DD-HH:MM:SS.out' in $l'",
" VISIBLE: ' file with a name o', cursor=1",
"SPEECH OUTPUT: ' file with a name of the form 'debug-YYYY-MM-DD-HH:MM:SS.out' in",
"'"]))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyComboAction("KP_7"))
sequence.append(utils.AssertPresentationAction(
"14. Review previous line",
["BRAILLE LINE: ' Enables debug output for cthulhu and sends all debug output to a $l'",
" VISIBLE: ' Enables debug ou', cursor=1",
"SPEECH OUTPUT: ' Enables debug output for cthulhu and sends all debug output to a",
"'"]))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyPressAction(0, None, "KP_Insert"))
sequence.append(KeyComboAction("KP_7"))
sequence.append(KeyReleaseAction(0, None, "KP_Insert"))
sequence.append(utils.AssertPresentationAction(
"15. Review first line",
["BRAILLE LINE: 'File Edit View Search Terminal Help $l'",
" VISIBLE: 'File Edit View Search Terminal H', cursor=1",
"SPEECH OUTPUT: 'File Edit View Search Terminal Help'"]))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyComboAction("KP_9"))
sequence.append(utils.AssertPresentationAction(
"16. Review next line",
["BRAILLE LINE: ' $l'",
" VISIBLE: ' $l', cursor=1",
"SPEECH OUTPUT: 'blank'"]))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyComboAction("KP_9"))
sequence.append(utils.AssertPresentationAction(
"17. Review next line",
["BRAILLE LINE: 'vertical scroll bar 26% $l'",
" VISIBLE: 'vertical scroll bar 26% $l', cursor=1",
"SPEECH OUTPUT: 'vertical scroll bar 26 percent.'"]))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyComboAction("KP_9"))
sequence.append(utils.AssertPresentationAction(
"18. Review next line",
["BRAILLE LINE: ' -u, --user-prefs-dir=dirname $l'",
" VISIBLE: ' -u, --user-prefs-dir=dirn', cursor=1",
"SPEECH OUTPUT: ' -u, --user-prefs-dir=dirname",
"'"]))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyComboAction("<Control>b"))
sequence.append(utils.AssertPresentationAction(
"19. Back one page",
["BRAILLE LINE: ' Manual page cthulhu(1) line 1 (press h for help or q to quit)'",
" VISIBLE: '(press h for help or q to quit)', cursor=32",
"BRAILLE LINE: ' Manual page cthulhu(1) line 1 (press h for help or q to quit)'",
" VISIBLE: '(press h for help or q to quit)', cursor=32",
"BRAILLE LINE: ' Manual page cthulhu(1) line 1 (press h for help or q to quit)'",
" VISIBLE: '(press h for help or q to quit)', cursor=32",
"SPEECH OUTPUT: 'cthulhu(1) General Commands Manual cthulhu(1)",
"",
"NAME",
" cthulhu - a scriptable screen reader",
"",
"SYNOPSIS",
" cthulhu [option...]",
"",
"DESCRIPTION",
" cthulhu is a screen reader for people with visual impairments, it provides",
" alternative access to the desktop by using speech synthesis and",
" braille.",
"",
" cthulhu works with applications and toolkits that support the Assistive",
" Technology Service Provider Interface (AT-SPI), which is the primary",
" assistive technology infrastructure for Linux and Solaris. Applications",
" and toolkits supporting the AT-SPI include the GNOME Gtk+ toolkit, the",
" Java platform's Swing toolkit, LibreOffice, Gecko, and WebKitGtk. AT-",
" SPI support for the KDE Qt toolkit is being pursued.",
"",
"OPTIONS",
" -s, --setup",
" When starting cthulhu, initiate the GUI-based configuration.",
" Manual page cthulhu(1) line 1 (press h for help or q to quit)'"]))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyComboAction("KP_8"))
sequence.append(utils.AssertPresentationAction(
"20. Review current line",
["BRAILLE LINE: ' Manual page cthulhu(1) line 1 (press h for help or q to quit) $l'",
" VISIBLE: ' (press h for help or q to quit)', cursor=32",
"SPEECH OUTPUT: ' Manual page cthulhu(1) line 1 (press h for help or q to quit)",
"'"]))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyComboAction("KP_7"))
sequence.append(utils.AssertPresentationAction(
"21. Review previous line",
["BRAILLE LINE: ' When starting cthulhu, initiate the GUI-based configuration. $l'",
" VISIBLE: ' When starting cthulhu', cursor=1",
"SPEECH OUTPUT: ' When starting cthulhu, initiate the GUI-based configuration.",
"'"]))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyComboAction("KP_7"))
sequence.append(utils.AssertPresentationAction(
"22. Review previous line",
["BRAILLE LINE: ' -s, --setup $l'",
" VISIBLE: ' -s, --setup $l', cursor=1",
"SPEECH OUTPUT: ' -s, --setup",
"'"]))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyPressAction(0, None, "KP_Insert"))
sequence.append(KeyComboAction("KP_7"))
sequence.append(KeyReleaseAction(0, None, "KP_Insert"))
sequence.append(utils.AssertPresentationAction(
"23. Review first line",
["BRAILLE LINE: 'File Edit View Search Terminal Help $l'",
" VISIBLE: 'File Edit View Search Terminal H', cursor=1",
"SPEECH OUTPUT: 'File Edit View Search Terminal Help'"]))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyComboAction("KP_9"))
sequence.append(utils.AssertPresentationAction(
"24. Review next line",
["BRAILLE LINE: 'cthulhu(1) General Commands Manual cthulhu(1) $l'",
" VISIBLE: 'cthulhu(1) Gene', cursor=1",
"SPEECH OUTPUT: 'cthulhu(1) General Commands Manual cthulhu(1)",
"'"]))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyComboAction("KP_9"))
sequence.append(utils.AssertPresentationAction(
"25. Review next line",
["BRAILLE LINE: 'vertical scroll bar 26% $l'",
" VISIBLE: 'vertical scroll bar 26% $l', cursor=1",
"SPEECH OUTPUT: 'vertical scroll bar 26 percent.'"]))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyComboAction("KP_9"))
sequence.append(utils.AssertPresentationAction(
"26. Review next line",
["BRAILLE LINE: ' $l'",
" VISIBLE: ' $l', cursor=1",
"SPEECH OUTPUT: 'blank'"]))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyComboAction("KP_9"))
sequence.append(utils.AssertPresentationAction(
"27. Review next line",
["BRAILLE LINE: 'NAME $l'",
" VISIBLE: 'NAME $l', cursor=1",
"SPEECH OUTPUT: 'NAME",
"'"]))
sequence.append(utils.StartRecordingAction())
sequence.append(KeyComboAction("KP_9"))
sequence.append(utils.AssertPresentationAction(
"28. Review next line",
["BRAILLE LINE: ' cthulhu - a scriptable screen reader $l'",
" VISIBLE: ' cthulhu - a scriptable scree', cursor=1",
"SPEECH OUTPUT: ' cthulhu - a scriptable screen reader",
"'"]))
sequence.append(utils.AssertionSummaryAction())
sequence.start()