velenium 0.3.0

Interact with an app using visual definitions of elements

velenium

Interact with an app using visual definitions of elements

sample usage

import unittest
from appium import webdriver
from velenium import VisualElement, VERTICAL_ORDER, HORIZONTAL_ORDER, CV_SQDIFF


class VisualTestCase(unittest.TestCase):

    def test_visual(self):
        desired_caps = dict(
            ...
        )
        driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)

        # create a visual definition
        element = VisualElement(driver, 'path/to/pattern.png')
        
        # create a visual definition using multiple images using glob path
        element = VisualElement(driver, 'path/to/patterns/**/pattern_*.png')

        # assert element is visible
        self.assertTrue(element.is_visible())

        # wait until visual element is visible, raises TimeoutException from selenium if timeout
        element.wait_until_visible()

        # wait until visual element is not visible, raises TimeoutException from selenium if timeout
        element.wait_until_not_visible()

        # click on element
        element.click()

        # refresh position of element and click
        element.reset_object().click()

        # click and wait no visibility of the element
        element.click().wait_until_not_visible()

        # find with different similarity threshold, by default is 70%
        VisualElement(driver, 'path/to/pattern.png', similarity=0.8).click()

        # click the 2nd best match of element
        VisualElement(driver, 'path/to/pattern.png', order=1).click()

        # click element at 2nd position in vertical order
        VisualElement(driver, 'path/to/pattern.png', order=1, disposal=VERTICAL_ORDER).click()
        # or
        item = VisualElement(driver, 'path/to/pattern.png', disposal=VERTICAL_ORDER)
        item[1].click()

        # click element at 3er position in horizontal order
        VisualElement(driver, 'path/to/pattern.png', order=2, disposal=HORIZONTAL_ORDER).click()
        # or
        item = VisualElement(driver, 'path/to/pattern.png', disposal=HORIZONTAL_ORDER)
        item[2].click()

        # use another cv2 method to get the match, by default uses CV_CCOEFF
        VisualElement(driver, 'path/to/pattern.png', method=CV_SQDIFF).wait_until_visible()

        # count matches
        print(len(element))

        # iterate over matches
        for e in element:
            e.click()
        
        # enable debug images in "temp/" folder
        element.debug()
        
        # disable debug images
        element.debug(False)


if __name__ == '__main__':
    unittest.main()