[wip] Add zoom and pan

[zahin178]

PR Type

Feature

PR Checklist

• Tests for the changes have been added / updated.
• Documentation comments have been added / updated.
• A changelog entry has been made.
• Version number has been updated.
• Required modules have been added to respective "requirements*.txt" files.
• Relevant Test Cases added to this description (below).
• (Team) Label with affected action categories and semver status.

Overview

Have added two new functions in Framework\Built_In_Automation\Mobile\CrossPlatform\Appium\BuiltInFunctions.py the functions are zoom_action and pan_action

The zoom_action function will enable zoom in and zoom out for Android devices

The pan_action function will pan left/right/up/down for Android devices

Also have updated the take_screenshot_appium function. Previously the screenshot's name was saved as a timestamp of the moment the screenshot was taken. But now we can provide a name as an optional option parameter. We can also access the location of the screen_capture_folder by providing a variable name in appium action. The default variable is 'ss_path'

filename = None
    var_name = 'ss_path'

for left, mid, right in data_set:
        if left.strip().lower() == 'filename':
            filename = right.strip().lower()
        elif 'action' in mid.strip().lower():
            var_name = right.strip()

if filename == None:
        filename_format = "%Y_%m_%d_%H-%M-%S"
        filename = time.strftime(filename_format) + ".png"
Shared_Resources.Set_Shared_Variables(var_name, screenshot_folder)

Also updated the compare_images function. The 'skimage' library will only get installed if we call the compare_images function. Also we can access the score of similarity by using the 'score' variable. We can also set the variable name in 'utility action' row

 try:
        import skimage, cv2, imutils
        from skimage.metrics import structural_similarity as ssim
 except:
        from Framework.module_installer import install_missing_modules
        install_missing_modules(['scikit-image'])
        import skimage, cv2, imutils
        from skimage.metrics import structural_similarity as ssim

Test Cases

• TEST-7010

[Muntasib-creator]

strip() not required

[zahin178]

Why is the strip() not required? Is it because the word "Action" will come from the control server and as there will be no user interference hence no need to strip() the word?

[Muntasib-creator]

replace() function you wrote is already doring strip()

[zahin178]

Done

[Muntasib-creator]

have you tested this code? I dont think it will work

[zahin178]

No I haven't tested it. In fact, we can remove this part. The idea was the user could provide a (x,y) coordinate and the zoom/pan action would occur keeping that coordinate in the center. But now as we have added element parameter I think it's redundant to keep the option of the coordinates as well. What do you think?

[Muntasib-creator]

okay. since there is no client need as well, you can remove it

[zahin178]

Done

[Muntasib-creator]

double_tap = right.strip().lower() in ('true', 'enable', 'ok', 'yes')

[zahin178]

Done