Feat: Element verifiers (#1)

* delete test.py file

* feat: Element verifiers

* feat: Update readme

* feat: upgrade version

* fix: remove wrong import at element

* fix: remvoe unfuntional keywords

* feat: raise error when automationName isnt flutter

* fix: scroll to element keyword

Author: igortavtib

AppiumFlutterLibrary/__init__.py

@@ -8,9 +8,10 @@
 class AppiumFlutterLibrary(
 	_ApplicationManagementKeyWords,
 	_ElementKeywords,
+	_LoggingKeywords,
+	_ScreenKeywords,
 	_RunOnFailureKeyWords,
 	_WaintingKeywords,
-	_LoggingKeywords
 ):
 	ROBOT_LIBRARY_SCOPE = 'GLOBAL'
 	ROBOT_LIBRARY_VERSION = VERSION

AppiumFlutterLibrary/finder/elementfinder.py

@@ -5,7 +5,8 @@ def __init__(self):
         self._element_finder = FlutterFinder()
         self._strategies = {
             'xpath': self._find_by_xpath,
-            'key': self._find_by_key
+            'key': self._find_by_key,
+            'text': self._find_by_text,
         }
 
     def find(self, application, locator):
@@ -29,6 +30,14 @@ def _find_by_key(self, application, element_key):
     def _find_by_xpath(self, application, xpath):
         return
 
+    def _find_by_text(self, application, element_text):
+        finder_text = self._element_finder.by_text(element_text)
+        element = FlutterElement(application, finder_text)
+
+        return element
+
+    
+
     def _parse_locator(self, locator):
         prefix = None
         criteria = locator

AppiumFlutterLibrary/keywords/__init__.py

@@ -1,13 +1,15 @@
 from ._applicationmanagement import _ApplicationManagementKeyWords
 from ._element import _ElementKeywords
+from ._logging import _LoggingKeywords
 from ._runonfailure import _RunOnFailureKeyWords
+from ._screen import _ScreenKeywords
 from ._waiting import _WaintingKeywords
-from ._logging import _LoggingKeywords
 
 __all__ = [
             "_ApplicationManagementKeyWords",
             "_ElementKeywords",
             "_LoggingKeywords",
             "_RunOnFailureKeyWords",
+            "_ScreenKeywords",
             "_WaintingKeywords"
           ]

AppiumFlutterLibrary/keywords/_applicationmanagement.py

@@ -1,6 +1,7 @@
 # -*- coding: utf-8 -*-
 
 import robot
+import time
 from AppiumFlutterLibrary.utils import ApplicationCache
 from AppiumFlutterLibrary.keywords.keywordgroup import KeywordGroup
 from appium.webdriver import Remote
@@ -15,8 +16,9 @@ def close_application(self):
 
     def open_application(self, remote_url, alias =None, **kwargs):
         desired_caps = kwargs
+        if desired_caps['automationName'] != 'flutter':
+            raise ValueError("Appium Flutter Library only suports flutter automation. Try changing automationName capability to 'flutter'")
         application = Remote(str(remote_url), desired_caps)
-
         return self._cache.register(application, alias)
 
     def set_appium_timeout(self, seconds):

AppiumFlutterLibrary/keywords/_element.py

@@ -1,4 +1,4 @@
-import time
+from appium.webdriver.webelement import WebElement
 from .keywordgroup import KeywordGroup
 from AppiumFlutterLibrary.finder import ElementFinder
 
@@ -10,12 +10,31 @@ def __init__(self):
         self._element_finder = ElementFinder()
 
     def input_text(self, locator, text):
-        application = self._current_application()
-        element = self._element_finder.find(application, locator)
+        element = self._find_element(locator)
         self._info("Typing text '%s' into component '%s'" % (text, locator))
         element.send_keys(text)
 
     def click_element(self, locator):
-        application = self._current_application()
-        element = self._element_finder.find(application, locator)
+        element = self._find_element(locator)
+        self._info("Clicking on element %s" % locator)
         element.click()
+
+    def element_should_be_visible(self, locator):
+        element = self._find_element(locator)
+        if not self._is_visible(element):
+            raise AssertionError("Element '%s' should be visible but not" % locator)
+
+    def element_text_should_be(self, locator, text):
+        element = self._find_element(locator)
+        if element.text != text:
+            raise AssertionError("Element '%s' text should be '%s' but is '%s'." %
+                                    (locator, text, element.text))
+
+    def _is_visible(self, element):
+        application = self._current_application()
+        application.execute_script('flutter:waitFor', element, 1)
+        return 1
+
+    def _find_element(self, locator):
+        application = self._current_application()
+        return self._element_finder.find(application, locator)

AppiumFlutterLibrary/keywords/_screen.py

@@ -1,4 +1,3 @@
-from _typeshed import ReadableBuffer
 from AppiumFlutterLibrary.finder import ElementFinder
 from AppiumFlutterLibrary.keywords.keywordgroup import KeywordGroup
 
@@ -9,4 +8,5 @@ def __init__(self):
     def scroll_to_element(self, locator):
         application = self._current_application()
         element = self._element_finder.find(application, locator)
-        application.execute_script('flutter:scrollIntoView', element)
+        self._info(element)
+        application.execute_script('flutter:scrollIntoView', element, 0)

AppiumFlutterLibrary/keywords/test.py

@@ -1,2 +1,2 @@
 # -*- coding: utf-8 -*-
-VERSION = '1.0.0-alpha.1'
+VERSION = '1.0.0-alpha.2'

AppiumFlutterLibrary/version.py

@@ -1,2 +1,16 @@
 # AppiumFlutterLibary
+
+![PyPI](https://img.shields.io/pypi/v/robotframework-appiumflutterlibrary?color=blue)
+![PyPI - Downloads](https://img.shields.io/pypi/dm/robotframework-appiumflutterlibrary)
+
 AppiumFlutterLibrary is a library for testing Flutter apps with [RobotFramework](https://robotframework.org/).
+
+The project uses the [Flutter Driver](https://flutter.dev/docs/cookbook/testing/integration/introduction) test tools integrated to [Appium](https://appium.io/) as a RobotFramework library.
+
+## Installation
+
+Install using [pip](https://pypi.org/project/robotframework-appiumflutterlibrary/)
+
+```bash
+pip install --upgrade robotframework-appiumflutterlibrary
+```

README.md

@@ -5,9 +5,8 @@
 
 ROOT = dirname(abspath(__file__))
 
-
 setup(name='robotframework-appiumflutterlibrary',
-      version='1.0.0-alpha.1',
+      version='1.0.0-alpha.2',
       description='Robot Framework Mobile flutter app testing library for Appium Client Android & iOS & Web',
       long_description=open(join(ROOT, 'README.md')).read(),
       author='Igor Augusto',