fix: fix type checker errors for pyright (#1203)

* Add `__all__` to specify public API for `appium.webdriver`

In `py.typed` modules, imported symbols considered private[^1], which is not importable by users.
To become public interface, explicit `__all__` symbol is required.

[^1]: https://typing.python.org/en/latest/spec/distributing.html#library-interface-public-and-private-symbols

* Comment out unimplemented methods in CanExecuteScripts protocol

* Uncomment and add deprecation warnings for unimplemented methods

Added deprecation warnings for unimplemented methods in CanExecuteScripts protocol.

* Update deprecation messages in CanExecuteScripts

* Restore CanExecuteScripts protocol methods

* Import Remote class from the original source

* Fix formatting

* Adjust formatting

* Adjust formatting

* Add explicit `__all__` and remove lint exceptions

Author: ilotoki0804

.ruff.toml

@@ -13,8 +13,6 @@ select = [
 
 [lint.per-file-ignores]
 "__init__.py" = [
-    # unused-import
-    "F401",
     # import violations
     "E402"
 ]

appium/options/android/__init__.py

@@ -1,2 +1,4 @@
 from .espresso.base import EspressoOptions
 from .uiautomator2.base import UiAutomator2Options
+
+__all__ = ['EspressoOptions', 'UiAutomator2Options']

appium/options/common/__init__.py

@@ -1 +1,3 @@
 from .base import AppiumOptions
+
+__all__ = ['AppiumOptions']

appium/options/flutter_integration/__init__.py

@@ -13,3 +13,5 @@
 # limitations under the License.
 
 from .base import FlutterOptions
+
+__all__ = ['FlutterOptions']

appium/options/gecko/__init__.py

@@ -1 +1,3 @@
 from .base import GeckoOptions
+
+__all__ = ['GeckoOptions']

appium/options/ios/__init__.py

@@ -1,2 +1,4 @@
 from .safari.base import SafariOptions
 from .xcuitest.base import XCUITestOptions
+
+__all__ = ['SafariOptions', 'XCUITestOptions']

appium/options/mac/__init__.py

@@ -1 +1,3 @@
 from .mac2.base import Mac2Options
+
+__all__ = ['Mac2Options']

appium/options/windows/__init__.py

@@ -1 +1,3 @@
 from .windows.base import WindowsOptions
+
+__all__ = ['WindowsOptions']

appium/webdriver/__init__.py

@@ -18,3 +18,5 @@
 
 from .webdriver import WebDriver as Remote
 from .webelement import WebElement
+
+__all__ = ['Remote', 'WebElement']

appium/webdriver/webdriver.py

@@ -14,7 +14,6 @@
 
 from typing import TYPE_CHECKING, Any, Callable, Dict, List, Optional, Set, Tuple, Type, Union
 
-from selenium import webdriver
 from selenium.common.exceptions import (
     InvalidArgumentException,
     SessionNotCreatedException,
@@ -23,6 +22,9 @@
 )
 from selenium.webdriver.remote.command import Command as RemoteCommand
 from selenium.webdriver.remote.remote_connection import RemoteConnection
+
+# `selenium.webdriver.Remote` could be used instead, but Pyright wouldn't locate the class properly.
+from selenium.webdriver.remote.webdriver import WebDriver as Remote
 from typing_extensions import Self
 
 from appium.common.logger import logger
@@ -208,7 +210,7 @@ def _get_remote_connection_and_client_config(
 
 
 class WebDriver(
-    webdriver.Remote,
+    Remote,
     ActionHelpers,
     Activities,
     Applications,