Appium-Python-Client 4.1.0__tar.gz → 4.1.1__tar.gz

appium_python_client-4.1.1/Appium_Python_Client.egg-info/PKG-INFO

@@ -0,0 +1,473 @@
+Metadata-Version: 2.1
+Name: Appium-Python-Client
+Version: 4.1.1
+Summary: Python client for Appium
+Home-page: http://appium.io/
+Author: Isaac Murchie
+Author-email: isaac@saucelabs.com
+Maintainer: Kazuaki Matsuo, Mykola Mokhnach, Mori Atsushi
+License: Apache 2.0
+Keywords: appium,selenium,selenium 4,python client,mobile automation
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Programming Language :: Python
+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)
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Other Audience
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: selenium<4.26,~=4.12
+
+# Appium Python Client
+
+[![PyPI version](https://badge.fury.io/py/Appium-Python-Client.svg)](https://badge.fury.io/py/Appium-Python-Client)
+[![Downloads](https://pepy.tech/badge/appium-python-client)](https://pepy.tech/project/appium-python-client)
+
+[![Functional Tests](https://github.com/appium/python-client/actions/workflows/functional-test.yml/badge.svg)](https://github.com/appium/python-client/actions/workflows/functional-test.yml)
+
+An extension library for adding [WebDriver Protocol](https://www.w3.org/TR/webdriver/) and Appium commands to the Selenium Python language binding for use with the mobile testing framework [Appium](https://appium.io).
+
+## Getting the Appium Python client
+
+There are three ways to install and use the Appium Python client.
+
+1. Install from [PyPi](https://pypi.org), as
+['Appium-Python-Client'](https://pypi.org/project/Appium-Python-Client/).
+
+    ```shell
+    pip install Appium-Python-Client
+    ```
+
+    You can see the history from [here](https://pypi.org/project/Appium-Python-Client/#history)
+
+2. Install from source, via [PyPi](https://pypi.org). From ['Appium-Python-Client'](https://pypi.org/project/Appium-Python-Client/),
+download and unarchive the source tarball (Appium-Python-Client-X.X.tar.gz).
+
+    ```shell
+    tar -xvf Appium-Python-Client-X.X.tar.gz
+    cd Appium-Python-Client-X.X
+    python setup.py install
+    ```
+
+3. Install from source via [GitHub](https://github.com/appium/python-client).
+
+    ```shell
+    git clone git@github.com:appium/python-client.git
+    cd python-client
+    python setup.py install
+    ```
+
+## Compatibility Matrix
+
+|Appium Python Client| Selenium binding| Python version |
+|----|----|----|
+|`3.0.0` - `4.2.1` |`4.12.0` - `4.25.0` | 3.8+ |
+|`2.10.0` - `2.11.1` |`4.1.0` - `4.11.2` | 3.7+ |
+|`2.2.0` - `2.9.0` |`4.1.0` - `4.9.0` | 3.7+ |
+|`2.0.0` - `2.1.4` |`4.0.0` | 3.7+ |
+|`1.0.0` - `1.3.0` |`3.x`| 3.7+ |
+|`0.52` and below|`3.x`| 2.7, 3.4 - 3.7 |
+
+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 example, some changes in the Selenium binding could break the Appium client.
+
+> **Note**
+> We strongly recommend you manage dependencies with version management tools such as Pipenv and requirements.txt
+> to keep compatible version combinations.
+
+
+### Quick migration guide from v3 to v4
+- Removal
+    - `MultiAction` and `TouchAction` are removed. Please use W3C WebDriver actions or `mobile:` extensions
+        - [appium/webdriver/extensions/action_helpers.py](appium/webdriver/extensions/action_helpers.py)
+        - https://www.selenium.dev/documentation/webdriver/actions_api/
+        - https://www.youtube.com/watch?v=oAJ7jwMNFVU
+        - https://appiumpro.com/editions/30-ios-specific-touch-action-methods
+        - https://appiumpro.com/editions/29-automating-complex-gestures-with-the-w3c-actions-api
+    - Deprecated `AppiumBy.WINDOWS_UI_AUTOMATION`, which has no usage right now.
+
+### Quick migration guide from v2 to v3
+- `options` keyword argument in the `webdriver.Remote` constructor such as `XCUITestOptions` instead of `desired_capabilities`
+    - Available options are https://github.com/appium/python-client/tree/master/appium/options
+        - Please check the [Usage](#usage) below as an example.
+    - Not a "new" change, but the `desired_capabilities` argument has been removed since v3.
+- Replacement
+    - `start_activity` method: Please use [`mobile: startActivity`](https://github.com/appium/appium-uiautomator2-driver?tab=readme-ov-file#mobile-startactivity)
+    - `launch_app`, `close_app` and `reset` methods: Please refer to https://github.com/appium/appium/issues/15807
+    - `available_ime_engines`, `is_ime_active`, `activate_ime_engine`, `deactivate_ime_engine` and `active_ime_engine` methods: Please use [`mobile: shell`](https://github.com/appium/appium-uiautomator2-driver?tab=readme-ov-file#mobile-shell)
+    - `set_value` and `set_text` methods: Please use `element.send_keys` or `send_keys` by W3C Actions
+- Removal
+    - `end_test_coverage` method is no longer available
+    - `session` property is no longer available
+    - `all_sessions` property is no longer available
+
+### Quick migration guide from v1 to v2
+- Enhancement
+    - Updated base Selenium Python binding version to v4
+        - Removed `forceMjsonwp` since Selenium v4 and Appium Python client v2 expect only W3C WebDriver protocol
+    - Methods `ActionHelpers#scroll`, `ActionHelpers#drag_and_drop`, `ActionHelpers#tap`, `ActionHelpers#swipe` and `ActionHelpers#flick` now call W3C actions as its backend
+        - Please check each behavior. Their behaviors could slightly differ.
+    - Added `strict_ssl` to relax SSL errors such as self-signed ones
+- Deprecated
+    - `MultiAction` and `TouchAction` are deprecated. Please use W3C WebDriver actions or `mobile:` extensions
+    - `launch_app`, `close_app`, and `reset` are deprecated. Please read [issues#15807](https://github.com/appium/appium/issues/15807) for more details
+
+#### MultiAction/TouchAction to W3C actions
+
+Some elements can be handled with `touch` pointer action instead of the default `mouse` pointer action in the Selenium Python client.
+For example, the below action builder is to replace the default one with the `touch` pointer action.
+
+```python
+from selenium.webdriver import ActionChains
+from selenium.webdriver.common.actions import interaction
+from selenium.webdriver.common.actions.action_builder import ActionBuilder
+from selenium.webdriver.common.actions.pointer_input import PointerInput
+
+actions = ActionChains(driver)
+# override as 'touch' pointer action
+actions.w3c_actions = ActionBuilder(driver, mouse=PointerInput(interaction.POINTER_TOUCH, "touch"))
+actions.w3c_actions.pointer_action.move_to_location(start_x, start_y)
+actions.w3c_actions.pointer_action.pointer_down()
+actions.w3c_actions.pointer_action.pause(2)
+actions.w3c_actions.pointer_action.move_to_location(end_x, end_y)
+actions.w3c_actions.pointer_action.release()
+actions.perform()
+```
+
+- [appium/webdriver/extensions/action_helpers.py](appium/webdriver/extensions/action_helpers.py)
+- https://www.selenium.dev/documentation/webdriver/actions_api/
+
+## Usage
+
+The Appium Python Client is fully compliant with the WebDriver Protocol
+including several helpers to make mobile testing in Python easier.
+
+To use the new functionality now, and to use the superset of functions, instead of
+including the Selenium `webdriver` module in your test code, use that from
+Appium instead.
+
+```python
+from appium import webdriver
+```
+
+From there much of your test code will work with no change.
+
+As a base for the following code examples, the following set up the [UnitTest](https://docs.python.org/3/library/unittest.html)
+environment:
+
+```python
+# Python/Pytest
+import pytest
+
+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
+
+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()
+```
+
+### Available `options`
+
+Appium Python Client has a common options class named `AppiumOptions` but the available commands are minimal.
+It does not have driver/automationName specific commands unless adding commands with `add_command` method.
+
+Available options for each automation name below will help to check what options are already defined.
+Please use proper options for your automaiton usage.
+
+`automationName` | Package path
+|:---|:-----|
+any | `appium.options.common.base.AppiumOptions`
+`uiautomator2` | `appium.options.android.Uiautomator2Options`
+`espresso` | `appium.options.android.EspressoOptions`
+`xcuitest` | `appium.options.ios.XCUITestOptions`
+`safari` | `appium.options.ios.SafariOptions`
+`mac2` | `appium.options.mac.Mac2Options`
+`windows` | `appium.options.WindowsOptions`
+`gecko` | `appium.options.GeckoOptions`
+`flutterintegration` | `appium.options.flutter_integration.FlutterOptions`
+
+## Direct Connect URLs
+
+If your Selenium/Appium server decorates the new session capabilities response with the following keys:
+
+- `directConnectProtocol`
+- `directConnectHost`
+- `directConnectPort`
+- `directConnectPath`
+
+Then python client will switch its endpoint to the one specified by the values of those keys.
+
+```python
+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.ios import XCUITestOptions
+
+# load_capabilities API could be used to
+# load options mapping stored in a dictionary
+options = XCUITestOptions().load_capabilities({
+    'platformVersion': '13.4',
+    'deviceName': 'iPhone Simulator',
+    'app': '/full/path/to/app/UICatalog.app.zip',
+})
+
+driver = webdriver.Remote(
+    # Appium1 points to http://127.0.0.1:4723/wd/hub by default
+    'http://127.0.0.1:4723',
+    options=options,
+    direct_connection=True
+)
+```
+
+## Relax SSL validation
+
+`strict_ssl` option allows you to send commands to an invalid certificate host like a self-signed one.
+
+```python
+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.common import AppiumOptions
+
+options = AppiumOptions()
+options.platform_name = 'mac'
+options.automation_name = 'safari'
+# set_capability API allows to provide any custom option
+# calls to it could be chained
+options.set_capability('browser_name', 'safari')
+
+# Appium1 points to http://127.0.0.1:4723/wd/hub by default
+driver = webdriver.Remote('http://127.0.0.1:4723', options=options, strict_ssl=False)
+```
+
+## Set custom `AppiumConnection`
+
+The first argument of `webdriver.Remote` can set an arbitrary command executor for you.
+
+1. Set init arguments for the pool manager Appium Python client uses to manage HTTP requests.
+
+```python
+from appium import webdriver
+from appium.options.ios import XCUITestOptions
+
+import urllib3
+from appium.webdriver.appium_connection import AppiumConnection
+
+# 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
+)
+
+options = XCUITestOptions()
+options.platformVersion = '13.4'
+options.udid = '123456789ABC'
+options.app = '/full/path/to/app/UICatalog.app.zip'
+driver = webdriver.Remote(appium_executor, options=options)
+```
+
+
+2. Define a subclass of `AppiumConnection`
+
+```python
+from appium import webdriver
+from appium.options.ios import XCUITestOptions
+
+from appium.webdriver.appium_connection import AppiumConnection
+
+class CustomAppiumConnection(AppiumConnection):
+    # Can add your own methods for the custom class
+    pass
+
+custom_executor = CustomAppiumConnection(remote_server_addr='http://127.0.0.1:4723')
+
+options = XCUITestOptions().load_capabilities({
+    'platformVersion': '13.4',
+    'deviceName': 'iPhone Simulator',
+    'app': '/full/path/to/app/UICatalog.app.zip',
+})
+driver = webdriver.Remote(custom_executor, options=options)
+
+```
+
+
+## Documentation
+
+- https://appium.github.io/python-client-sphinx/ is detailed documentation
+- [functional tests](test/functional) also may help to see concrete examples.
+
+## Development
+
+- Code Style: [PEP-0008](https://www.python.org/dev/peps/pep-0008/)
+  - Apply `ruff` as pre commit hook
+  - Run `make` command for development. See `make help` output for details
+- Docstring style: [Google Style](https://sphinxcontrib-napoleon.readthedocs.io/en/latest/example_google.html)
+- `gitchangelog` generates `CHANGELOG.rst`
+
+### Setup
+
+- `pip install --user pipenv`
+- `python -m pipenv lock --clear`
+  - If you experience `Locking Failed! unknown locale: UTF-8` error, then refer [pypa/pipenv#187](https://github.com/pypa/pipenv/issues/187) to solve it.
+- `python -m pipenv install --dev --system`
+- `pre-commit install`
+
+### Run tests
+
+You can run all of the tests running on CI via `tox` in your local.
+
+```bash
+$ tox
+```
+
+You also can run particular tests like below.
+
+#### Unit
+
+```bash
+$ pytest test/unit
+```
+
+Run with `pytest-xdist`
+
+```bash
+$ pytest -n 2 test/unit
+```
+
+#### Functional
+
+```bash
+$ pytest test/functional/ios/search_context/find_by_ios_class_chain_tests.py
+```
+
+#### In parallel for iOS
+
+1. Create simulators named 'iPhone X - 8100' and 'iPhone X - 8101'
+2. Install test libraries via pip, `pip install pytest pytest-xdist`
+3. Run tests
+
+```bash
+$ pytest -n 2 test/functional/ios/search_context/find_by_ios_class_chain_tests.py
+```
+
+## Release
+
+Follow the below steps.
+
+```bash
+$ pip install twine
+$ pip install git+git://github.com/vaab/gitchangelog.git # Getting via GitHub repository is necessary for Python 3.7
+# Type the new version number and 'yes' if you can publish it
+# You can test the command with DRY_RUN
+$ DRY_RUN=1 ./release.sh
+$ ./release.sh # release
+```
+
+If the `pypi` was not able to publish with user name and password, please try out `-u` and `-p` option by yourself with `twine` such as `twine upload -u <name> -p <pass> dist/Appium-Python-Client-4.1.0.tar.gz`.
+
+## License
+
+Apache License v2

{Appium-Python-Client-4.1.0 → appium_python_client-4.1.1}/Appium_Python_Client.egg-info/SOURCES.txt

@@ -1,7 +1,6 @@
 LICENSE
 MANIFEST.in
 README.md
-setup.cfg
 setup.py
 Appium_Python_Client.egg-info/PKG-INFO
 Appium_Python_Client.egg-info/SOURCES.txt
@@ -140,6 +139,12 @@ appium/options/common/supports_capabilities.py
 appium/options/common/system_host_option.py
 appium/options/common/system_port_option.py
 appium/options/common/udid_option.py
+appium/options/flutter_integration/__init__.py
+appium/options/flutter_integration/base.py
+appium/options/flutter_integration/flutter_element_wait_timeout_option.py
+appium/options/flutter_integration/flutter_enable_mock_camera_option.py
+appium/options/flutter_integration/flutter_server_launch_timeout_option.py
+appium/options/flutter_integration/flutter_system_port_option.py
 appium/options/gecko/__init__.py
 appium/options/gecko/android_storage_option.py
 appium/options/gecko/base.py
@@ -315,6 +320,10 @@ appium/webdriver/extensions/android/performance.py
 appium/webdriver/extensions/android/power.py
 appium/webdriver/extensions/android/sms.py
 appium/webdriver/extensions/android/system_bars.py
+appium/webdriver/extensions/flutter_integration/__init__.py
+appium/webdriver/extensions/flutter_integration/flutter_commands.py
+appium/webdriver/extensions/flutter_integration/flutter_finder.py
+appium/webdriver/extensions/flutter_integration/scroll_directions.py
 docs/Makefile
 docs/README.md
 docs/conf.py

appium_python_client-4.1.1/Appium_Python_Client.egg-info/requires.txt

@@ -0,0 +1 @@
+selenium<4.26,~=4.12