feat: define AppiumClientConfig

[KazuCocoa]

BREAKING:
Let's move the client configuration stuff to AppiumClientConfig only. This will be a major version up.

• https://github.com/SeleniumHQ/selenium/blob/trunk/py/selenium/webdriver/remote/client_config.py

[testerxiaodong]

When will this PR be merged?

[mykola-mokhnach]

would it be possible to extract this logic into a separate method, so super class init would be the very first call there?

[KazuCocoa]

super class init would be the very first call there?

Actually we could by modifying here like below:

    def __init__(
        self,
        command_executor: AppiumConnection,
        client_config: AppiumClientConfig,
        extensions: Optional[List['WebDriver']] = None,
        file_detector: Optional[FileDetector] = None,
        options: Union[AppiumOptions, List[AppiumOptions], None] = None,
    ):

Then, a new method will help to build client_config and command_executor.

To avoid handling string of command_executor in selenium, which uses ClientConfig, I have added these lines to keep using AppiumClientConfig as appium python client for such a string case (to keep providing similar syntax to webdriver.Remote for selenium and appium)

[Copilot]

Pull Request Overview

This PR introduces the new AppiumClientConfig to centralize client configuration while deprecating legacy direct connection arguments, which is a breaking change. Key changes include:

• New file appium/webdriver/client_config.py defining the AppiumClientConfig.
• Updates in tests and migration documentation to use the new client_config parameter.
• Modifications in WebDriver initialization to integrate AppiumClientConfig for command executor creation.

Reviewed Changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File	Description
appium/webdriver/client_config.py	Introduces the new AppiumClientConfig class.
test/unit/webdriver/webdriver_test.py	Updates tests to use client_config instead of direct_connection.
README.md	Provides migration guide and updates examples for new config usage.
appium/webdriver/webdriver.py	Updates WebDriver and connection logic to integrate AppiumClientConfig.

Comments suppressed due to low confidence (1)

appium/webdriver/client_config.py:28

• Consider rephrasing 'If enables' to 'If enabled' for grammatical correctness in the argument description.

            direct_connection: If enables [directConnect](https://github.com/appium/python-client?tab=readme-ov-file#direct-connect-urls) feature.

[mykola-mokhnach]

I would still prefer to keep the url positional argument
I believe most of the clients have the remote client arguments defined as (url, options), so this change would require all of them to change the code, which is a major inconvenience.

[mykola-mokhnach]

upd: I can observe the below code supports such feature, so we just need to mention that in documents

[KazuCocoa]

Sounds good.

The ClinetConfig requires remote_server_addr https://github.com/SeleniumHQ/selenium/blob/dbf3daef5519b0a35a8408510854ec7766455c66/py/selenium/webdriver/remote/client_config.py#L80C9-L80C27 so current example is to reduce adding remote_server_addr to both, but actually current one will confuse users.

I'll add this.

[mykola-mokhnach]

should the optional value be assigned to None by default?

[KazuCocoa]

Either is fine. Just wanted to let the caller explicitly set both

[mykola-mokhnach]

I believe if hasattr(self, 'command_executor') would always return True