Appium-Python-Client 6.0.0__py3-none-any.whl → 6.0.2__py3-none-any.whl

appium/common/helper.py

@@ -13,12 +13,12 @@
 # limitations under the License.
 
 import base64
-from typing import Any, Dict
+from typing import Any
 
 from appium import version as appium_version
 
 
-def extract_const_attributes(cls: type) -> Dict[str, Any]:
+def extract_const_attributes(cls: type) -> dict[str, Any]:
     """Return dict with constants attributes and values in the class(e.g. {'VAL1': 1, 'VAL2': 2})
 
     Args:

appium/options/android/common/adb/adb_exec_timeout_option.py

@@ -16,7 +16,6 @@
 # under the License.
 
 from datetime import timedelta
-from typing import Optional, Union
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -25,7 +24,7 @@ ADB_EXEC_TIMEOUT = 'adbExecTimeout'
 
 class AdbExecTimeoutOption(SupportsCapabilities):
     @property
-    def adb_exec_timeout(self) -> Optional[timedelta]:
+    def adb_exec_timeout(self) -> timedelta | None:
         """
         Maximum time to wait until single ADB command is executed.
         """
@@ -33,7 +32,7 @@ class AdbExecTimeoutOption(SupportsCapabilities):
         return None if value is None else timedelta(milliseconds=value)
 
     @adb_exec_timeout.setter
-    def adb_exec_timeout(self, value: Union[timedelta, int]) -> None:
+    def adb_exec_timeout(self, value: timedelta | int) -> None:
         """
         Maximum time to wait until single ADB command is executed.
         20000 ms by default.

appium/options/android/common/adb/adb_port_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,7 +23,7 @@ ADB_PORT = 'adbPort'
 
 class AdbPortOption(SupportsCapabilities):
     @property
-    def adb_port(self) -> Optional[int]:
+    def adb_port(self) -> int | None:
         """
         Number of the port where ADB is running.
         """

appium/options/android/common/adb/allow_delay_adb_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,7 +23,7 @@ ALLOW_DELAY_ADB = 'allowDelayAdb'
 
 class AllowDelayAdbOption(SupportsCapabilities):
     @property
-    def allow_delay_adb(self) -> Optional[bool]:
+    def allow_delay_adb(self) -> bool | None:
         """
         Whether to prevent the emulator to use -delay-adb feature.
         """

appium/options/android/common/adb/build_tools_version_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,7 +23,7 @@ BUILD_TOOLS_VERSION = 'buildToolsVersion'
 
 class BuildToolsVersionOption(SupportsCapabilities):
     @property
-    def build_tools_version(self) -> Optional[str]:
+    def build_tools_version(self) -> str | None:
         """
         Version of Android build tools to use.
         """

appium/options/android/common/adb/clear_device_logs_on_start_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,7 +23,7 @@ CLEAR_DEVICE_LOGS_ON_START = 'clearDeviceLogsOnStart'
 
 class ClearDeviceLogsOnStartOption(SupportsCapabilities):
     @property
-    def clear_device_logs_on_start(self) -> Optional[bool]:
+    def clear_device_logs_on_start(self) -> bool | None:
         """
         Makes the driver to delete all the existing logs in the
         device buffer before starting a new test.

appium/options/android/common/adb/ignore_hidden_api_policy_error_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,7 +23,7 @@ IGNORE_HIDDEN_API_POLICY_ERROR = 'ignoreHiddenApiPolicyError'
 
 class IgnoreHiddenApiPolicyErrorOption(SupportsCapabilities):
     @property
-    def ignore_hidden_api_policy_error(self) -> Optional[bool]:
+    def ignore_hidden_api_policy_error(self) -> bool | None:
         """
         Whether to ignore a failure while changing hidden API access policies.
         """

appium/options/android/common/adb/logcat_filter_specs_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,7 +23,7 @@ LOGCAT_FILTER_SPECS = 'logcatFilterSpecs'
 
 class LogcatFilterSpecsOption(SupportsCapabilities):
     @property
-    def logcat_filter_specs(self) -> Optional[str]:
+    def logcat_filter_specs(self) -> str | None:
         """
         Logcat filter format.
         """

appium/options/android/common/adb/logcat_format_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,7 +23,7 @@ LOGCAT_FORMAT = 'logcatFormat'
 
 class LogcatFormatOption(SupportsCapabilities):
     @property
-    def logcat_format(self) -> Optional[str]:
+    def logcat_format(self) -> str | None:
         """
         Log print format.
         """

appium/options/android/common/adb/mock_location_app_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,7 +23,7 @@ MOCK_LOCATION_APP = 'mockLocationApp'
 
 class MockLocationAppOption(SupportsCapabilities):
     @property
-    def mock_location_app(self) -> Optional[str]:
+    def mock_location_app(self) -> str | None:
         """
         Identifier of the app, which is used as a system mock location provider.
         """

appium/options/android/common/adb/remote_adb_host_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,7 +23,7 @@ REMOTE_ADB_HOST = 'remoteAdbHost'
 
 class RemoteAdbHostOption(SupportsCapabilities):
     @property
-    def remote_adb_host(self) -> Optional[str]:
+    def remote_adb_host(self) -> str | None:
         """
         Address of the host where ADB is running.
         """

appium/options/android/common/adb/skip_logcat_capture_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,7 +23,7 @@ SKIP_LOGCAT_CAPTURE = 'skipLogcatCapture'
 
 class SkipLogcatCaptureOption(SupportsCapabilities):
     @property
-    def skip_logcat_capture(self) -> Optional[bool]:
+    def skip_logcat_capture(self) -> bool | None:
         """
         Whether to delete all the existing logs in the
         device buffer before starting a new test.

appium/options/android/common/adb/suppress_kill_server_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,7 +23,7 @@ SUPPRESS_KILL_SERVER = 'suppressKillServer'
 
 class SuppressKillServerOption(SupportsCapabilities):
     @property
-    def suppress_kill_server(self) -> Optional[bool]:
+    def suppress_kill_server(self) -> bool | None:
         """
         Prevents the driver from ever killing the ADB server explicitly.
         """

appium/options/android/common/app/allow_test_packages_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,7 +23,7 @@ ALLOW_TEST_PACKAGES = 'allowTestPackages'
 
 class AllowTestPackagesOption(SupportsCapabilities):
     @property
-    def allow_test_packages(self) -> Optional[bool]:
+    def allow_test_packages(self) -> bool | None:
         """
         Whether it is possible to use packages built with the test flag for
         the automated testing (literally adds -t flag to the adb install command).

appium/options/android/common/app/android_install_timeout_option.py

@@ -16,7 +16,6 @@
 # under the License.
 
 from datetime import timedelta
-from typing import Optional, Union
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -25,7 +24,7 @@ ANDROID_INSTALL_TIMEOUT = 'androidInstallTimeout'
 
 class AndroidInstallTimeoutOption(SupportsCapabilities):
     @property
-    def android_install_timeout(self) -> Optional[timedelta]:
+    def android_install_timeout(self) -> timedelta | None:
         """
         Maximum amount of time to wait until the application under test is installed.
         """
@@ -33,7 +32,7 @@ class AndroidInstallTimeoutOption(SupportsCapabilities):
         return None if value is None else timedelta(milliseconds=value)
 
     @android_install_timeout.setter
-    def android_install_timeout(self, value: Union[timedelta, int]) -> None:
+    def android_install_timeout(self, value: timedelta | int) -> None:
         """
         Maximum amount of time to wait until the application under test is installed.
         90000 ms by default

appium/options/android/common/app/app_activity_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,7 +23,7 @@ APP_ACTIVITY = 'appActivity'
 
 class AppActivityOption(SupportsCapabilities):
     @property
-    def app_activity(self) -> Optional[str]:
+    def app_activity(self) -> str | None:
         """
         Name of the main app activity.
         """

appium/options/android/common/app/app_package_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,7 +23,7 @@ APP_PACKAGE = 'appPackage'
 
 class AppPackageOption(SupportsCapabilities):
     @property
-    def app_package(self) -> Optional[str]:
+    def app_package(self) -> str | None:
         """
         App package identifier.
         """

appium/options/android/common/app/app_wait_activity_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,7 +23,7 @@ APP_WAIT_ACTIVITY = 'appWaitActivity'
 
 class AppWaitActivityOption(SupportsCapabilities):
     @property
-    def app_wait_activity(self) -> Optional[str]:
+    def app_wait_activity(self) -> str | None:
         """
         Name of the app activity to wait for.
         """

appium/options/android/common/app/app_wait_duration_option.py

@@ -16,7 +16,6 @@
 # under the License.
 
 from datetime import timedelta
-from typing import Optional, Union
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -25,7 +24,7 @@ APP_WAIT_DURATION = 'appWaitDuration'
 
 class AppWaitDurationOption(SupportsCapabilities):
     @property
-    def app_wait_duration(self) -> Optional[timedelta]:
+    def app_wait_duration(self) -> timedelta | None:
         """
         Identifier of the app package to wait for.
         """
@@ -33,7 +32,7 @@ class AppWaitDurationOption(SupportsCapabilities):
         return None if value is None else timedelta(milliseconds=value)
 
     @app_wait_duration.setter
-    def app_wait_duration(self, value: Union[timedelta, int]) -> None:
+    def app_wait_duration(self, value: timedelta | int) -> None:
         """
         Maximum amount of time to wait until the application under test is started
         (e.g. an activity returns the control to the caller). 20000 ms by default.

appium/options/android/common/app/app_wait_for_launch_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,7 +23,7 @@ APP_WAIT_FOR_LAUNCH = 'appWaitForLaunch'
 
 class AppWaitForLaunchOption(SupportsCapabilities):
     @property
-    def app_wait_for_launch(self) -> Optional[bool]:
+    def app_wait_for_launch(self) -> bool | None:
         """
         Whether to block until the app under test returns the control to the
         caller after its activity has been started by Activity Manager.

appium/options/android/common/app/app_wait_package_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,7 +23,7 @@ APP_WAIT_PACKAGE = 'appWaitPackage'
 
 class AppWaitPackageOption(SupportsCapabilities):
     @property
-    def app_wait_package(self) -> Optional[str]:
+    def app_wait_package(self) -> str | None:
         """
         Identifier of the app package to wait for.
         """

appium/options/android/common/app/auto_grant_premissions_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,7 +23,7 @@ AUTO_GRANT_PERMISSIONS = 'autoGrantPermissions'
 
 class AutoGrantPermissionsOption(SupportsCapabilities):
     @property
-    def auto_grant_permissions(self) -> Optional[bool]:
+    def auto_grant_permissions(self) -> bool | None:
         """
         Whether to grant all the requested application permissions
         automatically when a test starts.

appium/options/android/common/app/enforce_app_install_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,7 +23,7 @@ ENFORCE_APP_INSTALL = 'enforceAppInstall'
 
 class EnforceAppInstallOption(SupportsCapabilities):
     @property
-    def enforce_app_install(self) -> Optional[bool]:
+    def enforce_app_install(self) -> bool | None:
         """
         Whether the application under test is always reinstalled even
         if a newer version of it already exists on the device under test.

appium/options/android/common/app/intent_action_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,7 +23,7 @@ INTENT_ACTION = 'intentAction'
 
 class IntentActionOption(SupportsCapabilities):
     @property
-    def intent_action(self) -> Optional[str]:
+    def intent_action(self) -> str | None:
         """
         Intent action to be applied when
         starting the given appActivity by Activity Manager.

appium/options/android/common/app/intent_category_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,7 +23,7 @@ INTENT_CATEGORY = 'intentCategory'
 
 class IntentCategoryOption(SupportsCapabilities):
     @property
-    def intent_category(self) -> Optional[str]:
+    def intent_category(self) -> str | None:
         """
         Intent category to be applied when
         starting the given appActivity by Activity Manager.

appium/options/android/common/app/intent_flags_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,7 +23,7 @@ INTENT_FLAGS = 'intentFlags'
 
 class IntentFlagsOption(SupportsCapabilities):
     @property
-    def intent_flags(self) -> Optional[str]:
+    def intent_flags(self) -> str | None:
         """
         Intent flags to be applied when
         starting the given appActivity by Activity Manager.

appium/options/android/common/app/optional_intent_arguments_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,7 +23,7 @@ OPTIONAL_INTENT_ARGUMENTS = 'optionalIntentArguments'
 
 class OptionalIntentArgumentsOption(SupportsCapabilities):
     @property
-    def optional_intent_arguments(self) -> Optional[str]:
+    def optional_intent_arguments(self) -> str | None:
         """
         Intent arguments to be applied when
         starting the given appActivity by Activity Manager.

appium/options/android/common/app/remote_apps_cache_limit_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,7 +23,7 @@ REMOTE_APPS_CACHE_LIMIT = 'remoteAppsCacheLimit'
 
 class RemoteAppsCacheLimitOption(SupportsCapabilities):
     @property
-    def remote_apps_cache_limit(self) -> Optional[int]:
+    def remote_apps_cache_limit(self) -> int | None:
         """
         Maximum amount of apps that could be cached on the remote device.
         """

appium/options/android/common/app/uninstall_other_packages_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,7 +23,7 @@ UNINSTALL_OTHER_PACKAGES = 'uninstallOtherPackages'
 
 class UninstallOtherPackagesOption(SupportsCapabilities):
     @property
-    def uninstall_other_packages(self) -> Optional[str]:
+    def uninstall_other_packages(self) -> str | None:
         """
         Identifiers of packages to be uninstalled from the device before a test starts.
         """

appium/options/android/common/avd/avd_args_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,7 +23,7 @@ AVD_ARGS = 'avdArgs'
 
 class AvdArgsOption(SupportsCapabilities):
     @property
-    def avd_args(self) -> Optional[str]:
+    def avd_args(self) -> str | None:
         """
         Emulator command line arguments.
         """

appium/options/android/common/avd/avd_env_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Dict, Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,14 +23,14 @@ AVD_ENV = 'avdEnv'
 
 class AvdEnvOption(SupportsCapabilities):
     @property
-    def avd_env(self) -> Optional[Dict[str, str]]:
+    def avd_env(self) -> dict[str, str] | None:
         """
         Mapping of emulator environment variables.
         """
         return self.get_capability(AVD_ENV)
 
     @avd_env.setter
-    def avd_env(self, value: Dict[str, str]) -> None:
+    def avd_env(self, value: dict[str, str]) -> None:
         """
         Set the mapping of emulator environment variables.
         """

appium/options/android/common/avd/avd_launch_timeout_option.py

@@ -16,7 +16,6 @@
 # under the License.
 
 from datetime import timedelta
-from typing import Optional, Union
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -25,7 +24,7 @@ AVD_LAUNCH_TIMEOUT = 'avdLaunchTimeout'
 
 class AvdLaunchTimeoutOption(SupportsCapabilities):
     @property
-    def avd_launch_timeout(self) -> Optional[timedelta]:
+    def avd_launch_timeout(self) -> timedelta | None:
         """
         Timeout to wait until Android Emulator is started.
         """
@@ -33,7 +32,7 @@ class AvdLaunchTimeoutOption(SupportsCapabilities):
         return None if value is None else timedelta(milliseconds=value)
 
     @avd_launch_timeout.setter
-    def avd_launch_timeout(self, value: Union[timedelta, int]) -> None:
+    def avd_launch_timeout(self, value: timedelta | int) -> None:
         """
         Maximum timeout to wait until Android Emulator is started.
         60000 ms by default.

appium/options/android/common/avd/avd_option.py

@@ -15,7 +15,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from typing import Optional
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -24,7 +23,7 @@ AVD = 'avd'
 
 class AvdOption(SupportsCapabilities):
     @property
-    def avd(self) -> Optional[str]:
+    def avd(self) -> str | None:
         """
         Name of Android emulator to run the test on.
         """

appium/options/android/common/avd/avd_ready_timeout_option.py

@@ -16,7 +16,6 @@
 # under the License.
 
 from datetime import timedelta
-from typing import Optional, Union
 
 from appium.options.common.supports_capabilities import SupportsCapabilities
 
@@ -25,7 +24,7 @@ AVD_READY_TIMEOUT = 'avdReadyTimeout'
 
 class AvdReadyTimeoutOption(SupportsCapabilities):
     @property
-    def avd_ready_timeout(self) -> Optional[timedelta]:
+    def avd_ready_timeout(self) -> timedelta | None:
         """
         Timeout to wait until Android Emulator is fully booted and is ready for usage.
         """
@@ -33,7 +32,7 @@ class AvdReadyTimeoutOption(SupportsCapabilities):
         return None if value is None else timedelta(milliseconds=value)
 
     @avd_ready_timeout.setter
-    def avd_ready_timeout(self, value: Union[timedelta, int]) -> None:
+    def avd_ready_timeout(self, value: timedelta | int) -> None:
         """
         Maximum timeout to wait until Android Emulator is fully booted and is ready for usage.
         60000 ms by default