Appium-Python-Client 2.10.1__tar.gz → 2.11.0__tar.gz

{Appium-Python-Client-2.10.1 → Appium-Python-Client-2.11.0}/Appium_Python_Client.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: Appium-Python-Client
-Version: 2.10.1
+Version: 2.11.0
 Summary: Python client for Appium
 Home-page: http://appium.io/
 Author: Isaac Murchie
@@ -14,6 +14,8 @@ Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3.7
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
 Classifier: Environment :: Console
 Classifier: Environment :: MacOS X
 Classifier: Environment :: Win32 (MS Windows)
@@ -112,6 +114,23 @@ download and unarchive the source tarball (Appium-Python-Client-X.X.tar.gz).
     python setup.py install
     ```
 
+## Compatibility Matrix
+
+|Appium Python Client| Selenium binding|
+|----|----|
+|`2.10.0`+ |`4.1.0`+ |
+|`2.2.0` - `2.9.0` |`4.1.0` - `4.9.0` |
+|`2.0.0` - `2.1.4` |`4.0.0` |
+|`1.1.0` and below|`3.x`|
+
+The Appium Python Client depends on [Selenium Python binding](https://pypi.org/project/selenium/), thus
+the Selenium Python binding update might affect the Appium Python Client behavior.
+For exampple, some changes in the Selenium binding could break the Appium client.
+
+> **Note**
+> We strongly recommend you to manage dependencies with version management tools such as Pipenv and requirements.txt
+> to keep compatible version combinations.
+
 ## Usage
 
 The Appium Python Client is fully compliant with the WebDriver Protocol
@@ -131,41 +150,102 @@ As a base for the following code examples, the following sets up the [UnitTest](
 environment:
 
 ```python
-# Android environment
-from appium import webdriver
-# Options are only available since client version 2.3.0
-# If you use an older client then switch to desired_capabilities
-# instead: https://github.com/appium/python-client/pull/720
-from appium.options.android import UiAutomator2Options
-from appium.webdriver.common.appiumby import AppiumBy
+# Python/Pytest
+import pytest
 
-options = UiAutomator2Options()
-options.platformVersion = '10'
-options.udid = '123456789ABC'
-options.app = PATH('../../../apps/test-app.apk')
-# Appium1 points to http://127.0.0.1:4723/wd/hub by default
-self.driver = webdriver.Remote('http://127.0.0.1:4723', options=options)
-el = self.driver.find_element(by=AppiumBy.ACCESSIBILITY_ID, value='item')
-el.click()
-```
-
-```python
-# iOS environment
 from appium import webdriver
 # Options are only available since client version 2.3.0
 # If you use an older client then switch to desired_capabilities
 # instead: https://github.com/appium/python-client/pull/720
+from appium.options.android import UiAutomator2Options
 from appium.options.ios import XCUITestOptions
+from appium.webdriver.appium_service import AppiumService
 from appium.webdriver.common.appiumby import AppiumBy
 
-options = XCUITestOptions()
-options.platformVersion = '13.4'
-options.udid = '123456789ABC'
-options.app = PATH('../../apps/UICatalog.app.zip')
-# Appium1 points to http://127.0.0.1:4723/wd/hub by default
-self.driver = webdriver.Remote('http://127.0.0.1:4723', options=options)
-el = self.driver.find_element(by=AppiumBy.ACCESSIBILITY_ID, value='item')
-el.click()
+APPIUM_PORT = 4723
+APPIUM_HOST = '127.0.0.1'
+
+
+# HINT: fixtures below could be extracted into conftest.py
+# HINT: and shared across all tests in the suite
+@pytest.fixture(scope='session')
+def appium_service():
+    service = AppiumService()
+    service.start(
+        # Check the output of `appium server --help` for the complete list of 
+        # server command line arguments
+        args=['--address', APPIUM_HOST, '-p', str(APPIUM_PORT)],
+        timeout_ms=20000,
+    )
+    yield service
+    service.stop()
+
+
+def create_ios_driver(custom_opts = None):    
+    options = XCUITestOptions()
+    options.platformVersion = '13.4'
+    options.udid = '123456789ABC'
+    if custom_opts is not None:
+        options.load_capabilities(custom_opts)
+    # Appium1 points to http://127.0.0.1:4723/wd/hub by default
+    return webdriver.Remote(f'http://{APPIUM_HOST}:{APPIUM_PORT}', options=options)
+    
+
+def create_android_driver(custom_opts = None):    
+    options = UiAutomator2Options()
+    options.platformVersion = '10'
+    options.udid = '123456789ABC'
+    if custom_opts is not None:
+        options.load_capabilities(custom_opts)
+    # Appium1 points to http://127.0.0.1:4723/wd/hub by default
+    return webdriver.Remote(f'http://{APPIUM_HOST}:{APPIUM_PORT}', options=options)
+
+
+@pytest.fixture
+def ios_driver_factory():
+    return create_ios_driver
+    
+
+@pytest.fixture
+def ios_driver():
+    # prefer this fixture if there is no need to customize driver options in tests 
+    driver = create_ios_driver()
+    yield driver
+    driver.quit()
+
+    
+@pytest.fixture
+def android_driver_factory():
+    return create_android_driver
+
+
+@pytest.fixture
+def android_driver():
+    # prefer this fixture if there is no need to customize driver options in tests 
+    driver = create_android_driver()
+    yield driver
+    driver.quit()
+
+            
+def test_ios_click(appium_service, ios_driver_factory):
+    # Usage of the context manager ensures the driver session is closed properly
+    # after the test completes. Otherwise, make sure to call `driver.quit()` on teardown.
+    with ios_driver_factory({
+        'appium:app': '/path/to/app/UICatalog.app.zip'
+    }) as driver:
+        el = driver.find_element(by=AppiumBy.ACCESSIBILITY_ID, value='item')
+        el.click()
+
+
+def test_android_click(appium_service, android_driver_factory):
+    # Usage of the context manager ensures the driver session is closed properly
+    # after the test completes. Otherwise, make sure to call `driver.quit()` on teardown.
+    with android_driver_factory({
+        'appium:app': '/path/to/app/test-app.apk',
+        'appium:udid': '567890',
+    }) as driver:
+        el = driver.find_element(by=AppiumBy.ACCESSIBILITY_ID, value='item')
+        el.click()
 ```
 
 ## Direct Connect URLs
@@ -191,10 +271,10 @@ from appium.options.ios import XCUITestOptions
 options = XCUITestOptions().load_capabilities({
     'platformVersion': '13.4',
     'deviceName': 'iPhone Simulator',
-    'app': PATH('../../apps/UICatalog.app.zip'),
+    'app': '/full/path/to/app/UICatalog.app.zip',
 })
 
-self.driver = webdriver.Remote(
+driver = webdriver.Remote(
     # Appium1 points to http://127.0.0.1:4723/wd/hub by default
     'http://127.0.0.1:4723',
     options=options,
@@ -221,7 +301,7 @@ options.automation_name = 'safari'
 options.set_capability('browser_name', 'safari')
 
 # Appium1 points to http://127.0.0.1:4723/wd/hub by default
-self.driver = webdriver.Remote('http://127.0.0.1:4723', options=options, strict_ssl=False)
+driver = webdriver.Remote('http://127.0.0.1:4723', options=options, strict_ssl=False)
 ```
 
 ## Set custom `AppiumConnection`
@@ -241,13 +321,15 @@ from appium.webdriver.appium_connection import AppiumConnection
 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)
+appium_executor = AppiumConnection(
+    remote_server_addr='http://127.0.0.1:4723',
+    init_args_for_pool_manage=init_args_for_pool_manage
+)
 
 options = XCUITestOptions()
 options.platformVersion = '13.4'
 options.udid = '123456789ABC'
-options.app = PATH('../../apps/UICatalog.app.zip')
+options.app = '/full/path/to/app/UICatalog.app.zip'
 driver = webdriver.Remote(appium_executor, options=options)
 ```
 
@@ -269,7 +351,7 @@ custom_executor = CustomAppiumConnection(remote_server_addr='http://127.0.0.1:47
 options = XCUITestOptions().load_capabilities({
     'platformVersion': '13.4',
     'deviceName': 'iPhone Simulator',
-    'app': PATH('../../apps/UICatalog.app.zip'),
+    'app': '/full/path/to/app/UICatalog.app.zip',
 })
 driver = webdriver.Remote(custom_executor, options=options)
 

{Appium-Python-Client-2.10.1 → Appium-Python-Client-2.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: Appium-Python-Client
-Version: 2.10.1
+Version: 2.11.0
 Summary: Python client for Appium
 Home-page: http://appium.io/
 Author: Isaac Murchie
@@ -14,6 +14,8 @@ Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3.7
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
 Classifier: Environment :: Console
 Classifier: Environment :: MacOS X
 Classifier: Environment :: Win32 (MS Windows)
@@ -112,6 +114,23 @@ download and unarchive the source tarball (Appium-Python-Client-X.X.tar.gz).
     python setup.py install
     ```
 
+## Compatibility Matrix
+
+|Appium Python Client| Selenium binding|
+|----|----|
+|`2.10.0`+ |`4.1.0`+ |
+|`2.2.0` - `2.9.0` |`4.1.0` - `4.9.0` |
+|`2.0.0` - `2.1.4` |`4.0.0` |
+|`1.1.0` and below|`3.x`|
+
+The Appium Python Client depends on [Selenium Python binding](https://pypi.org/project/selenium/), thus
+the Selenium Python binding update might affect the Appium Python Client behavior.
+For exampple, some changes in the Selenium binding could break the Appium client.
+
+> **Note**
+> We strongly recommend you to manage dependencies with version management tools such as Pipenv and requirements.txt
+> to keep compatible version combinations.
+
 ## Usage
 
 The Appium Python Client is fully compliant with the WebDriver Protocol
@@ -131,41 +150,102 @@ As a base for the following code examples, the following sets up the [UnitTest](
 environment:
 
 ```python
-# Android environment
-from appium import webdriver
-# Options are only available since client version 2.3.0
-# If you use an older client then switch to desired_capabilities
-# instead: https://github.com/appium/python-client/pull/720
-from appium.options.android import UiAutomator2Options
-from appium.webdriver.common.appiumby import AppiumBy
+# Python/Pytest
+import pytest
 
-options = UiAutomator2Options()
-options.platformVersion = '10'
-options.udid = '123456789ABC'
-options.app = PATH('../../../apps/test-app.apk')
-# Appium1 points to http://127.0.0.1:4723/wd/hub by default
-self.driver = webdriver.Remote('http://127.0.0.1:4723', options=options)
-el = self.driver.find_element(by=AppiumBy.ACCESSIBILITY_ID, value='item')
-el.click()
-```
-
-```python
-# iOS environment
 from appium import webdriver
 # Options are only available since client version 2.3.0
 # If you use an older client then switch to desired_capabilities
 # instead: https://github.com/appium/python-client/pull/720
+from appium.options.android import UiAutomator2Options
 from appium.options.ios import XCUITestOptions
+from appium.webdriver.appium_service import AppiumService
 from appium.webdriver.common.appiumby import AppiumBy
 
-options = XCUITestOptions()
-options.platformVersion = '13.4'
-options.udid = '123456789ABC'
-options.app = PATH('../../apps/UICatalog.app.zip')
-# Appium1 points to http://127.0.0.1:4723/wd/hub by default
-self.driver = webdriver.Remote('http://127.0.0.1:4723', options=options)
-el = self.driver.find_element(by=AppiumBy.ACCESSIBILITY_ID, value='item')
-el.click()
+APPIUM_PORT = 4723
+APPIUM_HOST = '127.0.0.1'
+
+
+# HINT: fixtures below could be extracted into conftest.py
+# HINT: and shared across all tests in the suite
+@pytest.fixture(scope='session')
+def appium_service():
+    service = AppiumService()
+    service.start(
+        # Check the output of `appium server --help` for the complete list of 
+        # server command line arguments
+        args=['--address', APPIUM_HOST, '-p', str(APPIUM_PORT)],
+        timeout_ms=20000,
+    )
+    yield service
+    service.stop()
+
+
+def create_ios_driver(custom_opts = None):    
+    options = XCUITestOptions()
+    options.platformVersion = '13.4'
+    options.udid = '123456789ABC'
+    if custom_opts is not None:
+        options.load_capabilities(custom_opts)
+    # Appium1 points to http://127.0.0.1:4723/wd/hub by default
+    return webdriver.Remote(f'http://{APPIUM_HOST}:{APPIUM_PORT}', options=options)
+    
+
+def create_android_driver(custom_opts = None):    
+    options = UiAutomator2Options()
+    options.platformVersion = '10'
+    options.udid = '123456789ABC'
+    if custom_opts is not None:
+        options.load_capabilities(custom_opts)
+    # Appium1 points to http://127.0.0.1:4723/wd/hub by default
+    return webdriver.Remote(f'http://{APPIUM_HOST}:{APPIUM_PORT}', options=options)
+
+
+@pytest.fixture
+def ios_driver_factory():
+    return create_ios_driver
+    
+
+@pytest.fixture
+def ios_driver():
+    # prefer this fixture if there is no need to customize driver options in tests 
+    driver = create_ios_driver()
+    yield driver
+    driver.quit()
+
+    
+@pytest.fixture
+def android_driver_factory():
+    return create_android_driver
+
+
+@pytest.fixture
+def android_driver():
+    # prefer this fixture if there is no need to customize driver options in tests 
+    driver = create_android_driver()
+    yield driver
+    driver.quit()
+
+            
+def test_ios_click(appium_service, ios_driver_factory):
+    # Usage of the context manager ensures the driver session is closed properly
+    # after the test completes. Otherwise, make sure to call `driver.quit()` on teardown.
+    with ios_driver_factory({
+        'appium:app': '/path/to/app/UICatalog.app.zip'
+    }) as driver:
+        el = driver.find_element(by=AppiumBy.ACCESSIBILITY_ID, value='item')
+        el.click()
+
+
+def test_android_click(appium_service, android_driver_factory):
+    # Usage of the context manager ensures the driver session is closed properly
+    # after the test completes. Otherwise, make sure to call `driver.quit()` on teardown.
+    with android_driver_factory({
+        'appium:app': '/path/to/app/test-app.apk',
+        'appium:udid': '567890',
+    }) as driver:
+        el = driver.find_element(by=AppiumBy.ACCESSIBILITY_ID, value='item')
+        el.click()
 ```
 
 ## Direct Connect URLs
@@ -191,10 +271,10 @@ from appium.options.ios import XCUITestOptions
 options = XCUITestOptions().load_capabilities({
     'platformVersion': '13.4',
     'deviceName': 'iPhone Simulator',
-    'app': PATH('../../apps/UICatalog.app.zip'),
+    'app': '/full/path/to/app/UICatalog.app.zip',
 })
 
-self.driver = webdriver.Remote(
+driver = webdriver.Remote(
     # Appium1 points to http://127.0.0.1:4723/wd/hub by default
     'http://127.0.0.1:4723',
     options=options,
@@ -221,7 +301,7 @@ options.automation_name = 'safari'
 options.set_capability('browser_name', 'safari')
 
 # Appium1 points to http://127.0.0.1:4723/wd/hub by default
-self.driver = webdriver.Remote('http://127.0.0.1:4723', options=options, strict_ssl=False)
+driver = webdriver.Remote('http://127.0.0.1:4723', options=options, strict_ssl=False)
 ```
 
 ## Set custom `AppiumConnection`
@@ -241,13 +321,15 @@ from appium.webdriver.appium_connection import AppiumConnection
 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)
+appium_executor = AppiumConnection(
+    remote_server_addr='http://127.0.0.1:4723',
+    init_args_for_pool_manage=init_args_for_pool_manage
+)
 
 options = XCUITestOptions()
 options.platformVersion = '13.4'
 options.udid = '123456789ABC'
-options.app = PATH('../../apps/UICatalog.app.zip')
+options.app = '/full/path/to/app/UICatalog.app.zip'
 driver = webdriver.Remote(appium_executor, options=options)
 ```
 
@@ -269,7 +351,7 @@ custom_executor = CustomAppiumConnection(remote_server_addr='http://127.0.0.1:47
 options = XCUITestOptions().load_capabilities({
     'platformVersion': '13.4',
     'deviceName': 'iPhone Simulator',
-    'app': PATH('../../apps/UICatalog.app.zip'),
+    'app': '/full/path/to/app/UICatalog.app.zip',
 })
 driver = webdriver.Remote(custom_executor, options=options)
 

{Appium-Python-Client-2.10.1 → Appium-Python-Client-2.11.0}/README.md

@@ -84,6 +84,23 @@ download and unarchive the source tarball (Appium-Python-Client-X.X.tar.gz).
     python setup.py install
     ```
 
+## Compatibility Matrix
+
+|Appium Python Client| Selenium binding|
+|----|----|
+|`2.10.0`+ |`4.1.0`+ |
+|`2.2.0` - `2.9.0` |`4.1.0` - `4.9.0` |
+|`2.0.0` - `2.1.4` |`4.0.0` |
+|`1.1.0` and below|`3.x`|
+
+The Appium Python Client depends on [Selenium Python binding](https://pypi.org/project/selenium/), thus
+the Selenium Python binding update might affect the Appium Python Client behavior.
+For exampple, some changes in the Selenium binding could break the Appium client.
+
+> **Note**
+> We strongly recommend you to manage dependencies with version management tools such as Pipenv and requirements.txt
+> to keep compatible version combinations.
+
 ## Usage
 
 The Appium Python Client is fully compliant with the WebDriver Protocol
@@ -103,41 +120,102 @@ As a base for the following code examples, the following sets up the [UnitTest](
 environment:
 
 ```python
-# Android environment
-from appium import webdriver
-# Options are only available since client version 2.3.0
-# If you use an older client then switch to desired_capabilities
-# instead: https://github.com/appium/python-client/pull/720
-from appium.options.android import UiAutomator2Options
-from appium.webdriver.common.appiumby import AppiumBy
+# Python/Pytest
+import pytest
 
-options = UiAutomator2Options()
-options.platformVersion = '10'
-options.udid = '123456789ABC'
-options.app = PATH('../../../apps/test-app.apk')
-# Appium1 points to http://127.0.0.1:4723/wd/hub by default
-self.driver = webdriver.Remote('http://127.0.0.1:4723', options=options)
-el = self.driver.find_element(by=AppiumBy.ACCESSIBILITY_ID, value='item')
-el.click()
-```
-
-```python
-# iOS environment
 from appium import webdriver
 # Options are only available since client version 2.3.0
 # If you use an older client then switch to desired_capabilities
 # instead: https://github.com/appium/python-client/pull/720
+from appium.options.android import UiAutomator2Options
 from appium.options.ios import XCUITestOptions
+from appium.webdriver.appium_service import AppiumService
 from appium.webdriver.common.appiumby import AppiumBy
 
-options = XCUITestOptions()
-options.platformVersion = '13.4'
-options.udid = '123456789ABC'
-options.app = PATH('../../apps/UICatalog.app.zip')
-# Appium1 points to http://127.0.0.1:4723/wd/hub by default
-self.driver = webdriver.Remote('http://127.0.0.1:4723', options=options)
-el = self.driver.find_element(by=AppiumBy.ACCESSIBILITY_ID, value='item')
-el.click()
+APPIUM_PORT = 4723
+APPIUM_HOST = '127.0.0.1'
+
+
+# HINT: fixtures below could be extracted into conftest.py
+# HINT: and shared across all tests in the suite
+@pytest.fixture(scope='session')
+def appium_service():
+    service = AppiumService()
+    service.start(
+        # Check the output of `appium server --help` for the complete list of 
+        # server command line arguments
+        args=['--address', APPIUM_HOST, '-p', str(APPIUM_PORT)],
+        timeout_ms=20000,
+    )
+    yield service
+    service.stop()
+
+
+def create_ios_driver(custom_opts = None):    
+    options = XCUITestOptions()
+    options.platformVersion = '13.4'
+    options.udid = '123456789ABC'
+    if custom_opts is not None:
+        options.load_capabilities(custom_opts)
+    # Appium1 points to http://127.0.0.1:4723/wd/hub by default
+    return webdriver.Remote(f'http://{APPIUM_HOST}:{APPIUM_PORT}', options=options)
+    
+
+def create_android_driver(custom_opts = None):    
+    options = UiAutomator2Options()
+    options.platformVersion = '10'
+    options.udid = '123456789ABC'
+    if custom_opts is not None:
+        options.load_capabilities(custom_opts)
+    # Appium1 points to http://127.0.0.1:4723/wd/hub by default
+    return webdriver.Remote(f'http://{APPIUM_HOST}:{APPIUM_PORT}', options=options)
+
+
+@pytest.fixture
+def ios_driver_factory():
+    return create_ios_driver
+    
+
+@pytest.fixture
+def ios_driver():
+    # prefer this fixture if there is no need to customize driver options in tests 
+    driver = create_ios_driver()
+    yield driver
+    driver.quit()
+
+    
+@pytest.fixture
+def android_driver_factory():
+    return create_android_driver
+
+
+@pytest.fixture
+def android_driver():
+    # prefer this fixture if there is no need to customize driver options in tests 
+    driver = create_android_driver()
+    yield driver
+    driver.quit()
+
+            
+def test_ios_click(appium_service, ios_driver_factory):
+    # Usage of the context manager ensures the driver session is closed properly
+    # after the test completes. Otherwise, make sure to call `driver.quit()` on teardown.
+    with ios_driver_factory({
+        'appium:app': '/path/to/app/UICatalog.app.zip'
+    }) as driver:
+        el = driver.find_element(by=AppiumBy.ACCESSIBILITY_ID, value='item')
+        el.click()
+
+
+def test_android_click(appium_service, android_driver_factory):
+    # Usage of the context manager ensures the driver session is closed properly
+    # after the test completes. Otherwise, make sure to call `driver.quit()` on teardown.
+    with android_driver_factory({
+        'appium:app': '/path/to/app/test-app.apk',
+        'appium:udid': '567890',
+    }) as driver:
+        el = driver.find_element(by=AppiumBy.ACCESSIBILITY_ID, value='item')
+        el.click()
 ```
 
 ## Direct Connect URLs
@@ -163,10 +241,10 @@ from appium.options.ios import XCUITestOptions
 options = XCUITestOptions().load_capabilities({
     'platformVersion': '13.4',
     'deviceName': 'iPhone Simulator',
-    'app': PATH('../../apps/UICatalog.app.zip'),
+    'app': '/full/path/to/app/UICatalog.app.zip',
 })
 
-self.driver = webdriver.Remote(
+driver = webdriver.Remote(
     # Appium1 points to http://127.0.0.1:4723/wd/hub by default
     'http://127.0.0.1:4723',
     options=options,
@@ -193,7 +271,7 @@ options.automation_name = 'safari'
 options.set_capability('browser_name', 'safari')
 
 # Appium1 points to http://127.0.0.1:4723/wd/hub by default
-self.driver = webdriver.Remote('http://127.0.0.1:4723', options=options, strict_ssl=False)
+driver = webdriver.Remote('http://127.0.0.1:4723', options=options, strict_ssl=False)
 ```
 
 ## Set custom `AppiumConnection`
@@ -213,13 +291,15 @@ from appium.webdriver.appium_connection import AppiumConnection
 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)
+appium_executor = AppiumConnection(
+    remote_server_addr='http://127.0.0.1:4723',
+    init_args_for_pool_manage=init_args_for_pool_manage
+)
 
 options = XCUITestOptions()
 options.platformVersion = '13.4'
 options.udid = '123456789ABC'
-options.app = PATH('../../apps/UICatalog.app.zip')
+options.app = '/full/path/to/app/UICatalog.app.zip'
 driver = webdriver.Remote(appium_executor, options=options)
 ```
 
@@ -241,7 +321,7 @@ custom_executor = CustomAppiumConnection(remote_server_addr='http://127.0.0.1:47
 options = XCUITestOptions().load_capabilities({
     'platformVersion': '13.4',
     'deviceName': 'iPhone Simulator',
-    'app': PATH('../../apps/UICatalog.app.zip'),
+    'app': '/full/path/to/app/UICatalog.app.zip',
 })
 driver = webdriver.Remote(custom_executor, options=options)
 

Appium-Python-Client-2.11.0/appium/version.py

@@ -0,0 +1 @@
+version = '2.11.0'

{Appium-Python-Client-2.10.1 → Appium-Python-Client-2.11.0}/appium/webdriver/appium_connection.py

@@ -24,6 +24,9 @@ if TYPE_CHECKING:
     from urllib.parse import ParseResult
 
 
+PREFIX_HEADER = 'appium/'
+
+
 class AppiumConnection(RemoteConnection):
     _proxy_url: Optional[str]
 
@@ -68,7 +71,8 @@ class AppiumConnection(RemoteConnection):
     def get_remote_connection_headers(cls, parsed_url: 'ParseResult', keep_alive: bool = True) -> Dict[str, Any]:
         """Override get_remote_connection_headers in RemoteConnection"""
         headers = RemoteConnection.get_remote_connection_headers(parsed_url, keep_alive=keep_alive)
-        headers['User-Agent'] = f'appium/python {library_version()} ({headers["User-Agent"]})'
+        # e.g. appium/0.49 (selenium/3.141.0 (python linux))
+        headers['User-Agent'] = f'{PREFIX_HEADER}{library_version()} ({headers["User-Agent"]})'
         if parsed_url.path.endswith('/session'):
             # https://github.com/appium/appium-base-driver/pull/400
             headers['X-Idempotency-Key'] = str(uuid.uuid4())

{Appium-Python-Client-2.10.1 → Appium-Python-Client-2.11.0}/appium/webdriver/mobilecommand.py

@@ -31,7 +31,6 @@ class MobileCommand:
     DEACTIVATE_IME_ENGINE = 'deactivateIMEEngine'
     GET_ACTIVE_IME_ENGINE = 'getActiveEngine'
 
-    CLEAR = 'clear'
     LOCATION_IN_VIEW = 'locationInView'
 
     CONTEXTS = 'getContexts'