Merge branch 'master' into remove-app-strings-fallback-16370282440067229945

Author: KazuCocoa

.github/workflows/publish.yml

@@ -2,8 +2,8 @@ name: Release
 
 on:
   workflow_dispatch:
-  push:
-    branches: [ master ]
+  # push:
+  #   branches: [ master ]
 
 permissions:
   contents: write

CHANGELOG.md

@@ -2,6 +2,33 @@
 
 <!-- version list -->
 
+## v5.3.1 (2026-04-19)
+
+### Bug Fixes
+
+- Replace assert with ValueError for state validation
+  ([#1219](https://github.com/appium/python-client/pull/1219),
+  [`2193837`](https://github.com/appium/python-client/commit/2193837fc0af579231f08315431c6a2347bc2b65))
+
+### Chores
+
+- **deps-dev**: Bump ruff from 0.15.10 to 0.15.11
+  ([#1217](https://github.com/appium/python-client/pull/1217),
+  [`30dad44`](https://github.com/appium/python-client/commit/30dad44a9ab991c14134119b876ca80c21d10e88))
+
+- **deps-dev**: Bump ruff from 0.15.7 to 0.15.8
+  ([#1210](https://github.com/appium/python-client/pull/1210),
+  [`7181b20`](https://github.com/appium/python-client/commit/7181b201d0cd94561fe5f07e8bcb0bf03b8ca0e0))
+
+- **deps-dev**: Bump ruff from 0.15.8 to 0.15.9
+  ([#1214](https://github.com/appium/python-client/pull/1214),
+  [`21fdecb`](https://github.com/appium/python-client/commit/21fdecbdf975515087e4c88e04c3356b288f5ac6))
+
+- **deps-dev**: Bump ruff from 0.15.9 to 0.15.10
+  ([#1216](https://github.com/appium/python-client/pull/1216),
+  [`9016e94`](https://github.com/appium/python-client/commit/9016e9431dd9e8c0218e1499c516dcf70642b7e4))
+
+
 ## v5.3.0 (2026-03-28)
 
 ### Bug Fixes

README.md

@@ -26,15 +26,15 @@ 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
+    pip 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
+    pip install .
     ```
 
 ## Compatibility Matrix

appium/version.py

@@ -12,11 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from importlib import metadata
+from importlib.metadata import version as _metadata_version
 
-
-def _get_version():
-    return metadata.version('Appium-Python-Client')
-
-
-version = _get_version()
+version = _metadata_version('Appium-Python-Client')

appium/webdriver/webdriver.py

@@ -303,7 +303,8 @@ def _update_command_executor(self, keep_alive: bool) -> None:
         direct_port = 'directConnectPort'
         direct_path = 'directConnectPath'
 
-        assert self.caps, 'Driver capabilities must be defined'
+        if not self.caps:
+            raise ValueError('Driver capabilities must be defined')
         if not {direct_protocol, direct_host, direct_port, direct_path}.issubset(set(self.caps)):
             message = 'Direct connect capabilities from server were:\n'
             for key in [direct_protocol, direct_host, direct_port, direct_path]:

pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "Appium-Python-Client"
 description = "Python client for Appium"
-version = "5.3.0"
+version = "5.3.1"
 readme = "README.md"
 license = "Apache-2.0"
 license-files = ["LICENSE"]
@@ -64,11 +64,6 @@ dev = [
 requires = ["hatchling"]
 build-backend = "hatchling.build"
 
-[tool.hatch.version]
-source = "regex"
-path = "appium/version.py"
-pattern = "(?P<version>\\d+\\.\\d+\\.\\d+)"
-
 [tool.hatch.build]
 exclude = [
   "test/",