PowerToys/doc/releases/0.57.0/tests-checklist-jaime.md
2022-03-29 16:59:31 +01:00

12 KiB

File Explorer Add-ons

  • Running as user:
    • go to PowerToys repo root
    • verify the README.md Preview Pane shows the correct content
    • go to PowerToys repo and visit src\modules\ShortcutGuide\ShortcutGuide\svgs
    • verify Preview Pane works for the SVG files
    • verify the Icon Preview works for the SVG file (loop through different icon preview sizes)
    • go to PowerToys repo and visit src\modules\previewpane\UnitTests-PdfPreviewHandler\HelperFiles
    • verify Preview Pane works for the PDF file
    • verify the Icon Preview works for the PDF file (loop through different icon preview sizes)
    • go to PowerToys repo and visit src\modules\previewpane\UnitTests-GcodePreviewHandler\HelperFiles
    • verify Preview Pane works for the gcode file
    • verify the Icon Preview works for the gcode file (loop through different icon preview sizes)
    • go to PowerToys repo and visit src\modules\previewpane\UnitTests-StlThumbnailProvider\HelperFiles
    • verify the Icon Preview works for the stl file (loop through different icon preview sizes)
    • go to PowerToys repo and visit src\runner
    • verify Preview Pane works for source files (shows syntax highlighting)
  • Running as admin (or user since recently):
    • open the Settings and turn off the Preview Pane and Icon Previous toggles
    • go to PowerToys repo root
    • verify the README.md Preview Pane doesn't show any content
    • go to PowerToys repo and visit src\modules\ShortcutGuide\ShortcutGuide\svgs
    • verify Preview Pane doesn't show the preview for the SVG files
    • the Icon Preview for the existing SVG will still show since the icons are cached (you can also use cleanmgr.exe to clean all thumbnails cached in your system). You may need to restart the machine for this setting to apply as well.
    • copy and paste one of the SVG file and verify the new file show the generic SVG icon
    • go to PowerToys repo and visit src\modules\previewpane\UnitTests-PdfPreviewHandler\HelperFiles
    • verify Preview Pane doesn't show the preview for the PDF file
    • go to PowerToys repo and visit src\modules\previewpane\UnitTests-GcodePreviewHandler\HelperFiles
    • verify Preview Pane doesn't show the preview for the gcode file
    • go to PowerToys repo and visit src\modules\previewpane\UnitTests-StlThumbnailProvider\HelperFiles
    • verify Preview Pane doesn't show the preview for the stl file (a generated thumbnail would show when there's no preview)
    • go to PowerToys repo and visit src\runner
    • verify Preview Pane doesn't show the preview for source code files or that it's a default previewer instead of Monaco

Image Resizer

  • Disable the Image Resizer and check that Resize images is absent in the context menu

  • Enable the Image Resizer and check that Resize images is present in the context menu

  • Remove one image size and add a custom image size. Open the Image Resize window from the context menu and verify that changes are populated

  • Resize one image

  • Resize multiple images

  • Open the image resizer to resize a .gif file and verify the "Gif files with animations may not be correctly resized." warning appears.

  • Resize images with Fill option

  • Resize images with Fit option

  • Resize images with Stretch option

  • Resize images using dimension: Centimeters

  • Resize images using dimension: Inches

  • Resize images using dimension: Percents

  • Resize images using dimension: Pixels

  • Change Filename format to %1 - %2 - %3 - %4 - %5 - %6 and check if the new format is applied to resized images

  • Check Use original date modified and verify that modified date is not changed for resized images. Take into account that Resize the original pictures(don't create copy) should be selected

  • Check Make pictures smaller but not larger and verify that smaller pictures are not resized

  • Check Resize the original pictures (don't create copies) and verify that the original picture is resized and a copy is not created

  • Uncheck Ignore the orientation of pictures and verify that swapped width and height will actually resize a picture if the width is not equal to the height

Keyboard Manager

UI Validation:

  • In Remap keys, add and remove rows to validate those buttons. While the blank rows are present, pressing the OK button should result in a warning dialog that some mappings are invalid.
  • Using only the Type buttons, for both the remap windows, try adding keys/shortcuts in all the columns. The right-side column in both windows should accept both keys and shortcuts, while the left-side column will accept only keys or only shortcuts for Remap keys and Remap shortcuts respectively. Validate that the Hold Enter and Esc accessibility features work as expected.
  • Using the drop downs try to add key to key, key to shortcut, shortcut to key and shortcut to shortcut remapping and ensure that you are able to select remapping both by using mouse and by keyboard navigation.
  • Validate that remapping can be saved by pressing the OK button and re-opening the windows loads existing remapping.

Remapping Validation:

For all the remapping below, try pressing and releasing the remapped key/shortcut and pressing and holding it. Try different behaviors like releasing the modifier key before the action key and vice versa.

  • Test key to key remapping
    • A->B
    • Ctrl->A
    • A->Ctrl
    • Win->B (make sure Start menu doesn't appear accidentally)
    • B->Win (make sure Start menu doesn't appear accidentally)
    • A->Disable
    • Win->Disable
  • Test key to shortcut remapping
    • A->Ctrl+V
    • B->Win+A
  • Test shortcut to shortcut remapping
    • Ctrl+A->Ctrl+V
    • Win+A->Ctrl+V
    • Ctrl+V->Win+A
    • Win+A->Win+F
  • Test shortcut to key remapping
    • Ctrl+A->B
    • Ctrl+A->Win
    • Win+A->B
  • Test app-specific remaps
    • Similar remaps to above with Edge (entered as msedge), VSCode (entered as code) and cmd. For cmd try admin and non-admin (requires PT to run as admin)
    • Try some cases where focus is lost due to the shortcut. Example remapping to Alt+Tab or Alt+F4
  • Test switching between remapping while holding down modifiers - Eg. Ctrl+D->Ctrl+A and Ctrl+E->Ctrl+V, hold Ctrl and press D followed by E. Should select all and paste over it in a text editor. Similar steps for Windows key shortcuts.

PowerToys Run

  • Enable PT Run in settings and ensure that the hotkey brings up PT Run
    • when PowerToys is running unelevated on start-up
    • when PowerToys is running as admin on start-up
    • when PowerToys is restarted as admin, by clicking the restart as admin button in settings.
  • Check that each of the plugins is working:
    • Program - launch a Win32 application
    • Program - launch a Win32 application as admin
    • Program - launch a packaged application
    • Calculator - ensure a mathematical input returns a correct response and is copied on enter.
    • Windows Search - open a file on the disk.
    • Windows Search - find a file and copy file path.
    • Windows Search - find a file and open containing folder.
    • Shell - execute a command. Enter the action keyword >, followed by the query, both with and without space (e.g. > ping localhost).
    • Folder - Search and open a sub-folder on entering the path.
    • Uri - launch a web page on entering the uri.
    • Window walker - Switch focus to a running window.
    • Service - start, stop, restart windows service. Enter the action keyword ! to get the list of services.
    • Registry - navigate through the registry tree and open registry editor. Enter the action keyword : to get the root keys.
    • Registry - navigate through the registry tree and copy key path.
    • System - test lock.
    • System - test empty recycle bin.
    • System - test shutdown.
  • Disable PT Run and ensure that the hotkey doesn't bring up PT Run.

  • Test tab navigation.

  • Test Plugin Manager
    • Enable/disable plugins and verify changes are picked up by PT Run
    • Change Direct activation phrase and verify changes are picked up by PT Run
    • Change Include in global result and verify changes picked up by PT Run
    • Clear Direct activation phrase and uncheck Include in global result. Verify a warning message is shown.
    • Disable all plugins and verify the warning message is shown.

OOBE

  • Quit PowerToys
  • Delete %localappdata%\Microsoft\PowerToys
  • Start PowerToys and verify OOBE opens
  • Change version saved on %localappdata%\Microsoft\PowerToys\last_version.txt
  • Start PowerToys and verify OOBE opens in the "What's New" page
  • Visit each OOBE section and for each section:
    • open the Settings for that module
    • verify the Settings work as expected (toggle some controls on/off etc.)
    • close the Settings
    • if it's available, test the Launch module name button
  • Close OOBE
  • Open the Settings and from the General page open OOBE using the Welcome to PowerToys link

Mouse Utils

Find My Mouse:

  • Enable FindMyMouse. Then, without moving your mouse:
    • Press Left Ctrl twice and verify the overlay appears.
    • Press any other key and verify the overlay disappears.
    • Press Left Ctrl twice and verify the overlay appears.
    • Press a mouse button and verify the overlay disappears.
  • Disable FindMyMouse. Verify the overlay no longer appears when you press Left Ctrl twice.
  • Enable FindMyMouse. Then, without moving your mouse:
    • Press Left Ctrl twice and verify the overlay appears.
  • Enable the "Do not activate on game mode" option. Start playing a game that uses CG native full screen.
    • Verify the overlay no longer appears when you press Left Ctrl twice.
  • Disable the "Do not activate on game mode" option. Start playing the same game.
    • Verify the overlay appears when you press Left Ctrl twice. (though it'll likely minimize the game)
  • Test the different settings and verify they apply:
    • Overlay opacity
    • Background color
    • Spotlight color
    • Spotlight radius
    • Spotlight initial zoom (1x vs 9x will show the difference)
    • Animation duration
    • Change activation method to shake and activate by shaking your mouse pointer
    • Excluded apps

Mouse Highlighter:

  • Enable Mouse Highlighter. Then:
    • Press the activation shortcut and press left and right click somewhere, verifying the hightlights are applied.
    • With left mouse button pressed, drag the mouse and verify the hightlight is dragged with the pointer.
    • With right mouse button pressed, drag the mouse and verify the hightlight is dragged with the pointer.
    • Press the activation shortcut again and verify no highlights appear when the mouse buttons are clicked.
    • Disable Mouse Highlighter and verify that the module is not activated when you press the activation shortcut.
  • Test the different settings and verify they apply:
    • Change activation shortcut and test it
    • Left button highlight color
    • Right button highlight color
    • Opacity
    • Radius
    • Fade delay
    • Fade duration

Mouse Pointer Crosshairs:

  • Enable Mouse Pointer Crosshairs. Then:
    • Press the activation shortcut and verify the crosshairs appear, and that they follow the mouse around.
    • Press the activation shortcut again and verify the crosshairs disappear.
    • Disable Mouse Pointer Crosshairs and verify that the module is not activated when you press the activation shortcut.
  • Test the different settings and verify they apply:
    • Change activation shortcut and test it
    • Crosshairs color
    • Crosshairs opacity
    • Crosshairs center radius
    • Crosshairs thickness
    • Crosshairs border color
    • Crosshairs border size

Awake

  • Try out the features and see if they work, no list at this time.