Swipe By Percent - new keyword added

Get Window Height - new keyword added
Get Window Width - new keyword added

Author: Qualify

CHANGES.rst

@@ -1,5 +1,13 @@
 History
 =======
+1.4.5
+----------------
+- Swipe By Percent - new keyword added
+- Element Should Be Visible - new keyword added
+- Text Should Be Visible - new keyword added
+- Get Window Height - new keyword added
+- Get Window Width - new keyword added
+
 1.4.4
 ----------------
 - Get Capability  added for easy access to desired capabilities

README.rst

@@ -14,6 +14,12 @@ AppiumLibrary is modeled after (and forked from)  `appiumandroidlibrary <https:/
 
 It support Python 2.x only.
 
+Documentation
+-------------
+
+The keyword documentation could be found at `Keyword Documentation
+<http://serhatbolsu.github.io/robotframework-appiumlibrary/AppiumLibrary.html>`_
+
 
 Installation
 ------------
@@ -62,11 +68,6 @@ for more information.
 As it uses Appium make sure your Appium server is up and running.
 For how to use Appium please refer to `Appium Documentation <http://appium.io/getting-started.html>`_
 
-Documentation
--------------
-
-The keyword documentation could be found at `Keyword Documentation 
-<http://serhatbolsu.github.io/robotframework-appiumlibrary/AppiumLibrary.html>`_
 
 Contributing
 -------------

docs/AppiumLibrary.html

@@ -146,6 +146,8 @@ def wait_activity(self, activity, timeout, interval=1):
 
     def install_app(self, app_path, app_package):
         """ Install App via Appium
+        
+        Android only.
 
         - app_path - path to app
         - app_package - package of install app to verify

src/AppiumLibrary/keywords/_android_utils.py

@@ -192,6 +192,30 @@ def get_contexts(self):
         print(self._current_application().contexts)
         return self._current_application().contexts
 
+    def get_window_height(self):
+        """Get current device height.
+        
+        Example:
+        | ${width}       | Get Window Height |
+        | ${height}      | Get Window Height |
+        | Click A Point  | ${width           | ${height} |
+               
+        New in AppiumLibrary 1.4.5
+        """
+        return self._current_application().get_window_size()['height']
+
+    def get_window_width(self):
+        """Get current device width.
+        
+        Example:
+        | ${width}       | Get Window Height |
+        | ${height}      | Get Window Height |
+        | Click A Point  | ${width           | ${height} |
+        
+        New in AppiumLibrary 1.4.5
+        """
+        return self._current_application().get_window_size()['width']
+
     def switch_to_context(self, context_name):
         """Switch to a new context"""
         self._current_application().switch_to.context(context_name)

src/AppiumLibrary/keywords/_applicationmanagement.py

@@ -41,12 +41,46 @@ def swipe(self, start_x, start_y, offset_x, offset_y, duration=1000):
         Usage:
         | Swipe | 500 | 100 | 100 | 0 | 1000 |
 
-        *!Important Note:* Android `Swipe` is not working properly, use ``offset_x`` and ``offset_y``
-        as if these are destination points.
+        _*NOTE: *_ 
+        Android 'Swipe' is not working properly, use ``offset_x`` and ``offset_y`` as if these are destination points.
         """
         driver = self._current_application()
         driver.swipe(start_x, start_y, offset_x, offset_y, duration)
 
+    def swipe_by_percent(self, start_x, start_y, end_x, end_y):
+        """
+        Swipe from one percent of the screen to another percent, for an optional duration. 
+        Normal swipe fails to scale for different screen resolutions, this can be avoided using percent.
+
+        Args:
+         - start_x - x-percent at which to start
+         - start_y - y-percent at which to start
+         - end_x - x-percent distance from start_x at which to stop
+         - end_y - y-percent distance from start_y at which to stop
+         - duration - (optional) time to take the swipe, in ms.
+         
+        Usage:
+        | Swipe By Percent | 90 | 50 | 10 | 50 | # Swipes screen from right to left. |
+
+        _*NOTE: *_
+        This also considers swipe acts different between iOS and Android.
+        
+        New in AppiumLibrary 1.4.5
+        """
+        width = self.get_window_width()
+        height = self.get_window_height()
+        x_start = float(start_x) / 100 * width
+        x_end = float(end_x) / 100 * width
+        y_start = float(start_y) / 100 * height
+        y_end = float(end_y) / 100 * height
+        x_offset = x_end - x_start
+        y_offset = y_end - y_start
+        platform = self._get_platform()
+        if platform == 'android':
+            self.swipe(x_start, y_start, x_end, y_end)
+        else:
+            self.swipe(x_start, y_start, x_offset, y_offset)
+
     def scroll(self, start_locator, end_locator):
         """
         Scrolls from one element to another

src/AppiumLibrary/keywords/_touch.py

@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 
-VERSION = '1.4.4'
+VERSION = '1.4.5'