Appium-Python-Client 6.1.2__py3-none-any.whl → 6.1.4__py3-none-any.whl

appium/webdriver/extensions/flutter_integration/flutter_commands.py

@@ -38,7 +38,8 @@ class FlutterCommand:
 
         Args:
             locator (Union[WebElement, FlutterFinder]): The element to wait for; can be a WebElement or a FlutterFinder.
-            timeout (Optional[float]): Maximum wait time in seconds. Defaults to a predefined timeout if not specified.
+            timeout (Optional[float]): Maximum wait time in whole seconds. The Flutter server drops any fractional
+                part, so 0.5 becomes 0. Defaults to a predefined timeout if not specified.
 
         Returns:
             None
@@ -59,7 +60,8 @@ class FlutterCommand:
 
         Args:
             locator (Union[WebElement, FlutterFinder]): The element to wait for; can be a WebElement or a FlutterFinder.
-            timeout (Optional[float]): Maximum wait time in seconds. Defaults to a predefined timeout if not specified.
+            timeout (Optional[float]): Maximum wait time in whole seconds. The Flutter server drops any fractional
+                part, so 0.5 becomes 0. Defaults to a predefined timeout if not specified.
 
         Returns:
             None:
@@ -128,10 +130,10 @@ class FlutterCommand:
 
         Args:
             scroll_to (FlutterFinder): The Flutter element to scroll to.
-            scroll_direction (ScrollDirection): The direction to scroll up or down. Defaults to `ScrollDirection.DOWN`.
+            scroll_direction (ScrollDirection): The direction to scroll. Defaults to `ScrollDirection.DOWN`.
 
         KeywordArgs:
-                scrollView (str): The view of the scroll. Default value is 'Scrollable'
+                scrollView (FlutterFinder | dict): Finder of the scrollable view. Defaults to the first `Scrollable` widget
                 delta (int): delta for the scroll. Default value is 64
                 maxScrolls (int): Max times to scroll. Default value is 15
                 settleBetweenScrollsTimeout (float): settle timeout in milliseconds. Default value is 5000
@@ -142,6 +144,8 @@ class FlutterCommand:
         """
         opts['finder'] = scroll_to.to_dict()
         opts['scrollDirection'] = scroll_direction.value
+        if isinstance(opts.get('scrollView'), FlutterFinder):
+            opts['scrollView'] = opts['scrollView'].to_dict()
         return self.execute_flutter_command('scrollTillVisible', opts)
 
     def inject_mock_image(self, value: str) -> str:

appium/webdriver/extensions/flutter_integration/scroll_directions.py

@@ -4,3 +4,5 @@ from enum import Enum
 class ScrollDirection(Enum):
     UP = 'up'
     DOWN = 'down'
+    LEFT = 'left'
+    RIGHT = 'right'

appium/webdriver/webdriver.py

@@ -74,7 +74,7 @@ class ExtensionBase:
 
     Example:
         When you want to add `example_command` which calls a get request to
-        `session/$sessionId/path/to/your/custom/url`.
+        `/session/$sessionId/path/to/your/custom/url`.
 
         #. Defines an extension as a subclass of `ExtensionBase`
             .. code-block:: python
@@ -91,7 +91,7 @@ class ExtensionBase:
 
                     # Used to register the command pair as "Appium command" in this driver.
                     def add_command(self):
-                        return ('GET', 'session/$sessionId/path/to/your/custom/url')
+                        return ('GET', '/session/$sessionId/path/to/your/custom/url')
 
         #. Creates a session with the extension.
             .. code-block:: python
@@ -105,7 +105,7 @@ class ExtensionBase:
             .. code-block:: python
 
                 # Then, the driver calls a get request against
-                # `session/$sessionId/path/to/your/custom/url`. `$sessionId` will be
+                # `/session/$sessionId/path/to/your/custom/url`. `$sessionId` will be
                 # replaced properly in the driver. Then, the method returns
                 # the `value` part of the response.
                 driver.custom_method_name()
@@ -127,16 +127,16 @@ class ExtensionBase:
                 def method_name(self):
                     return 'custom_method_name'
 
-                def test_command(self, argument):
+                def custom_method_name(self, argument):
                     return self.execute(argument)['value']
 
                 def add_command(self):
-                    return ('post', 'session/$sessionId/path/to/your/custom/url')
+                    return ('post', '/session/$sessionId/path/to/your/custom/url')
 
             driver = webdriver.Remote('http://localhost:4723/wd/hub', options=options,
                 extensions=[YourCustomCommand])
 
-            # Then, the driver sends a post request to `session/$sessionId/path/to/your/custom/url`
+            # Then, the driver sends a post request to `/session/$sessionId/path/to/your/custom/url`
             # with `{'dummy_arg': 'as a value'}` JSON body.
             driver.custom_method_name({'dummy_arg': 'as a value'})
 
@@ -153,13 +153,13 @@ class ExtensionBase:
                     return self.execute({'id': element_id})['value']
 
                 def add_command(self):
-                    return ('GET', 'session/$sessionId/path/to/your/custom/$id/url')
+                    return ('GET', '/session/$sessionId/path/to/your/custom/$id/url')
 
             driver = webdriver.Remote('http://localhost:4723/wd/hub', options=options,
-                extensions=[YourCustomCommand])
+                extensions=[CustomURLCommand])
             element = driver.find_element(by=AppiumBy.ACCESSIBILITY_ID, value='id')
 
-            # Then, the driver calls a get request to `session/$sessionId/path/to/your/custom/$id/url`
+            # Then, the driver calls a get request to `/session/$sessionId/path/to/your/custom/$id/url`
             # with replacing the `$id` with the given `element.id`
             driver.custom_method_name(element.id)
 

{appium_python_client-6.1.2.dist-info → appium_python_client-6.1.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: Appium-Python-Client
-Version: 6.1.2
+Version: 6.1.4
 Summary: Python client for Appium
 Project-URL: Homepage, https://appium.io/
 Project-URL: Repository, https://github.com/appium/python-client
@@ -232,7 +232,7 @@ def appium_service():
 
 def create_ios_driver(custom_opts=None):
     options = XCUITestOptions()
-    options.platformVersion = '13.4'
+    options.platform_version = '13.4'
     options.udid = '123456789ABC'
     if custom_opts is not None:
         options.load_capabilities(custom_opts)
@@ -242,7 +242,7 @@ def create_ios_driver(custom_opts=None):
 
 def create_android_driver(custom_opts=None):
     options = UiAutomator2Options()
-    options.platformVersion = '10'
+    options.platform_version = '10'
     options.udid = '123456789ABC'
     if custom_opts is not None:
         options.load_capabilities(custom_opts)
@@ -408,15 +408,20 @@ from appium.options.ios import XCUITestOptions
 
 import urllib3
 from appium.webdriver.appium_connection import AppiumConnection
+from appium.webdriver.client_config import AppiumClientConfig
 
 # Retry connection error up to 3 times.
-init_args_for_pool_manage = {'retries': urllib3.util.retry.Retry(total=3, connect=3, read=False)}
-appium_executor = AppiumConnection(
-    remote_server_addr='http://127.0.0.1:4723', init_args_for_pool_manage=init_args_for_pool_manage
+# Selenium passes the arguments under the nested 'init_args_for_pool_manager' key to urllib3.PoolManager.
+init_args_for_pool_manager = {
+    'init_args_for_pool_manager': {'retries': urllib3.util.retry.Retry(total=3, connect=3, read=False)}
+}
+client_config = AppiumClientConfig(
+    remote_server_addr='http://127.0.0.1:4723', init_args_for_pool_manager=init_args_for_pool_manager
 )
+appium_executor = AppiumConnection(client_config=client_config)
 
 options = XCUITestOptions()
-options.platformVersion = '13.4'
+options.platform_version = '13.4'
 options.udid = '123456789ABC'
 options.app = '/full/path/to/app/UICatalog.app.zip'
 driver = webdriver.Remote(appium_executor, options=options)

{appium_python_client-6.1.2.dist-info → appium_python_client-6.1.4.dist-info}/RECORD

@@ -282,7 +282,7 @@ appium/webdriver/errorhandler.py,sha256=_aT6Qo64ARGch7evG2Uku4-l8wkDaM1R2o06PWXx
 appium/webdriver/locator_converter.py,sha256=uUdJsX1o0E8x-StcJvO5gFFJbcRzhOmySfgPqJ0UaU4,999
 appium/webdriver/mobilecommand.py,sha256=B_okscraJMPrN4hSyetSNddkOZ0PyTzsQvBdYHHQqvM,3162
 appium/webdriver/switch_to.py,sha256=kom9MHNOdZuEG0ALDuaw27NHvtsRDnl-sy_XNAd-Rl4,1174
-appium/webdriver/webdriver.py,sha256=G0bx_EwubHhMl-Pe11TXeMDHuaHGS-quGuLD3FlqLnU,19316
+appium/webdriver/webdriver.py,sha256=6i3KPWyBOKeshv58VB9N0vDFTgDmU6z9oEpup3cSyjo,19328
 appium/webdriver/webelement.py,sha256=ewBkxaZiJtmhRoKjQk317WjewansQ6tpm3JePSv1pQ4,4500
 appium/webdriver/common/__init__.py,sha256=4MapoJ3p5LiP0AsHMgL2xoPTIFno4dcH1GSoxaZzv4w,623
 appium/webdriver/common/appiumby.py,sha256=1sFzgJht8v9pO0fG-uK1jgbb8zMJwfBy3LJH15OPqq8,1785
@@ -316,10 +316,10 @@ appium/webdriver/extensions/android/power.py,sha256=BD-fwZNY9aFeAZCRKa79OdOXI0ml
 appium/webdriver/extensions/android/sms.py,sha256=ZXvZ0DpA_X5iojNDlh91O8tYJUmNb28S_VlnSpijwPw,1488
 appium/webdriver/extensions/android/system_bars.py,sha256=1vCIwg5UGpY1GfCoXFPL9nfSVjafAGVsTonBMrmIwaw,1530
 appium/webdriver/extensions/flutter_integration/__init__.py,sha256=wSUl6yC2TJNla7xbHXkCfn9J1LpQs9UIx8oOs6V8kZA,567
-appium/webdriver/extensions/flutter_integration/flutter_commands.py,sha256=FwNqIykRyMAU8-344GTlceBOxLbS-bA9bfGX4iJpHxw,11985
+appium/webdriver/extensions/flutter_integration/flutter_commands.py,sha256=1bAczDwqr40Rrbln321cIVG83ghar7-27aerRAKbfMs,12306
 appium/webdriver/extensions/flutter_integration/flutter_finder.py,sha256=HH9vGAouJuHzp29Jam_lQGrh67PDq6MxU5Ifewf7C5w,2164
-appium/webdriver/extensions/flutter_integration/scroll_directions.py,sha256=CkOv7k21SMe-h2-EYSZ6MBKBGTRC1csQ-tuowHgMn0E,85
-appium_python_client-6.1.2.dist-info/METADATA,sha256=3baTi7BcpESKmZBTGQsP1yWzBk_e14Dr5hdYNRsLbF8,21766
-appium_python_client-6.1.2.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
-appium_python_client-6.1.2.dist-info/licenses/LICENSE,sha256=QxeKfXNmPWCfFyrXiwdVzMFPFMK0nlBrKhYLUoIcqhk,11384
-appium_python_client-6.1.2.dist-info/RECORD,,
+appium/webdriver/extensions/flutter_integration/scroll_directions.py,sha256=y1BCEbWHJ86ivj5quhln10uwV9fWsA6nsdQ18j1Ua3E,123
+appium_python_client-6.1.4.dist-info/METADATA,sha256=PQUU3xirFx0Sll61PqYlPdj8LiByORgDMAKP5Y2pjj4,22042
+appium_python_client-6.1.4.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+appium_python_client-6.1.4.dist-info/licenses/LICENSE,sha256=QxeKfXNmPWCfFyrXiwdVzMFPFMK0nlBrKhYLUoIcqhk,11384
+appium_python_client-6.1.4.dist-info/RECORD,,