Appium-Python-Client 5.2.0__py3-none-any.whl

appium/options/ios/xcuitest/webview/enable_async_execute_from_https_option.py

@@ -0,0 +1,39 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from typing import Optional
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+ENABLE_ASYNC_EXECUTE_FROM_HTTPS = 'enableAsyncExecuteFromHttps'
+
+
+class EnableAsyncExecuteFromHttpsOption(SupportsCapabilities):
+    @property
+    def enable_async_execute_from_https(self) -> Optional[bool]:
+        """
+        Whether to allow simulators to execute async JavaScript on pages using HTTPS.
+        """
+        return self.get_capability(ENABLE_ASYNC_EXECUTE_FROM_HTTPS)
+
+    @enable_async_execute_from_https.setter
+    def enable_async_execute_from_https(self, value: bool) -> None:
+        """
+        Capability to allow simulators to execute asynchronous JavaScript
+        on pages using HTTPS. Defaults to false.
+        """
+        self.set_capability(ENABLE_ASYNC_EXECUTE_FROM_HTTPS, value)

appium/options/ios/xcuitest/webview/full_context_list_option.py

@@ -0,0 +1,42 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from typing import Optional
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+FULL_CONTEXT_LIST = 'fullContextList'
+
+
+class FullContextListOption(SupportsCapabilities):
+    @property
+    def full_context_list(self) -> Optional[bool]:
+        """
+        Whether to return the detailed information on contexts for the get available
+        context command.
+        """
+        return self.get_capability(FULL_CONTEXT_LIST)
+
+    @full_context_list.setter
+    def full_context_list(self, value: bool) -> None:
+        """
+        Sets to return the detailed information on contexts for the get available
+        context command. If this capability is enabled, then each item in the returned
+        contexts list would additionally include WebView title, full URL and the bundle
+        identifier. Defaults to false.
+        """
+        self.set_capability(FULL_CONTEXT_LIST, value)

appium/options/ios/xcuitest/webview/include_safari_in_webviews_option.py

@@ -0,0 +1,41 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from typing import Optional
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+INCLUDE_SAFARI_IN_WEBVIEWS = 'includeSafariInWebviews'
+
+
+class IncludeSafariInWebviewsOption(SupportsCapabilities):
+    @property
+    def include_safari_in_webviews(self) -> Optional[bool]:
+        """
+        Whether to add Safari web views to the list of contexts available
+        during a native/webview app test.
+        """
+        return self.get_capability(INCLUDE_SAFARI_IN_WEBVIEWS)
+
+    @include_safari_in_webviews.setter
+    def include_safari_in_webviews(self, value: bool) -> None:
+        """
+        Add Safari web contexts to the list of contexts available during a
+        native/webview app test. This is useful if the test opens Safari and
+        needs to be able to interact with it. Defaults to false.
+        """
+        self.set_capability(INCLUDE_SAFARI_IN_WEBVIEWS, value)

appium/options/ios/xcuitest/webview/native_web_tap_option.py

@@ -0,0 +1,40 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from typing import Optional
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+NATIVE_WEB_TAP = 'nativeWebTap'
+
+
+class NativeWebTapOption(SupportsCapabilities):
+    @property
+    def native_web_tap(self) -> Optional[bool]:
+        """
+        Whether to enable native taps in web view mode.
+        """
+        return self.get_capability(NATIVE_WEB_TAP)
+
+    @native_web_tap.setter
+    def native_web_tap(self, value: bool) -> None:
+        """
+        Enable native, non-javascript-based taps being in web context mode. Defaults
+        to false. Warning: sometimes the preciseness of native taps could be broken,
+        because there is no reliable way to map web element coordinates to native ones.
+        """
+        self.set_capability(NATIVE_WEB_TAP, value)

appium/options/ios/xcuitest/webview/safari_garbage_collect_option.py

@@ -0,0 +1,39 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from typing import Optional
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+SAFARI_GARBAGE_COLLECT = 'safariGarbageCollect'
+
+
+class SafariGarbageCollectOption(SupportsCapabilities):
+    @property
+    def safari_garbage_collect(self) -> Optional[bool]:
+        """
+        Whether to turn on garbage collection when executing scripts on Safari.
+        """
+        return self.get_capability(SAFARI_GARBAGE_COLLECT)
+
+    @safari_garbage_collect.setter
+    def safari_garbage_collect(self, value: bool) -> None:
+        """
+        Turns on/off Web Inspector garbage collection when executing scripts on Safari.
+        Turning on may improve performance. Defaults to false.
+        """
+        self.set_capability(SAFARI_GARBAGE_COLLECT, value)

appium/options/ios/xcuitest/webview/safari_ignore_fraud_warning_option.py

@@ -0,0 +1,39 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from typing import Optional
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+SAFARI_IGNORE_FRAUD_WARNING = 'safariIgnoreFraudWarning'
+
+
+class SafariIgnoreFraudWarningOption(SupportsCapabilities):
+    @property
+    def safari_ignore_fraud_warning(self) -> Optional[bool]:
+        """
+        Whether to prevent Safari from showing a fraudulent website warning.
+        """
+        return self.get_capability(SAFARI_IGNORE_FRAUD_WARNING)
+
+    @safari_ignore_fraud_warning.setter
+    def safari_ignore_fraud_warning(self, value: bool) -> None:
+        """
+        Prevent Safari from showing a fraudulent website warning.
+        Default keeps current sim setting..
+        """
+        self.set_capability(SAFARI_IGNORE_FRAUD_WARNING, value)

appium/options/ios/xcuitest/webview/safari_ignore_web_hostnames_option.py

@@ -0,0 +1,42 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from typing import Optional
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+SAFARI_IGNORE_WEB_HOSTNAMES = 'safariIgnoreWebHostnames'
+
+
+class SafariIgnoreWebHostnamesOption(SupportsCapabilities):
+    @property
+    def safari_ignore_web_hostnames(self) -> Optional[str]:
+        """
+        Comma-separated list of host names to be ignored.
+        """
+        return self.get_capability(SAFARI_IGNORE_WEB_HOSTNAMES)
+
+    @safari_ignore_web_hostnames.setter
+    def safari_ignore_web_hostnames(self, value: str) -> None:
+        """
+        Provide a list of hostnames (comma-separated) that the Safari automation
+        tools should ignore. This is to provide a workaround to prevent a webkit
+        bug where the web context is unintentionally changed to a 3rd party website
+        and the test gets stuck. The common culprits are search engines (yahoo, bing,
+        google) and about:blank.
+        """
+        self.set_capability(SAFARI_IGNORE_WEB_HOSTNAMES, value)

appium/options/ios/xcuitest/webview/safari_initial_url_option.py

@@ -0,0 +1,38 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from typing import Optional
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+SAFARI_INITIAL_URL = 'safariInitialUrl'
+
+
+class SafariInitialUrlOption(SupportsCapabilities):
+    @property
+    def safari_initial_url(self) -> Optional[str]:
+        """
+        The initial safari url.
+        """
+        return self.get_capability(SAFARI_INITIAL_URL)
+
+    @safari_initial_url.setter
+    def safari_initial_url(self, value: str) -> None:
+        """
+        Set initial safari url, default is a local welcome page.
+        """
+        self.set_capability(SAFARI_INITIAL_URL, value)

appium/options/ios/xcuitest/webview/safari_log_all_communication_hex_dump_option.py

@@ -0,0 +1,43 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from typing import Optional
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+SAFARI_LOG_ALL_COMMUNICATION_HEX_DUMP = 'safariLogAllCommunicationHexDump'
+
+
+class SafariLogAllCommunicationHexDumpOption(SupportsCapabilities):
+    @property
+    def safari_log_all_communication_hex_dump(self) -> Optional[bool]:
+        """
+        Whether to log of plists sent to and received from the Web Inspector
+        in hex dump format.
+        """
+        return self.get_capability(SAFARI_LOG_ALL_COMMUNICATION_HEX_DUMP)
+
+    @safari_log_all_communication_hex_dump.setter
+    def safari_log_all_communication_hex_dump(self, value: bool) -> None:
+        """
+        Log all communication sent to and received from the Web Inspector, as raw
+        hex dump and printable characters. This logging is done before any data
+        manipulation, and so can elucidate some communication issues. Like
+        appium:safariLogAllCommunication, this can produce a lot of data in some cases,
+        so it is recommended to be used only when necessary. Defaults to false.
+        """
+        self.set_capability(SAFARI_LOG_ALL_COMMUNICATION_HEX_DUMP, value)

appium/options/ios/xcuitest/webview/safari_log_all_communication_option.py

@@ -0,0 +1,40 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from typing import Optional
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+SAFARI_LOG_ALL_COMMUNICATION = 'safariLogAllCommunication'
+
+
+class SafariLogAllCommunicationOption(SupportsCapabilities):
+    @property
+    def safari_log_all_communication(self) -> Optional[bool]:
+        """
+        Whether to log of plists sent to and received from the Web Inspector.
+        """
+        return self.get_capability(SAFARI_LOG_ALL_COMMUNICATION)
+
+    @safari_log_all_communication.setter
+    def safari_log_all_communication(self, value: bool) -> None:
+        """
+        Log all plists sent to and received from the Web Inspector, as plain text.
+        For some operations this can be a lot of data, so it is recommended to
+        be used only when necessary. Defaults to false.
+        """
+        self.set_capability(SAFARI_LOG_ALL_COMMUNICATION, value)

appium/options/ios/xcuitest/webview/safari_open_links_in_background_option.py

@@ -0,0 +1,39 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from typing import Optional
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+SAFARI_OPEN_LINKS_IN_BACKGROUND = 'safariOpenLinksInBackground'
+
+
+class SafariOpenLinksInBackgroundOption(SupportsCapabilities):
+    @property
+    def safari_open_links_in_background(self) -> Optional[bool]:
+        """
+        Whether Safari should allow links to open in new windows.
+        """
+        return self.get_capability(SAFARI_OPEN_LINKS_IN_BACKGROUND)
+
+    @safari_open_links_in_background.setter
+    def safari_open_links_in_background(self, value: bool) -> None:
+        """
+        Whether Safari should allow links to open in new windows.
+        Default keeps current sim setting.
+        """
+        self.set_capability(SAFARI_OPEN_LINKS_IN_BACKGROUND, value)

appium/options/ios/xcuitest/webview/safari_socket_chunk_size_option.py

@@ -0,0 +1,41 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from typing import Optional
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+SAFARI_SOCKET_CHUNK_SIZE = 'safariSocketChunkSize'
+
+
+class SafariSocketChunkSizeOption(SupportsCapabilities):
+    @property
+    def safari_socket_chunk_size(self) -> Optional[int]:
+        """
+        Get the size of a single remote debugger socket chunk.
+        """
+        return self.get_capability(SAFARI_SOCKET_CHUNK_SIZE)
+
+    @safari_socket_chunk_size.setter
+    def safari_socket_chunk_size(self, value: int) -> None:
+        """
+        The size, in bytes, of the data to be sent to the Web Inspector on
+        iOS 11+ real devices. Some devices hang when sending large amounts of
+        data to the Web Inspector, and breaking them into smaller parts can be
+        helpful in those cases. Defaults to 16384 (also the maximum possible).
+        """
+        self.set_capability(SAFARI_SOCKET_CHUNK_SIZE, value)

appium/options/ios/xcuitest/webview/safari_web_inspector_max_frame_length_option.py

@@ -0,0 +1,41 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from typing import Optional
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+SAFARI_WEB_INSPECTOR_MAX_FRAME_LENGTH = 'safariWebInspectorMaxFrameLength'
+
+
+class SafariWebInspectorMaxFrameLengthOption(SupportsCapabilities):
+    @property
+    def safari_web_inspector_max_frame_length(self) -> Optional[int]:
+        """
+        Maximum size in bytes of a single data frame for the Web Inspector.
+        """
+        return self.get_capability(SAFARI_WEB_INSPECTOR_MAX_FRAME_LENGTH)
+
+    @safari_web_inspector_max_frame_length.setter
+    def safari_web_inspector_max_frame_length(self, value: int) -> None:
+        """
+        The maximum size in bytes of a single data frame for the Web Inspector.
+        Too high values could introduce slowness and/or memory leaks.
+        Too low values could introduce possible buffer overflow exceptions.
+        Defaults to 20MiB (20*1024*1024).
+        """
+        self.set_capability(SAFARI_WEB_INSPECTOR_MAX_FRAME_LENGTH, value)

appium/options/ios/xcuitest/webview/webkit_response_timeout_option.py

@@ -0,0 +1,43 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from datetime import timedelta
+from typing import Optional, Union
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+WEBKIT_RESPONSE_TIMEOUT = 'webkitResponseTimeout'
+
+
+class WebkitResponseTimeoutOption(SupportsCapabilities):
+    @property
+    def webkit_response_timeout(self) -> Optional[timedelta]:
+        """
+        Time to wait for a response from WebKit in a Safari session.
+        """
+        value = self.get_capability(WEBKIT_RESPONSE_TIMEOUT)
+        return None if value is None else timedelta(milliseconds=value)
+
+    @webkit_response_timeout.setter
+    def webkit_response_timeout(self, value: Union[timedelta, int]) -> None:
+        """
+        (Real device only) Set the time to wait for a response from
+        WebKit in a Safari session. Defaults to 5000ms.
+        """
+        self.set_capability(
+            WEBKIT_RESPONSE_TIMEOUT, int(value.total_seconds() * 1000) if isinstance(value, timedelta) else value
+        )

appium/options/ios/xcuitest/webview/webview_connect_retries_option.py

@@ -0,0 +1,40 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from typing import Optional
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+WEBVIEW_CONNECT_RETRIES = 'webviewConnectRetries'
+
+
+class WebviewConnectRetriesOption(SupportsCapabilities):
+    @property
+    def webview_connect_retries(self) -> Optional[int]:
+        """
+        Number of retries to send connection message to remote debugger,
+        to get a webview.
+        """
+        return self.get_capability(WEBVIEW_CONNECT_RETRIES)
+
+    @webview_connect_retries.setter
+    def webview_connect_retries(self, value: int) -> None:
+        """
+        Number of times to send connection message to remote debugger,
+        to get a webview. Default: 8.
+        """
+        self.set_capability(WEBVIEW_CONNECT_RETRIES, value)

appium/options/ios/xcuitest/webview/webview_connect_timeout_option.py

@@ -0,0 +1,43 @@
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from datetime import timedelta
+from typing import Optional, Union
+
+from appium.options.common.supports_capabilities import SupportsCapabilities
+
+WEBVIEW_CONNECT_TIMEOUT = 'webviewConnectTimeout'
+
+
+class WebviewConnectTimeoutOption(SupportsCapabilities):
+    @property
+    def webview_connect_timeout(self) -> Optional[timedelta]:
+        """
+        Timeout to wait for the initial presence of webviews.
+        """
+        value = self.get_capability(WEBVIEW_CONNECT_TIMEOUT)
+        return None if value is None else timedelta(milliseconds=value)
+
+    @webview_connect_timeout.setter
+    def webview_connect_timeout(self, value: Union[timedelta, int]) -> None:
+        """
+        The time to wait for the initial presence of webviews in
+        MobileSafari or hybrid apps. Defaults to 0ms.
+        """
+        self.set_capability(
+            WEBVIEW_CONNECT_TIMEOUT, int(value.total_seconds() * 1000) if isinstance(value, timedelta) else value
+        )

appium/options/mac/__init__.py

@@ -0,0 +1 @@
+from .mac2.base import Mac2Options